threenative-asset-mcp 0.10.0 → 0.12.0

package/README.md

@@ -145,10 +145,36 @@ Fab:
   flows.
 - `asset_import_unreal` — converts an already-downloaded Unreal directory to
   self-contained GLBs plus `import-report.json`; Unreal Engine is not required.
+  Cascade `ParticleSystem` and Niagara systems are exported as data-only
+  descriptors under `Effects/<system>-<hash>.<cascade|niagara>.json`, one per
+  canonical package and object path so two same-basename systems in different
+  folders stay distinct. No runtime plays them: each descriptor lists the
+  modules and inputs it does not carry, and a placed effect component points at
+  its descriptor through `import-report.json`. Effects with no exported
+  descriptor stay named in the report; the importer never reconstructs a
+  particle simulation.
 - `fab_import_asset` — downloads an owned listing through the user's existing
   FabCLI session, then runs the same Unreal importer. It never signs in, claims,
   or purchases an asset.
 
+Blendkit (through the user's own official Blendkit-Client; see
+[docs/blendkit-integration.md](docs/blendkit-integration.md)):
+
+- `blendkit_status` — local-only health: whether the Client runs on loopback,
+  its version and `export_glb` recipe, whether live access is enabled, and the
+  setup steps still missing. It never contacts Blendkit.
+- `blendkit_import_asset` — acquires one free Blendkit model through the Client,
+  converts it with the Client's bundled `export_glb` recipe under headless
+  Blender, inspects the GLB (meshes, triangles, PBR texture slots, size) and
+  writes a provenance file. It needs the item's license acknowledgement and
+  explicit project-use consent, and it refuses paid items and unknown licenses.
+  The output is private use only: the Blendkit Terms forbid open-format models
+  such as GLB in software and apply that to CC0-labelled items too. It never
+  goes into game builds, demos or starter kits, and `purpose: "redistribution"`
+  is always refused. Existing outputs are never overwritten. Live search and
+  import stay off until `BLENDKIT_PROVIDER_PERMISSION` is set. With it,
+  `asset_search` also searches Blendkit.
+
 Poly Haven:
 
 - `polyhaven_search_assets` — searches HDRIs, textures, and models by text,
@@ -383,6 +409,9 @@ it out of process. Modern UE5 packages rejected by UE Viewer use a pinned,
 out-of-process CUE4Parse adapter. Set `THREENATIVE_TOOLCHAIN_AUTOINSTALL=0` to
 require manually installed tools instead.
 
+**Supported, verified and missing formats:** [`docs/unreal-format-support.md`](docs/unreal-format-support.md)
+is the tracking ledger for every Unreal 4 and 5 class, with its status, evidence and gaps.
+
 ### Fab login for owned packs
 
 `fab_import_asset` and `fab_list_owned` read your Fab library through
@@ -430,8 +459,9 @@ sweep's `--no-graph-bake` uses this to produce a baseline).
 | --- | --- |
 | Cooked loose UE4 static meshes and textures | GLB geometry, LOD sections, embedded textures, and common PBR reconstruction |
 | Cooked loose UE4 skeletal meshes and standalone animation packages | Standard skinned GLB; joints, weights, inverse-bind matrices, and existing clips are preserved; ActorX PSA clips are attached by case-insensitive bone name when at least 80% of tracks match, without duplicating an existing clip name |
+| UE5 `AnimSequence`, blend spaces, aim offsets, montages and composites | UE5.0–5.5 conventional clips and UE5.4+ FK Sequencer-model clips become glTF animations and attach by bone name; blend spaces, aim offsets, montages and composites become `Animation/<name>.json` with typed axes, mirror flags and resolved section starts, and `<clip>.clip.json` sidecars preserve notifies, curves and sync markers. Current release 0.12.0 / importer124 / converter `.584.10.2` fresh public/native proof retains 325 selected UE5.4 clips and 7 UE5.8 clips. Independent actual UE5.8.3 full-pose comparison passes 7 clips, 8 GLB-document comparisons and 72,233 keys (actual current maximum 0.000264° against 0.5°); scope is serialized raw bones, excluding only 2 independently declared mannequin virtuals and no face bones. Static poses remain intact; non-FK graphs remain reported. Current independent replay and all four local repository gates pass (PRD-596); selected clips do not prove whole-pack or generated-virtual-bone support. |
 | Uncooked UE4 `FMeshDescription` static meshes (object versions 517–522) | GLB geometry with centimetres converted to metres; verified on Fab Office Pack Vol.1 (47/47 meshes) |
