@workglow/huggingface-inference 0.2.28

package/dist/ai-provider/HfInferenceProvider.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AiProvider } from "@workglow/ai/worker";
+import type { AiProviderPreviewRunFn, AiProviderRunFn, AiProviderStreamFn } from "@workglow/ai/worker";
+import type { HfInferenceModelConfig } from "./common/HFI_ModelSchema";
+/**
+ * AI provider for Hugging Face Inference API.
+ *
+ * Supports text generation, text embedding, text rewriting, and text summarization
+ * via the Hugging Face Inference API using the `@huggingface/inference` SDK.
+ *
+ * Task run functions are injected via the constructor so that the `@huggingface/inference` SDK
+ * is only imported where actually needed (inline mode, worker server), not on
+ * the main thread in worker mode.
+ */
+export declare class HfInferenceProvider extends AiProvider<HfInferenceModelConfig> {
+    readonly name = "HF_INFERENCE";
+    readonly displayName = "Hugging Face Inference";
+    readonly isLocal = false;
+    readonly supportsBrowser = true;
+    readonly taskTypes: readonly ["ModelInfoTask", "TextGenerationTask", "TextEmbeddingTask", "TextRewriterTask", "TextSummaryTask", "ToolCallingTask", "ModelSearchTask"];
+    constructor(tasks?: Record<string, AiProviderRunFn<any, any, HfInferenceModelConfig>>, streamTasks?: Record<string, AiProviderStreamFn<any, any, HfInferenceModelConfig>>, previewTasks?: Record<string, AiProviderPreviewRunFn<any, any, HfInferenceModelConfig>>);
+}
+//# sourceMappingURL=HfInferenceProvider.d.ts.map

package/dist/ai-provider/HfInferenceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HfInferenceProvider.d.ts","sourceRoot":"","sources":["../../src/ai-provider/HfInferenceProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE;;;;;;;;;GASG;AACH,qBAAa,mBAAoB,SAAQ,UAAU,CAAC,sBAAsB,CAAC;IACzE,QAAQ,CAAC,IAAI,kBAAgB;IAC7B,QAAQ,CAAC,WAAW,4BAA4B;IAChD,QAAQ,CAAC,OAAO,SAAS;IACzB,QAAQ,CAAC,eAAe,QAAQ;IAEhC,QAAQ,CAAC,SAAS,YAChB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACR;IAEX,YACE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAAC,EACzE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAAC,EAClF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAAC,EAGxF;CACF"}

package/dist/ai-provider/HfInferenceQueuedProvider.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AiProvider } from "@workglow/ai";
+import type { AiProviderPreviewRunFn, AiProviderRunFn, AiProviderStreamFn } from "@workglow/ai";
+import type { HfInferenceModelConfig } from "./common/HFI_ModelSchema";
+/** Main-thread registration (inline or worker-backed). No queue — uses direct execution. */
+export declare class HfInferenceQueuedProvider extends AiProvider<HfInferenceModelConfig> {
+    readonly name = "HF_INFERENCE";
+    readonly displayName = "Hugging Face Inference";
+    readonly isLocal = false;
+    readonly supportsBrowser = true;
+    readonly taskTypes: readonly ["ModelInfoTask", "TextGenerationTask", "TextEmbeddingTask", "TextRewriterTask", "TextSummaryTask", "ToolCallingTask", "ModelSearchTask", "ImageGenerateTask", "ImageEditTask"];
+    constructor(tasks?: Record<string, AiProviderRunFn<any, any, HfInferenceModelConfig>>, streamTasks?: Record<string, AiProviderStreamFn<any, any, HfInferenceModelConfig>>, previewTasks?: Record<string, AiProviderPreviewRunFn<any, any, HfInferenceModelConfig>>);
+}
+//# sourceMappingURL=HfInferenceQueuedProvider.d.ts.map

