@workglow/ai 0.0.116 → 0.0.118

package/dist/task/AgentTypes.d.ts

@@ -0,0 +1,181 @@
+/**
+ * @license
+ * Copyright 2026 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DataPorts } from "@workglow/task-graph";
+import type { ToolCall, ToolCalls, ToolDefinition } from "./ToolCallingTask";
+/**
+ * A text content block within a chat message.
+ */
+export interface TextContentBlock {
+    readonly type: "text";
+    readonly text: string;
+}
+/**
+ * An image content block within a chat message.
+ */
+export interface ImageContentBlock {
+    readonly type: "image";
+    readonly mimeType: string;
+    readonly data: string;
+}
+/**
+ * An audio content block within a chat message.
+ */
+export interface AudioContentBlock {
+    readonly type: "audio";
+    readonly mimeType: string;
+    readonly data: string;
+}
+/**
+ * A tool-use content block within an assistant message.
+ * Represents the LLM requesting a tool invocation.
+ */
+export interface ToolUseContentBlock {
+    readonly type: "tool_use";
+    readonly id: string;
+    readonly name: string;
+    readonly input: Record<string, unknown>;
+}
+/**
+ * A tool-result content block within a tool message.
+ * Represents the result of executing a tool call.
+ */
+export interface ToolResultContentBlock {
+    readonly type: "tool_result";
+    readonly tool_use_id: string;
+    readonly content: string | ReadonlyArray<ToolResultInnerBlock>;
+    readonly is_error?: boolean;
+}
+/** Content blocks allowed in user messages */
+export type UserContentBlock = TextContentBlock | ImageContentBlock | AudioContentBlock;
+/** Content blocks allowed inside tool result content */
+export type ToolResultInnerBlock = TextContentBlock | ImageContentBlock | AudioContentBlock;
+export type ContentBlock = TextContentBlock | ImageContentBlock | AudioContentBlock | ToolUseContentBlock | ToolResultContentBlock;
+/**
+ * Provider-agnostic chat message for multi-turn conversations.
+ * Uses a discriminated union on `role` to enforce correct content types.
+ */
+export type ChatMessage = {
+    readonly role: "user";
+    readonly content: string | ReadonlyArray<UserContentBlock>;
+} | {
+    readonly role: "assistant";
+    readonly content: ReadonlyArray<TextContentBlock | ToolUseContentBlock>;
+} | {
+    readonly role: "tool";
+    readonly content: ReadonlyArray<ToolResultContentBlock>;
+};
+/**
+ * A tool backed by a Task in the TaskRegistry. Instantiated and run via
+ * `TaskRegistry.all.get(taskType)`. Optional `config` is passed to the
+ * task constructor for configurable tasks (e.g. `McpToolCallTask`,
+ * `JavaScriptTask`).
+ */
+export interface RegistryToolSource {
+    readonly type: "registry";
+    readonly definition: ToolDefinition;
+    readonly taskType: string;
+    /** Configuration values passed to the task constructor. */
+    readonly config?: DataPorts;
+}
+/**
+ * A user-provided tool with a custom executor function.
+ */
+export interface FunctionToolSource {
+    readonly type: "function";
+    readonly definition: ToolDefinition;
+    readonly run: (input: DataPorts) => Promise<DataPorts>;
+}
+export type ToolSource = RegistryToolSource | FunctionToolSource;
+export interface ToolResult {
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly output: DataPorts;
+    readonly isError: boolean;
+    /** Optional media content blocks to include alongside the JSON output. */
+    readonly mediaContent?: ReadonlyArray<ToolResultInnerBlock>;
+}
+/**
+ * Decision returned by the beforeToolCall hook.
+ * - `"allow"`: proceed with the tool call as-is
+ * - `"deny"`: skip the tool call and return an error to the LLM
+ * - `"modify"`: proceed with modified input
+ */
+export type ToolCallDecision = {
+    readonly action: "allow";
+} | {
+    readonly action: "deny";
+    readonly reason?: string;
+} | {
+    readonly action: "modify";
+    readonly input: Record<string, unknown>;
+};
+/**
+ * Action returned by the onToolError hook.
+ * - `"throw"`: report the error to the LLM (default when no hook)
+ * - `"result"`: use a fallback result instead of reporting the error
+ */
+export type ToolErrorAction = {
+    readonly action: "throw";
+} | {
+    readonly action: "result";
+    readonly output: Record<string, unknown>;
+};
+/**
+ * Action returned by the onIteration hook.
+ * - `"continue"`: proceed with the next LLM call
+ * - `"stop"`: end the agent loop and return current results
+ */
+export type IterationAction = {
+    readonly action: "continue";
+} | {
+    readonly action: "stop";
+};
+/**
+ * Lifecycle hooks for the AgentTask loop.
+ * All hooks are optional; the agent runs without intervention by default.
+ */
+export interface AgentHooks {
+    /** Called before each tool call. Can approve, deny, or modify the call. */
+    readonly beforeToolCall?: (call: ToolCall, source: ToolSource) => Promise<ToolCallDecision>;
+    /** Called after each successful tool call. Can transform the result. */
+    readonly afterToolCall?: (call: ToolCall, result: ToolResult) => Promise<ToolResult>;
+    /** Called when a tool call throws. Can provide a fallback result or re-throw. */
+    readonly onToolError?: (call: ToolCall, error: Error) => Promise<ToolErrorAction>;
+    /**
+     * Called at the start of each iteration, before calling the LLM.
+     * Can stop the loop or inspect state (e.g. for context trimming).
+     */
+    readonly onIteration?: (iteration: number, messages: ReadonlyArray<ChatMessage>, stats: {
+        readonly totalToolCalls: number;
+    }) => Promise<IterationAction>;
+}
+export declare function imageBlock(mimeType: string, data: string): ImageContentBlock;
+export declare function audioBlock(mimeType: string, data: string): AudioContentBlock;
+export declare function imageBlockFromDataUri(dataUri: string): ImageContentBlock;
+export declare function audioBlockFromDataUri(dataUri: string): AudioContentBlock;
+/**
+ * Creates a user message from a prompt string or array of content blocks.
+ */
+export declare function userMessage(prompt: string | ReadonlyArray<UserContentBlock>): ChatMessage;
+/**
+ * Creates an assistant message from text and optional tool calls.
+ */
+export declare function assistantMessage(text: string, toolCalls?: ToolCalls): ChatMessage;
+/**
+ * Creates a tool message from an array of tool results.
+ * When a result has `mediaContent`, emits content as an array of blocks
+ * instead of a plain JSON string.
+ */
+export declare function toolMessage(results: ReadonlyArray<ToolResult>): ChatMessage;
+/**
+ * Extracts all ToolDefinitions from an array of ToolSources.
+ */
+export declare function toolSourceDefinitions(sources: ReadonlyArray<ToolSource>): ToolDefinition[];
+/**
+ * Finds the ToolSource matching a tool call name.
+ */
+export declare function findToolSource(sources: ReadonlyArray<ToolSource>, name: string): ToolSource | undefined;
+//# sourceMappingURL=AgentTypes.d.ts.map

