@workglow/ai 0.2.30 → 0.2.32

package/dist/provider/AiProviderRegistry.d.ts

@@ -5,7 +5,7 @@
  */
 import { TaskInput, TaskOutput } from "@workglow/task-graph";
 import type { StreamEvent } from "@workglow/task-graph";
-import type { JsonSchema } from "@workglow/util/worker";
+import type { JsonSchema, ServiceRegistry } from "@workglow/util/worker";
 import type { IAiExecutionStrategy, AiStrategyResolver } from "../execution/IAiExecutionStrategy";
 import type { ModelConfig } from "../model/ModelSchema";
 import type { AiProvider } from "./AiProvider";
@@ -185,6 +185,24 @@ export declare class AiProviderRegistry {
         title?: string | undefined;
     }>;
 }
-export declare function getAiProviderRegistry(): AiProviderRegistry;
-export declare function setAiProviderRegistry(pr: AiProviderRegistry): void;
+/**
+ * Service token for the AI provider registry.
+ */
+export declare const AI_PROVIDER_REGISTRY: import("@workglow/util").ServiceToken<AiProviderRegistry>;
+/**
+ * Returns the AI provider registry from the given registry (defaults to global).
+ * Lazy-registers a fresh `AiProviderRegistry` if the token is absent — same
+ * pattern as `getLogger`. Makes scoped registries safe to use without an
+ * explicit `registerAiProviderDefaults(registry)` call.
+ */
+export declare function getAiProviderRegistry(registry?: ServiceRegistry): AiProviderRegistry;
+/**
+ * Replaces the AI provider registry on the given registry (defaults to global).
+ */
+export declare function setAiProviderRegistry(pr: AiProviderRegistry, registry?: ServiceRegistry): void;
+/**
+ * Registers the AI provider registry default factory on the given registry.
+ * Called by `bootstrapWorkglow` and `createOrchestrationContext`.
+ */
+export declare function registerAiProviderDefaults(registry?: ServiceRegistry): void;
 //# sourceMappingURL=AiProviderRegistry.d.ts.map

package/dist/provider/AiProviderRegistry.d.ts.map

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

package/dist/provider-utils/BaseCloudProvider.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AiProvider } from "../provider/AiProvider";
+import type { AiProviderPreviewRunFn, AiProviderRunFn, AiProviderStreamFn } from "../provider/AiProviderRegistry";
+import type { ModelConfig } from "../model/ModelSchema";
+/**
+ * Static metadata describing a cloud-backed AI provider.
+ *
+ * Shared across each provider's worker- and main-thread class shells so the
+ * declarations live in one place and only the constructor base differs.
+ */
+export interface CloudProviderMetadata<TaskTypes extends readonly string[] = readonly string[]> {
+    readonly name: string;
+    readonly displayName: string;
+    readonly isLocal?: boolean;
+    readonly supportsBrowser?: boolean;
+    readonly taskTypes: TaskTypes;
+}
+/**
+ * Constructor signature mirroring {@link AiProvider}'s public constructor.
+ * Declared structurally so callers can pass either the worker or main-thread
+ * `AiProvider` import without forcing this module to import either at runtime.
+ */
+type AiProviderCtor<TModelConfig extends ModelConfig> = abstract new (tasks?: Record<string, AiProviderRunFn<any, any, TModelConfig>>, streamTasks?: Record<string, AiProviderStreamFn<any, any, TModelConfig>>, previewTasks?: Record<string, AiProviderPreviewRunFn<any, any, TModelConfig>>) => AiProvider<TModelConfig>;
+/**
+ * Build a concrete provider class by mixing the shared declarations from
+ * {@link CloudProviderMetadata} into a caller-supplied {@link AiProvider} base.
+ *
+ * Each cloud provider package keeps two thin shells (worker + main-thread)
+ * and supplies the appropriate `AiProvider` import to this factory. The
+ * generated class implements `name`, `displayName`, `isLocal`,
+ * `supportsBrowser`, and `taskTypes` from the metadata literal; the
+ * constructor is inherited unchanged from the base.
+ */
+export declare function createCloudProviderClass<TModelConfig extends ModelConfig, T extends readonly string[]>(Base: AiProviderCtor<TModelConfig>, meta: CloudProviderMetadata<T>): new (tasks?: Record<string, AiProviderRunFn<any, any, TModelConfig>>, streamTasks?: Record<string, AiProviderStreamFn<any, any, TModelConfig>>, previewTasks?: Record<string, AiProviderPreviewRunFn<any, any, TModelConfig>>) => AiProvider<TModelConfig> & {
+    readonly name: string;
+    readonly displayName: string;
+    readonly isLocal: boolean;
+    readonly supportsBrowser: boolean;
+    readonly taskTypes: T;
+};
+export {};
+//# sourceMappingURL=BaseCloudProvider.d.ts.map