package/dist/ai-provider/HfInferenceQueuedProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HfInferenceQueuedProvider.d.ts","sourceRoot":"","sources":["../../src/ai-provider/HfInferenceQueuedProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEhG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE,4FAA4F;AAC5F,qBAAa,yBAA0B,SAAQ,UAAU,CAAC,sBAAsB,CAAC;IAC/E,QAAQ,CAAC,IAAI,kBAAgB;IAC7B,QAAQ,CAAC,WAAW,4BAA4B;IAChD,QAAQ,CAAC,OAAO,SAAS;IACzB,QAAQ,CAAC,eAAe,QAAQ;IAEhC,QAAQ,CAAC,SAAS,YAChB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACN;IAEX,YACE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAAC,EACzE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAAC,EAClF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAAC,EAGxF;CACF"}

package/dist/ai-provider/common/HFI_AspectRatio.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type AspectRatio = "1:1" | "16:9" | "9:16" | "4:3" | "3:4";
+export interface ImageDims {
+    width: number;
+    height: number;
+}
+/** Resolves output dims for a model id and aspect ratio. Falls back to SDXL dims. */
+export declare function resolveHfImageDims(modelId: string, aspectRatio: AspectRatio): ImageDims;
+/** Returns true if the model id matches a known inpainting variant (mask supported). */
+export declare function isHfInpaintingModel(modelId: string): boolean;
+//# sourceMappingURL=HFI_AspectRatio.d.ts.map

package/dist/ai-provider/common/HFI_AspectRatio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HFI_AspectRatio.d.ts","sourceRoot":"","sources":["../../../src/ai-provider/common/HFI_AspectRatio.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAElE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAyBD,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,SAAS,CAGvF;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/dist/ai-provider/common/HFI_Client.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { InferenceProviderOrPolicy } from "@huggingface/inference";
+import type { HfInferenceModelConfig } from "./HFI_ModelSchema";
+export declare function loadHfInferenceSDK(): Promise<typeof import("@huggingface/inference")>;
+export declare function getClient(model: HfInferenceModelConfig | undefined): Promise<import("@huggingface/inference").InferenceClient>;
+export declare function getModelName(model: HfInferenceModelConfig | undefined): string;
+export declare function getProvider(model: HfInferenceModelConfig | undefined): InferenceProviderOrPolicy | undefined;
+//# sourceMappingURL=HFI_Client.d.ts.map

package/dist/ai-provider/common/HFI_Client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HFI_Client.d.ts","sourceRoot":"","sources":["../../../src/ai-provider/common/HFI_Client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAIhE,wBAAsB,kBAAkB,qDAWvC;AASD,wBAAsB,SAAS,CAAC,KAAK,EAAE,sBAAsB,GAAG,SAAS,6DAmBxE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,sBAAsB,GAAG,SAAS,GAAG,MAAM,CAM9E;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,sBAAsB,GAAG,SAAS,GACxC,yBAAyB,GAAG,SAAS,CAEvC"}

package/dist/ai-provider/common/HFI_Constants.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const HF_INFERENCE = "HF_INFERENCE";
+//# sourceMappingURL=HFI_Constants.d.ts.map

package/dist/ai-provider/common/HFI_Constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HFI_Constants.d.ts","sourceRoot":"","sources":["../../../src/ai-provider/common/HFI_Constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,YAAY,iBAAiB,CAAC"}

package/dist/ai-provider/common/HFI_ImageEdit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AiProviderRunFn, AiProviderStreamFn, ImageEditTaskInput, ImageEditTaskOutput } from "@workglow/ai";
+import type { HfInferenceModelConfig } from "./HFI_ModelSchema";
+export declare const HFI_ImageEdit: AiProviderRunFn<ImageEditTaskInput, ImageEditTaskOutput, HfInferenceModelConfig>;
+/**
+ * One-shot stream wrapper. HF Inference does not support partial image streaming,
+ * so we call the non-streaming run function, yield one snapshot, then finish.
+ */
+export declare const HFI_ImageEdit_Stream: AiProviderStreamFn<ImageEditTaskInput, ImageEditTaskOutput, HfInferenceModelConfig>;
+//# sourceMappingURL=HFI_ImageEdit.d.ts.map

