@illalabs/sdk 0.1.0 → 0.3.0-canary.eb4a29bf

package/README.md

@@ -0,0 +1,258 @@
+# @illalabs/sdk
+
+TypeScript SDK for building chat-based blockchain interactions with Illa's Core API.
+
+## 🚀 Installation
+
+```bash
+npm install @illalabs/sdk
+# or
+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";
+
+// Configure the API provider
+const provider = new CoreApiProvider({
+    baseURL: "https://api-dev.illalabs.io",
+    headers: {
+        "x-api-key": "your-api-key",
+    },
+});
+
+// Set up context management with caching
+const cache = new InMemoryCache();
+const contextManager = new ContextManager(cache);
+
+// Create a chat instance
+const chat = new Chat({
+    coreApiProvider: provider,
+    contextManager,
+    userContext: {
+        address: "0x...", // User's wallet address
+    },
+});
+
+// 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
+
+```bash
+pnpm test              # Run unit tests
+pnpm test:cov          # Run with coverage
+```
+
+### E2E Tests
+
+The SDK provides comprehensive E2E testing using Anvil to fork Base mainnet. This ensures tests run against a realistic blockchain environment that's compatible with the Core API (chain ID 8453).
+
+#### Prerequisites
+
+E2E tests **require** a Base RPC URL for forking:
+
+```bash
+# Set Base fork URL (required for E2E tests)
+export E2E_FORK_BASE_RPC_URL="https://mainnet.base.org"
+
+# Get a faster RPC from:
+# - Alchemy: https://www.alchemy.com/
+# - Infura: https://www.infura.io/
+# - QuickNode: https://www.quicknode.com/
+```
+
+#### Quick Start
+
+```bash
+# Mocked API + Anvil (Base fork)
+E2E_FORK_BASE_RPC_URL="https://mainnet.base.org" pnpm test:e2e:anvil
+
+# Real API + Anvil (Base fork) - full integration
+E2E_API_KEY=your-api-key E2E_FORK_BASE_RPC_URL="https://mainnet.base.org" pnpm test:e2e:anvil
+```
+
+#### Configuration Options
+
+**Required:**
+
+-   `E2E_FORK_BASE_RPC_URL`: Base mainnet RPC URL for forking (required for all E2E tests)
+
+**Optional:**
+
+-   `E2E_API_KEY`: API key for authentication (if not provided, uses mocked API)
+-   `E2E_BASE_URL`: Base URL for the API endpoint (default: `https://api-dev.illalabs.io`)
+-   `E2E_TEST_ADDRESS`: Test wallet address (default: `0x5527E7744df42A56ABE7451cbFEDa1601Fa35196`)
+
+**Note:** Environment variables use the `E2E_` prefix to avoid conflicts with vitest/vite built-in variables.
+
+## 📚 Documentation
+
+-   [Introduction](./docs/introduction.mdx)
+-   [Authentication](./docs/authentication.mdx)
+-   [Quickstart](./docs/quickstart.mdx)
+-   [Configuration](./docs/concepts/configuration.mdx)
+-   [Error Handling](./docs/concepts/error-handling.mdx)
+-   [TypeScript Support](./docs/concepts/typescript-support.mdx)
+-   [Testing Guide](./docs/testing.mdx)
+
+## Features
+
+-   **Chat-based Interface**: Intuitive conversational API for blockchain interactions
+-   **Context Management**: Automatic conversation history and state management
+-   **Multi-turn Conversations**: Seamless context preservation across messages
+-   **Session Persistence**: Resume conversations across different instances
+-   **Async Tool Monitoring**: Built-in support for long-running blockchain operations
+-   **TypeScript-first**: Full type safety with comprehensive type definitions
+-   **Flexible Caching**: Pluggable cache implementations (in-memory, Redis, etc.)
+
+## 📦 Project Structure
+
+```plaintext
+src/
+├── sdk.ts             # Main SDK facade (IllaSDK class)
+├── chat/              # Chat class and related utilities
+├── context/           # Context management
+├── caching/           # Cache implementations
+├── prompt/            # Prompt creation and formatting
+├── providers/         # API provider implementations
+├── interfaces/        # TypeScript interfaces
+└── asyncToolChecker/  # Tool execution monitoring
+
+test/
+├── unit/              # Unit tests
+├── e2e/               # End-to-end tests organized by class
+└── utils/             # Shared test utilities and helpers
+```
+
+## Contributing
+
+Wonderland is a team of top Web3 researchers, developers, and operators who believe that the future needs to be open-source, permissionless, and decentralized
+
+[DeFi sucks](https://defi.sucks), but Wonderland is here to make it better
+
+## 📄 License
+
+MIT - See [LICENSE](../../LICENSE) for details.

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;IAwCpE,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.
      *
@@ -51,7 +54,10 @@ export class Chat {
                 promptSnapshot,
                 messages: stagedMessages,
                 toolsConfig: originalContext.toolsConfig,
-                response,
+                response: {
+                    isError: true,
+                    error: response,
+                },
             };
         }
         await this.contextManager.setMessages(this.id, response.messages);
