@illalabs/sdk 0.3.3-canary.b7f69a88 → 0.4.0-canary.361ed2fa

package/dist/src/sdk.js

@@ -1,3 +1,5 @@
+import { normalizePrompt } from "./chat/utils/prompt.js";
+import { SdkEmptyToolsResultsError } from "./errors/SdkEmptyToolsResultsError.js";
 import { AsyncToolChecker, Chat, ContextManager, CoreApiProvider, InMemoryCache, Prompt, UserContextMissing, } from "./internal.js";
 /**
  * Error raised when attempting to interact with a chat that doesn't exist.
@@ -77,9 +79,13 @@ class IllaSDK {
     constructor(config, options) {
         this.coreApiProvider = new CoreApiProvider({
             baseURL: config.baseURL,
+            timeout: config.timeout,
             headers: {
                 "x-api-key": config.apiKey,
+                ...config.headers,
             },
+            httpClientFactory: config.httpClientFactory,
+            routes: config.routes,
         });
         if (options && options.contextManager) {
             this.contextManager = options.contextManager;
@@ -164,6 +170,7 @@ class IllaSDK {
                 coreApiProvider: this.coreApiProvider,
             }),
             personalityContext: options.personalityContext,
+            modelContext: options.modelContext,
         });
         this.chats.set(chat.getId(), chat);
         return chat;
@@ -173,15 +180,16 @@ class IllaSDK {
      * If a chatId is provided, the message will be sent to the existing chat.
      * If a chatId is not provided, a new chat will be created with the provided userContext.
      *
-     * @param msg - The message text to send
+     * @param msg - The message to send (can be a string or Prompt object)
      * @param context - Context containing either chatId for existing chat or userContext for new chat
+     * @param chatOptions - Optional chat configuration when creating a new chat
      * @returns {Promise<SendMessageResult>} The AI's response including chat ID, response text, and any pending tools
      *
      * @example
      * ```typescript
      * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
      *
-     * // Start a new conversation
+     * // Start a new conversation with a string
      * const result1 = await sdk.sendMessage(
      *   "What can you help me with?",
      *   { userContext: { address: "0x1234..." } }
@@ -189,11 +197,9 @@ class IllaSDK {
      * console.log(result1.response.text);
      * console.log("Chat ID:", result1.chatId);
      *
-     * // Continue the conversation using the chat ID
-     * const result2 = await sdk.sendMessage(
-     *   "I want to swap 1 ETH for USDC on Base",
-     *   { chatId: result1.chatId }
-     * );
+     * // Continue the conversation with a Prompt object
+     * const prompt = new Prompt({ text: "I want to swap 1 ETH for USDC on Base" });
+     * const result2 = await sdk.sendMessage(prompt, { chatId: result1.chatId });
      *
      * // Check if there are tools to execute
      * if (result2.response.pendingTools && result2.response.pendingTools.length > 0) {
@@ -201,16 +207,32 @@ class IllaSDK {
      * }
      * ```
      */