package/dist/ai-provider/common/HFI_ImageEdit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HFI_ImageEdit.d.ts","sourceRoot":"","sources":["../../../src/ai-provider/common/HFI_ImageEdit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EAEpB,MAAM,cAAc,CAAC;AAOtB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AA0BhE,eAAO,MAAM,aAAa,EAAE,eAAe,CACzC,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,CAoDvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,CACnD,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,CAMvB,CAAC"}

package/dist/ai-provider/common/HFI_ImageGenerate.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AiProviderRunFn, AiProviderStreamFn, ImageGenerateTaskInput, ImageGenerateTaskOutput } from "@workglow/ai";
+import type { HfInferenceModelConfig } from "./HFI_ModelSchema";
+export declare const HFI_ImageGenerate: AiProviderRunFn<ImageGenerateTaskInput, ImageGenerateTaskOutput, HfInferenceModelConfig>;
+/**
+ * One-shot stream wrapper. HF Inference does not support partial image streaming,
+ * so we call the non-streaming run function, yield one snapshot, then finish.
+ */
+export declare const HFI_ImageGenerate_Stream: AiProviderStreamFn<ImageGenerateTaskInput, ImageGenerateTaskOutput, HfInferenceModelConfig>;
+//# sourceMappingURL=HFI_ImageGenerate.d.ts.map

package/dist/ai-provider/common/HFI_ImageGenerate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HFI_ImageGenerate.d.ts","sourceRoot":"","sources":["../../../src/ai-provider/common/HFI_ImageGenerate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EAExB,MAAM,cAAc,CAAC;AAMtB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAYhE,eAAO,MAAM,iBAAiB,EAAE,eAAe,CAC7C,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,CAyCvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,kBAAkB,CACvD,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,CAMvB,CAAC"}

package/dist/ai-provider/common/HFI_ImageValidation.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function registerHfImageValidator(): void;
+//# sourceMappingURL=HFI_ImageValidation.d.ts.map

package/dist/ai-provider/common/HFI_ImageValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HFI_ImageValidation.d.ts","sourceRoot":"","sources":["../../../src/ai-provider/common/HFI_ImageValidation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,wBAAgB,wBAAwB,IAAI,IAAI,CA8B/C"}

package/dist/ai-provider/common/HFI_JobRunFns.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AiProviderRunFn, AiProviderStreamFn } from "@workglow/ai";
+import type { HfInferenceModelConfig } from "./HFI_ModelSchema";
+export { loadHfInferenceSDK, getClient, getModelName, getProvider } from "./HFI_Client";
+export declare const HFI_TASKS: Record<string, AiProviderRunFn<any, any, HfInferenceModelConfig>>;
+export declare const HFI_STREAM_TASKS: Record<string, AiProviderStreamFn<any, any, HfInferenceModelConfig>>;
+//# sourceMappingURL=HFI_JobRunFns.d.ts.map

package/dist/ai-provider/common/HFI_JobRunFns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HFI_JobRunFns.d.ts","sourceRoot":"","sources":["../../../src/ai-provider/common/HFI_JobRunFns.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGhE,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAWxF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAUvF,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CACnC,MAAM,EACN,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAQrD,CAAC"}

package/dist/ai-provider/common/HFI_ModelInfo.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AiProviderRunFn, ModelInfoTaskInput, ModelInfoTaskOutput } from "@workglow/ai";
+import type { HfInferenceModelConfig } from "./HFI_ModelSchema";
+export declare const HFI_ModelInfo: AiProviderRunFn<ModelInfoTaskInput, ModelInfoTaskOutput, HfInferenceModelConfig>;
+//# sourceMappingURL=HFI_ModelInfo.d.ts.map

package/dist/ai-provider/common/HFI_ModelInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HFI_ModelInfo.d.ts","sourceRoot":"","sources":["../../../src/ai-provider/common/HFI_ModelInfo.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC7F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,eAAO,MAAM,aAAa,EAAE,eAAe,CACzC,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,CA8BvB,CAAC"}

package/dist/ai-provider/common/HFI_ModelSchema.d.ts

