@illalabs/sdk 0.1.0-canary.48bfe253 → 0.1.0-canary.9fc2c20f

package/README.md

@@ -12,6 +12,98 @@ pnpm add @illalabs/sdk
 
 ## 📖 Quick Start
 
+The SDK provides a simple interface (`IllaSDK`) that handles all the complexity of managing chats, context, and API communication:
+
+```typescript
+import { IllaSDK } from "@illalabs/sdk";
+
+// Initialize the SDK with your API key
+const sdk = new IllaSDK({
+    apiKey: "your-api-key",
+});
+
+// Start a conversation
+const result = await sdk.sendMessage("What is my wallet balance on Base?", {
+    userContext: { address: "0x..." },
+});
+
+console.log("Response:", result.response.text);
+console.log("Chat ID:", result.chatId);
+```
+
+### Multi-turn Conversations
+
+Continue a conversation by passing the chat ID from previous messages:
+
+```typescript
+// Start a new conversation
+const result1 = await sdk.sendMessage("What can you help me with?", {
+    userContext: { address: "0x..." },
+});
+
+// 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,
+});
+```
+
+### Handling Tool Execution
+
+When the AI needs to execute blockchain operations, it will return pending tools:
+
+```typescript
+const result = await sdk.sendMessage("Swap 1 ETH for USDC on Base", {
+    userContext: { address: "0x..." },
+});
+
+// Check if there are tools to execute
+if (result.response.pendingTools && result.response.pendingTools.length > 0) {
+    const tool = result.response.pendingTools[0];
+
+    // Execute the tool (e.g., send a transaction)
+    const executionResult = await executeTool(tool);
+
+    // Send the result back to the AI
+    const toolResult = {
+        toolCallId: tool.toolCallId,
+        toolName: tool.toolName,
+        result: executionResult,
+    };
+
+    const followUp = await sdk.sendToolResult(result.chatId, toolResult);
+    console.log(followUp.response.text);
+}
+```
+
+## 🔧 Advanced Usage
+
+For more control over the SDK's behavior, you can directly instantiate and configure individual components:
+
+### Custom Cache and Context Manager
+
+```typescript
+import { ContextManager, IllaSDK, InMemoryCache } from "@illalabs/sdk";
+
+// Create a custom cache
+const cache = new InMemoryCache();
+
+// Initialize SDK with custom cache
+const sdk = new IllaSDK({ apiKey: "your-api-key" }, { cache });
+
+// Or create a custom context manager with specific configuration
+const contextManager = IllaSDK.createNewContextManager(cache, {
+    defaultToolsConfig: {
+        autoRouter: { swapOrBridge: "lifi" },
+    },
+});
+
+const customSdk = new IllaSDK({ apiKey: "your-api-key" }, { contextManager });
+```
+
+### Direct Component Usage
+
+For maximum flexibility, you can use the SDK components directly:
+
 ```typescript
 import { Chat, ContextManager, CoreApiProvider, InMemoryCache, Prompt } from "@illalabs/sdk";
 
@@ -36,13 +128,35 @@ const chat = new Chat({
     },
 });
 
-// Send a message
+// Send a message using Prompt
 const prompt = new Prompt({ text: "What is my wallet balance on Base?" });
 const result = await chat.sendMessage(prompt);
 
 console.log("Response:", result.response.text);
 ```
 
+### Managing Multiple Chats
+
+```typescript
+import { IllaSDK } from "@illalabs/sdk";
+
+const sdk = new IllaSDK({ apiKey: "your-api-key" });
+
+// Create chat instances explicitly
+const chat1 = sdk.createChat({
+    userContext: { address: "0x123..." },
+});
+
+const chat2 = sdk.createChat({
+    userContext: { address: "0x456..." },
+    id: "custom-chat-id", // Optional: provide your own ID
+});
+
+// Get all active chat IDs
+const chatIds = sdk.chatIds;
+console.log("Active chats:", chatIds);
+```
+
 ## 🧪 Testing
 
 ### Unit Tests
@@ -118,6 +232,7 @@ E2E_API_KEY=your-api-key E2E_FORK_BASE_RPC_URL="https://mainnet.base.org" pnpm t
 
 ```plaintext
 src/
+├── sdk.ts             # Main SDK facade (IllaSDK class)
 ├── chat/              # Chat class and related utilities
 ├── context/           # Context management
 ├── caching/           # Cache implementations
@@ -128,8 +243,8 @@ src/
 
 test/
 ├── unit/              # Unit tests
-├── e2e/              # End-to-end tests organized by class
-└── utils/            # Shared test utilities and helpers
+├── e2e/               # End-to-end tests organized by class
+└── utils/             # Shared test utilities and helpers
 ```
 
 ## Contributing

package/dist/src/chat/Chat.d.ts

@@ -1,3 +1,4 @@
+import type { MessageHistoryType } from "@illalabs/interfaces";
 import type { AwaitableActionDescriptor, AwaitActionResult } from "../asyncToolChecker/index.js";
 import type { ChatContextSnapshot, ChatOptions, SendMessageResult } from "../interfaces/index.js";
 import type { Prompt } from "../prompt/index.js";