-| Uncooked UE5 editor static meshes (source models only, no render data) | LOD0 of the `FMeshDescription` source model is decoded from the package trailer's Oodle payloads, with the cooked glTF writer's axes, scale, and material naming. Verified on Fab's Megascans Common Hazel and European Hornbeam UE5.1 artifacts: triangle counts match the UE4.27 decoder of the same scans exactly |
+| Uncooked UE5 editor static meshes (source models only, no render data) | Requested payload-backed `FMeshDescription` source models are decoded from the package trailer's Oodle payloads as `Models/<name>_LOD<n>.glb`; `BuildScale3D` from `SourceModels[0].BuildSettings` is applied on the modern route. Source models Unreal generates at build time are reported as generated and are not faked. Verified on Fab's Megascans European Hornbeam UE5.1 artifact for LOD0/1/2 |
 | Uncooked UE4.0–4.20 static and skeletal meshes (object versions below 517) | Exported by UE Viewer from the editor source data, with materials, skins, and ActorX clips like cooked packages. Verified on Fab packs from UE4.10 to UE4.20: Modular Building Set (129 meshes), Animal Variety Pack (6 rigged animals, 146 clips), STF Landscape Pro 2.0 (61), Power Plant (65), and a UE4.19 fern pack (38) |
 | Standalone `Texture2D` packages | Collision-free source-relative PNGs under `textures/`; duplicate Unreal basenames are exported independently instead of overwriting one another |
 | `Texture2D` with an `RGBA16F` source | Raw little-endian half-float RGBA binaries and a versioned JSON manifest under `data-textures/`, promoted together under the package's qualified path. Values are stored, not decoded: no PivotPainter, classifier, source UV, graph or WPO semantics, and no material binding. The PNG exporters cannot encode the format, so the importer asks the converter for this route after a legacy PNG export fails; a UE 4.x pack needs its `engine` (`UE_4.19`), since the default detector reads every UE4 package as the latest UE4. Loaded in the browser with `threenative-asset-mcp/data-texture` (see Three.js usage) |
@@ -439,6 +469,7 @@ sweep's `--no-graph-bake` uses this to produce a baseline).
 | `Texture2DArray`, `TextureCubeArray`, and `VolumeTexture` | Collision-free RGBA8 slice data plus JSON dimensions under `textures3d/`; use `DataArrayTexture` for arrays and `Data3DTexture` for volumes. Cube-array faces remain ordered in groups of six for custom shaders. Floating-point/HDR stacks are rejected rather than reduced to RGBA8 |
 | Standalone `Material` and `MaterialInstanceConstant` packages | One directly loadable `Materials/UnrealMaterialLibrary.glb`; each source-relative swatch name is collision-free, follows parent instances, embeds resolved texture inputs, and applies common base-color/emissive vectors plus roughness/metallic/opacity scalars |
 | Standalone `SoundWave` packages | Collision-free WAV/Ogg/MP3/FLAC files under `audio/`; modern UE5 editor source WAVs and cooked formats exposed by CUE4Parse feed the same report path, verified through Three.js `AudioLoader` |
+| Skeletal and static mesh sockets, static-mesh simple collision, `PhysicsAsset`, and `SoundCue` graphs | Socket nodes (`socket:<name>`) under the joint their bone names (or the mesh node for a static socket); simple collision on the mesh node's `extras.unrealCollision` and in `Collision/<package>.json`; physics bodies, constraints (limits, motions and drives) and collision-disabled pairs in metre-scale `Physics/<asset>.json`, referenced from the skinned mesh node; and each SoundCue graph in `Audio/<cue>.cue.json` with every `WavePlayer` leaf rewritten to the exported audio file or reported as a missing wave. A UE4 package that holds one of these classes routes to the CUE4Parse adapter, which UE Viewer cannot decode; an ordinary UE4 mesh whose only gameplay signal is a `BodySetup` or a cross-package PhysicsAsset/Skeleton reference joins the adapter run for its metadata while keeping its verified UE Viewer geometry route |
 | Runtime `Font` and inline `FontFace` packages | Validated TTF/OTF faces under collision-free `fonts/` paths; direct SFNT and legacy multi-block zlib `FontBulkData` are supported without Unreal Engine, with family/style/weight metadata for the browser `FontFace` API |
 | Offline `Font` packages | Pre-baked glyph pages and serialized `FontCharacter` rectangles become collision-safe atlas PNGs plus BMFont-compatible JSON under `bitmap-fonts/`; Unicode remaps, baseline metrics, kerning, page indices, and distance-field metadata are retained for Three.js bitmap/SDF text |
 | Paper2D `PaperSprite` and `PaperFlipbook` packages | Each sprite becomes a self-contained, unlit GLB with exact baked triangles and a cropped atlas region; flipbooks become JSON manifests preserving FPS and per-frame run lengths. Verified in Three.js on a real UE5.2 Paper2D project without Unreal Engine |