@@ -0,0 +1,152 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { FromSchema } from "@workglow/util/worker";
+export declare const HfInferenceModelSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly provider: {
+            readonly const: "HF_INFERENCE";
+            readonly description: "Discriminator: Hugging Face Inference API provider.";
+        };
+        readonly provider_config: {
+            readonly type: "object";
+            readonly description: "Hugging Face Inference-specific configuration.";
+            readonly properties: {
+                readonly model_name: {
+                    readonly type: "string";
+                    readonly description: "The Hugging Face model identifier (e.g., 'meta-llama/Llama-3.3-70B-Instruct').";
+                };
+                readonly credential_key: {
+                    readonly type: "string";
+                    readonly format: "credential";
+                    readonly description: "Key to look up in the credential store for the API key.";
+                    readonly "x-ui-hidden": true;
+                };
+                readonly provider: {
+                    readonly type: "string";
+                    readonly description: "Optional provider to route to specific HF inference providers (e.g., 'fal-ai', 'fireworks-ai').";
+                };
+            };
+            readonly required: readonly ["model_name"];
+            readonly additionalProperties: false;
+        };
+    };
+    readonly required: readonly ["provider", "provider_config"];
+    readonly additionalProperties: true;
+};
+export declare const HfInferenceModelRecordSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly model_id: {
+            readonly type: "string";
+        };
+        readonly tasks: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly "x-ui-editor": "multiselect";
+        };
+        readonly title: {
+            readonly type: "string";
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly "x-ui-editor": "textarea";
+        };
+        readonly metadata: {
+            readonly type: "object";
+            readonly default: {};
+            readonly "x-ui-hidden": true;
+        };
+        readonly provider: {
+            readonly const: "HF_INFERENCE";
+            readonly description: "Discriminator: Hugging Face Inference API provider.";
+        };
+        readonly provider_config: {
+            readonly type: "object";
+            readonly description: "Hugging Face Inference-specific configuration.";
+            readonly properties: {
+                readonly model_name: {
+                    readonly type: "string";
+                    readonly description: "The Hugging Face model identifier (e.g., 'meta-llama/Llama-3.3-70B-Instruct').";
+                };
+                readonly credential_key: {
+                    readonly type: "string";
+                    readonly format: "credential";
+                    readonly description: "Key to look up in the credential store for the API key.";
+                    readonly "x-ui-hidden": true;
+                };
+                readonly provider: {
+                    readonly type: "string";
+                    readonly description: "Optional provider to route to specific HF inference providers (e.g., 'fal-ai', 'fireworks-ai').";
+                };
+            };
+            readonly required: readonly ["model_name"];
+            readonly additionalProperties: false;
+        };
+    };
+    readonly required: readonly ["model_id", "tasks", "provider", "title", "description", "provider_config", "metadata", "provider", "provider_config"];
+    readonly additionalProperties: false;
+};
+export type HfInferenceModelRecord = FromSchema<typeof HfInferenceModelRecordSchema>;
+export declare const HfInferenceModelConfigSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly model_id: {
+            readonly type: "string";
+        };
+        readonly tasks: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly "x-ui-editor": "multiselect";
+        };
+        readonly title: {
+            readonly type: "string";
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly "x-ui-editor": "textarea";
+        };
+        readonly metadata: {
+            readonly type: "object";
+            readonly default: {};
+            readonly "x-ui-hidden": true;
+        };
+        readonly provider: {
+            readonly const: "HF_INFERENCE";
+            readonly description: "Discriminator: Hugging Face Inference API provider.";
+        };
+        readonly provider_config: {
+            readonly type: "object";
+            readonly description: "Hugging Face Inference-specific configuration.";
+            readonly properties: {
+                readonly model_name: {
+                    readonly type: "string";
+                    readonly description: "The Hugging Face model identifier (e.g., 'meta-llama/Llama-3.3-70B-Instruct').";
+                };
+                readonly credential_key: {
+                    readonly type: "string";
+                    readonly format: "credential";
+                    readonly description: "Key to look up in the credential store for the API key.";
+                    readonly "x-ui-hidden": true;
+                };
+                readonly provider: {
+                    readonly type: "string";
+                    readonly description: "Optional provider to route to specific HF inference providers (e.g., 'fal-ai', 'fireworks-ai').";
+                };
+            };
+            readonly required: readonly ["model_name"];
+            readonly additionalProperties: false;
+        };
+    };
+    readonly required: readonly ["provider", "provider_config", "provider", "provider_config"];
+    readonly additionalProperties: false;
+};
+export type HfInferenceModelConfig = FromSchema<typeof HfInferenceModelConfigSchema>;
+//# sourceMappingURL=HFI_ModelSchema.d.ts.map

