@nodetool-ai/runtime 0.7.0-rc.11

package/dist/providers/meshy-provider.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Meshy AI Provider — wraps the Meshy AI 3D generation API to expose
+ * `textTo3D` and `imageTo3D` through the standard {@link BaseProvider}
+ * interface.
+ *
+ * Meshy AI offers two 3D generation modes:
+ * - **Text-to-3D** — generate a 3D mesh from a text prompt.
+ * - **Image-to-3D** — generate a 3D mesh from a single reference image.
+ *
+ * API docs: https://docs.meshy.ai/
+ *
+ * Ported from the historical Python implementation at
+ * `nodetool-core@25e60910:src/nodetool/providers/meshy_provider.py`.
+ */
+import { BaseProvider } from "./base-provider.js";
+import type { ImageTo3DParams, Message, Model3D, ProviderStreamItem, TextTo3DParams } from "./types.js";
+/**
+ * The 3D generation models exposed by Meshy. Mirrors `MESHY_3D_MODELS` in
+ * the original Python provider; bump this list when Meshy ships new models.
+ */
+export declare const MESHY_3D_MODELS: Model3D[];
+/**
+ * Optional knobs for tests and advanced users. Production callers should leave
+ * these at their defaults.
+ */
+export interface MeshyProviderOptions {
+    /** Override the polling interval (ms). Defaults to 5000. */
+    pollIntervalMs?: number;
+    /** Override the max poll attempts. Defaults to 120 (= 10 minutes @ 5s). */
+    maxPollAttempts?: number;
+}
+export declare class MeshyProvider extends BaseProvider {
+    private readonly apiKey;
+    private readonly pollIntervalMs;
+    private readonly maxPollAttempts;
+    constructor(secrets?: Record<string, unknown>, options?: MeshyProviderOptions);
+    static requiredSecrets(): string[];
+    generateMessage(_args: Parameters<BaseProvider["generateMessage"]>[0]): Promise<Message>;
+    generateMessages(_args: Parameters<BaseProvider["generateMessages"]>[0]): AsyncGenerator<ProviderStreamItem>;
+    getAvailable3DModels(): Promise<Model3D[]>;
+    textTo3D(params: TextTo3DParams): Promise<Uint8Array>;
+    imageTo3D(image: Uint8Array, params: ImageTo3DParams): Promise<Uint8Array>;
+    private headers;
+    private computeMaxAttempts;
+    private encodeImageAsDataUri;
+    private submitTextTo3D;
+    private submitImageTo3D;
+    private submitRefine;
+    private submitTask;
+    private pollTaskStatus;
+    private downloadResultMesh;
+}
+//# sourceMappingURL=meshy-provider.d.ts.map

package/dist/providers/meshy-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meshy-provider.d.ts","sourceRoot":"","sources":["../../src/providers/meshy-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EACV,eAAe,EACf,OAAO,EACP,OAAO,EACP,kBAAkB,EAClB,cAAc,EACf,MAAM,YAAY,CAAC;AAiBpB;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,OAAO,EA6BpC,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAgBD,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAGvC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,OAAO,GAAE,oBAAyB;WAWpB,eAAe,IAAI,MAAM,EAAE;IAIrC,eAAe,CACnB,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GACpD,OAAO,CAAC,OAAO,CAAC;IAIZ,gBAAgB,CACrB,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,GACrD,cAAc,CAAC,kBAAkB,CAAC;IAItB,oBAAoB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAQ1C,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IA4BrD,SAAS,CACtB,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,UAAU,CAAC;IAoBtB,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,oBAAoB;YAKd,cAAc;YAYd,eAAe;YAIf,YAAY;YAOZ,UAAU;YAwBV,cAAc;YAkCd,kBAAkB;CAyBjC"}

package/dist/providers/meshy-provider.js