-    sendMessage(msg, context) {
-        if (context.chatId && this.chats.get(context.chatId) !== undefined) {
-            return this.chats.get(context.chatId).sendMessage(new Prompt({ text: msg }));
+    sendMessage(msg, context, chatOptions) {
+        const prompt = normalizePrompt(msg);
+        const chat = this.getOrCreateChat(context, chatOptions);
+        return chat.sendMessage(prompt);
+    }
+    /**
+     * Gets an existing chat or creates a new one if it doesn't exist.
+     *
+     * @param context - Context containing either chatId for existing chat or userContext for new chat
+     * @param chatOptions - Optional chat configuration when creating a new chat
+     * @returns {Chat} The chat instance
+     */
+    getOrCreateChat(context, chatOptions) {
+        if (context.chatId) {
+            const existingChat = this.chats.get(context.chatId);
+            if (existingChat) {
+                return existingChat;
+            }
         }
+        // If no chatId is provided, create a new chat
         if (!context.userContext) {
             throw new UserContextMissing();
         }
-        const chat = this.createChat({ userContext: context.userContext });
+        const chat = this.createChat({ userContext: context.userContext, ...chatOptions });
         this.chats.set(chat.getId(), chat);
-        return chat.sendMessage(new Prompt({ text: msg }));
+        return chat;
     }
     /**
      * Sends the result of a tool execution back to the AI. This method is used to complete
@@ -219,10 +241,12 @@ class IllaSDK {
      * @param chatId - The ID of the chat to send the tool result to
      * @param toolResult - The result of the tool execution
      * @returns {Promise<SendMessageResult>} The AI's response after processing the tool result
-     * @throws {Error} If the chat with the specified chatId is not found
+     * @throws {ChatNotFound} If the chat with the specified chatId is not found
      *
      * @example
      * ```typescript
+     * import { IllaToolOutcome, IllaToolError } from '@illalabs/interfaces';
+     *
      * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
      *
      * // Start a conversation that will request a tool execution
@@ -235,27 +259,30 @@ class IllaSDK {
      * if (result1.response.pendingTools && result1.response.pendingTools.length > 0) {
      *   const tool = result1.response.pendingTools[0];
      *
-     *   // Execute the tool (e.g., send a transaction)
-     *   const executionResult = await executeTool(tool);
+     *   // Execute the tool and create the outcome
+     *   let toolResult: IllaToolOutcome<unknown>;
+     *   try {
+     *     const executionResult = await executeTool(tool);
+     *     toolResult = IllaToolOutcome.success(tool.toolCallId, tool.toolName, executionResult);
+     *   } catch (error) {
+     *     toolResult = IllaToolOutcome.error(
+     *       tool.toolCallId,
+     *       tool.toolName,
+     *       IllaToolError.execution(tool.toolCallId, tool.toolName, error.message)
+     *     );
+     *   }
      *
-     *   // Send the result back to the ILLA
-     *   const toolResult: ToolResultType = {
-     *     toolCallId: tool.toolCallId,
-     *     toolName: tool.toolName,
-     *     result?: executionResult,
-     *     error?: executionResult.error,
-     *   };
-     *
-     *   const result2 = await sdk.sendToolResult(result1.chatId, toolResult);
+     *   // Send the result back to ILLA
+     *   const result2 = await sdk.sendToolResult(result1.chatId, toolResult.toJSON());
      *   console.log(result2.response.text); // ILLA's response after processing the tool result
      * }
      * ```
      */
     async sendToolResult(chatId, toolResult) {
-        if (this.chats.get(chatId) === undefined) {
+        if (!this.chats.has(chatId)) {
             throw new ChatNotFound(chatId);
         }
-        return await this.chats.get(chatId).sendMessage(new Prompt({ toolResult }));
+        return this.chats.get(chatId).sendMessage(new Prompt({ toolResult: [toolResult] }));
     }
     /**
      * Gets the messages for a given chat ID.
@@ -271,6 +298,265 @@ class IllaSDK {
         }
         return chat.messages;
     }
+    /**
+     * Appends messages to an existing chat's message history.
+     *
+     * @param chatId - The ID of the chat to append messages to
+     * @param messages - The messages to append to the chat history
+     * @throws {ChatNotFound} If the chat with the specified chatId is not found
+     *
+     * @example
+     * ```typescript
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * // Append synthetic messages for testing or prompting
+     * await sdk.appendMessages(chatId, [
+     *   { role: "user", content: "Previous context..." },
+     *   { role: "assistant", content: "Understood..." }
+     * ]);
+     * ```
+     */
+    async appendMessages(chatId, messages) {
+        if (!this.chats.has(chatId)) {
+            throw new ChatNotFound(chatId);
+        }
+        await this.contextManager.appendMessages(chatId, messages);
+    }
+    /**
+     * Clears the message history for a chat while keeping the chat instance.
+     *
+     * @param chatId - The ID of the chat to clear
+     * @throws {ChatNotFound} If the chat with the specified chatId is not found
+     *
+     * @example
+     * ```typescript
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * // Clear chat history to start fresh
+     * await sdk.clearContext(chatId);
+     * ```
+     */
+    async clearContext(chatId) {
+        if (!this.chats.has(chatId)) {
+            throw new ChatNotFound(chatId);
+        }
+        await this.contextManager.clearContext(chatId);
+    }
+    /**
+     * Deletes a chat and removes all associated data.
+     *
+     * @param chatId - The ID of the chat to delete
+     * @throws {ChatNotFound} If the chat with the specified chatId is not found
+     *
+     * @example
+     * ```typescript
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * // Clean up chat when done
+     * await sdk.deleteChat(chatId);
+     * ```
+     */
+    async deleteChat(chatId) {
+        if (!this.chats.has(chatId)) {
+            throw new ChatNotFound(chatId);
+        }
+        await this.contextManager.deleteContext(chatId);
+        this.chats.delete(chatId);
+    }
+    /**
+     * Sends multiple tool results back to the AI in a single request.
+     * This method is used when multiple tools need to be executed and their results
+     * sent back together.
+     *
+     * @param chatId - The ID of the chat to send the tool results to
+     * @param toolResults - Array of tool execution results
+     * @param options - Optional parameters including AbortSignal
+     * @returns {Promise<SendMessageResult>} The AI's response after processing all tool results
+     * @throws {ChatNotFound} If the chat with the specified chatId is not found
+     *
+     * @example
+     * ```typescript
+     * import { IllaToolOutcome, IllaToolError } from '@illalabs/interfaces';
+     *
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * // Execute multiple tools and send results together
+     * const toolResults = pendingTools.map(tool => {
+     *   try {
+     *     const result = executeToolSync(tool);
+     *     return IllaToolOutcome.success(tool.toolCallId, tool.toolName, result);
+     *   } catch (error) {
+     *     return IllaToolOutcome.error(
+     *       tool.toolCallId,
+     *       tool.toolName,
+     *       IllaToolError.execution(tool.toolCallId, tool.toolName, error.message)
+     *     );
+     *   }
+     * });
+     *
+     * const response = await sdk.sendToolResults(chatId, toolResults.map(r => r.toJSON()));
+     * ```
+     */
+    async sendToolResults(chatId, toolResults) {
+        if (!this.chats.has(chatId)) {
+            throw new ChatNotFound(chatId);
+        }
+        if (toolResults.length === 0) {
+            throw new SdkEmptyToolsResultsError({ chatId });
+        }
+        const chat = this.chats.get(chatId);
+        return await chat.sendMessage(new Prompt({ toolResult: toolResults }));
+    }
+    /**
+     * Subscribes to status updates for a long-running tool execution.
+     *
+     * @param params - Parameters identifying the tool execution to monitor
+     * @param callbacks - Event handlers for status changes and errors
+     * @param config - Optional polling configuration
+     * @returns {EventSubscription} Subscription handle to cancel monitoring
+     *
+     * @example
+     * ```typescript
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * const subscription = sdk.subscribeToToolStatus(
+     *   { toolName: "swap", protocol: "li.fi", args: txHash },
+     *   {
+     *     onStatusChange: (event) => console.log("Status:", event.status),
+     *     onError: (error) => console.error("Error:", error)
+     *   },
+     *   { interval: 2000, maxDuration: 300, maxRetries: 3 }
+     * );
+     *
+     * // Later, cancel the subscription
+     * subscription.unsubscribe();
+     * ```
+     */
+    subscribeToToolStatus(params, callbacks, config) {
+        const asyncToolChecker = new AsyncToolChecker({
+            coreApiProvider: this.coreApiProvider,
+        });
+        const defaultConfig = {
+            interval: config?.interval ?? 5000,
+            maxDuration: config?.maxDuration ?? 300,
+            retryThreshold: config?.retryThreshold ?? 30000,
+            maxRetries: config?.maxRetries ?? 3,
+        };
+        return asyncToolChecker.subscribe(params, callbacks, defaultConfig);
+    }
+    /**
+     * Awaits the completion of a long-running action triggered by a chat.
+     *
+     * @param chatId - The ID of the chat that triggered the action
+     * @param descriptor - Descriptor identifying the action to track
+     * @returns {Promise<AwaitActionResult>} The final status of the action
+     * @throws {ChatNotFound} If the chat with the specified chatId is not found
+     *
+     * @example
+     * ```typescript
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * const result = await sdk.awaitAction(chatId, {
+     *   toolName: "swap",
+     *   protocol: "li.fi",
+     *   args: { txHash: "0x..." }
+     * });
+     *
+     * if (result.isError) {
+     *   console.error("Action failed:", result.error);
+     * } else {
+     *   console.log("Action completed:", result.response);
+     * }
+     * ```
+     */
+    async awaitAction(chatId, descriptor) {
+        const chat = this.chats.get(chatId);
+        if (!chat) {
+            throw new ChatNotFound(chatId);
+        }
+        return chat.awaitAction(descriptor);
+    }
+    /**
+     * Gets the underlying Chat instance for advanced operations.
+     *
+     * @param chatId - The ID of the chat to retrieve
+     * @returns {Chat} The Chat instance
+     * @throws {ChatNotFound} If the chat with the specified chatId is not found
+     *
+     * @example
+     * ```typescript
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * const chat = sdk.getChat(chatId);
+     * // Now you can use advanced Chat methods directly
+     * const context = await chat.getContext();
+     * ```
+     */
+    getChat(chatId) {
+        const chat = this.chats.get(chatId);
+        if (!chat) {
+            throw new ChatNotFound(chatId);
+        }
+        return chat;
+    }
+    /**
+     * Gets all active chat IDs as an array.
+     * Alias for the chatIds getter property.
+     *
+     * @returns {string[]} Array of active chat IDs
+     *
+     * @example
+     * ```typescript
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * const ids = sdk.getChatIds();
+     * console.log("Active chats:", ids);
+     * ```
+     */
+    getChatIds() {
+        return this.chatIds;
+    }
+    /**
+     * Helper method to extract detailed response metadata from a SendMessageResult.
+     * Provides access to incompleteTools, toolErrors, and other response details.
+     *
+     * @param result - The SendMessageResult to extract metadata from
+     * @returns {ResponseMetadata} Extracted response metadata
+     *
+     * @example
+     * ```typescript
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * const result = await sdk.sendMessage("Hello", { chatId });
+     * const metadata = sdk.getResponseMetadata(result);
+     *
+     * if (metadata.incompleteTools?.length > 0) {
+     *   console.log("Incomplete tools:", metadata.incompleteTools);
+     * }
+     * if (metadata.toolErrors?.length > 0) {
+     *   console.log("Tool errors:", metadata.toolErrors);
+     * }
+     * ```
+     */
+    getResponseMetadata(result) {
+        if (result.response.isError) {
+            return {
+                isError: true,
+                error: result.response.error,
+            };
+        }
+        const data = result.response.data;
+        return {
+            isError: false,
+            text: data.text,
+            messages: data.messages,
+            pendingTools: data.pendingTools,
+            toolErrors: data.toolErrors,
+        };
+    }
+    isSuccessResponse(response) {
+        return "status" in response && response.status === 200;
+    }
 }
 /**
  * Exports the public API of the SDK.

package/dist/src/sdk.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@illalabs/sdk",
-  "version": "0.3.3-canary.b7f69a88",
+  "version": "0.4.0-canary.361ed2fa",
   "private": false,
   "description": "TypeScript SDK for interacting with Illa's Core API",
   "license": "MIT",
@@ -23,7 +23,7 @@
     "axios": "1.12.2",
     "uuid": "13.0.0",
     "viem": "2.37.13",
-    "@illalabs/interfaces": "0.3.0-canary.b7f69a88"
+    "@illalabs/interfaces": "0.3.0-canary.361ed2fa"
   },
   "devDependencies": {
     "zod": "4.1.12"

package/dist/src/chat/errors/ChatInvalidModelContext.d.ts

@@ -1,15 +0,0 @@
-/**
- * Error emitted when attempting to create a chat with an invalid model context.
- *
- * The error may include a `context` property with additional debugging information
- * such as the `modelContext` that was invalid.
- */
-export declare class ChatInvalidModelContext extends Error {
-    /**
-     * Creates a new {@link ChatInvalidModelContext} instance.
-     *
-     * @param context Additional context useful for debugging, e.g. `{ modelContext: unknown }`.
-     */
-    constructor(context?: unknown);
-}
-//# sourceMappingURL=ChatInvalidModelContext.d.ts.map

package/dist/src/chat/errors/ChatInvalidModelContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ChatInvalidModelContext.d.ts","sourceRoot":"","sources":["../../../../src/chat/errors/ChatInvalidModelContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAC9C;;;;OAIG;gBACgB,OAAO,CAAC,EAAE,OAAO;CAUvC"}

package/dist/src/chat/errors/ChatInvalidModelContext.js

@@ -1,24 +0,0 @@
-/**
- * Error emitted when attempting to create a chat with an invalid model context.
- *
- * The error may include a `context` property with additional debugging information
- * such as the `modelContext` that was invalid.
- */
-export class ChatInvalidModelContext extends Error {
-    /**
-     * Creates a new {@link ChatInvalidModelContext} instance.
-     *
-     * @param context Additional context useful for debugging, e.g. `{ modelContext: unknown }`.
-     */
-    constructor(context) {
-        super("Invalid model context.");
-        this.name = "ChatInvalidModelContext";
-        if (context !== undefined) {
-            Object.defineProperty(this, "context", {
-                value: context,
-                enumerable: true,
-            });
-        }
-    }
-}
-//# sourceMappingURL=ChatInvalidModelContext.js.map

package/dist/src/chat/errors/ChatInvalidModelContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ChatInvalidModelContext.js","sourceRoot":"","sources":["../../../../src/chat/errors/ChatInvalidModelContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAC9C;;;;OAIG;IACH,YAAmB,OAAiB;QAChC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE;gBACnC,KAAK,EAAE,OAAO;gBACd,UAAU,EAAE,IAAI;aACnB,CAAC,CAAC;QACP,CAAC;IACL,CAAC;CACJ"}

package/dist/src/prompt/utils/normalizeTextPrompt.d.ts

@@ -1,14 +0,0 @@
-import type { MessageType } from "@illalabs/interfaces";
-import type { PromptRole } from "../types.js";
-/**
- * Transforms a text prompt into both prompt and message formats for API communication.
- *
- * @param text The text prompt to normalize.
- * @param role The role to assign to the generated message.
- * @returns An object containing the prompt payload and formatted message.
- */
-export declare function normalizeTextPrompt(text: string, role: PromptRole): {
-    readonly prompt: string;
-    readonly message: MessageType;
-};
-//# sourceMappingURL=normalizeTextPrompt.d.ts.map

package/dist/src/prompt/utils/normalizeTextPrompt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalizeTextPrompt.d.ts","sourceRoot":"","sources":["../../../../src/prompt/utils/normalizeTextPrompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,GACjB;IACC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CACjC,CAaA"}

package/dist/src/prompt/utils/normalizeTextPrompt.js

@@ -1,22 +0,0 @@
-/**
- * Transforms a text prompt into both prompt and message formats for API communication.
- *
- * @param text The text prompt to normalize.
- * @param role The role to assign to the generated message.
- * @returns An object containing the prompt payload and formatted message.
- */
-export function normalizeTextPrompt(text, role) {
-    return {
-        prompt: text,
-        message: {
-            role,
-            content: [
-                {
-                    type: "text",
-                    text,
-                },
-            ],
-        },
-    };
-}
-//# sourceMappingURL=normalizeTextPrompt.js.map

package/dist/src/prompt/utils/normalizeTextPrompt.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalizeTextPrompt.js","sourceRoot":"","sources":["../../../../src/prompt/utils/normalizeTextPrompt.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAC/B,IAAY,EACZ,IAAgB;IAKhB,OAAO;QACH,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE;YACL,IAAI;YACJ,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAM;oBACZ,IAAI;iBACP;aACJ;SACJ;KACJ,CAAC;AACN,CAAC"}

package/dist/src/prompt/utils/normalizeToolResult.d.ts

@@ -1,14 +0,0 @@
-import type { MessageType, ToolResultType } from "@illalabs/interfaces";
-import type { PromptRole } from "../types.js";
-/**
- * Transforms a tool result into both prompt and message formats for API communication.
- *
- * @param toolResult The tool result to normalize.
- * @param role The role to assign to the generated message.
- * @returns An object containing the prompt payload and formatted message.
- */
-export declare function normalizeToolResult(toolResult: ToolResultType, role: PromptRole): {
-    readonly prompt: ToolResultType;
-    readonly message: MessageType;
-};
-//# sourceMappingURL=normalizeToolResult.d.ts.map

package/dist/src/prompt/utils/normalizeToolResult.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalizeToolResult.d.ts","sourceRoot":"","sources":["../../../../src/prompt/utils/normalizeToolResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,UAAU,GACjB;IACC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CACjC,CAkBA"}

package/dist/src/prompt/utils/normalizeToolResult.js

@@ -1,27 +0,0 @@
-import { cloneToolResult } from "./cloneToolResult.js";
-/**
- * Transforms a tool result into both prompt and message formats for API communication.
- *
- * @param toolResult The tool result to normalize.
- * @param role The role to assign to the generated message.
- * @returns An object containing the prompt payload and formatted message.
- */
-export function normalizeToolResult(toolResult, role) {
-    const promptPayload = cloneToolResult(toolResult);
-    return {
-        prompt: promptPayload,
-        message: {
-            role,
-            content: [
-                {
-                    type: "tool-result",
-                    toolCallId: promptPayload.toolCallId,
-                    toolName: promptPayload.toolName,
-                    result: promptPayload.result,
-                    ...(promptPayload.error !== undefined && { error: promptPayload.error }),
-                },
-            ],
-        },
-    };
-}
-//# sourceMappingURL=normalizeToolResult.js.map

package/dist/src/prompt/utils/normalizeToolResult.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalizeToolResult.js","sourceRoot":"","sources":["../../../../src/prompt/utils/normalizeToolResult.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAC/B,UAA0B,EAC1B,IAAgB;IAKhB,MAAM,aAAa,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAElD,OAAO;QACH,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE;YACL,IAAI;YACJ,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,aAAa;oBACnB,UAAU,EAAE,aAAa,CAAC,UAAU;oBACpC,QAAQ,EAAE,aAAa,CAAC,QAAQ;oBAChC,MAAM,EAAE,aAAa,CAAC,MAAM;oBAC5B,GAAG,CAAC,aAAa,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC;iBAC3E;aACJ;SACJ;KACJ,CAAC;AACN,CAAC"}