@@ -62,7 +68,10 @@ export class Chat {
             promptSnapshot,
             messages: response.messages,
             toolsConfig: originalContext.toolsConfig,
-            response,
+            response: {
+                data: response,
+                isError: false,
+            },
         };
     }
     buildRequest(context, normalizedPrompt) {

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

@@ -1 +1 @@
-{"version":3,"file":"Chat.js","sourceRoot":"","sources":["../../../src/chat/Chat.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;GAEG;AACH,MAAM,OAAO,IAAI;IACI,EAAE,CAAS;IAEX,eAAe,CAAmB;IAElC,cAAc,CAAkB;IAEhC,gBAAgB,CAAoB;IAEpC,WAAW,CAAa;IAExB,WAAW,CAAc;IAE1C;;;;OAIG;IACH,YAAmB,OAAoB;QACnC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;QACjD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,MAAM,CAAC;QACjD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACI,KAAK;QACR,OAAO,IAAI,CAAC,EAAE,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,WAAW,CAAC,MAAc;QACnC,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,gBAAgB,GAAG,MAAM,CAAC,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxE,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,YAAY,CACxD,eAAe,EACf,gBAAgB,CACnB,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAE9D,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,OAAO;gBACH,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,cAAc;gBACd,QAAQ,EAAE,cAAc;gBACxB,WAAW,EAAE,eAAe,CAAC,WAAW;gBACxC,QAAQ;aACX,CAAC;QACN,CAAC;QAED,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClE,MAAM,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;QAE/E,OAAO;YACH,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,cAAc;YACd,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,WAAW,EAAE,eAAe,CAAC,WAAW;YACxC,QAAQ;SACX,CAAC;IACN,CAAC;IAEO,YAAY,CAChB,OAA4B,EAC5B,gBAA0C;QAM1C,OAAO;YACH,IAAI,EAAE;gBACF,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,MAAM,EAAE,gBAAgB,CAAC,OAAO;aACnC;YACD,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;SACnC,CAAC;IACN,CAAC;IAEO,MAAM,CAAC,iBAAiB,CAC5B,QAA6B;QAE7B,OAAO,QAAQ,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,KAAK,CAAC,WAAW,CAAC,UAAqC;QAC1D,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,+BAA+B,CAAC;gBACtC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE;gBACpB,UAAU;aACb,CAAC,CAAC;QACP,CAAC;QAED,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;YAC/B,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,UAAU,EAAE,UAAU,CAAC,IAAI;SAC9B,CAAC,CAAC;IACP,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,UAAU;QACnB,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,UAAU,CAAC,QAA6B;QACjD,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClE,MAAM,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC5E,CAAC;CACJ"}
+{"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/interfaces/chat.interface.d.ts

@@ -1,4 +1,4 @@
-import type { CoreApiChatBodyRequest, CoreApiChatResponse, MessageHistoryType, ToolAutorouterRequest, UserContext } from "@illalabs/interfaces";
+import type { CoreApiChatBodyRequest, CoreApiChatErrorResponse, CoreApiChatSuccessResponse, MessageHistoryType, ToolAutorouterRequest, UserContext } from "@illalabs/interfaces";
 import type { AsyncToolChecker } from "../asyncToolChecker/index.js";
 import type { PromptRole, PromptSnapshot } from "../prompt/index.js";
 import type { IContextManager } from "./contextManager.interface.js";
@@ -62,7 +62,13 @@ export interface SendMessageResult {
     /**
      * Raw response from the Core API.
      */
-    readonly response: CoreApiChatResponse;
+    readonly response: {
+        readonly data: CoreApiChatSuccessResponse;
+        readonly isError: false;
+    } | {
+        readonly isError: true;
+        readonly error: CoreApiChatErrorResponse;
+    };
 }
 /**
  * Payload structure for chat requests sent to the Core API.

package/dist/src/interfaces/chat.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/chat.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAElD;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACrC"}
+{"version":3,"file":"chat.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/chat.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAElD;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EACX;QACI,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;QAC1C,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;KAC3B,GACD;QACI,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;KAC5C,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACrC"}

package/dist/src/interfaces/coreApiProvider.interface.d.ts

@@ -1,5 +1,5 @@
 import type { CoreApiChatRequest, CoreApiChatResponse, LongPollingActionRequest, LongPollingActionResponse } from "@illalabs/interfaces";
-import type { RequestOptions } from "../providers/coreApiProvider/index.js";
+import type { CoreApiProviderRoutes, RequestOptions } from "../providers/coreApiProvider/index.js";
 /**
  * Contract for the Core API provider
  */
@@ -22,5 +22,11 @@ export interface ICoreApiProvider {
      * @returns Core API execution checker response
      */
     awaitTransaction(request: LongPollingActionRequest["params"], options?: RequestOptions): Promise<LongPollingActionResponse>;
+    /**
+     * Retrieves the configured routes for the Core API endpoints used by the provider.
+     *
+     * @returns Route configuration including chat and action status paths.
+     */
+    getRoutes(): Required<CoreApiProviderRoutes>;
 }
 //# sourceMappingURL=coreApiProvider.interface.d.ts.map

package/dist/src/interfaces/coreApiProvider.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coreApiProvider.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/coreApiProvider.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;;;;OAOG;IACH,WAAW,CACP,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,EACnC,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC;;;;;;;OAOG;IACH,gBAAgB,CACZ,OAAO,EAAE,wBAAwB,CAAC,QAAQ,CAAC,EAC3C,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACzC"}
+{"version":3,"file":"coreApiProvider.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/coreApiProvider.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEnG;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;;;;OAOG;IACH,WAAW,CACP,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,EACnC,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC;;;;;;;OAOG;IACH,gBAAgB,CACZ,OAAO,EAAE,wBAAwB,CAAC,QAAQ,CAAC,EAC3C,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAEtC;;;;OAIG;IACH,SAAS,IAAI,QAAQ,CAAC,qBAAqB,CAAC,CAAC;CAChD"}

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

@@ -1,7 +1,8 @@
 import type { CoreApiChatRequest, CoreApiChatResponse, LongPollingActionRequest, LongPollingActionResponse } from "@illalabs/interfaces";
 import type { AxiosInstance } from "axios";
 import type { ICoreApiProvider } from "../../interfaces/index.js";
-import type { CoreApiProviderConfig, RequestOptions } from "./index.js";
+import type { CoreApiProviderConfig, CoreApiProviderRoutes } from "./interfaces/index.js";
+import type { RequestOptions } from "./types.js";
 /**
  * Axios based Core API provider implementation
  */
@@ -10,10 +11,14 @@ export declare class CoreApiProvider implements ICoreApiProvider {
      * Axios instance configured for the Core API
      */
     protected readonly client: AxiosInstance;
+    /**
+     * Routes used by the provider when issuing requests.
+     */
+    protected readonly routes: Required<CoreApiProviderRoutes>;
     /**
      * @param config Core API provider configuration
      */
-    constructor({ baseURL, timeout, headers, httpClientFactory }: CoreApiProviderConfig);
+    constructor({ baseURL, timeout, headers, httpClientFactory, routes }: CoreApiProviderConfig);
     /**
      * Sends a chat message to the Core API
      */
@@ -22,6 +27,8 @@ export declare class CoreApiProvider implements ICoreApiProvider {
      * Polls the Core API for transaction status
      */
     awaitTransaction(params: LongPollingActionRequest["params"], options?: RequestOptions): Promise<LongPollingActionResponse>;
+    /** @inheritdoc */
+    getRoutes(): Required<CoreApiProviderRoutes>;
     /**
      * Builds request configuration shared across endpoints
      */