package/dist/provider-utils/BaseCloudProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseCloudProvider.d.ts","sourceRoot":"","sources":["../../src/provider-utils/BaseCloudProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB,CAAC,SAAS,SAAS,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE;IAC5F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED;;;;GAIG;AACH,KAAK,cAAc,CAAC,YAAY,SAAS,WAAW,IAAI,QAAQ,MAE9D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,EAE/D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,EAExE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,KAC1E,UAAU,CAAC,YAAY,CAAC,CAAC;AAE9B;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,SAAS,WAAW,EAChC,CAAC,SAAS,SAAS,MAAM,EAAE,EAC3B,IAAI,EAAE,cAAc,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAQ/B,KAEjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,EAE/D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,EAExE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,KAC1E,UAAU,CAAC,YAAY,CAAC,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;CACvB,CACF"}

package/dist/provider-utils/CloudProviderClient.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Shared cloud-provider client utilities: API-key resolution and lazy SDK
+ * loading. Used by each provider's `*_Client.ts` so the same fallback chain
+ * (provider_config → env var) and the same "package missing" error message
+ * live in one place.
+ */
+export interface CloudCredentialConfig {
+    readonly credential_key?: string;
+    readonly api_key?: string;
+}
+export interface ResolveApiKeyArgs {
+    readonly config: CloudCredentialConfig | undefined;
+    /** Single env var name, or list of alternatives tried in order. */
+    readonly envVar: string | readonly string[];
+    /** Human-friendly provider label used in the error message. */
+    readonly providerLabel: string;
+}
+/**
+ * Resolve the API key for a cloud provider.
+ *
+ * Looks at `config.credential_key`, then `config.api_key`, then each entry in
+ * `envVar` (in order). Throws a uniform error if nothing is found.
+ */
+export declare function resolveApiKey(args: ResolveApiKeyArgs): string;
+/**
+ * Dynamically import a provider SDK package, throwing a uniform install hint
+ * if the package isn't present.
+ */
+export declare function loadProviderSdk<T = unknown>(packageName: string, friendlyName?: string): Promise<T>;
+/**
+ * True when running inside a browser-like environment (window/worker globals
+ * present). Cloud SDKs use this to set their `dangerouslyAllowBrowser` flag.
+ */
+export declare function isBrowserLike(): boolean;
+//# sourceMappingURL=CloudProviderClient.d.ts.map

package/dist/provider-utils/CloudProviderClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudProviderClient.d.ts","sourceRoot":"","sources":["../../src/provider-utils/CloudProviderClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AAEH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,SAAS,CAAC;IACnD,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC5C,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAgB7D;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/C,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC"}

package/dist/provider-utils/HfModelSearch.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ModelSearchResultItem } from "../task/ModelSearchTask";
+export interface HfModelEntry {
+    id: string;
+    modelId: string;
+    pipeline_tag?: string;
+    library_name?: string;
+    likes: number;
+    downloads: number;
+    tags?: string[];
+    siblings?: Array<{
+        rfilename: string;
+    }>;
+}
+export declare function formatDownloads(n: number): string;
+/**
+ * Map an HF model entry to a provider-specific config object.
+ */
+export declare function mapHfProviderConfig(entry: HfModelEntry, provider: string): Record<string, unknown>;
+/**
+ * Map an HF model entry to a ModelSearchResultItem.
+ */
+export declare function mapHfModelResult(entry: HfModelEntry, provider: string): ModelSearchResultItem;
+/**
+ * Search HuggingFace models API. Returns all results (limit=500, no pagination).
+ * An empty `query` lists top models by sort order (no text filter).
+ */
+export declare function searchHfModels(query: string, extraParams?: Record<string, string>, expandFields?: string[], signal?: AbortSignal, credentialKey?: string): Promise<HfModelEntry[]>;
+//# sourceMappingURL=HfModelSearch.d.ts.map

