@nodetool-ai/runtime 0.7.0-rc.23 → 0.8.2

package/dist/providers/responses-api.js

@@ -0,0 +1,297 @@
+import { isRecord, isString } from "@nodetool-ai/protocol";
+export { isRecord };
+export function stringifyContent(value) {
+    if (isString(value))
+        return value;
+    if (value == null)
+        return "";
+    return JSON.stringify(value);
+}
+export function dataUri(mimeType, data) {
+    if (isString(data) && data.startsWith("data:"))
+        return data;
+    const base64 = isString(data) ? data : Buffer.from(data).toString("base64");
+    return `data:${mimeType};base64,${base64}`;
+}
+export async function responseInputContent(content, resolveUri) {
+    if (content.type === "text") {
+        return { type: "input_text", text: content.text };
+    }
+    if (content.type === "image_url") {
+        const image = content.image;
+        if (image.uri) {
+            const resolved = await resolveUri(image.uri);
+            return { type: "input_image", image_url: resolved };
+        }
+        if (image.data) {
+            return {
+                type: "input_image",
+                image_url: dataUri(image.mimeType ?? "image/jpeg", image.data)
+            };
+        }
+    }
+    return null;
+}
+export async function messagesToResponsesInput(messages, resolveUri) {
+    const input = [];
+    // Images generated on a prior assistant turn, awaiting re-presentation. The
+    // Responses input schema doesn't accept images in assistant output, so each
+    // one is re-presented as a user input_image — but only AFTER the turn's tool
+    // block: a function_call and its function_call_output must stay adjacent,
+    // so the flush waits for the first non-tool message (or end of history).
+    // Preserves multi-turn edit context on a fresh replay (no
+    // previous_response_id to resume from / expired session).
+    let pendingImages = [];
+    for (const message of messages) {
+        if (message.role !== "tool" && pendingImages.length > 0) {
+            input.push(...pendingImages);
+            pendingImages = [];
+        }
+        if (message.role === "tool") {
+            input.push({
+                type: "function_call_output",
+                call_id: message.toolCallId ?? "",
+                output: stringifyContent(message.content)
+            });
+            continue;
+        }
+        if (message.role === "assistant") {
+            const outputParts = [];
+            if (isString(message.content)) {
+                if (message.content) {
+                    outputParts.push({ type: "output_text", text: message.content });
+                }
+            }
+            else if (Array.isArray(message.content)) {
+                const textParts = [];
+                for (const part of message.content) {
+                    if (part.type === "text") {
+                        textParts.push(part.text);
+                    }
+                    else if (part.type === "image_url") {
+                        const converted = await responseInputContent(part, resolveUri);
+                        if (converted) {
+                            pendingImages.push({
+                                type: "message",
+                                role: "user",
+                                content: [converted]
+                            });
+                        }
+                    }
+                }
+                const text = textParts.join("");
+                if (text)
+                    outputParts.push({ type: "output_text", text });
+            }
+            if (outputParts.length > 0) {
+                input.push({
+                    type: "message",
+                    role: "assistant",
+                    content: outputParts
+                });
+            }
+            for (const toolCall of message.toolCalls ?? []) {
+                // Only `call_id` (the `call_...`-prefixed id) is echoed back. The item
+                // `id` is deliberately omitted: we track the call_id, not the `fc_...`
+                // item id, and supplying the call_id in the `id` field makes the
+                // Responses API reject it ("Expected an ID that begins with 'fc'").
+                input.push({
+                    type: "function_call",
+                    call_id: toolCall.id,
+                    name: toolCall.name,
+                    arguments: JSON.stringify(toolCall.args ?? {})
+                });
+            }
+            continue;
+        }
+        const content = [];
+        if (isString(message.content)) {
+            content.push({ type: "input_text", text: message.content });
+        }
+        else if (Array.isArray(message.content)) {
+            for (const part of message.content) {
+                const converted = await responseInputContent(part, resolveUri);
+                if (converted)
+                    content.push(converted);
+            }
+        }
+        if (content.length === 0)
+            continue;
+        input.push({ role: message.role, content });
+    }
+    input.push(...pendingImages);
+    return input;
+}
+export function responseTools(tools = []) {
+    return tools.map((tool) => ({
+        type: "function",
+        name: tool.name,
+        description: tool.description ?? "",
+        parameters: tool.inputSchema ?? { type: "object", properties: {} }
+    }));
+}
+export function responseToolChoice(toolChoice) {
+    if (!toolChoice)
+        return undefined;
+    // "any" is the cross-provider sentinel for "the model MUST call a tool". The
+    // Responses API forcing value is "required"; "auto" (the previous mapping) is
+    // the default and leaves tool use optional, silently defeating forced calls.
+    if (toolChoice === "any")
+        return "required";
+    return { type: "function", name: toolChoice };
+}
+export function extractResponsesText(output) {
+    if (!Array.isArray(output))
+        return "";
+    const parts = [];
+    for (const item of output) {
+        if (!isRecord(item) || item.type !== "message" || !Array.isArray(item.content)) {
+            continue;
+        }
+        for (const content of item.content) {
+            if (isRecord(content) && content.type === "output_text") {
+                parts.push(String(content.text ?? ""));
+            }
+        }
+    }
+    return parts.join("");
+}
+export function extractResponsesToolCalls(output, buildToolCall) {
+    if (!Array.isArray(output))
+        return [];
+    const toolCalls = [];
+    for (const item of output) {
+        if (!isRecord(item) || item.type !== "function_call")
+            continue;
+        toolCalls.push(buildToolCall(String(item.call_id ?? item.id ?? ""), String(item.name ?? ""), item.arguments));
+    }
+    return toolCalls;
+}
+export function extractResponsesImages(output) {
+    if (!Array.isArray(output))
+        return [];
+    const images = [];
+    for (const item of output) {
+        if (!isRecord(item) ||
+            item.type !== "image_generation_call" ||
+            !isString(item.result)) {
+            continue;
+        }
+        const format = isString(item.output_format) ? item.output_format : "png";
+        images.push({
+            type: "image_url",
+            image: { data: item.result, mimeType: `image/${format}` }
+        });
+    }
+    return images;
+}
+export function responseUsage(response) {
+    const usage = response.usage;
+    if (!isRecord(usage)) {
+        return { inputTokens: 0, outputTokens: 0, cachedTokens: 0 };
+    }
+    const inputTokens = Number(usage.input_tokens ?? 0);
+    const outputTokens = Number(usage.output_tokens ?? 0);
+    const details = usage.input_tokens_details;
+    const cachedTokens = isRecord(details)
+        ? Number(details.cached_tokens ?? 0)
+        : 0;
+    return {
+        inputTokens: Number.isFinite(inputTokens) ? inputTokens : 0,
+        outputTokens: Number.isFinite(outputTokens) ? outputTokens : 0,
+        cachedTokens: Number.isFinite(cachedTokens) ? cachedTokens : 0
+    };
+}
+export async function* streamResponsesEvents(stream, options) {
+    const pending = new Map();
+    for await (const event of stream) {
+        const type = event.type;
+        if (type === "response.created" || type === "response.completed") {
+            const response = event.response;
+            if (isRecord(response) && isString(response.id)) {
+                options.onResponseId?.(response.id);
+            }
+        }
+        if (type === "response.output_text.delta") {
+            const chunk = {
+                type: "chunk",
+                content: String(event.delta ?? ""),
+                done: false
+            };
+            yield chunk;
+            continue;
+        }
+        if (type === "response.output_item.added") {
+            const item = event.item;
+            if (isRecord(item) && item.type === "function_call") {
+                const itemId = String(item.id ?? event.item_id ?? "");
+                pending.set(itemId, {
+                    callId: String(item.call_id ?? itemId),
+                    name: String(item.name ?? ""),
+                    args: ""
+                });
+            }
+            continue;
+        }
+        if (type === "response.function_call_arguments.delta") {
+            const itemId = String(event.item_id ?? "");
+            const current = pending.get(itemId) ?? {
+                callId: itemId,
+                name: "",
+                args: ""
+            };
+            current.args += String(event.delta ?? "");
+            pending.set(itemId, current);
+            continue;
+        }
+        if (type === "response.function_call_arguments.done") {
+            const itemId = String(event.item_id ?? "");
+            const current = pending.get(itemId);
+            const argsText = String(event.arguments ?? current?.args ?? "{}");
+            pending.delete(itemId);
+            yield options.buildToolCall(current?.callId ?? itemId, String(event.name ?? current?.name ?? ""), argsText);
+            continue;
+        }
+        if (type === "response.output_item.done") {
+            // The `image_generation` tool is a server-side tool: the image arrives as
+            // a completed output item, with no function_call_output round trip, so it
+            // must never enter the pending tool-call set. Surface it as an image chunk.
+            const item = event.item;
+            if (isRecord(item) &&
+                item.type === "image_generation_call" &&
+                isString(item.result)) {
+                const format = isString(item.output_format) ? item.output_format : "png";
+                const chunk = {
+                    type: "chunk",
+                    content: item.result,
+                    content_type: "image",
+                    content_metadata: {
+                        mimeType: `image/${format}`,
+                        itemId: isString(item.id) ? item.id : undefined,
+                        revisedPrompt: isString(item.revised_prompt)
+                            ? item.revised_prompt
+                            : undefined
+                    },
+                    done: false
+                };
+                yield chunk;
+            }
+            continue;
+        }
+        if (type === "response.completed") {
+            const response = event.response;
+            if (isRecord(response)) {
+                options.onUsage(options.model, responseUsage(response));
+            }
+            const chunk = { type: "chunk", content: "", done: true };
+            yield chunk;
+            continue;
+        }
+        if (type === "response.failed" ||
+            type === "response.error" ||
+            type === "error") {
+            throw new Error(`Responses stream failed: ${JSON.stringify(event)}`);
+        }
+    }
+}
+//# sourceMappingURL=responses-api.js.map