package/dist/task/AgentTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentTypes.d.ts","sourceRoot":"","sources":["../../src/task/AgentTypes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAM7E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAAC;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,8CAA8C;AAC9C,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAExF,wDAAwD;AACxD,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAE5F,MAAM,MAAM,YAAY,GACpB,gBAAgB,GAChB,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,sBAAsB,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAA;CAAE,GACrF;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,gBAAgB,GAAG,mBAAmB,CAAC,CAAC;CACzE,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAA;CAAE,CAAC;AAMvF;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CACxD;AAED,MAAM,MAAM,UAAU,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAMjE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;CAC7D;AAMD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAE3E;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAE5E;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5F;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE5F,wEAAwE;IACxE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAErF,iFAAiF;IACjF,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAElF;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,EACpC,KAAK,EAAE;QAAE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;KAAE,KACvC,OAAO,CAAC,eAAe,CAAC,CAAC;CAC/B;AAMD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAE5E;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAE5E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAGxE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAGxE;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,gBAAgB,CAAC,GAAG,WAAW,CAEzF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,WAAW,CAgBjF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,WAAW,CAiB3E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,cAAc,EAAE,CAE1F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,EAClC,IAAI,EAAE,MAAM,GACX,UAAU,GAAG,SAAS,CAExB"}