package/dist/provider-utils/HfModelSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HfModelSearch.d.ts","sourceRoot":"","sources":["../../src/provider-utils/HfModelSearch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGrE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzC;AAID,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAmB7F;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,MAAM,CAAC,EAAE,WAAW,EACpB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC,CAoBzB"}

package/dist/provider-utils/OpenAIShapedChat.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ToolCallingTaskOutput } from "../task/ToolCallingTask";
+import type { ToolCalls, ToolDefinition } from "../task/ToolCallingUtils";
+import type { StreamEvent } from "@workglow/task-graph";
+/**
+ * Shared helpers for providers that expose an OpenAI-compatible chat-completions
+ * API (currently OpenAI itself and Hugging Face Inference). They cover:
+ *
+ *  - Building the OpenAI `tools` array from workglow {@link ToolDefinition}s.
+ *  - Mapping workglow `toolChoice` strings to the OpenAI union, with optional
+ *    named-function support (HFI accepts only `auto | none | required`).
+ *  - Streaming a chat-completions response into workglow {@link StreamEvent}s,
+ *    accumulating fragmented tool-call argument JSON internally and yielding
+ *    `text-delta` + per-tool-call `object-delta` events. The final `finish`
+ *    event carries `{}` per the streaming convention in CLAUDE.md — the
+ *    consumer (`StreamProcessor`) is responsible for accumulating deltas.
+ */
+/** OpenAI-shape tool entry. Kept loose because each SDK names the type differently. */
+export interface OpenAIShapedTool {
+    readonly type: "function";
+    readonly function: {
+        readonly name: string;
+        readonly description: string;
+        readonly parameters: any;
+    };
+}
+export type OpenAIShapedToolChoice = "auto" | "none" | "required" | {
+    readonly type: "function";
+    readonly function: {
+        readonly name: string;
+    };
+};
+export declare function buildOpenAITools(tools: readonly ToolDefinition[]): OpenAIShapedTool[];
+/**
+ * Map workglow `toolChoice` to an OpenAI-shaped tool_choice value.
+ *
+ * @param toolChoice - One of `"auto" | "none" | "required" | <tool_name>` (or undefined).
+ * @param allowNamedFunction - When true, an unrecognized value is treated as a
+ *   tool name and emitted as `{ type: "function", function: { name } }`. When
+ *   false (HFI), it falls back to `"auto"` because HFI's API only accepts the
+ *   three keywords.
+ */
+export declare function mapOpenAIToolChoice(toolChoice: string | undefined, allowNamedFunction: boolean): OpenAIShapedToolChoice;
+/**
+ * Parse a non-streaming OpenAI-shape chat completion message into workglow
+ * {@link ToolCalls}. Used by the synchronous `*_ToolCalling` runFns.
+ *
+ * Some providers (HFI) don't always return an `id` per tool call; we
+ * auto-generate `call_<index>` in that case.
+ */
+export declare function parseOpenAIToolCallMessage(toolCallsRaw: readonly any[] | undefined): ToolCalls;
+/**
+ * Adapt an OpenAI-shape streaming response (each chunk has
+ * `choices[0].delta.{content?, tool_calls?[]}`) to workglow stream events.
+ *
+ * Yields:
+ *  - `text-delta` for each non-empty `delta.content`.
+ *  - `object-delta` (single-element array) per tool-call delta with the latest
+ *    parsed input. The downstream `StreamProcessor` upserts by `id`.
+ *  - `finish` with structural defaults (`{ text: "", toolCalls: [] }`) once the
+ *    stream ends. The defaults are minimal scaffolding so the final output
+ *    always satisfies {@link ToolCallingTaskOutput} even when the model
+ *    streams only `tool_calls` (no `content` deltas) — the consumer's
+ *    `StreamProcessor` overrides any port for which deltas were accumulated.
+ */
+export declare function accumulateOpenAIStream(stream: AsyncIterable<any>): AsyncGenerator<StreamEvent<ToolCallingTaskOutput>, void, unknown>;
+//# sourceMappingURL=OpenAIShapedChat.d.ts.map