@@ -23,6 +24,7 @@ export declare class Chat {
      * @returns Chat identifier.
      */
     getId(): string;
+    get messages(): Promise<MessageHistoryType>;
     /**
      * Sends a prompt to the Core API and returns the processed result.
      *

package/dist/src/chat/Chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../../src/chat/Chat.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAER,yBAAyB,EACzB,iBAAiB,EACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACR,mBAAmB,EACnB,WAAW,EAGX,iBAAiB,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAA4B,MAAM,EAAc,MAAM,oBAAoB,CAAC;AAIvF;;GAEG;AACH,qBAAa,IAAI;IACb,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmB;IAEnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IAEjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAmB;IAErD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAEzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C;;;;OAIG;gBACgB,OAAO,EAAE,WAAW;IASvC;;;;OAIG;IACI,KAAK,IAAI,MAAM;IAItB;;;;;;OAMG;IACU,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkCpE,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAMhC;;;;;;;;;;;;OAYG;IACU,WAAW,CAAC,UAAU,EAAE,yBAAyB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAe3F;;;OAGG;IACU,UAAU,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAIvD;;;;OAIG;IACU,UAAU,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAIxE"}
+{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../../src/chat/Chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIR,kBAAkB,EAGrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAER,yBAAyB,EACzB,iBAAiB,EACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACR,mBAAmB,EACnB,WAAW,EAGX,iBAAiB,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAA4B,MAAM,EAAc,MAAM,oBAAoB,CAAC;AAIvF;;GAEG;AACH,qBAAa,IAAI;IACb,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmB;IAEnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IAEjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAmB;IAErD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAEzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C;;;;OAIG;gBACgB,OAAO,EAAE,WAAW;IASvC;;;;OAIG;IACI,KAAK,IAAI,MAAM;IAItB,IAAW,QAAQ,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAEjD;IAED;;;;;;OAMG;IACU,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkCpE,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAMhC;;;;;;;;;;;;OAYG;IACU,WAAW,CAAC,UAAU,EAAE,yBAAyB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAe3F;;;OAGG;IACU,UAAU,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAIvD;;;;OAIG;IACU,UAAU,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAIxE"}

package/dist/src/chat/Chat.js

@@ -31,6 +31,9 @@ export class Chat {
     getId() {
         return this.id;
     }
+    get messages() {
+        return this.contextManager.getContext(this.id).then((context) => context.messages);
+    }
     /**
      * Sends a prompt to the Core API and returns the processed result.
      *

package/dist/src/chat/Chat.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * Error raised when a user context is not provided when creating a new chat.
+ */
+export declare class UserContextMissing extends Error {
+    /**
+     * Creates a new {@link UserContextMissing} instance.
+     */
+    constructor();
+}
+//# sourceMappingURL=UserContextMissing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UserContextMissing.d.ts","sourceRoot":"","sources":["../../../../src/chat/errors/UserContextMissing.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IACzC;;OAEG;;CAKN"}

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

@@ -0,0 +1,13 @@
+/**
+ * Error raised when a user context is not provided when creating a new chat.
+ */
+export class UserContextMissing extends Error {
+    /**
+     * Creates a new {@link UserContextMissing} instance.
+     */
+    constructor() {
+        super("User context is required to create a new chat");
+        this.name = "UserContextMissing";
+    }
+}
+//# sourceMappingURL=UserContextMissing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UserContextMissing.js","sourceRoot":"","sources":["../../../../src/chat/errors/UserContextMissing.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACzC;;OAEG;IACH;QACI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACrC,CAAC;CACJ"}

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

@@ -1,2 +1,3 @@
 export { ChatAsyncToolCheckerUnavailable } from "./ChatAsyncToolCheckerUnavailable.js";
+export { UserContextMissing } from "./UserContextMissing.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/chat/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/chat/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

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

@@ -1,2 +1,3 @@
 export { ChatAsyncToolCheckerUnavailable } from "./ChatAsyncToolCheckerUnavailable.js";
+export { UserContextMissing } from "./UserContextMissing.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/chat/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/chat/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/src/external.d.ts

@@ -1,14 +1,7 @@
 /**
  * Public API exports for the Illa SDK package
  *
- * This file explicitly defines the public interface of the SDK.
- * Only exports listed here are considered part of the public API.
+ * This file exports the public API of the SDK.
  */
-export { InMemoryCache } from "./caching/index.js";
-export { Chat } from "./chat/index.js";
-export { ContextManager } from "./context/index.js";
-export { AsyncToolChecker } from "./asyncToolChecker/index.js";
-export type { CacheEntryOptions, ChatContextSnapshot, ContextManagerOptions, ICache, IContextManager, } from "./interfaces/index.js";
-export * from "./prompt/index.js";
-export * from "./providers/index.js";
+export * from "./sdk.js";
 //# sourceMappingURL=external.d.ts.map

package/dist/src/external.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../src/external.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EACR,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,MAAM,EACN,eAAe,GAClB,MAAM,uBAAuB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../src/external.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,UAAU,CAAC"}

package/dist/src/external.js

@@ -1,13 +1,7 @@
 /**
  * Public API exports for the Illa SDK package
  *
- * This file explicitly defines the public interface of the SDK.
- * Only exports listed here are considered part of the public API.
+ * This file exports the public API of the SDK.
  */
-export { InMemoryCache } from "./caching/index.js";
-export { Chat } from "./chat/index.js";
-export { ContextManager } from "./context/index.js";
-export { AsyncToolChecker } from "./asyncToolChecker/index.js";
-export * from "./prompt/index.js";
-export * from "./providers/index.js";
+export * from "./sdk.js";
 //# sourceMappingURL=external.js.map

package/dist/src/external.js.map

@@ -1 +1 @@
-{"version":3,"file":"external.js","sourceRoot":"","sources":["../../src/external.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAQ/D,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"external.js","sourceRoot":"","sources":["../../src/external.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,UAAU,CAAC"}

package/dist/src/internal.d.ts

@@ -8,7 +8,8 @@
 export * from "./caching/index.js";
 export * from "./chat/index.js";
 export * from "./context/index.js";
-export * from "./external.js";
 export * from "./prompt/index.js";
 export * from "./asyncToolChecker/index.js";
+export * from "./providers/index.js";
+export * from "./interfaces/index.js";
 //# sourceMappingURL=internal.d.ts.map

package/dist/src/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/src/internal.js

@@ -8,7 +8,8 @@
 export * from "./caching/index.js";
 export * from "./chat/index.js";
 export * from "./context/index.js";
-export * from "./external.js";
 export * from "./prompt/index.js";
 export * from "./asyncToolChecker/index.js";
+export * from "./providers/index.js";
+export * from "./interfaces/index.js";
 //# sourceMappingURL=internal.js.map

package/dist/src/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/src/providers/coreApiProvider/CoreApiErrorHandler.d.ts

@@ -0,0 +1,13 @@
+import type { CoreApiChatErrorResponse, LongPollingActionErrorResponse } from "@illalabs/interfaces";
+declare class ChatErrorHandler {
+    private static handleAxiosError;
+    private static handleUnknownError;
+    static handle(error: unknown): CoreApiChatErrorResponse;
+}
+declare class AsyncToolCheckerErrorHandler {
+    private static handleAxiosError;
+    private static handleUnknownError;
+    static handle(error: unknown): LongPollingActionErrorResponse;
+}
+export { ChatErrorHandler, AsyncToolCheckerErrorHandler };
+//# sourceMappingURL=CoreApiErrorHandler.d.ts.map

package/dist/src/providers/coreApiProvider/CoreApiErrorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreApiErrorHandler.d.ts","sourceRoot":"","sources":["../../../../src/providers/coreApiProvider/CoreApiErrorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,wBAAwB,EACxB,8BAA8B,EACjC,MAAM,sBAAsB,CAAC;AAG9B,cAAM,gBAAgB;IAClB,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAe/B,OAAO,CAAC,MAAM,CAAC,kBAAkB;WAQnB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB;CAKjE;AAED,cAAM,4BAA4B;IAC9B,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAe/B,OAAO,CAAC,MAAM,CAAC,kBAAkB;WAQnB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,8BAA8B;CAKvE;AAED,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,CAAC"}

package/dist/src/providers/coreApiProvider/CoreApiErrorHandler.js

@@ -0,0 +1,67 @@
+import { AxiosError } from "axios";
+class ChatErrorHandler {
+    static handleAxiosError(error) {
+        const body = error.response?.data;
+        if (body) {
+            return {
+                ...body,
+                statusCode: error.status ?? 500,
+            };
+        }
+        return {
+            name: error.name,
+            message: error.message,
+            statusCode: error.status ?? 500,
+            details: error.message,
+        };
+    }
+    static handleUnknownError(error) {
+        return {
+            name: error.name,
+            message: error.message,
+            statusCode: 500,
+            details: "SDK Call SendMessage failed",
+        };
+    }
+    static handle(error) {
+        if (error instanceof AxiosError)
+            return this.handleAxiosError(error);
+        if (error instanceof Error)
+            return this.handleUnknownError(error);
+        return this.handleUnknownError(new Error(String(error)));
+    }
+}
+class AsyncToolCheckerErrorHandler {
+    static handleAxiosError(error) {
+        const body = error.response?.data;
+        if (body) {
+            return {
+                ...body,
+                statusCode: error.status ?? 500,
+            };
+        }
+        return {
+            name: error.name,
+            message: error.message,
+            statusCode: error.status ?? 500,
+            details: error.message,
+        };
+    }
+    static handleUnknownError(error) {
+        return {
+            name: error.name,
+            message: error.message,
+            statusCode: 500,
+            details: "SDK AsyncToolChecker awaitTransaction failed",
+        };
+    }
+    static handle(error) {
+        if (error instanceof AxiosError)
+            return this.handleAxiosError(error);
+        if (error instanceof Error)
+            return this.handleUnknownError(error);
+        return this.handleUnknownError(new Error(String(error)));
+    }
+}
+export { ChatErrorHandler, AsyncToolCheckerErrorHandler };
+//# sourceMappingURL=CoreApiErrorHandler.js.map

package/dist/src/providers/coreApiProvider/CoreApiErrorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreApiErrorHandler.js","sourceRoot":"","sources":["../../../../src/providers/coreApiProvider/CoreApiErrorHandler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,MAAM,gBAAgB;IACV,MAAM,CAAC,gBAAgB,CAAC,KAAiB;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAgC,CAAC;QAC9D,IAAI,IAAI,EAAE,CAAC;YACP,OAAO;gBACH,GAAG,IAAI;gBACP,UAAU,EAAE,KAAK,CAAC,MAAM,IAAI,GAAG;aAClC,CAAC;QACN,CAAC;QACD,OAAO;YACH,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,MAAM,IAAI,GAAG;YAC/B,OAAO,EAAE,KAAK,CAAC,OAAO;SACzB,CAAC;IACN,CAAC;IACO,MAAM,CAAC,kBAAkB,CAAC,KAAY;QAC1C,OAAO;YACH,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,6BAA6B;SACzC,CAAC;IACN,CAAC;IACM,MAAM,CAAC,MAAM,CAAC,KAAc;QAC/B,IAAI,KAAK,YAAY,UAAU;YAAE,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACrE,IAAI,KAAK,YAAY,KAAK;YAAE,OAAO,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;CACJ;AAED,MAAM,4BAA4B;IACtB,MAAM,CAAC,gBAAgB,CAAC,KAAiB;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAsC,CAAC;QACpE,IAAI,IAAI,EAAE,CAAC;YACP,OAAO;gBACH,GAAG,IAAI;gBACP,UAAU,EAAE,KAAK,CAAC,MAAM,IAAI,GAAG;aAClC,CAAC;QACN,CAAC;QACD,OAAO;YACH,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,MAAM,IAAI,GAAG;YAC/B,OAAO,EAAE,KAAK,CAAC,OAAO;SACzB,CAAC;IACN,CAAC;IACO,MAAM,CAAC,kBAAkB,CAAC,KAAY;QAC1C,OAAO;YACH,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,8CAA8C;SAC1D,CAAC;IACN,CAAC;IACM,MAAM,CAAC,MAAM,CAAC,KAAc;QAC/B,IAAI,KAAK,YAAY,UAAU;YAAE,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACrE,IAAI,KAAK,YAAY,KAAK;YAAE,OAAO,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;CACJ;AAED,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,CAAC"}

package/dist/src/providers/coreApiProvider/CoreApiProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoreApiProvider.d.ts","sourceRoot":"","sources":["../../../../src/providers/coreApiProvider/CoreApiProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAER,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,OAAO,CAAC;AAG/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,KAAK,EAAqB,cAAc,EAAE,MAAM,YAAY,CAAC;AAGpE;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACpD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAEzC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAE3D;;OAEG;gBACS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAE,qBAAqB;IAmB3F;;OAEG;IACU,WAAW,CACpB,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAChC,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IAsB/B;;OAEG;IACU,gBAAgB,CACzB,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC,EAC1C,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,yBAAyB,CAAC;IA6BrC,kBAAkB;IACX,SAAS,IAAI,QAAQ,CAAC,qBAAqB,CAAC;IAInD;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE;IAM/E,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,iBAAiB;CAO5B"}
+{"version":3,"file":"CoreApiProvider.d.ts","sourceRoot":"","sources":["../../../../src/providers/coreApiProvider/CoreApiProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGR,kBAAkB,EAClB,mBAAmB,EAEnB,wBAAwB,EACxB,yBAAyB,EAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,OAAO,CAAC;AAG/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,KAAK,EAAqB,cAAc,EAAE,MAAM,YAAY,CAAC;AAIpE;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACpD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAEzC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAE3D;;OAEG;gBACS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAE,qBAAqB;IAmB3F;;OAEG;IACU,WAAW,CACpB,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAChC,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IAgB/B;;OAEG;IACU,gBAAgB,CACzB,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC,EAC1C,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,yBAAyB,CAAC;IAuBrC,kBAAkB;IACX,SAAS,IAAI,QAAQ,CAAC,qBAAqB,CAAC;IAInD;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE;IAM/E,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,iBAAiB;CAO5B"}

package/dist/src/providers/coreApiProvider/CoreApiProvider.js

@@ -1,4 +1,5 @@
 import axios from "axios";
+import { AsyncToolCheckerErrorHandler, ChatErrorHandler } from "./CoreApiErrorHandler.js";
 import { CoreApiAuthenticationMissing } from "./errors/index.js";
 /**
  * Axios based Core API provider implementation
@@ -34,45 +35,35 @@ export class CoreApiProvider {
      */
     async sendMessage(body, options = {}) {
         const requestConfig = this.buildRequestConfig(options);
-        const response = await this.client.post(this.routes.chat, body, requestConfig);
-        return response.data;
-        //TODO: Handle errors
-        // try{
-        //    this.client.post<CoreApiChatSuccessResponse>(...);
-        //    return response.data;
-        // }
-        // catch(error){
-        // All errors will end up here because Axios throws for 4XX and 5XX status codes
-        // if (error instanceof AxiosError) {
-        //    const errorResponse: CoreApiChatErrorResponse = ChatErrorHandler.handle(error);
-        //    return errorResponse;
-        // }
+        try {
+            const response = await this.client.post(this.routes.chat, body, requestConfig);
+            return response.data;
+        }
+        catch (error) {
+            const errorResponse = ChatErrorHandler.handle(error);
+            return errorResponse;
+        }
     }
     /**
      * Polls the Core API for transaction status
      */
     async awaitTransaction(params, options = {}) {
         const requestConfig = this.buildRequestConfig(options);
-        const response = await this.client.get(this.routes.actionStatus, {
-            ...requestConfig,
-            params: {
-                toolName: params.toolName,
-                protocol: params.protocol,
-                args: params.args,
-            },
-        });
-        return response.data;
-        //TODO: Handle errors
-        // try{
-        //    this.client.get<LongPollingActionSuccessResponse>(...);
-        //    return response.data;
-        // }
-        // catch(error){
-        // All errors will end up here because Axios throws for 4XX and 5XX status codes
-        // if (error instanceof AxiosError) {
-        //    const errorResponse: LongPollingActionErrorResponse = ExecutionCheckerErrorHandler.handle(error);
-        //    return errorResponse;
-        // }
+        try {
+            const response = await this.client.get(this.routes.actionStatus, {
+                ...requestConfig,
+                params: {
+                    toolName: params.toolName,
+                    protocol: params.protocol,
+                    args: params.args,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            const errorResponse = AsyncToolCheckerErrorHandler.handle(error);
+            return errorResponse;
+        }
     }
     /** @inheritdoc */
     getRoutes() {

package/dist/src/providers/coreApiProvider/CoreApiProvider.js.map

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

package/dist/src/sdk.d.ts

@@ -0,0 +1,288 @@
+import type { MessageHistoryType, ToolResultType, UserContext } from "@illalabs/interfaces";
+import type { CacheEntryOptions, ChatContextSnapshot, ContextManagerOptions, ICache, IContextManager, SendMessageResult } from "./internal.js";
+import { Chat, ContextManager } from "./internal.js";
+/**
+ * Configuration options for initializing the IllaSDK.
+ *
+ * @property apiKey - Your ILLA API key for authentication
+ * @property baseURL - Optional custom base URL for the ILLA API (defaults to production API)
+ */
+type illaSDKConfig = {
+    apiKey: string;
+    baseURL?: string;
+};
+/**
+ * Optional configuration for the IllaSDK instance.
+ * You can either provide a custom cache and context manager options,
+ * or provide a complete custom context manager implementation.
+ *
+ * @property cache - Optional custom cache implementation (used with contextManagerOptions)
+ * @property contextManagerOptions - Optional configuration for the default context manager
+ * @property contextManager - Optional custom context manager implementation (mutually exclusive with cache/contextManagerOptions)
+ */
+type illaSDKOptions = {
+    cache?: ICache;
+    contextManagerOptions?: ContextManagerOptions;
+    contextManager?: never;
+} | {
+    contextManager: IContextManager;
+    cache?: never;
+    contextManagerOptions?: never;
+};
+/**
+ * Options for creating a new chat instance.
+ *
+ * @property userContext - The user's context information { address: `0x${string}` }
+ * @property id - Optional custom ID for the chat. If not provided, a UUID will be generated
+ */
+type ChatOptions = {
+    userContext: UserContext;
+    id?: string;
+};
+/**
+ * Context for sending a message. Requires either a chatId (to use an existing chat)
+ * or a userContext (to create a new chat).
+ *
+ * @property chatId - ID of an existing chat to send the message to
+ * @property userContext - User context for creating a new chat (required if chatId is not provided)
+ */
+type SendMessageContext = {
+    chatId: string;
+    userContext?: never;
+} | {
+    chatId?: never;
+    userContext: UserContext;
+};
+/**
+ * Error raised when attempting to interact with a chat that doesn't exist.
+ *
+ * This typically occurs when using an invalid or expired chat ID with methods
+ * like {@link IllaSDK.sendToolResult}.
+ */
+declare class ChatNotFound extends Error {
+    /**
+     * The ID of the chat that was not found.
+     */
+    readonly chatId: string;
+    /**
+     * Creates a new {@link ChatNotFound} instance.
+     *
+     * @param chatId The ID of the chat that was not found.
+     * @param options Error options for error chaining.
+     */
+    constructor(chatId: string, options?: ErrorOptions);
+}
+/**
+ * The main entry point for interacting with the ILLA AI SDK.
+ * This class provides methods for creating and managing chat sessions,
+ * sending messages, handling tool results, and configuring async tool checkers.
+ *
+ * @example
+ * ```typescript
+ * import { IllaSDK } from '@illalabs/sdk';
+ *
+ * const sdk = new IllaSDK({
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * // Start a conversation
+ * const result = await sdk.sendMessage(
+ *   "What can you help me with?",
+ *   { userContext: { address: "0x1234..." } }
+ * );
+ *
+ * console.log(result.response.text);
+ * ```
+ */
+declare class IllaSDK {
+    private coreApiProvider;
+    private contextManager;
+    private chats;
+    /**
+     * Creates a new instance of the IllaSDK.
+     *
+     * @param config - Configuration object containing API key and optional base URL
+     * @param options - Optional configuration for cache and context manager
+     *
+     * @example
+     * ```typescript
+     * // Basic initialization
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * // With custom cache
+     * const cache = new InMemoryCache();
+     * const sdk = new IllaSDK(
+     *   { apiKey: 'your-api-key' },
+     *   { cache }
+     * );
+     *
+     * // With custom context manager
+     * const contextManager = new ContextManager(cache, { defaultToolsConfig: { autoRouter: { swapOrBridge: 'lifi' } } });
+     * const sdk = new IllaSDK(
+     *   { apiKey: 'your-api-key' },
+     *   { contextManager }
+     * );
+     * ```
+     */
+    constructor(config: illaSDKConfig, options?: illaSDKOptions);
+    /**
+     * Gets an array of all active chat IDs managed by this SDK instance.
+     *
+     * @returns {string[]} Array of chat IDs
+     *
+     * @example
+     * ```typescript
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * await sdk.sendMessage("Hello", { userContext: { address: "0x123" } });
+     * await sdk.sendMessage("Hi", { userContext: { address: "0x456" } });
+     *
+     * const chatIds = sdk.chatIds;
+     * console.log(chatIds); // ['chat-id-1', 'chat-id-2']
+     * ```
+     */
+    get chatIds(): string[];
+    /**
+     * Creates a new ContextManager instance. This is a factory method for creating
+     * context managers with custom configurations.
+     *
+     * @param cache - The cache implementation to use for storing context
+     * @param options - Configuration options for the context manager
+     * @returns {ContextManager} A new ContextManager instance
+     *
+     * @example
+     * ```typescript
+     * const cache = new InMemoryCache();
+     * const contextManager = IllaSDK.createNewContextManager(cache, {
+     *  defaultToolsConfig: {
+     *    autoRouter: { swapOrBridge: 'lifi' }
+     *  }
+     * });
+     *
+     * const sdk = new IllaSDK(
+     *   { apiKey: 'your-api-key' },
+     *   { contextManager }
+     * );
+     * ```
+     */
+    static createNewContextManager(cache: ICache, options: ContextManagerOptions): ContextManager;
+    /**
+     * Creates a new Chat instance with the specified options.
+     * The chat is automatically registered with this SDK instance.
+     *
+     * @param options - Options for creating the chat, including user context and optional ID
+     * @param contextManager - Optional custom context manager for this chat. If not provided, uses the SDK's default
+     * @returns {Chat} A new Chat instance
+     *
+     * @example
+     * ```typescript
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * // Create a new chat
+     * const chat = sdk.createChat({
+     *   userContext: { address: "0x1234..." }
+     * });
+     *
+     * // Send messages directly through the chat instance
+     * const result = await chat.sendMessage(new Prompt({ text: "Hello!" }));
+     * ```
+     */
+    createChat(options: ChatOptions, contextManager?: ContextManager): Chat;
+    /**
+     * Sends a message to a chat session. This is the primary method for interacting with the AI.
+     * 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 context - Context containing either chatId for existing chat or userContext for 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
+     * const result1 = await sdk.sendMessage(
+     *   "What can you help me with?",
+     *   { userContext: { address: "0x1234..." } }
+     * );
+     * 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 }
+     * );
+     *
+     * // Check if there are tools to execute
+     * if (result2.response.pendingTools && result2.response.pendingTools.length > 0) {
+     *   console.log("Tool to execute:", result2.response.pendingTools[0]);
+     * }
+     * ```
+     */
+    sendMessage(msg: string, context: SendMessageContext): Promise<SendMessageResult>;
+    /**
+     * Sends the result of a tool execution back to the AI. This method is used to complete
+     * the tool execution loop when the AI requests a tool to be executed.
+     *
+     * @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
+     *
+     * @example
+     * ```typescript
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * // Start a conversation that will request a tool execution
+     * const result1 = await sdk.sendMessage(
+     *   "Swap 1 ETH for USDC on Base",
+     *   { userContext: { address: "0x1234..." } }
+     * );
+     *
+     * // Check if there are pending tools to execute
+     * 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);
+     *
+     *   // 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);
+     *   console.log(result2.response.text); // ILLA's response after processing the tool result
+     * }
+     * ```
+     */
+    sendToolResult(chatId: string, toolResult: ToolResultType): Promise<SendMessageResult>;
+    /**
+     * Gets the messages for a given chat ID.
+     *
+     * @param chatId - The ID of the chat to get the messages for
+     * @returns {Promise<MessageHistoryType>} The messages for the chat
+     * @throws {ChatNotFound} If the chat with the specified chatId is not found
+     */
+    getMessages(chatId: string): Promise<MessageHistoryType>;
+}
+/**
+ * Exports the public API of the SDK.
+ * A user could import IllaSDK as a single entry point to the SDK.
+ * Or they could import the individual components of the SDK for advanced usage.
+ */
+export { IllaSDK, ChatNotFound };
+export { InMemoryCache } from "./caching/index.js";
+export { Prompt } from "./prompt/index.js";
+export { Chat } from "./chat/index.js";
+export { ContextManager } from "./context/index.js";
+export { AsyncToolChecker } from "./asyncToolChecker/index.js";
+export { CoreApiProvider } from "./providers/index.js";
+export { UserContextMissing } from "./chat/errors/index.js";
+export type { illaSDKConfig, ChatContextSnapshot, CacheEntryOptions, ICache, IContextManager, SendMessageContext, };
+//# sourceMappingURL=sdk.d.ts.map

package/dist/src/sdk.d.ts.map

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

package/dist/src/sdk.js

@@ -0,0 +1,287 @@
+import { AsyncToolChecker, Chat, ContextManager, CoreApiProvider, InMemoryCache, Prompt, UserContextMissing, } from "./internal.js";
+/**
+ * Error raised when attempting to interact with a chat that doesn't exist.
+ *
+ * This typically occurs when using an invalid or expired chat ID with methods
+ * like {@link IllaSDK.sendToolResult}.
+ */
+class ChatNotFound extends Error {
+    /**
+     * The ID of the chat that was not found.
+     */
+    chatId;
+    /**
+     * Creates a new {@link ChatNotFound} instance.
+     *
+     * @param chatId The ID of the chat that was not found.
+     * @param options Error options for error chaining.
+     */
+    constructor(chatId, options) {
+        super(`Chat with ID ${chatId} not found`, options);
+        this.name = "ChatNotFound";
+        this.chatId = chatId;
+    }
+}
+/**
+ * The main entry point for interacting with the ILLA AI SDK.
+ * This class provides methods for creating and managing chat sessions,
+ * sending messages, handling tool results, and configuring async tool checkers.
+ *
+ * @example
+ * ```typescript
+ * import { IllaSDK } from '@illalabs/sdk';
+ *
+ * const sdk = new IllaSDK({
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * // Start a conversation
+ * const result = await sdk.sendMessage(
+ *   "What can you help me with?",
+ *   { userContext: { address: "0x1234..." } }
+ * );
+ *
+ * console.log(result.response.text);
+ * ```
+ */
+class IllaSDK {
+    coreApiProvider;
+    contextManager;
+    chats = new Map();
+    /**
+     * Creates a new instance of the IllaSDK.
+     *
+     * @param config - Configuration object containing API key and optional base URL
+     * @param options - Optional configuration for cache and context manager
+     *
+     * @example
+     * ```typescript
+     * // Basic initialization
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * // With custom cache
+     * const cache = new InMemoryCache();
+     * const sdk = new IllaSDK(
+     *   { apiKey: 'your-api-key' },
+     *   { cache }
+     * );
+     *
+     * // With custom context manager
+     * const contextManager = new ContextManager(cache, { defaultToolsConfig: { autoRouter: { swapOrBridge: 'lifi' } } });
+     * const sdk = new IllaSDK(
+     *   { apiKey: 'your-api-key' },
+     *   { contextManager }
+     * );
+     * ```
+     */
+    constructor(config, options) {
+        this.coreApiProvider = new CoreApiProvider({
+            baseURL: config.baseURL,
+            headers: {
+                "x-api-key": config.apiKey,
+            },
+        });
+        if (options && options.contextManager) {
+            this.contextManager = options.contextManager;
+        }
+        else {
+            this.contextManager = new ContextManager(options?.cache ?? new InMemoryCache(), options?.contextManagerOptions ?? {});
+        }
+    }
+    /**
+     * Gets an array of all active chat IDs managed by this SDK instance.
+     *
+     * @returns {string[]} Array of chat IDs
+     *
+     * @example
+     * ```typescript
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * await sdk.sendMessage("Hello", { userContext: { address: "0x123" } });
+     * await sdk.sendMessage("Hi", { userContext: { address: "0x456" } });
+     *
+     * const chatIds = sdk.chatIds;
+     * console.log(chatIds); // ['chat-id-1', 'chat-id-2']
+     * ```
+     */
+    get chatIds() {
+        return Array.from(this.chats.keys());
+    }
+    /**
+     * Creates a new ContextManager instance. This is a factory method for creating
+     * context managers with custom configurations.
+     *
+     * @param cache - The cache implementation to use for storing context
+     * @param options - Configuration options for the context manager
+     * @returns {ContextManager} A new ContextManager instance
+     *
+     * @example
+     * ```typescript
+     * const cache = new InMemoryCache();
+     * const contextManager = IllaSDK.createNewContextManager(cache, {
+     *  defaultToolsConfig: {
+     *    autoRouter: { swapOrBridge: 'lifi' }
+     *  }
+     * });
+     *
+     * const sdk = new IllaSDK(
+     *   { apiKey: 'your-api-key' },
+     *   { contextManager }
+     * );
+     * ```
+     */
+    static createNewContextManager(cache, options) {
+        return new ContextManager(cache, options);
+    }
+    /**
+     * Creates a new Chat instance with the specified options.
+     * The chat is automatically registered with this SDK instance.
+     *
+     * @param options - Options for creating the chat, including user context and optional ID
+     * @param contextManager - Optional custom context manager for this chat. If not provided, uses the SDK's default
+     * @returns {Chat} A new Chat instance
+     *
+     * @example
+     * ```typescript
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * // Create a new chat
+     * const chat = sdk.createChat({
+     *   userContext: { address: "0x1234..." }
+     * });
+     *
+     * // Send messages directly through the chat instance
+     * const result = await chat.sendMessage(new Prompt({ text: "Hello!" }));
+     * ```
+     */
+    createChat(options, contextManager) {
+        const chat = new Chat({
+            coreApiProvider: this.coreApiProvider,
+            contextManager: contextManager ?? this.contextManager,
+            userContext: options.userContext,
+            id: options.id,
+            asyncToolChecker: new AsyncToolChecker({
+                coreApiProvider: this.coreApiProvider,
+            }),
+        });
+        this.chats.set(chat.getId(), chat);
+        return chat;
+    }
+    /**
+     * Sends a message to a chat session. This is the primary method for interacting with the AI.
+     * 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 context - Context containing either chatId for existing chat or userContext for 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
+     * const result1 = await sdk.sendMessage(
+     *   "What can you help me with?",
+     *   { userContext: { address: "0x1234..." } }
+     * );
+     * 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 }
+     * );
+     *
+     * // Check if there are tools to execute
+     * if (result2.response.pendingTools && result2.response.pendingTools.length > 0) {
+     *   console.log("Tool to execute:", result2.response.pendingTools[0]);
+     * }
+     * ```
+     */
+    sendMessage(msg, context) {
+        if (context.chatId && this.chats.get(context.chatId) !== undefined) {
+            return this.chats.get(context.chatId).sendMessage(new Prompt({ text: msg }));
+        }
+        if (!context.userContext) {
+            throw new UserContextMissing();
+        }
+        const chat = this.createChat({ userContext: context.userContext });
+        this.chats.set(chat.getId(), chat);
+        return chat.sendMessage(new Prompt({ text: msg }));
+    }
+    /**
+     * Sends the result of a tool execution back to the AI. This method is used to complete
+     * the tool execution loop when the AI requests a tool to be executed.
+     *
+     * @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
+     *
+     * @example
+     * ```typescript
+     * const sdk = new IllaSDK({ apiKey: 'your-api-key' });
+     *
+     * // Start a conversation that will request a tool execution
+     * const result1 = await sdk.sendMessage(
+     *   "Swap 1 ETH for USDC on Base",
+     *   { userContext: { address: "0x1234..." } }
+     * );
+     *
+     * // Check if there are pending tools to execute
+     * 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);
+     *
+     *   // 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);
+     *   console.log(result2.response.text); // ILLA's response after processing the tool result
+     * }
+     * ```
+     */
+    async sendToolResult(chatId, toolResult) {
+        if (this.chats.get(chatId) === undefined) {
+            throw new ChatNotFound(chatId);
+        }
+        return await this.chats.get(chatId).sendMessage(new Prompt({ toolResult }));
+    }
+    /**
+     * Gets the messages for a given chat ID.
+     *
+     * @param chatId - The ID of the chat to get the messages for
+     * @returns {Promise<MessageHistoryType>} The messages for the chat
+     * @throws {ChatNotFound} If the chat with the specified chatId is not found
+     */
+    async getMessages(chatId) {
+        const chat = this.chats.get(chatId);
+        if (!chat) {
+            throw new ChatNotFound(chatId);
+        }
+        return chat.messages;
+    }
+}
+/**
+ * Exports the public API of the SDK.
+ * A user could import IllaSDK as a single entry point to the SDK.
+ * Or they could import the individual components of the SDK for advanced usage.
+ */
+export { IllaSDK, ChatNotFound };
+export { InMemoryCache } from "./caching/index.js";
+export { Prompt } from "./prompt/index.js";
+export { Chat } from "./chat/index.js";
+export { ContextManager } from "./context/index.js";
+export { AsyncToolChecker } from "./asyncToolChecker/index.js";
+export { CoreApiProvider } from "./providers/index.js";
+export { UserContextMissing } from "./chat/errors/index.js";
+//# sourceMappingURL=sdk.js.map

package/dist/src/sdk.js.map

@@ -0,0 +1 @@
+{"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.1.0-canary.48bfe253",
+  "version": "0.1.0-canary.9fc2c20f",
   "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.1.0-canary.48bfe253"
+    "@illalabs/interfaces": "0.1.0-canary.9fc2c20f"
   },
   "devDependencies": {
     "zod": "4.1.12"