@@ -0,0 +1,230 @@
+/**
+ * Meshy AI Provider — wraps the Meshy AI 3D generation API to expose
+ * `textTo3D` and `imageTo3D` through the standard {@link BaseProvider}
+ * interface.
+ *
+ * Meshy AI offers two 3D generation modes:
+ * - **Text-to-3D** — generate a 3D mesh from a text prompt.
+ * - **Image-to-3D** — generate a 3D mesh from a single reference image.
+ *
+ * API docs: https://docs.meshy.ai/
+ *
+ * Ported from the historical Python implementation at
+ * `nodetool-core@25e60910:src/nodetool/providers/meshy_provider.py`.
+ */
+import { BaseProvider } from "./base-provider.js";
+import { createLogger } from "@nodetool-ai/config";
+const log = createLogger("nodetool.runtime.providers.meshy");
+const MESHY_API_BASE_URL = "https://api.meshy.ai";
+/**
+ * Default polling cadence. Tasks typically take 30s–5min; 5s polling keeps
+ * latency low without overwhelming the API. Tests can shorten this via
+ * {@link MeshyProviderOptions}.
+ */
+const DEFAULT_POLL_INTERVAL_MS = 5000;
+/** Default cap of 10 minutes (`120 * 5s`). */
+const DEFAULT_MAX_POLL_ATTEMPTS = 120;
+const DEFAULT_OUTPUT_FORMAT = "glb";
+/**
+ * The 3D generation models exposed by Meshy. Mirrors `MESHY_3D_MODELS` in
+ * the original Python provider; bump this list when Meshy ships new models.
+ */
+export const MESHY_3D_MODELS = [
+    {
+        id: "meshy-4",
+        name: "Meshy-4 Text-to-3D",
+        provider: "meshy",
+        supportedTasks: ["text_to_3d"],
+        outputFormats: ["glb", "fbx", "obj", "usdz"]
+    },
+    {
+        id: "meshy-3-turbo",
+        name: "Meshy-3 Turbo Text-to-3D",
+        provider: "meshy",
+        supportedTasks: ["text_to_3d"],
+        outputFormats: ["glb", "fbx", "obj", "usdz"]
+    },
+    {
+        id: "meshy-4-image",
+        name: "Meshy-4 Image-to-3D",
+        provider: "meshy",
+        supportedTasks: ["image_to_3d"],
+        outputFormats: ["glb", "fbx", "obj", "usdz"]
+    },
+    {
+        id: "meshy-3-turbo-image",
+        name: "Meshy-3 Turbo Image-to-3D",
+        provider: "meshy",
+        supportedTasks: ["image_to_3d"],
+        outputFormats: ["glb", "fbx", "obj", "usdz"]
+    }
+];
+/** Detect PNG by magic header; everything else is treated as JPEG. */
+function detectImageMime(image) {
+    const PNG_MAGIC = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
+    if (image.length < PNG_MAGIC.length)
+        return "image/jpeg";
+    for (let i = 0; i < PNG_MAGIC.length; i++) {
+        if (image[i] !== PNG_MAGIC[i])
+            return "image/jpeg";
+    }
+    return "image/png";
+}
+function bytesToBase64(bytes) {
+    return Buffer.from(bytes).toString("base64");
+}
+export class MeshyProvider extends BaseProvider {
+    apiKey;
+    pollIntervalMs;
+    maxPollAttempts;
+    constructor(secrets = {}, options = {}) {
+        super("meshy");
+        this.apiKey = secrets["MESHY_API_KEY"] ?? "";
+        this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+        this.maxPollAttempts = options.maxPollAttempts ?? DEFAULT_MAX_POLL_ATTEMPTS;
+        if (!this.apiKey) {
+            log.warn("Meshy API key not configured");
+        }
+    }
+    static requiredSecrets() {
+        return ["MESHY_API_KEY"];
+    }
+    async generateMessage(_args) {
+        throw new Error("meshy does not support chat generation");
+    }
+    async *generateMessages(_args) {
+        throw new Error("meshy does not support chat generation");
+    }
+    async getAvailable3DModels() {
+        if (!this.apiKey) {
+            log.debug("No Meshy API key configured, returning empty 3D model list");
+            return [];
+        }
+        return MESHY_3D_MODELS;
+    }
+    async textTo3D(params) {
+        if (!params.prompt)
+            throw new Error("prompt must not be empty");
+        if (!this.apiKey)
+            throw new Error("Meshy API key is not configured");
+        const maxAttempts = this.computeMaxAttempts(params.timeoutSeconds);
+        const previewTaskId = await this.submitTextTo3D(params);
+        log.debug(`Meshy text-to-3D preview task submitted: ${previewTaskId}`);
+        const previewResult = await this.pollTaskStatus(previewTaskId, "/v2/text-to-3d", maxAttempts);
+        if (params.enableTextures) {
+            const refineTaskId = await this.submitRefine(previewTaskId);
+            log.debug(`Meshy text-to-3D refine task submitted: ${refineTaskId}`);
+            const refineResult = await this.pollTaskStatus(refineTaskId, "/v2/text-to-3d", maxAttempts);
+            return this.downloadResultMesh(refineResult, params.outputFormat);
+        }
+        return this.downloadResultMesh(previewResult, params.outputFormat);
+    }
+    async imageTo3D(image, params) {
+        if (!image || image.length === 0)
+            throw new Error("image must not be empty");
+        if (!this.apiKey)
+            throw new Error("Meshy API key is not configured");
+        const maxAttempts = this.computeMaxAttempts(params.timeoutSeconds);
+        const imageUrl = this.encodeImageAsDataUri(image);
+        const taskId = await this.submitImageTo3D(imageUrl);
+        log.debug(`Meshy image-to-3D task submitted: ${taskId}`);
+        const result = await this.pollTaskStatus(taskId, "/v1/image-to-3d", maxAttempts);
+        return this.downloadResultMesh(result, params.outputFormat);
+    }
+    // --- internals ---
+    headers() {
+        return {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json"
+        };
+    }
+    computeMaxAttempts(timeoutSeconds) {
+        if (!timeoutSeconds || timeoutSeconds <= 0) {
+            return this.maxPollAttempts;
+        }
+        return Math.max(1, Math.floor((timeoutSeconds * 1000) / this.pollIntervalMs));
+    }
+    encodeImageAsDataUri(image) {
+        const mime = detectImageMime(image);
+        return `data:${mime};base64,${bytesToBase64(image)}`;
+    }
+    async submitTextTo3D(params) {
+        const payload = {
+            mode: "preview",
+            prompt: params.prompt
+        };
+        if (params.artStyle)
+            payload.art_style = params.artStyle;
+        if (params.negativePrompt)
+            payload.negative_prompt = params.negativePrompt;
+        if (params.seed != null && params.seed >= 0)
+            payload.seed = params.seed;
+        return this.submitTask("/v2/text-to-3d", payload);
+    }
+    async submitImageTo3D(imageUrl) {
+        return this.submitTask("/v1/image-to-3d", { image_url: imageUrl });
+    }
+    async submitRefine(previewTaskId) {
+        return this.submitTask("/v2/text-to-3d", {
+            mode: "refine",
+            preview_task_id: previewTaskId
+        });
+    }
+    async submitTask(endpoint, payload) {
+        const url = `${MESHY_API_BASE_URL}${endpoint}`;
+        const res = await fetch(url, {
+            method: "POST",
+            headers: this.headers(),
+            body: JSON.stringify(payload)
+        });
+        if (res.status !== 200 && res.status !== 202) {
+            const errText = await res.text();
+            throw new Error(`Meshy API error (${res.status}): ${errText}`);
+        }
+        const data = (await res.json());
+        const taskId = data.result;
+        if (typeof taskId !== "string" || !taskId) {
+            throw new Error(`Meshy submit returned no task id: ${JSON.stringify(data)}`);
+        }
+        return taskId;
+    }
+    async pollTaskStatus(taskId, endpoint, maxAttempts) {
+        const url = `${MESHY_API_BASE_URL}${endpoint}/${taskId}`;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            const res = await fetch(url, { headers: this.headers() });
+            if (res.status !== 200) {
+                const errText = await res.text();
+                throw new Error(`Meshy API poll error (${res.status}): ${errText}`);
+            }
+            const data = (await res.json());
+            const status = String(data.status ?? "").toUpperCase();
+            if (status === "SUCCEEDED")
+                return data;
+            if (status === "FAILED" || status === "EXPIRED") {
+                const taskError = data.task_error;
+                const message = taskError?.message ?? "Unknown error";
+                throw new Error(`Meshy task failed: ${message}`);
+            }
+            log.debug(`Meshy task ${taskId} status: ${status} (attempt ${attempt + 1}/${maxAttempts})`);
+            await new Promise((r) => setTimeout(r, this.pollIntervalMs));
+        }
+        throw new Error(`Meshy task ${taskId} timed out after ${(maxAttempts * this.pollIntervalMs) / 1000}s`);
+    }
+    async downloadResultMesh(result, requestedFormat) {
+        const format = (requestedFormat ?? DEFAULT_OUTPUT_FORMAT).toLowerCase();
+        const modelUrls = result.model_urls;
+        const modelUrl = modelUrls?.[format] ?? modelUrls?.[DEFAULT_OUTPUT_FORMAT];
+        if (!modelUrl) {
+            throw new Error(`No model URL found in Meshy response for format: ${format}`);
+        }
+        const dlRes = await fetch(modelUrl);
+        if (!dlRes.ok) {
+            const errText = await dlRes.text().catch(() => "");
+            throw new Error(`Failed to download Meshy result (${dlRes.status}): ${errText}`);
+        }
+        const bytes = new Uint8Array(await dlRes.arrayBuffer());
+        log.debug(`Downloaded ${bytes.length} bytes of 3D model data from Meshy`);
+        return bytes;
+    }
+}
+//# sourceMappingURL=meshy-provider.js.map