package/dist/provider-utils/OpenAIShapedChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIShapedChat.d.ts","sourceRoot":"","sources":["../../src/provider-utils/OpenAIShapedChat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD;;;;;;;;;;;;GAYG;AAEH,uFAAuF;AACvF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAE7B,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,MAAM,GACN,UAAU,GACV;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEhF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,gBAAgB,EAAE,CAUrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,kBAAkB,EAAE,OAAO,GAC1B,sBAAsB,CAMxB;AAaD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAExC,YAAY,EAAE,SAAS,GAAG,EAAE,GAAG,SAAS,GACvC,SAAS,CAsBX;AAQD;;;;;;;;;;;;;GAaG;AACH,wBAAuB,sBAAsB,CAE3C,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,GACzB,cAAc,CAAC,WAAW,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CA4CnE"}

package/dist/provider-utils/PipelineTaskMapping.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/** Convert an app task type to its primary HuggingFace pipeline name. */
+export declare function taskTypeToPipeline(taskType: string): string | undefined;
+/** Convert an app task type to all matching HuggingFace pipeline names. */
+export declare function taskTypeToPipelines(taskType: string): string[];
+/** Reverse lookup: given a HuggingFace pipeline name, return all matching app task types. */
+export declare function pipelineToTaskTypes(pipeline: string): string[];
+//# sourceMappingURL=PipelineTaskMapping.d.ts.map

package/dist/provider-utils/PipelineTaskMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PipelineTaskMapping.d.ts","sourceRoot":"","sources":["../../src/provider-utils/PipelineTaskMapping.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4BH,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9D;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAI9D"}

package/dist/provider-utils/ToolCallParsers.d.ts