package/dist/ai-provider/common/HFI_ModelSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HFI_ModelSchema.d.ts","sourceRoot":"","sources":["../../../src/ai-provider/common/HFI_ModelSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAwB,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGzE,eAAO,MAAM,sBAAsB;mBAC3B,QAAQ;;iBAEZ,QAAQ;qBACN,KAAK;qBACL,WAAW,EAAE,qDAAqD;;iBAEpE,eAAe;qBACb,IAAI,EAAE,QAAQ;qBACd,WAAW,EAAE,gDAAgD;qBAC7D,UAAU;yBACR,UAAU;6BACR,IAAI,EAAE,QAAQ;6BACd,WAAW,EACT,gFAAgF;;yBAEpF,cAAc;6BACZ,IAAI,EAAE,QAAQ;6BACd,MAAM,EAAE,YAAY;6BACpB,WAAW,EAAE,yDAAyD;6BACtE,aAAa;;yBAEf,QAAQ;6BACN,IAAI,EAAE,QAAQ;6BACd,WAAW,EACT,iGAAiG;;;qBAGvG,QAAQ;qBACR,oBAAoB;;;;;CAKe,CAAC;AAE1C,eAAO,MAAM,4BAA4B;mBACjC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;qBAjCV,KAAK;qBACL,WAAW,EAAE,qDAAqD;;;qBAGlE,IAAI,EAAE,QAAQ;qBACd,WAAW,EAAE,gDAAgD;qBAC7D,UAAU;yBACR,UAAU;6BACR,IAAI,EAAE,QAAQ;6BACd,WAAW,EACT,gFAAgF;;yBAEpF,cAAc;6BACZ,IAAI,EAAE,QAAQ;6BACd,MAAM,EAAE,YAAY;6BACpB,WAAW,EAAE,yDAAyD;6BACtE,aAAa;;yBAEf,QAAQ;6BACN,IAAI,EAAE,QAAQ;6BACd,WAAW,EACT,iGAAiG;;;qBAGvG,QAAQ;qBACR,oBAAoB;;;;;CAee,CAAC;AAE1C,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAErF,eAAO,MAAM,4BAA4B;mBACjC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;qBA7CV,KAAK;qBACL,WAAW,EAAE,qDAAqD;;;qBAGlE,IAAI,EAAE,QAAQ;qBACd,WAAW,EAAE,gDAAgD;qBAC7D,UAAU;yBACR,UAAU;6BACR,IAAI,EAAE,QAAQ;6BACd,WAAW,EACT,gFAAgF;;yBAEpF,cAAc;6BACZ,IAAI,EAAE,QAAQ;6BACd,MAAM,EAAE,YAAY;6BACpB,WAAW,EAAE,yDAAyD;6BACtE,aAAa;;yBAEf,QAAQ;6BACN,IAAI,EAAE,QAAQ;6BACd,WAAW,EACT,iGAAiG;;;qBAGvG,QAAQ;qBACR,oBAAoB;;;;;CA2Be,CAAC;AAE1C,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/ai-provider/common/HFI_ModelSearch.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AiProviderRunFn, ModelSearchTaskInput, ModelSearchTaskOutput } from "@workglow/ai";
+export declare const HFI_ModelSearch: AiProviderRunFn<ModelSearchTaskInput, ModelSearchTaskOutput>;
+//# sourceMappingURL=HFI_ModelSearch.d.ts.map