@@ -448,9 +479,11 @@ sweep's `--no-graph-bake` uses this to produce a baseline).
 | Modern UE5 loose static meshes, skeletal meshes, `Texture2D`, Material, and `.umap` packages rejected by UE Viewer | CUE4Parse converts directly to the same output/report pipeline; verified with UE5.5 cooked static geometry, UE5 editor skeletal geometry, Oodle-compressed UE5.3 editor texture source art, and a UE5.2 Paper2D map. Editor source art is restored to display colour: `TSF_BGRA8` sources are stored with red and blue swapped, and sRGB-sampled `TSF_RGBA16` sources are linear, so both are corrected (checked against UE Viewer's export of the same textures from the UE4.27 artifact). Cooked packages using unversioned properties require one matching `.usmap` file beside the imported tree |
 | Separate roughness/metalness, solid palette maps, glass, and mirrors | Packed glTF PBR maps or explicit material fallbacks; extra graph inputs remain named sidecars |
 | UE4 `.umap` placement, direct lights, and serialized Blueprint component templates (object versions 517–522) | Directly loadable scene GLB plus a transform/source manifest; repeated actors instance shared meshes; inherited mesh/light defaults are merged into placed instances; directional, point, and spot lights use `KHR_lights_punctual` |
+| UE5 World Partition `.umap` external actors | The selected level export loads `__ExternalActors__` packages with the same provider mount and complete map path into the scene; external actor/object packages belonging to maps outside the import remain reported as skipped. Real-pack verification is tracked by PRD-598 |
 | Standalone modern UE5 Blueprint prefabs | Serialized static/skeletal mesh and light component defaults become directly loadable scene GLBs; referenced meshes, transforms, skins, and bone hierarchies are retained, while bytecode is explicitly reported and never executed |
 | UE4 ISM/HISM and painted static-mesh foliage placement | Bulk-serialized instance matrices become `EXT_mesh_gpu_instancing`, which Three.js `GLTFLoader` loads as GPU-instanced meshes |
 | UE4 editor `LandscapeComponent` heightfields | Package-relative compressed BGRA8 heightmaps become indexed terrain meshes with decoded normals, component transforms, and original material names |
+| UE5 level `Landscape` and `LandscapeStreamingProxy` heightfields | CUE4Parse follows every proxy component, restores trailer-backed BGRA8 source pixels, and emits indexed terrain meshes with decoded heights, normals, proxy-root transforms, and material identity |
 | ActorX per-frame bone scale, dynamic Blueprint bytecode/construction scripts, Paper Terrain/spline deformation, and Nanite-only data without a fallback mesh | Detected or reported honestly; scene-level omissions are listed in `scenes[].omittedActors`, and Blueprint bytecode is never executed by the importer |
 | Arbitrary Unreal shader graphs | Recoverable PBR inputs become standard glTF materials. Reports mark materials as degraded when shader connections are unavailable, even if every section has a texture; section `limitations` explain omitted layering, graph UV transforms, subsurface lighting, normal strength, and deformation |
 | Encrypted Pak/IoStore | Unsupported without user-supplied keys and archive extraction; never reported as a complete conversion |
@@ -714,6 +747,10 @@ new `--out`, or add `--no-sheets`. Profiles and binaries derive from licensed pa
 | `ASSET_PROVIDER_TIMEOUT_MS`     | `8000`                                             | Provider deadline; range 1–30000 milliseconds. |
 | `ASSET_SEARCH_TIMEOUT_MS`       | `10000`                                            | Aggregate search/metadata deadline including queue time; range 1–60000. |
 | `ASSET_PLAN_TTL_MS`             | `300000`                                           | Acquisition-plan TTL; range 1–900000; at most 100 bounded plans. |
+| `BLENDKIT_CLIENT_URL`           | `http://127.0.0.1:62485`                           | Loopback address of the user's official Blendkit-Client; other hosts fail. |
+| `BLENDKIT_PROVIDER_PERMISSION`  | unset                                              | Citation of documented Blendkit permission for this use. Unset keeps live Blendkit search and import off. |
+| `BLENDKIT_API_KEY`              | unset                                              | **Your own** key from the official Blendkit sign-in; sent only to the loopback Client, never logged or returned. |
+| `BLENDKIT_BLENDER_PATH`         | Client-stored Blender                              | Absolute path to the Blender that runs the `export_glb` recipe. |
 | `THREENATIVE_TOOLCHAIN_AUTOINSTALL` | `1`                                            | Set to `0` to disable first-use external-tool installs.  |
 | `THREENATIVE_TOOLCHAIN_DIR`     | OS cache under `threenative-asset-mcp/toolchain`   | UE Viewer, FabCLI, and uncooked-converter cache.          |
 | `THREENATIVE_UMODEL_PATH`       | auto-detected/provisioned                           | Absolute path to a UE Viewer executable override.        |

package/dist/blendkit/client.d.ts

@@ -0,0 +1,112 @@
+/**
+ * HTTP client for the official Blendkit-Client (https://github.com/BlenderKit/bk_client), a
+ * GPL-2.0-or-later Go service the user installs and runs. This module only speaks its documented
+ * local HTTP API (client/docs/API.md, v1.13.6); it bundles and copies none of its code.
+ *
+ * Asynchronous work (search, download, tool runs) returns a task_id; the result arrives through
+ * POST /report, which also hands each finished or failed task out exactly once.
+ */
+export type BlendkitErrorCode = "BLENDKIT_INVALID_INPUT" | "BLENDKIT_UNSAFE_URL" | "BLENDKIT_CLIENT_UNAVAILABLE" | "BLENDKIT_INVALID_RESPONSE" | "BLENDKIT_TASK_FAILED" | "BLENDKIT_TIMEOUT" | "BLENDKIT_CANCELLED" | "BLENDKIT_PERMISSION_REQUIRED" | "BLENDKIT_NOT_FOUND" | "BLENDKIT_PAID_DENIED" | "BLENDKIT_AUTH_REQUIRED" | "BLENDKIT_LICENSE_DENIED" | "BLENDKIT_CONSENT_REQUIRED" | "BLENDKIT_UNSUPPORTED" | "BLENDKIT_CONVERSION_FAILED" | "BLENDKIT_OUTPUT_EXISTS" | "BLENDKIT_PUBLISH_FAILED" | "BLENDKIT_PARTIAL_OUTPUT" | "BLENDKIT_CLIENT_ERROR" | "BLENDKIT_STAGING_RETAINED";
+export declare class BlendkitError extends Error {
+    readonly code: BlendkitErrorCode;
+    constructor(code: BlendkitErrorCode, message: string);
+}
+export declare const DEFAULT_CLIENT_URL = "http://127.0.0.1:62485";
+/** The Client is a local service: only plain-HTTP loopback origins are accepted. */
+export declare function loopbackOrigin(raw: string): string;
+/**
+ * Task text comes from the Client and the provider: bounded, single-line, with any configured
+ * credential (plain text, not only inside a URL) and every URL, signed or not, removed.
+ */
+export declare function safeTaskText(value: unknown, secrets?: Iterable<string>): string;
+/**
+ * True only for an OBSERVED terminal task state (the Client's /report said the task failed or was
+ * cancelled). A transport error such as HTTP 500 or an unreachable Client proves nothing about
+ * whether a Go download or a Blender export is still writing.
+ */
+export declare function taskEnded(error: unknown): boolean;
+/** A task failed or was aborted and the Client did not confirm that it stopped writing. */
+export declare class UnconfirmedStopError extends Error {
+    readonly reason: unknown;
+    constructor(reason: unknown);
+}
+export type BlendkitTask = {
+    taskId: string;
+    taskType: string;
+    status: string;
+    progress: number;
+    message: string;
+    result: unknown;
+};
+export type TaskProgress = {
+    progress: number;
+    message: string;
+};
+export type BlendkitClientOptions = {
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    requestTimeoutMs?: number;
+    maxResponseBytes?: number;
+    pollIntervalMs?: number;
+    /** How long to wait for the Client to report a cancelled download as over. */
+    cancelConfirmMs?: number;
+    appId?: number;
+    addonVersion?: string;
+};
+export declare class BlendkitClient {
+    readonly origin: string;
+    private readonly fetcher;
+    private readonly requestTimeoutMs;
+    private readonly maxResponseBytes;
+    private readonly pollIntervalMs;
+    private readonly cancelConfirmMs;
+    readonly appId: number;
+    private readonly addonVersion;
+    /** Stable scene identity for this client session, forwarded by the Client as scene_uuid. */
+    private readonly sceneId;
+    /** Terminal tasks /report handed over before their waiter asked; each is delivered once. */
+    private readonly done;
+    private readonly latest;
+    /** Tasks someone is waiting for: their parked results are never evicted. */
+    private readonly active;
+    /** Start requests in flight: their task id is unknown, so nothing may be evicted meanwhile. */
+    private pendingStarts;
+    /** API keys seen in requests, redacted from any task text the Client echoes back. */
+    private readonly secrets;
+    private polling;
+    constructor(options?: BlendkitClientOptions);
+    private identity;
+    private request;
+    /** Local-only health: neither endpoint subscribes this process or contacts the provider. */
+    status(signal: AbortSignal): Promise<{
+        clientVersion: string;
+        tools: string[];
+    }>;
+    /**
+     * A start request for work that writes files (download, recipe) can fail after the Client
+     * accepted it: the connection may drop or the answer may be malformed, and then there is no task
+     * id to cancel or watch. That is not proof that nothing runs, so it never counts as "not started".
+     */
+    private startWriter;
+    private startTask;
+    /**
+     * One /report request at a time, shared by every waiter, so it runs on its own deadline rather
+     * than one caller's signal. Terminal tasks are parked until their waiter takes them.
+     */
+    private poll;
+    private waitTask;
+    /** Starts a provider search whose URL the caller built and validated; returns the raw result. */
+    search(urlquery: string, pageSize: number, apiKey: string, signal: AbortSignal): Promise<unknown>;
+    /** Downloads one asset into downloadDir; a failure that is not an observed task end cancels the Client task. */
+    download(assetData: {
+        id: string;
+        name: string;
+        assetType: string;
+        files: unknown[];
+    }, downloadDir: string, resolution: string, apiKey: string, signal: AbortSignal, onProgress?: (progress: TaskProgress) => void): Promise<string[]>;
+    /** True only when the cancelled task was observed in a terminal state within the deadline. */
+    private cancelDownload;
+    /** Runs one bundled recipe under the user's headless Blender. The Client cannot cancel a run. */
+    runTool(scriptId: string, blendPath: string, outputPath: string, params: Record<string, unknown>, blenderExePath: string, signal: AbortSignal): Promise<string>;
+}
+//# sourceMappingURL=client.d.ts.map

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

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

package/dist/blendkit/client.js

@@ -0,0 +1,346 @@
+import { randomUUID } from "node:crypto";
+import { setTimeout as delay } from "node:timers/promises";
+export class BlendkitError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "BlendkitError";
+    }
+}
+export const DEFAULT_CLIENT_URL = "http://127.0.0.1:62485";
+const LOOPBACK_HOSTS = new Set(["127.0.0.1", "localhost", "[::1]"]);
+/** The Client is a local service: only plain-HTTP loopback origins are accepted. */
+export function loopbackOrigin(raw) {
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        throw new BlendkitError("BLENDKIT_UNSAFE_URL", "The Blendkit-Client URL is not a valid URL.");
+    }
+    if (url.protocol !== "http:" ||
+        !LOOPBACK_HOSTS.has(url.hostname) ||
+        url.username ||
+        url.password ||
+        (url.pathname !== "/" && url.pathname !== "") ||
+        url.search ||
+        url.hash)
+        throw new BlendkitError("BLENDKIT_UNSAFE_URL", "The Blendkit-Client URL must be a loopback http origin such as http://127.0.0.1:62485.");
+    return url.origin;
+}
+/**
+ * Task text comes from the Client and the provider: bounded, single-line, with any configured
+ * credential (plain text, not only inside a URL) and every URL, signed or not, removed.
+ */
+export function safeTaskText(value, secrets = []) {
+    if (typeof value !== "string")
+        return "";
+    // URLs go first: a short secret such as ":" would otherwise split "https://" and leave a
+    // signed link's token behind. Then one pass over the secrets, longest first.
+    const withoutUrls = value.replace(/[a-z][a-z0-9+.-]*:\/\/\S+/giu, "<url>");
+    const known = [...secrets].filter(Boolean).sort((a, b) => b.length - a.length);
+    const text = known.length
+        ? withoutUrls.replace(new RegExp(known.map((secret) => secret.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&")).join("|"), "gu"), "<redacted>")
+        : withoutUrls;
+    return text
+        .replace(/[\p{Cc}\p{Cf}]+/gu, " ")
+        .trim()
+        .slice(0, 300);
+}
+/**
+ * True only for an OBSERVED terminal task state (the Client's /report said the task failed or was
+ * cancelled). A transport error such as HTTP 500 or an unreachable Client proves nothing about
+ * whether a Go download or a Blender export is still writing.
+ */
+export function taskEnded(error) {
+    return (error instanceof BlendkitError &&
+        (error.code === "BLENDKIT_TASK_FAILED" || error.code === "BLENDKIT_CANCELLED"));
+}
+/** A task failed or was aborted and the Client did not confirm that it stopped writing. */
+export class UnconfirmedStopError extends Error {
+    reason;
+    constructor(reason) {
+        super(reason instanceof Error ? reason.message : "The Client task was interrupted.");
+        this.reason = reason;
+        this.name = "UnconfirmedStopError";
+    }
+}
+const TERMINAL = new Set(["finished", "error", "cancelled"]);
+export class BlendkitClient {
+    origin;
+    fetcher;
+    requestTimeoutMs;
+    maxResponseBytes;
+    pollIntervalMs;
+    cancelConfirmMs;
+    appId;
+    addonVersion;
+    /** Stable scene identity for this client session, forwarded by the Client as scene_uuid. */
+    sceneId = randomUUID();
+    /** Terminal tasks /report handed over before their waiter asked; each is delivered once. */
+    done = new Map();
+    latest = new Map();
+    /** Tasks someone is waiting for: their parked results are never evicted. */
+    active = new Set();
+    /** Start requests in flight: their task id is unknown, so nothing may be evicted meanwhile. */
+    pendingStarts = 0;
+    /** API keys seen in requests, redacted from any task text the Client echoes back. */
+    secrets = new Set();
+    polling;
+    constructor(options = {}) {
+        this.origin = loopbackOrigin(options.baseUrl ?? DEFAULT_CLIENT_URL);
+        this.fetcher = options.fetch ?? fetch;
+        this.requestTimeoutMs = options.requestTimeoutMs ?? 10_000;
+        this.maxResponseBytes = options.maxResponseBytes ?? 8 * 1024 * 1024;
+        this.pollIntervalMs = options.pollIntervalMs ?? 500;
+        this.cancelConfirmMs = options.cancelConfirmMs ?? 5000;
+        this.appId = options.appId ?? process.pid;
+        this.addonVersion = options.addonVersion ?? "0.0.0";
+    }
+    identity() {
+        return {
+            app_id: this.appId,
+            addon_version: this.addonVersion,
+            platform_version: `${process.platform}-${process.arch}`,
+        };
+    }
+    async request(path, body, signal, expectJson = true) {
+        const requestSignal = AbortSignal.any([signal, AbortSignal.timeout(this.requestTimeoutMs)]);
+        let response;
+        try {
+            response = await this.fetcher(new URL(path, this.origin), {
+                method: body === undefined ? "GET" : "POST",
+                redirect: "error",
+                signal: requestSignal,
+                ...(body === undefined
+                    ? {}
+                    : { headers: { "content-type": "application/json" }, body: JSON.stringify(body) }),
+            });
+        }
+        catch {
+            signal.throwIfAborted();
+            throw new BlendkitError("BLENDKIT_CLIENT_UNAVAILABLE", `No Blendkit-Client answered at ${this.origin}. Start the official client (see blendkit_status).`);
+        }
+        const declared = Number(response.headers.get("content-length") ?? 0);
+        if (declared > this.maxResponseBytes) {
+            await response.body?.cancel();
+            throw new BlendkitError("BLENDKIT_INVALID_RESPONSE", "Blendkit-Client response is too large.");
+        }
+        const chunks = [];
+        let size = 0;
+        for await (const chunk of response.body ?? []) {
+            size += chunk.byteLength;
+            if (size > this.maxResponseBytes)
+                throw new BlendkitError("BLENDKIT_INVALID_RESPONSE", "Blendkit-Client response is too large.");
+            chunks.push(chunk);
+        }
+        if (!response.ok)
+            throw new BlendkitError(response.status === 404 ? "BLENDKIT_UNSUPPORTED" : "BLENDKIT_CLIENT_ERROR", `Blendkit-Client ${path} answered HTTP ${response.status}.`);
+        if (!expectJson)
+            return undefined;
+        try {
+            return JSON.parse(Buffer.concat(chunks).toString("utf8"));
+        }
+        catch {
+            throw new BlendkitError("BLENDKIT_INVALID_RESPONSE", `Blendkit-Client ${path} returned no JSON.`);
+        }
+    }
+    /** Local-only health: neither endpoint subscribes this process or contacts the provider. */
+    async status(signal) {
+        const addons = (await this.request("/addons/list", undefined, signal));
+        const listed = (await this.request("/tools/list", undefined, signal));
+        const clientVersion = String(addons?.clientVersion ?? "");
+        if (!/^\d+\.\d+\.\d+$/u.test(clientVersion) || !Array.isArray(listed?.tools))
+            throw new BlendkitError("BLENDKIT_INVALID_RESPONSE", "Unexpected Blendkit-Client status shape.");
+        const tools = listed.tools
+            .map((tool) => tool?.id)
+            .filter((id) => typeof id === "string" && /^[a-z0-9_]{1,64}$/u.test(id));
+        return { clientVersion, tools };
+    }
+    /**
+     * A start request for work that writes files (download, recipe) can fail after the Client
+     * accepted it: the connection may drop or the answer may be malformed, and then there is no task
+     * id to cancel or watch. That is not proof that nothing runs, so it never counts as "not started".
+     */
+    startWriter(path, body, signal) {
+        return this.startTask(path, body, signal).catch((error) => {
+            throw new UnconfirmedStopError(error);
+        });
+    }
+    async startTask(path, body, signal) {
+        this.pendingStarts += 1;
+        try {
+            const started = (await this.request(path, body, signal));
+            const taskId = started?.task_id;
+            if (typeof taskId !== "string" || !/^[a-f0-9-]{36}$/u.test(taskId))
+                throw new BlendkitError("BLENDKIT_INVALID_RESPONSE", "Blendkit-Client returned no task id.");
+            this.active.add(taskId);
+            return taskId;
+        }
+        finally {
+            this.pendingStarts -= 1;
+        }
+    }
+    /**
+     * One /report request at a time, shared by every waiter, so it runs on its own deadline rather
+     * than one caller's signal. Terminal tasks are parked until their waiter takes them.
+     */
+    poll() {
+        this.polling ??= (async () => {
+            try {
+                const tasks = await this.request("/report", {
+                    ...this.identity(),
+                    api_key: "",
+                    software: "ThreeNative Asset MCP",
+                    software_version: this.addonVersion,
+                }, AbortSignal.timeout(this.requestTimeoutMs));
+                if (!Array.isArray(tasks))
+                    throw new BlendkitError("BLENDKIT_INVALID_RESPONSE", "Blendkit-Client /report is not a list.");
+                for (const raw of tasks) {
+                    // Only these fields are read: a task's `data` echoes its request, API key included.
+                    const item = raw;
+                    if (typeof item?.task_id !== "string" || typeof item.status !== "string")
+                        continue;
+                    const task = {
+                        taskId: item.task_id,
+                        taskType: safeTaskText(item.task_type, this.secrets).slice(0, 64),
+                        status: item.status,
+                        progress: Math.max(0, Math.min(100, Number(item.progress) || 0)),
+                        message: safeTaskText(item.message, this.secrets),
+                        result: item.result,
+                    };
+                    this.latest.set(task.taskId, { progress: task.progress, message: task.message });
+                    if (TERMINAL.has(task.status))
+                        this.done.set(task.taskId, task);
+                }
+                // ponytail: parked results of abandoned waiters are dropped oldest-first past 256.
+                for (const map of this.pendingStarts ? [] : [this.done, this.latest])
+                    for (const id of map.keys()) {
+                        if (map.size <= 256)
+                            break;
+                        if (!this.active.has(id))
+                            map.delete(id);
+                    }
+            }
+            finally {
+                this.polling = undefined;
+            }
+        })();
+        return this.polling;
+    }
+    async waitTask(taskId, signal, onProgress) {
+        try {
+            for (;;) {
+                // Before the parked result: a caller that has aborted never accepts a completion.
+                signal.throwIfAborted();
+                const finished = this.done.get(taskId);
+                if (finished) {
+                    this.done.delete(taskId);
+                    if (finished.status === "finished")
+                        return finished;
+                    throw new BlendkitError(finished.status === "cancelled" ? "BLENDKIT_CANCELLED" : "BLENDKIT_TASK_FAILED", `Blendkit-Client ${finished.taskType || "task"} ${finished.status}: ${finished.message || "no reason given"}`);
+                }
+                await this.poll();
+                const latest = this.latest.get(taskId);
+                if (latest && onProgress)
+                    onProgress(latest);
+                // timers/promises rejects with a generic AbortError; surface the caller's own reason.
+                if (!this.done.has(taskId))
+                    await delay(this.pollIntervalMs, undefined, { signal }).catch(() => signal.throwIfAborted());
+            }
+        }
+        finally {
+            // A parked completion stays (bounded by eviction): an aborted caller still needs to learn,
+            // through cancelDownload, whether the task really ended.
+            this.active.delete(taskId);
+            this.latest.delete(taskId);
+        }
+    }
+    /** Starts a provider search whose URL the caller built and validated; returns the raw result. */
+    async search(urlquery, pageSize, apiKey, signal) {
+        if (apiKey)
+            this.secrets.add(apiKey);
+        const taskId = await this.startTask("/assets/search", {
+            ...this.identity(),
+            api_key: apiKey,
+            PREFS: { api_key: apiKey },
+            urlquery,
+            page_size: pageSize,
+            asset_type: "",
+            tempdir: "",
+            get_next: false,
+        }, signal);
+        return (await this.waitTask(taskId, signal)).result;
+    }
+    /** Downloads one asset into downloadDir; a failure that is not an observed task end cancels the Client task. */
+    async download(assetData, downloadDir, resolution, apiKey, signal, onProgress) {
+        signal.throwIfAborted();
+        if (apiKey)
+            this.secrets.add(apiKey);
+        // The start request runs to completion so an abort always knows which task to cancel.
+        const taskId = await this.startWriter("/assets/download", {
+            ...this.identity(),
+            download_dirs: [downloadDir],
+            resolution,
+            asset_data: { ...assetData, available_resolutions: [] },
+            PREFS: {
+                api_key: apiKey,
+                scene_id: this.sceneId,
+                app_id: this.appId,
+                unpack_files: false,
+                create_asset_library: false,
+                resolution,
+            },
+        }, AbortSignal.timeout(this.requestTimeoutMs));
+        let task;
+        try {
+            task = await this.waitTask(taskId, signal, onProgress);
+        }
+        catch (error) {
+            if (taskEnded(error))
+                throw error;
+            // Anything else (abort, timeout, /report failing): ask the official Client to stop the
+            // download, then only trust that it did once /report says the task is over.
+            throw (await this.cancelDownload(taskId)) ? error : new UnconfirmedStopError(error);
+        }
+        const paths = task.result?.file_paths;
+        if (!Array.isArray(paths) || !paths.every((path) => typeof path === "string"))
+            throw new BlendkitError("BLENDKIT_INVALID_RESPONSE", "Download task returned no file paths.");
+        return paths;
+    }
+    /** True only when the cancelled task was observed in a terminal state within the deadline. */
+    async cancelDownload(taskId) {
+        try {
+            await this.request("/assets/cancel_download", { task_id: taskId, app_id: this.appId }, AbortSignal.timeout(this.requestTimeoutMs), false);
+            this.active.add(taskId);
+            await this.waitTask(taskId, AbortSignal.timeout(this.cancelConfirmMs));
+            return true;
+        }
+        catch (error) {
+            return taskEnded(error);
+        }
+    }
+    /** Runs one bundled recipe under the user's headless Blender. The Client cannot cancel a run. */
+    async runTool(scriptId, blendPath, outputPath, params, blenderExePath, signal) {
+        signal.throwIfAborted();
+        const taskId = await this.startWriter("/tools/run", {
+            ...this.identity(),
+            script_id: scriptId,
+            blender_exe_path: blenderExePath,
+            blend_path: blendPath,
+            output_path: outputPath,
+            params: { ...params, output_path: outputPath },
+            software: "ThreeNative Asset MCP",
+        }, signal);
+        // The Client cannot cancel a recipe: anything but an observed end leaves Blender possibly writing.
+        const task = await this.waitTask(taskId, signal).catch((error) => {
+            throw taskEnded(error) ? error : new UnconfirmedStopError(error);
+        });
+        const path = task.result?.file_path;
+        if (path !== outputPath)
+            throw new BlendkitError("BLENDKIT_INVALID_RESPONSE", "Tool run reported an unexpected output.");
+        return path;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/blendkit/client.js.map

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