@@ -0,0 +1,252 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ToolCallingTaskInput } from "../task/ToolCallingTask";
+import type { ToolCalls } from "../task/ToolCallingUtils";
+export interface ToolCall {
+    readonly name: string;
+    readonly arguments: Record<string, unknown>;
+    readonly id: string | null;
+}
+export interface ToolCallParserResult {
+    readonly tool_calls: ReadonlyArray<ToolCall>;
+    readonly content: string;
+    readonly parser: string;
+}
+export interface ParseToolCallsOptions {
+    readonly tokenizer?: TokenizerLike | null;
+    readonly model?: string | null;
+    readonly parser?: string | null;
+}
+/**
+ * Minimal tokenizer shape used for model-family detection.
+ * Compatible with `PreTrainedTokenizer` from `@huggingface/transformers`.
+ */
+export interface TokenizerLike {
+    readonly config?: {
+        readonly name_or_path?: string;
+        readonly _name_or_path?: string;
+        readonly model_type?: string;
+    };
+    readonly name_or_path?: string;
+}
+export type ParserFn = (text: string) => ToolCallParserResult | null;
+/**
+ * Strip thinking blocks (`<think>...</think>`) and HFT special tokens
+ * (`<|im_end|>`, `<|end_of_turn|>`, etc.) from model output.
+ * Used to clean up content text returned alongside tool calls.
+ */
+export declare function stripModelArtifacts(text: string): string;
+/**
+ * Extract text from a content block that may be a string, array of content
+ * blocks, or other structure.
+ */
+export declare function extractMessageText(content: unknown): string;
+export declare function makeToolCall(name: string, args: Record<string, unknown>, id?: string | null): ToolCall;
+export declare function tryParseJson(text: string): unknown | undefined;
+export declare function parseJsonToolCallArray(jsonStr: string, nameKey?: string, argsKeys?: ReadonlyArray<string>): ReadonlyArray<ToolCall> | undefined;
+/**
+ * Parse key=value argument syntax used by Gorilla, NexusRaven, and Gemma.
+ * Handles quoted strings (`"val"`, `'val'`) and bare values.
+ */
+export declare function parseKeyValueArgs(argsStr: string): Record<string, unknown>;
+export declare function coerceArgValue(value: string): unknown;
+export declare function toolChoiceForcesToolCall(toolChoice: ToolCallingTaskInput["toolChoice"]): boolean;
+export declare function forcedToolSelection(input: ToolCallingTaskInput): string | undefined;
+export declare function resolveParsedToolName(name: string, input: ToolCallingTaskInput): string;
+/**
+ * Convert a low-level parser result to the workglow `ToolCalls` type.
+ * When `input` is provided, tool names are resolved against the available
+ * tools list (and forced selection is applied for unrecognized names).
+ */
+export declare function adaptParserResult(result: ToolCallParserResult, input?: ToolCallingTaskInput): {
+    text: string;
+    toolCalls: ToolCalls;
+};
+/**
+ * Llama 3.1/3.2/3.3 (Meta)
+ *
+ * Formats:
+ * - `<|python_tag|>{"name": "func", "parameters": {"arg": "val"}}`
+ * - `<function=func>{"arg": "val"}</function>` (3.2 lightweight 1B/3B)
+ * - `{"name": "func", "parameters": {...}}` (bare JSON)
+ */
+export declare const parseLlama: ParserFn;
+/**
+ * Mistral / Mixtral (Mistral AI)
+ *
+ * Format: `[TOOL_CALLS] [{"name": "func", "arguments": {...}, "id": "9charID"}]`
+ */
+export declare const parseMistral: ParserFn;
+/**
+ * Hermes (NousResearch) — also used by Qwen 2.5, Qwen 3, SOLAR, and others
+ *
+ * Format: `<tool_call>\n{"name": "func", "arguments": {...}}\n</tool_call>`
+ */
+export declare const parseHermes: ParserFn;
+/**
+ * Cohere Command-R / Command-R+
+ *
+ * Formats:
+ * - `Action: ```json\n[{"tool_name": "func", "parameters": {...}}]\n````
+ * - `Action: [{"tool_name": ..., "parameters": ...}]`
+ */
+export declare const parseCohere: ParserFn;
+/**
+ * DeepSeek V2/V3/V3.1
+ *
+ * V2 format: `<｜tool▁call▁begin｜>function_name\n```json\n{...}\n```<｜tool▁call▁end｜>`
+ * V3.1 format: `<｜tool▁calls▁begin｜><｜tool▁call▁begin｜>name<｜tool▁sep｜>{args}<｜tool▁call▁end｜><｜tool▁calls▁end｜>`
+ */
+export declare const parseDeepSeek: ParserFn;
+/**
+ * Phi-4 / Phi-4-mini (Microsoft)
+ *
+ * Format: `<|tool_calls|>[{"name": "func", "arguments": {...}}]<|/tool_calls|>`
+ */
+export declare const parsePhi: ParserFn;
+/**
+ * Phi-3 functools format (legacy)
+ *
+ * Format: `functools[{"name": "func", "arguments": {...}}]`
+ */
+export declare const parsePhiFunctools: ParserFn;
+/**
+ * InternLM 2 / 2.5 (Shanghai AI Lab)
+ *
+ * Format: `<|action_start|><|plugin|>\n{"name": "func", "parameters": {...}}<|action_end|>`
+ */
+export declare const parseInternLM: ParserFn;
+/**
+ * ChatGLM / GLM-4 (Zhipu AI)
+ *
+ * Format: function name followed by newline and JSON arguments.
+ * `func_name\n{"arg": "val"}`
+ */
+export declare const parseChatGLM: ParserFn;
+/**
+ * Functionary (MeetKai)
+ *
+ * Format: `>>>func_name\n{"arg": "val"}`
+ * Uses `all` as a special function name for regular text.
+ */
+export declare const parseFunctionary: ParserFn;
+/**
+ * Gorilla (Berkeley)
+ *
+ * Format: `<<function>>func_name(arg1="val1", arg2=val2)`
+ */
+export declare const parseGorilla: ParserFn;
+/**
+ * NexusRaven (Nexusflow)
+ *
+ * Format: `Call: func_name(arg1="val1", arg2=val2)\nThought: reasoning...`
+ */
+export declare const parseNexusRaven: ParserFn;
+/**
+ * xLAM (Salesforce)
+ *
+ * Format: Raw JSON array of tool calls: `[{"name": "func", "arguments": {...}}]`
+ * May be wrapped in ```json code blocks.
+ */
+export declare const parseXLAM: ParserFn;
+/**
+ * FireFunction (Fireworks AI)
+ *
+ * Format: `{"tool_calls": [{"function": {"name": "...", "arguments": "..."}}]}`
+ */
+export declare const parseFireFunction: ParserFn;
+/**
+ * Granite (IBM)
+ *
+ * Format: `<|tool_call|>{"name": "func", "arguments": {...}}<|/tool_call|>` or `<|end_of_text|>`
+ */
+export declare const parseGranite: ParserFn;
+/**
+ * Gemma 2/3 (Google) — prompt-based, no dedicated tokens
+ *
+ * Formats:
+ * - ```tool_code\nfunc(arg=val)\n```
+ * - `{"name": "func", "parameters": {...}}`
+ */
+export declare const parseGemma: ParserFn;
+/**
+ * LiquidAI LFM / LFM2 / LFM2.5
+ *
+ * Formats:
+ * - `<|tool_call_start|>[func_name(key="value", key2=123)]<|tool_call_end|>`
+ * - `[func_name(params={"key": "val"})]` (bracket-only, no special tokens)
+ * Parallel calls: `<|tool_call_start|>[func1(a="b"), func2(c="d")]<|tool_call_end|>`
+ * Uses Pythonic function call syntax.
+ */
+export declare const parseLiquid: ParserFn;
+/**
+ * Jamba (AI21)
+ *
+ * Format: `<tool_calls>[{"name": "func", "arguments": {...}}]</tool_calls>`
+ * Also supports OpenAI-compatible format via FireFunction fallback.
+ */
+export declare const parseJamba: ParserFn;
+/**
+ * Qwen 3.5 XML format
+ *
+ * Format:
+ * ```
+ * <tool_call>
+ * <function=function_name>
+ * <parameter=param_name>value</parameter>
+ * ...
+ * </function>
+ * </tool_call>
+ * ```
+ *
+ * The special `params` parameter may contain a JSON object to be spread
+ * into the arguments.
+ */
+export declare const parseQwen35Xml: ParserFn;
+/**
+ * Parse tool calls from LLM output text.
+ *
+ * Automatically detects the model family from the tokenizer and applies the
+ * appropriate parser(s). Falls back to trying all known formats if the model
+ * family cannot be determined.
+ */
+export declare function parseToolCalls(text: string, { tokenizer, model, parser }?: ParseToolCallsOptions): ToolCallParserResult;
+/**
+ * Check if text likely contains tool calls without fully parsing them.
+ * Faster than `parseToolCalls` when you only need presence detection.
+ */
+export declare function hasToolCalls(text: string): boolean;
+/**
+ * Get the list of available parser names.
+ */
+export declare function getAvailableParsers(): ReadonlyArray<string>;
+/**
+ * Get a model-family-specific generation prefix that guides the model to
+ * produce tool calls. Appended to the prompt before generation and prepended
+ * to the decoded output before parsing.
+ *
+ * @param family - The detected model family (from `getAvailableParsers` / `detectModelFamily`).
+ * @param forcedToolName - When a specific tool is forced, include its name in the prefix.
+ * @returns The prefix string, or `undefined` if no prefix is needed.
+ */
+export declare function getGenerationPrefix(family: string | null, _forcedToolName: string | undefined): string | undefined;
+/**
+ * Parse tool calls from model-generated text, returning the workglow `ToolCalls`
+ * type directly (with `input` field instead of `arguments`).
+ *
+ * Tries, in order:
+ * 1. `<tool_call>JSON</tool_call>` tags (Qwen/Hermes)
+ * 2. Bare JSON objects with `name` + `arguments`/`parameters` keys
+ * 3. `{"function": {"name": ..., "arguments": ...}}` format
+ *
+ * Returns both the cleaned text (with tool-call markup removed) and the parsed
+ * ToolCall array.
+ */
+export declare function parseToolCallsFromText(responseText: string): {
+    text: string;
+    toolCalls: ToolCalls;
+};
+//# sourceMappingURL=ToolCallParsers.d.ts.map