package/dist/providers/meshy-provider.js.map

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

package/dist/providers/minimax-provider.d.ts

@@ -0,0 +1,66 @@
+/**
+ * MiniMax provider — exposes MiniMax's full multimodal stack through the
+ * standard BaseProvider interface.
+ *
+ * Chat inherits the OpenAI-compatible path (MiniMax-M2.x models), while image,
+ * video, and speech generation go through MiniMax's own REST endpoints. Video
+ * uses the async task + File API download pattern.
+ *
+ * Docs: https://platform.minimax.io/docs/api-reference/api-overview
+ */
+import OpenAI from "openai";
+import { OpenAIProvider } from "./openai-provider.js";
+import type { ASRModel, EmbeddingModel, EncodedAudioResult, ImageModel, ImageToImageParams, ImageToVideoParams, LanguageModel, StreamingAudioChunk, TextToImageParams, TextToVideoParams, TTSModel, VideoModel } from "./types.js";
+interface MinimaxProviderOptions {
+    client?: OpenAI;
+    clientFactory?: (apiKey: string) => OpenAI;
+    fetchFn?: typeof fetch;
+}
+export declare class MinimaxProvider extends OpenAIProvider {
+    static requiredSecrets(): string[];
+    private readonly _minimaxFetch;
+    constructor(secrets: {
+        MINIMAX_API_KEY?: string;
+    }, options?: MinimaxProviderOptions);
+    getContainerEnv(): Record<string, string>;
+    hasToolSupport(_model: string): Promise<boolean>;
+    private headers;
+    getAvailableLanguageModels(): Promise<LanguageModel[]>;
+    getAvailableImageModels(): Promise<ImageModel[]>;
+    getAvailableVideoModels(): Promise<VideoModel[]>;
+    getAvailableTTSModels(): Promise<TTSModel[]>;
+    /** MiniMax does not expose a public ASR endpoint we support here. */
+    getAvailableASRModels(): Promise<ASRModel[]>;
+    /** Embeddings require a MiniMax GroupId we don't manage; leave disabled. */
+    getAvailableEmbeddingModels(): Promise<EmbeddingModel[]>;
+    automaticSpeechRecognition(_args: Parameters<OpenAIProvider["automaticSpeechRecognition"]>[0]): Promise<import("./types.js").ASRResult>;
+    generateEmbedding(_args: Parameters<OpenAIProvider["generateEmbedding"]>[0]): Promise<number[][]>;
+    textToImage(params: TextToImageParams): Promise<Uint8Array>;
+    textToImages(params: TextToImageParams, numImages: number): Promise<Uint8Array[]>;
+    imageToImage(image: Uint8Array, params: ImageToImageParams): Promise<Uint8Array>;
+    imageToImages(image: Uint8Array, params: ImageToImageParams, numImages: number): Promise<Uint8Array[]>;
+    private _imageToImageAsTextParams;
+    private _generateImages;
+    textToVideo(params: TextToVideoParams): Promise<Uint8Array>;
+    imageToVideo(image: Uint8Array, params: ImageToVideoParams): Promise<Uint8Array>;
+    private _generateVideo;
+    private _pollVideoTask;
+    private _downloadFile;
+    textToSpeechEncoded(args: {
+        text: string;
+        model: string;
+        voice?: string;
+        speed?: number;
+        audioFormat?: string;
+    }): Promise<EncodedAudioResult | null>;
+    textToSpeech(args: {
+        text: string;
+        model: string;
+        voice?: string;
+        speed?: number;
+        audioFormat?: string;
+    }): AsyncGenerator<StreamingAudioChunk>;
+    private _synthesize;
+}
+export {};
+//# sourceMappingURL=minimax-provider.d.ts.map

package/dist/providers/minimax-provider.d.ts.map

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