package/dist/task/AgentUtils.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IExecuteContext } from "@workglow/task-graph";
+import type { ServiceRegistry } from "@workglow/util";
+import type { AgentHooks, ToolResult, ToolSource } from "./AgentTypes";
+import type { ToolCall, ToolCalls, ToolDefinition } from "./ToolCallingTask";
+/**
+ * Builds an array of {@link ToolSource} entries from a unified tools list.
+ *
+ * Each entry is either:
+ * - A **string** — resolved from the TaskRegistry via {@link taskTypesToTools}.
+ * - A **{@link ToolDefinition}** object — dispatched based on its shape:
+ *   - Has `execute` function → {@link FunctionToolSource}
+ *   - Has a backing task in the task constructors (looked up by `name`) →
+ *     {@link RegistryToolSource} with optional `config` passed through
+ *   - Otherwise → {@link FunctionToolSource} that throws on invocation
+ *
+ * This mirrors the model resolution pattern: strings are convenient
+ * shorthand, objects give full control (including `config` for
+ * configurable tasks like `McpToolCallTask` or `JavaScriptTask`).
+ *
+ * The original order of entries in `tools` is preserved in the returned
+ * sources array. An optional `registry` can be provided to use a
+ * DI-scoped constructor map instead of the global TaskRegistry.
+ */
+export declare function buildToolSources(tools?: ReadonlyArray<string | ToolDefinition>, registry?: ServiceRegistry): ToolSource[];
+/**
+ * Executes a single tool call by dispatching to the appropriate handler
+ * based on the tool source type. Applies beforeToolCall, afterToolCall,
+ * and onToolError hooks when provided.
+ */
+export declare function executeToolCall(toolCall: ToolCall, sources: ReadonlyArray<ToolSource>, context: IExecuteContext, hooks?: AgentHooks): Promise<ToolResult>;
+/**
+ * Executes multiple tool calls with concurrency control.
+ *
+ * Uses the same shared-cursor worker pool pattern as IteratorTaskRunner:
+ * spawns N workers that pull from a shared cursor until all items are
+ * processed. Results are returned in the original order.
+ *
+ * @param maxConcurrency - Max parallel tool executions (default: 5)
+ */
+export declare function executeToolCalls(toolCalls: ToolCalls, sources: ReadonlyArray<ToolSource>, context: IExecuteContext, hooks?: AgentHooks, maxConcurrency?: number): Promise<ToolResult[]>;
+/**
+ * Checks whether a ToolCallingTask output contains any tool calls.
+ */
+export declare function hasToolCalls(toolCalls: unknown[] | undefined): boolean;
+//# sourceMappingURL=AgentUtils.d.ts.map

package/dist/task/AgentUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentUtils.d.ts","sourceRoot":"","sources":["../../src/task/AgentUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,KAAK,EACV,UAAU,EAGV,UAAU,EACV,UAAU,EACX,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAM3B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,cAAc,CAAC,EAC9C,QAAQ,CAAC,EAAE,eAAe,GACzB,UAAU,EAAE,CA+Dd;AAMD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,EAClC,OAAO,EAAE,eAAe,EACxB,KAAK,CAAC,EAAE,UAAU,GACjB,OAAO,CAAC,UAAU,CAAC,CAsFrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,EAClC,OAAO,EAAE,eAAe,EACxB,KAAK,CAAC,EAAE,UAAU,EAClB,cAAc,GAAE,MAAU,GACzB,OAAO,CAAC,UAAU,EAAE,CAAC,CA4BvB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,SAAS,GAAG,OAAO,CAEtE"}

package/dist/task/ChunkRetrievalTask.d.ts