package/dist/providers/responses-api.js.map

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

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

@@ -0,0 +1,46 @@
+/**
+ * Reve Provider — exposes Reve's image API (create / edit) through the standard
+ * {@link BaseProvider} interface so Reve models work from NodeTool's generic
+ * image-generation nodes (model picker), and surfaces the `REVE_API_KEY` secret
+ * in Settings → API Keys.
+ *
+ *   - textToImage  → POST /v1/image/create
+ *   - imageToImage → POST /v1/image/edit   (one source image)
+ *                  → POST /v1/image/remix  (two or more reference images)
+ *
+ * imageToImage routes by image count: a single source image uses the Edit
+ * endpoint (`edit_instruction` + one base64 `reference_image`); two or more use
+ * the Remix endpoint (`prompt` + a base64 `reference_images` array, capped at
+ * 6 — the only Reve endpoint that accepts more than one reference image).
+ * Remix's indexed `<img>` prompt tags remain the domain of the
+ * `@nodetool-ai/reve-nodes` `reve.RemixImage` node.
+ *
+ * These are Reve's v1 endpoints. Reve's v2 API
+ * (https://api.reve.com/console/docs/v2/) reportedly lifts the reference-image
+ * ceiling to 8 on a unified create/edit endpoint; migrating there is future
+ * work and is not wired here.
+ *
+ * Wire spec (https://api.reve.com/console/docs):
+ *  - Auth:    `Authorization: Bearer <api_key>`.
+ *  - Body:    JSON; reference images are base64-encoded strings.
+ *  - Accept:  `application/json` → response carries a base64 PNG in `image`.
+ */
+import { BaseProvider, type ProviderCapability } from "./base-provider.js";
+import type { ImageModel, ImageToImageParams, Message, ProviderStreamItem, TextToImageParams } from "./types.js";
+export declare class ReveProvider extends BaseProvider {
+    private readonly apiKey;
+    protected declaredCapabilities(): readonly ProviderCapability[];
+    static requiredSecrets(): string[];
+    constructor(secrets?: Record<string, unknown>);
+    getContainerEnv(): {
+        REVE_API_KEY: string;
+    };
+    private requireApiKey;
+    generateMessage(_args: Parameters<BaseProvider["generateMessage"]>[0]): Promise<Message>;
+    generateMessages(_args: Parameters<BaseProvider["generateMessages"]>[0]): AsyncGenerator<ProviderStreamItem>;
+    getAvailableImageModels(): Promise<ImageModel[]>;
+    private post;
+    textToImage(params: TextToImageParams): Promise<Uint8Array>;
+    imageToImage(images: Uint8Array[], params: ImageToImageParams): Promise<Uint8Array>;
+}
+//# sourceMappingURL=reve-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reve-provider.d.ts","sourceRoot":"","sources":["../../src/providers/reve-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,OAAO,EACP,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAgCpB,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,UAAmB,oBAAoB,IAAI,SAAS,kBAAkB,EAAE,CAKvE;IAED,OAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;IAED,YAAY,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAGhD;IAEQ,eAAe;QACb,YAAY;MACtB;IAED,OAAO,CAAC,aAAa;IAOf,eAAe,CACnB,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GACpD,OAAO,CAAC,OAAO,CAAC,CAElB;IAGM,gBAAgB,CACrB,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,GACrD,cAAc,CAAC,kBAAkB,CAAC,CAEpC;IAEc,uBAAuB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAgB9D;YAEa,IAAI;IA4BH,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAQzE;IAEc,YAAY,CACzB,MAAM,EAAE,UAAU,EAAE,EACpB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,UAAU,CAAC,CAuCrB;CACF"}