package/dist/provider-utils/ToolCallParsers.d.ts.map

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

package/dist/provider-utils/imageOutputHelpers.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Shared helpers for AI provider run/stream functions that produce image
+ * outputs. Each helper takes a wire form delivered by a provider SDK
+ * (encoded PNG/JPEG bytes, a base64 data URI, or a Blob) and returns a
+ * platform-appropriate {@link ImageValue}:
+ *
+ *   - Node / Bun: a {@link NodeImageValue} wrapping the encoded bytes plus
+ *     dimensions read from a sharp metadata probe. The encoded buffer is
+ *     retained as-is — no decode/re-encode round trip.
+ *   - Browser: a {@link BrowserImageValue} wrapping an `ImageBitmap`
+ *     created via `createImageBitmap(blob)`.
+ *
+ * Provider responses are always either PNG or JPEG. WebP and other formats
+ * are not produced by the supported endpoints and would need explicit
+ * mime detection if added later.
+ */
+import type { ImageValue, NodeImageFormat } from "@workglow/util/media";
+/**
+ * Wrap an encoded image buffer in a Node {@link ImageValue}. Reads
+ * width/height via a sharp metadata probe; no pixel decode is performed.
+ */
+export declare function pngBytesToImageValue(bytes: Uint8Array, format?: NodeImageFormat): Promise<ImageValue>;
+/**
+ * Decode a `data:<mime>;base64,...` URI into an {@link ImageValue}.
+ * On node, retains the encoded bytes via {@link pngBytesToImageValue}. In a
+ * browser environment, decodes via `createImageBitmap` instead.
+ */
+export declare function dataUriToImageValue(dataUri: string): Promise<ImageValue>;
+/**
+ * Convert a `Blob` (e.g. from the HF Inference SDK) into an
+ * {@link ImageValue}. On node uses sharp metadata to size the wrapper; in
+ * a browser uses `createImageBitmap` directly.
+ */
+export declare function blobToImageValue(blob: Blob): Promise<ImageValue>;
+/**
+ * Encode an inbound provider-input image into PNG bytes suitable for upload.
+ *
+ * Accepts the wire forms an `ImageValue` port may carry into a worker:
+ *   - {@link NodeImageValue} — encodes via sharp (raw-rgba) or returns bytes
+ *     directly if already PNG/JPEG.
+ *   - {@link BrowserImageValue} — encodes via canvas/`OffscreenCanvas`.
+ *   - `data:` URI string — legacy materialization form; base64-decodes the
+ *     payload.
+ *
+ * Always returns PNG bytes. Callers wrap the result in whatever transport
+ * shape the SDK expects (Blob, File, OpenAI.toFile, inlineData Part).
+ */
+export declare function imageValueToPngBytes(image: unknown): Promise<Uint8Array>;
+/**
+ * Encode an inbound provider-input image into a PNG `Blob` suitable for SDKs
+ * that accept Blob/File-shaped inputs (e.g. HuggingFace Transformers.js
+ * pipelines). Thin wrapper around {@link imageValueToPngBytes}.
+ */
+export declare function imageValueToBlob(image: unknown): Promise<Blob>;
+//# sourceMappingURL=imageOutputHelpers.d.ts.map