package/dist/ai-provider/common/HFI_ModelSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HFI_ModelSearch.d.ts","sourceRoot":"","sources":["../../../src/ai-provider/common/HFI_ModelSearch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,eAAe,EAEf,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,cAAc,CAAC;AA6BtB,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,oBAAoB,EAAE,qBAAqB,CA2BxF,CAAC"}

package/dist/ai-provider/common/HFI_TextEmbedding.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AiProviderRunFn, TextEmbeddingTaskInput, TextEmbeddingTaskOutput } from "@workglow/ai";
+import type { HfInferenceModelConfig } from "./HFI_ModelSchema";
+export declare const HFI_TextEmbedding: AiProviderRunFn<TextEmbeddingTaskInput, TextEmbeddingTaskOutput, HfInferenceModelConfig>;
+//# sourceMappingURL=HFI_TextEmbedding.d.ts.map

package/dist/ai-provider/common/HFI_TextEmbedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HFI_TextEmbedding.d.ts","sourceRoot":"","sources":["../../../src/ai-provider/common/HFI_TextEmbedding.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGhE,eAAO,MAAM,iBAAiB,EAAE,eAAe,CAC7C,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,CAyCvB,CAAC"}

package/dist/ai-provider/common/HFI_TextGeneration.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AiProviderRunFn, AiProviderStreamFn, TextGenerationTaskInput, TextGenerationTaskOutput } from "@workglow/ai";
+import type { HfInferenceModelConfig } from "./HFI_ModelSchema";
+export declare const HFI_TextGeneration: AiProviderRunFn<TextGenerationTaskInput, TextGenerationTaskOutput, HfInferenceModelConfig>;
+export declare const HFI_TextGeneration_Stream: AiProviderStreamFn<TextGenerationTaskInput, TextGenerationTaskOutput, HfInferenceModelConfig>;
+//# sourceMappingURL=HFI_TextGeneration.d.ts.map

package/dist/ai-provider/common/HFI_TextGeneration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HFI_TextGeneration.d.ts","sourceRoot":"","sources":["../../../src/ai-provider/common/HFI_TextGeneration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGhE,eAAO,MAAM,kBAAkB,EAAE,eAAe,CAC9C,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,CA2BvB,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,kBAAkB,CACxD,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,CA0BvB,CAAC"}

package/dist/ai-provider/common/HFI_TextRewriter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AiProviderRunFn, AiProviderStreamFn, TextRewriterTaskInput, TextRewriterTaskOutput } from "@workglow/ai";
+import type { HfInferenceModelConfig } from "./HFI_ModelSchema";
+export declare const HFI_TextRewriter: AiProviderRunFn<TextRewriterTaskInput, TextRewriterTaskOutput, HfInferenceModelConfig>;
+export declare const HFI_TextRewriter_Stream: AiProviderStreamFn<TextRewriterTaskInput, TextRewriterTaskOutput, HfInferenceModelConfig>;
+//# sourceMappingURL=HFI_TextRewriter.d.ts.map

package/dist/ai-provider/common/HFI_TextRewriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HFI_TextRewriter.d.ts","sourceRoot":"","sources":["../../../src/ai-provider/common/HFI_TextRewriter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGhE,eAAO,MAAM,gBAAgB,EAAE,eAAe,CAC5C,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,CAqBvB,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,kBAAkB,CACtD,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,CAyBvB,CAAC"}

package/dist/ai-provider/common/HFI_TextSummary.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AiProviderRunFn, AiProviderStreamFn, TextSummaryTaskInput, TextSummaryTaskOutput } from "@workglow/ai";
+import type { HfInferenceModelConfig } from "./HFI_ModelSchema";
+export declare const HFI_TextSummary: AiProviderRunFn<TextSummaryTaskInput, TextSummaryTaskOutput, HfInferenceModelConfig>;
+export declare const HFI_TextSummary_Stream: AiProviderStreamFn<TextSummaryTaskInput, TextSummaryTaskOutput, HfInferenceModelConfig>;
+//# sourceMappingURL=HFI_TextSummary.d.ts.map