@@ -265,10 +265,10 @@ export declare const chunkRetrieval: (input: ChunkRetrievalTaskInput, config?: J
     metadata: {
         [x: string]: unknown;
     }[];
+    query: string | TypedArray | (string | TypedArray)[];
     chunks: string[];
-    count: number;
     scores: number[];
-    query: string | TypedArray | (string | TypedArray)[];
+    count: number;
     chunk_ids: string[];
 }>;
 declare module "@workglow/task-graph" {

package/dist/task/ChunkVectorSearchTask.d.ts

@@ -123,10 +123,10 @@ export declare const vectorStoreSearch: (input: VectorStoreSearchTaskInput, conf
     metadata: {
         [x: string]: unknown;
     }[];
+    scores: number[];
+    count: number;
     ids: string[];
     vectors: import("@workglow/util").TypedArray[];
-    count: number;
-    scores: number[];
 }>;
 declare module "@workglow/task-graph" {
     interface Workflow {

package/dist/task/ChunkVectorUpsertTask.d.ts

@@ -107,8 +107,8 @@ export declare class ChunkVectorUpsertTask extends Task<VectorStoreUpsertTaskInp
     execute(input: VectorStoreUpsertTaskInput, context: IExecuteContext): Promise<VectorStoreUpsertTaskOutput>;
 }
 export declare const chunkVectorUpsert: (input: VectorStoreUpsertTaskInput, config?: JobQueueTaskConfig) => Promise<{
-    doc_id: string;
     count: number;
+    doc_id: string;
     chunk_ids: string[];
 }>;
 declare module "@workglow/task-graph" {

package/dist/task/HierarchicalChunkerTask.d.ts

@@ -275,7 +275,6 @@ export declare class HierarchicalChunkerTask extends Task<HierarchicalChunkerTas
     private collectAllText;
 }
 export declare const hierarchicalChunker: (input: HierarchicalChunkerTaskInput, config?: JobQueueTaskConfig) => Promise<{
-    doc_id: string;
     chunks: {
         [x: string]: unknown;
         doc_title?: string | undefined;
@@ -294,8 +293,9 @@ export declare const hierarchicalChunker: (input: HierarchicalChunkerTaskInput,
         nodePath: string[];
         depth: number;
     }[];
-    text: string[];
     count: number;
+    doc_id: string;
+    text: string[];
 }>;
 declare module "@workglow/task-graph" {
     interface Workflow {

package/dist/task/HierarchyJoinTask.d.ts

@@ -332,8 +332,8 @@ export declare const hierarchyJoin: (input: HierarchyJoinTaskInput, config?: Job
         depth: number;
     }[];
     chunks: string[];
-    count: number;
     scores: number[];
+    count: number;
     chunk_ids: string[];
 }>;
 declare module "@workglow/task-graph" {

package/dist/task/MessageConversion.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Shared message conversion utilities for converting provider-agnostic
+ * ChatMessage arrays to provider-specific formats.
+ *
+ * These are pure functions safe for both main-thread and worker contexts.
+ * Providers with unique requirements (Anthropic, Gemini, LlamaCpp)
+ * maintain their own conversion logic.
+ */
+import type { ToolCallingTaskInput } from "./ToolCallingTask";
+export interface OpenAICompatMessage {
+    role: string;
+    content: string | null | Array<{
+        type: string;
+        [key: string]: unknown;
+    }>;
+    tool_calls?: Array<{
+        id: string;
+        type: "function";
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+    tool_call_id?: string;
+}
+/**
+ * Converts ToolCallingTaskInput to OpenAI-compatible message format.
+ * Used by OpenAI and HuggingFace Inference providers.
+ *
+ * Multi-turn capable: preserves full tool call metadata across turns.
+ */
+export declare function toOpenAIMessages(input: ToolCallingTaskInput): OpenAICompatMessage[];
+export interface TextFlatMessage {
+    role: string;
+    content: string;
+}
+/**
+ * Converts ToolCallingTaskInput to a simplified text-only message format.
+ * Used by providers that don't natively support structured multi-turn
+ * tool calling (Ollama, HuggingFace Transformers).
+ *
+ * NOTE: This format discards tool_use blocks from assistant messages.
+ * The LLM will not see what tools it previously called. Multi-turn tool
+ * calling will have degraded quality on these providers.
+ */
+export declare function toTextFlatMessages(input: ToolCallingTaskInput): TextFlatMessage[];
+//# sourceMappingURL=MessageConversion.d.ts.map

package/dist/task/MessageConversion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageConversion.d.ts","sourceRoot":"","sources":["../../src/task/MessageConversion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAsB9D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IACzE,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/C,CAAC,CAAC;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,GAAG,mBAAmB,EAAE,CAuInF;AAMD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe,EAAE,CAqFjF"}

package/dist/task/QueryExpanderTask.d.ts

@@ -115,9 +115,9 @@ export declare class QueryExpanderTask extends Task<QueryExpanderTaskInput, Quer
     private preserveCapitalization;
 }
 export declare const queryExpander: (input: QueryExpanderTaskInput, config?: JobQueueTaskConfig) => Promise<{
-    count: number;
     query: string[];
     method: string;
+    count: number;
     originalQuery: string;
 }>;
 declare module "@workglow/task-graph" {

package/dist/task/RerankerTask.d.ts

@@ -204,9 +204,9 @@ export declare const reranker: (input: RerankerTaskInput, config?: JobQueueTaskC
         [x: string]: unknown;
     }[] | undefined;
     chunks: string[];
-    count: number;
     scores: number[];
     originalIndices: number[];
+    count: number;
 }>;
 declare module "@workglow/task-graph" {
     interface Workflow {