package/dist/provider-utils/imageOutputHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageOutputHelpers.d.ts","sourceRoot":"","sources":["../../src/provider-utils/imageOutputHelpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAqBxE;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,UAAU,EACjB,MAAM,GAAE,eAAuB,GAC9B,OAAO,CAAC,UAAU,CAAC,CAOrB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAwB9E;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAWtE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CA4D9E;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpE"}

package/dist/provider-utils/modelSearchQuery.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ModelSearchResultItem } from "../task/ModelSearchTask";
+/**
+ * Normalized search string for model search, or undefined when absent or whitespace-only.
+ */
+export declare function normalizedModelSearchQuery(query: string | undefined): string | undefined;
+/**
+ * Filter static/SDK model rows by optional query (substring match on label, value, or description).
+ */
+export declare function filterLabeledModelsByQuery<T extends {
+    label: string;
+    value: string;
+    description?: string;
+}>(models: ReadonlyArray<T>, query: string | undefined): T[];
+/**
+ * Filter {@link ModelSearchResultItem} rows by optional query.
+ */
+export declare function filterModelSearchResultsByQuery(results: ModelSearchResultItem[], query: string | undefined): ModelSearchResultItem[];
+//# sourceMappingURL=modelSearchQuery.d.ts.map

package/dist/provider-utils/modelSearchQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelSearchQuery.d.ts","sourceRoot":"","sources":["../../src/provider-utils/modelSearchQuery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGxF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAChE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,CAAC,EAAE,CAS1D;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,qBAAqB,EAAE,EAChC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,qBAAqB,EAAE,CASzB"}