package/dist/ai-provider/common/HFI_TextSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HFI_TextSummary.d.ts","sourceRoot":"","sources":["../../../src/ai-provider/common/HFI_TextSummary.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGhE,eAAO,MAAM,eAAe,EAAE,eAAe,CAC3C,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,CAqBvB,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,kBAAkB,CACrD,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,CAyBvB,CAAC"}

package/dist/ai-provider/common/HFI_ToolCalling.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AiProviderRunFn, AiProviderStreamFn, ToolCallingTaskInput, ToolCallingTaskOutput } from "@workglow/ai";
+import type { HfInferenceModelConfig } from "./HFI_ModelSchema";
+export declare const HFI_ToolCalling: AiProviderRunFn<ToolCallingTaskInput, ToolCallingTaskOutput, HfInferenceModelConfig>;
+export declare const HFI_ToolCalling_Stream: AiProviderStreamFn<ToolCallingTaskInput, ToolCallingTaskOutput, HfInferenceModelConfig>;
+//# sourceMappingURL=HFI_ToolCalling.d.ts.map

package/dist/ai-provider/common/HFI_ToolCalling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HFI_ToolCalling.d.ts","sourceRoot":"","sources":["../../../src/ai-provider/common/HFI_ToolCalling.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EAGtB,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAYhE,eAAO,MAAM,eAAe,EAAE,eAAe,CAC3C,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,CA0DvB,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,kBAAkB,CACrD,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,CA+FvB,CAAC"}

package/dist/ai-provider/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./common/HFI_AspectRatio";
+export * from "./common/HFI_Constants";
+export * from "./common/HFI_ImageValidation";
+export * from "./common/HFI_ModelSchema";
+export * from "./common/HFI_ModelSearch";
+export * from "./registerHfInference";
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai-provider/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/ai-provider/registerHfInference.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AiProviderRegisterOptions } from "@workglow/ai";
+export declare function registerHfInference(options: AiProviderRegisterOptions & {
+    worker: Worker | (() => Worker);
+}): Promise<void>;
+//# sourceMappingURL=registerHfInference.d.ts.map

package/dist/ai-provider/registerHfInference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerHfInference.d.ts","sourceRoot":"","sources":["../../src/ai-provider/registerHfInference.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAK9D,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,yBAAyB,GAAG;IACnC,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;CACjC,GACA,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/ai-provider/registerHfInferenceInline.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AiProviderRegisterOptions } from "@workglow/ai";
+export declare function registerHfInferenceInline(options?: AiProviderRegisterOptions): Promise<void>;
+//# sourceMappingURL=registerHfInferenceInline.d.ts.map

package/dist/ai-provider/registerHfInferenceInline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerHfInferenceInline.d.ts","sourceRoot":"","sources":["../../src/ai-provider/registerHfInferenceInline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAM9D,wBAAsB,yBAAyB,CAC7C,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/ai-provider/registerHfInferenceWorker.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function registerHfInferenceWorker(): Promise<void>;
+//# sourceMappingURL=registerHfInferenceWorker.d.ts.map

package/dist/ai-provider/registerHfInferenceWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerHfInferenceWorker.d.ts","sourceRoot":"","sources":["../../src/ai-provider/registerHfInferenceWorker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAK/D"}

package/dist/ai-provider/runtime.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Worker server and main-thread inline Hugging Face Inference registration (pulls in `HFI_JobRunFns`),
+ * plus API client helpers (`HFI_Client`).
+ * Import from `@workglow/huggingface-inference/ai-provider-runtime` — not from the main `hf-inference` barrel.
+ *
+ * Use `export *` (not `export { … } from "…"`) so the Bun bundler keeps the module graph.
+ */
+export * from "./common/HFI_Client";
+export * from "./registerHfInferenceInline";
+export * from "./registerHfInferenceWorker";
+//# sourceMappingURL=runtime.d.ts.map

package/dist/ai-provider/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/ai-provider/runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC"}

package/dist/ai-provider-runtime.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./ai-provider/runtime";
+//# sourceMappingURL=ai-provider-runtime.d.ts.map

package/dist/ai-provider-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-provider-runtime.d.ts","sourceRoot":"","sources":["../src/ai-provider-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,uBAAuB,CAAC"}