package/dist/providers/reve-provider.js

@@ -0,0 +1,165 @@
+/**
+ * Reve Provider — exposes Reve's image API (create / edit) through the standard
+ * {@link BaseProvider} interface so Reve models work from NodeTool's generic
+ * image-generation nodes (model picker), and surfaces the `REVE_API_KEY` secret
+ * in Settings → API Keys.
+ *
+ *   - textToImage  → POST /v1/image/create
+ *   - imageToImage → POST /v1/image/edit   (one source image)
+ *                  → POST /v1/image/remix  (two or more reference images)
+ *
+ * imageToImage routes by image count: a single source image uses the Edit
+ * endpoint (`edit_instruction` + one base64 `reference_image`); two or more use
+ * the Remix endpoint (`prompt` + a base64 `reference_images` array, capped at
+ * 6 — the only Reve endpoint that accepts more than one reference image).
+ * Remix's indexed `<img>` prompt tags remain the domain of the
+ * `@nodetool-ai/reve-nodes` `reve.RemixImage` node.
+ *
+ * These are Reve's v1 endpoints. Reve's v2 API
+ * (https://api.reve.com/console/docs/v2/) reportedly lifts the reference-image
+ * ceiling to 8 on a unified create/edit endpoint; migrating there is future
+ * work and is not wired here.
+ *
+ * Wire spec (https://api.reve.com/console/docs):
+ *  - Auth:    `Authorization: Bearer <api_key>`.
+ *  - Body:    JSON; reference images are base64-encoded strings.
+ *  - Accept:  `application/json` → response carries a base64 PNG in `image`.
+ */
+import { BaseProvider } from "./base-provider.js";
+import { createLogger } from "@nodetool-ai/config";
+// Stryker disable next-line StringLiteral: logger name is diagnostic, not asserted.
+const log = createLogger("nodetool.runtime.providers.reve");
+const REVE_API_BASE = "https://api.reve.com";
+/** Model ids exposed to the generic image composer. */
+const REVE_CREATE_MODEL = "reve-create";
+const REVE_EDIT_MODEL = "reve-edit";
+/** Max reference images accepted by the Remix endpoint. */
+const REVE_MAX_REMIX_IMAGES = 6;
+const VALID_ASPECT_RATIOS = new Set([
+    "16:9",
+    "9:16",
+    "3:2",
+    "2:3",
+    "4:3",
+    "3:4",
+    "1:1"
+]);
+export class ReveProvider extends BaseProvider {
+    apiKey;
+    declaredCapabilities() {
+        return [
+            "text_to_image",
+            "image_to_image"
+        ];
+    }
+    static requiredSecrets() {
+        return ["REVE_API_KEY"];
+    }
+    constructor(secrets = {}) {
+        super("reve");
+        this.apiKey = secrets["REVE_API_KEY"] ?? "";
+    }
+    getContainerEnv() {
+        return { REVE_API_KEY: this.apiKey };
+    }
+    requireApiKey() {
+        if (!this.apiKey || !this.apiKey.trim()) {
+            throw new Error("REVE_API_KEY is not configured");
+        }
+        return this.apiKey;
+    }
+    async generateMessage(_args) {
+        throw new Error("reve does not support chat generation");
+    }
+    // eslint-disable-next-line require-yield
+    async *generateMessages(_args) {
+        throw new Error("reve does not support chat generation");
+    }
+    async getAvailableImageModels() {
+        if (!this.apiKey)
+            return [];
+        return [
+            {
+                id: REVE_CREATE_MODEL,
+                name: "Reve Create",
+                provider: "reve",
+                supportedTasks: ["text_to_image"]
+            },
+            {
+                id: REVE_EDIT_MODEL,
+                name: "Reve Edit",
+                provider: "reve",
+                supportedTasks: ["image_to_image"]
+            }
+        ];
+    }
+    async post(endpoint, body) {
+        const response = await fetch(`${REVE_API_BASE}/v1/image/${endpoint}`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.requireApiKey()}`,
+                "Content-Type": "application/json",
+                Accept: "application/json"
+            },
+            body: JSON.stringify(body)
+        });
+        if (!response.ok) {
+            throw new Error(`Reve ${endpoint} failed: ${response.status} ${await response.text()}`);
+        }
+        const json = (await response.json());
+        if (json.content_violation) {
+            throw new Error("Reve flagged this request as a content policy violation");
+        }
+        if (!json.image) {
+            throw new Error(`Reve returned no image: ${JSON.stringify(json)}`);
+        }
+        return new Uint8Array(Buffer.from(json.image, "base64"));
+    }
+    async textToImage(params) {
+        const body = { prompt: params.prompt };
+        if (params.aspectRatio && VALID_ASPECT_RATIOS.has(params.aspectRatio)) {
+            body.aspect_ratio = params.aspectRatio;
+        }
+        // Stryker disable next-line StringLiteral,ObjectLiteral: diagnostic log, not asserted.
+        log.debug("Reve textToImage", { model: params.model.id });
+        return this.post("create", body);
+    }
+    async imageToImage(images, params) {
+        const sources = images.filter((b) => b && b.length > 0);
+        if (sources.length === 0) {
+            throw new Error("image must not be empty");
+        }
+        if (sources.length > REVE_MAX_REMIX_IMAGES) {
+            throw new Error(`Reve accepts at most ${REVE_MAX_REMIX_IMAGES} reference images, got ${sources.length}.`);
+        }
+        const aspectRatio = params.aspectRatio && VALID_ASPECT_RATIOS.has(params.aspectRatio)
+            ? params.aspectRatio
+            : undefined;
+        // One source image uses Edit; two or more use Remix — the only Reve
+        // endpoint that accepts multiple reference images.
+        if (sources.length === 1) {
+            const body = {
+                edit_instruction: params.prompt,
+                reference_image: Buffer.from(sources[0]).toString("base64")
+            };
+            if (aspectRatio)
+                body.aspect_ratio = aspectRatio;
+            // Stryker disable next-line StringLiteral,ObjectLiteral: diagnostic log, not asserted.
+            log.debug("Reve imageToImage (edit)", { model: params.model.id });
+            return this.post("edit", body);
+        }
+        const body = {
+            prompt: params.prompt,
+            reference_images: sources.map((b) => Buffer.from(b).toString("base64"))
+        };
+        if (aspectRatio)
+            body.aspect_ratio = aspectRatio;
+        // Stryker disable next-line StringLiteral,ObjectLiteral: diagnostic log, not asserted.
+        log.debug("Reve imageToImage (remix)", {
+            model: params.model.id,
+            images: sources.length
+        });
+        return this.post("remix", body);
+    }
+}
+//# sourceMappingURL=reve-provider.js.map

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

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

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

@@ -14,18 +14,33 @@
  * subscription key — fixed here by reading both `uuids` and
  * `subscription_key` from a single submit response.
  */
-import { BaseProvider } from "./base-provider.js";
+import { BaseProvider, type ProviderCapability } from "./base-provider.js";
 import type { ImageTo3DParams, Message, Model3D, ProviderStreamItem, TextTo3DParams } from "./types.js";
 export declare const RODIN_3D_MODELS: Model3D[];
-export interface RodinProviderOptions {
+interface RodinProviderOptions {
     pollIntervalMs?: number;
     maxPollAttempts?: number;
 }
+interface RodinEncodedImage {
+    type: "png" | "jpeg";
+    data: string;
+}
+export declare function detectImageType(image: Uint8Array): "png" | "jpeg";
+export declare function encodeImageForRodin(image: Uint8Array): RodinEncodedImage;
+/** Pure: normalize a requested 3D output format to Rodin's upper-cased value. */
+export declare function rodinOutputFormat(outputFormat: string | undefined): string;
+/** Pure: attach a non-negative `seed` to a request payload (in place). */
+export declare function applyRodinSeed(payload: Record<string, unknown>, seed: number | null | undefined): void;
+/** Pure: build the Rodin text-to-3D submit payload. */
+export declare function buildRodinTextPayload(prompt: string, format: string, seed: number | null | undefined): Record<string, unknown>;
+/** Pure: build the Rodin image-to-3D submit payload. */
+export declare function buildRodinImagePayload(encoded: RodinEncodedImage, format: string, prompt: string | null | undefined, seed: number | null | undefined): Record<string, unknown>;
 export declare class RodinProvider extends BaseProvider {
     private readonly apiKey;
     private readonly pollIntervalMs;
     private readonly maxPollAttempts;
     constructor(secrets?: Record<string, unknown>, options?: RodinProviderOptions);
+    protected declaredCapabilities(): readonly ProviderCapability[];
     static requiredSecrets(): string[];
     generateMessage(_args: Parameters<BaseProvider["generateMessage"]>[0]): Promise<Message>;
     generateMessages(_args: Parameters<BaseProvider["generateMessages"]>[0]): AsyncGenerator<ProviderStreamItem>;
@@ -34,8 +49,16 @@ export declare class RodinProvider extends BaseProvider {
     imageTo3D(image: Uint8Array, params: ImageTo3DParams): Promise<Uint8Array>;
     private headers;
     private computeMaxAttempts;
+    /**
+     * Per-call timeout signal (mirrors the gemini provider): threaded into the
+     * submit / poll / download fetches so an expired budget aborts the in-flight
+     * request instead of leaking it. The inter-poll sleep is left on the loop's
+     * own attempt cap, which surfaces the friendly "timed out" message.
+     */
+    private timeoutSignal;
     private submitTask;
     private pollTaskStatus;
     private downloadResult;
 }
+export {};
 //# sourceMappingURL=rodin-provider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"rodin-provider.d.ts","sourceRoot":"","sources":["../../src/providers/rodin-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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;AAWpB,eAAO,MAAM,eAAe,EAAE,OAAO,EAsBpC,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA4CD,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;IAoBrD,SAAS,CACtB,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,UAAU,CAAC;IAyBtB,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,kBAAkB;YAOZ,UAAU;YA8BV,cAAc;YA6Cd,cAAc;CA+B7B"}
+{"version":3,"file":"rodin-provider.d.ts","sourceRoot":"","sources":["../../src/providers/rodin-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG3E,OAAO,KAAK,EACV,eAAe,EACf,OAAO,EACP,OAAO,EACP,kBAAkB,EAClB,cAAc,EACf,MAAM,YAAY,CAAC;AAYpB,eAAO,MAAM,eAAe,EAAE,OAAO,EAsBpC,CAAC;AAEF,UAAU,oBAAoB;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAOD,UAAU,iBAAiB;IACzB,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,GAAG,MAAM,CASjE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,iBAAiB,CAKxE;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAE1E;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9B,IAAI,CAEN;AAED,uDAAuD;AACvD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,2BAQhC;AAED,wDAAwD;AACxD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,2BAShC;AAED,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;IAEzC,YACE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,OAAO,GAAE,oBAAyB,EAWnC;IAED,UAAmB,oBAAoB,IAAI,SAAS,kBAAkB,EAAE,CAKvE;IAED,OAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;IAEK,eAAe,CACnB,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GACpD,OAAO,CAAC,OAAO,CAAC,CAElB;IAGM,gBAAgB,CACrB,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,GACrD,cAAc,CAAC,kBAAkB,CAAC,CAEpC;IAEc,oBAAoB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAOxD;IAEc,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAiBnE;IAEc,SAAS,CACtB,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,UAAU,CAAC,CAwBrB;IAID,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,kBAAkB;IAa1B;;;;;OAKG;IACH,OAAO,CAAC,aAAa;YAQP,UAAU;YAgCV,cAAc;YA+Cd,cAAc;CAqC7B"}