@illalabs/sdk 0.0.0 → 0.1.0-canary.9fc2c20f

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

@@ -0,0 +1,27 @@
+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

@@ -0,0 +1 @@
+{"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"}

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

@@ -0,0 +1,42 @@
+import type { CoreApiChatRequest, CoreApiChatResponse, LongPollingActionRequest, LongPollingActionResponse } from "@illalabs/interfaces";
+import type { AxiosInstance } from "axios";
+import type { ICoreApiProvider } from "../../interfaces/index.js";
+import type { CoreApiProviderConfig, CoreApiProviderRoutes } from "./interfaces/index.js";
+import type { RequestOptions } from "./types.js";
+/**
+ * Axios based Core API provider implementation
+ */
+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, routes }: CoreApiProviderConfig);
+    /**
+     * Sends a chat message to the Core API
+     */
+    sendMessage(body: CoreApiChatRequest["body"], options?: RequestOptions): Promise<CoreApiChatResponse>;
+    /**
+     * 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
+     */
+    protected buildRequestConfig(options: RequestOptions): {
+        signal?: AbortSignal;
+    };
+    private resolveBaseUrl;
+    private buildDefaultHeaders;
+    private ensureAuthHeaders;
+}
+//# sourceMappingURL=CoreApiProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,97 @@
+import axios from "axios";
+import { AsyncToolCheckerErrorHandler, ChatErrorHandler } from "./CoreApiErrorHandler.js";
+import { CoreApiAuthenticationMissing } from "./errors/index.js";
+/**
+ * Axios based Core API provider implementation
+ */
+export class CoreApiProvider {
+    /**
+     * Axios instance configured for the Core API
+     */
+    client;
+    /**
+     * Routes used by the provider when issuing requests.
+     */
+    routes;
+    /**
+     * @param config Core API provider configuration
+     */
+    constructor({ baseURL, timeout, headers, httpClientFactory, routes }) {
+        const authHeaders = this.ensureAuthHeaders(headers);
+        const resolveClientFactory = httpClientFactory ??
+            ((configuration) => axios.create(configuration));
+        this.client = resolveClientFactory({
+            baseURL: this.resolveBaseUrl(baseURL),
+            timeout,
+            headers: this.buildDefaultHeaders(authHeaders),
+        });
+        this.routes = {
+            chat: routes?.chat ?? "/api/v1/chat/",
+            actionStatus: routes?.actionStatus ?? "/api/v1/actions/check",
+        };
+    }
+    /**
+     * Sends a chat message to the Core API
+     */
+    async sendMessage(body, options = {}) {
+        const requestConfig = this.buildRequestConfig(options);
+        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);
+        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() {
+        return this.routes;
+    }
+    /**
+     * Builds request configuration shared across endpoints
+     */
+    buildRequestConfig(options) {
+        return {
+            signal: options.signal,
+        };
+    }
+    resolveBaseUrl(baseURL) {
+        // TODO: update base URL depending on final deployment
+        return baseURL ?? "https://api-dev.illalabs.io";
+    }
+    buildDefaultHeaders(headers) {
+        return {
+            "Content-Type": "application/json",
+            ...headers,
+        };
+    }
+    ensureAuthHeaders(headers) {
+        if (headers?.["x-api-key"] === undefined) {
+            throw new CoreApiAuthenticationMissing();
+        }
+        return headers;
+    }
+}
+//# sourceMappingURL=CoreApiProvider.js.map

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

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

package/dist/src/providers/coreApiProvider/errors/CoreApiAuthenticationMissing.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Raised when the API key is not provided
+ */
+export declare class CoreApiAuthenticationMissing extends Error {
+    readonly statusCode = 401;
+    constructor();
+}
+//# sourceMappingURL=CoreApiAuthenticationMissing.d.ts.map

package/dist/src/providers/coreApiProvider/errors/CoreApiAuthenticationMissing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreApiAuthenticationMissing.d.ts","sourceRoot":"","sources":["../../../../../src/providers/coreApiProvider/errors/CoreApiAuthenticationMissing.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACnD,SAAgB,UAAU,OAAO;;CAWpC"}

package/dist/src/providers/coreApiProvider/errors/CoreApiAuthenticationMissing.js

@@ -0,0 +1,15 @@
+/**
+ * Raised when the API key is not provided
+ */
+export class CoreApiAuthenticationMissing extends Error {
+    statusCode = 401;
+    constructor() {
+        const message = "Core API key is required";
+        super(message);
+        this.name = "CoreApiAuthenticationMissing";
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, CoreApiAuthenticationMissing);
+        }
+    }
+}
+//# sourceMappingURL=CoreApiAuthenticationMissing.js.map

package/dist/src/providers/coreApiProvider/errors/CoreApiAuthenticationMissing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreApiAuthenticationMissing.js","sourceRoot":"","sources":["../../../../../src/providers/coreApiProvider/errors/CoreApiAuthenticationMissing.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACnC,UAAU,GAAG,GAAG,CAAC;IAEjC;QACI,MAAM,OAAO,GAAG,0BAA0B,CAAC;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAE3C,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,4BAA4B,CAAC,CAAC;QAChE,CAAC;IACL,CAAC;CACJ"}

package/dist/src/providers/coreApiProvider/errors/CoreApiMethodNotImplemented.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Raised when a Core API provider method has not been implemented yet.
+ *
+ */
+export declare class CoreApiMethodNotImplemented extends Error {
+    readonly statusCode = 501;
+    constructor(method: string);
+}
+//# sourceMappingURL=CoreApiMethodNotImplemented.d.ts.map

package/dist/src/providers/coreApiProvider/errors/CoreApiMethodNotImplemented.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreApiMethodNotImplemented.d.ts","sourceRoot":"","sources":["../../../../../src/providers/coreApiProvider/errors/CoreApiMethodNotImplemented.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IAClD,SAAgB,UAAU,OAAO;gBAErB,MAAM,EAAE,MAAM;CAW7B"}

package/dist/src/providers/coreApiProvider/errors/CoreApiMethodNotImplemented.js

@@ -0,0 +1,19 @@
+/**
+ * Raised when a Core API provider method has not been implemented yet.
+ *
+ */
+export class CoreApiMethodNotImplemented extends Error {
+    statusCode = 501;
+    constructor(method) {
+        const message = `Core API provider method ${method} is not implemented`;
+        super(message);
+        this.name = "CoreApiMethodNotImplemented";
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, CoreApiMethodNotImplemented);
+        }
+        else {
+            this.stack = new Error(message).stack;
+        }
+    }
+}
+//# sourceMappingURL=CoreApiMethodNotImplemented.js.map

package/dist/src/providers/coreApiProvider/errors/CoreApiMethodNotImplemented.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreApiMethodNotImplemented.js","sourceRoot":"","sources":["../../../../../src/providers/coreApiProvider/errors/CoreApiMethodNotImplemented.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAClC,UAAU,GAAG,GAAG,CAAC;IAEjC,YAAY,MAAc;QACtB,MAAM,OAAO,GAAG,4BAA4B,MAAM,qBAAqB,CAAC;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAE1C,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC;QAC1C,CAAC;IACL,CAAC;CACJ"}

package/dist/src/providers/coreApiProvider/errors/index.d.ts

@@ -0,0 +1,3 @@
+export { CoreApiAuthenticationMissing } from "./CoreApiAuthenticationMissing.js";
+export { CoreApiMethodNotImplemented } from "./CoreApiMethodNotImplemented.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/providers/coreApiProvider/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/providers/coreApiProvider/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/src/providers/coreApiProvider/errors/index.js

@@ -0,0 +1,3 @@
+export { CoreApiAuthenticationMissing } from "./CoreApiAuthenticationMissing.js";
+export { CoreApiMethodNotImplemented } from "./CoreApiMethodNotImplemented.js";
+//# sourceMappingURL=index.js.map

package/dist/src/providers/coreApiProvider/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/providers/coreApiProvider/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC"}

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

@@ -0,0 +1,6 @@
+export * from "./CoreApiProvider.js";
+export type { ICoreApiProvider } from "../../interfaces/index.js";
+export type { CoreApiProviderConfig, CoreApiProviderRoutes } from "./interfaces/index.js";
+export type { HttpClientFactory, RequestOptions } from "./types.js";
+export * from "./errors/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/providers/coreApiProvider/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC1F,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACpE,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,3 @@
+export * from "./CoreApiProvider.js";
+export * from "./errors/index.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/providers/coreApiProvider/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AAIrC,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,29 @@
+import type { CoreApiAuthHeaders } from "@illalabs/interfaces";
+import type { HttpClientFactory } from "../types.js";
+import type { CoreApiProviderRoutes } from "./CoreApiProviderRoutes.interface.js";
+/**
+ * Core API provider configuration
+ */
+export interface CoreApiProviderConfig {
+    /**
+     * Base URL of the Core API
+     */
+    readonly baseURL?: string;
+    /**
+     * Request timeout in milliseconds
+     */
+    readonly timeout?: number;
+    /**
+     * Authentication headers
+     */
+    readonly headers?: CoreApiAuthHeaders;
+    /**
+     * Optional factory used to create a configured axios instance. Primarily used for testing.
+     */
+    readonly httpClientFactory?: HttpClientFactory;
+    /**
+     * Optional overrides for API routes used by the provider.
+     */
+    readonly routes?: CoreApiProviderRoutes;
+}
+//# sourceMappingURL=CoreApiProviderConfig.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CoreApiProviderConfig.interface.d.ts","sourceRoot":"","sources":["../../../../../src/providers/coreApiProvider/interfaces/CoreApiProviderConfig.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAE/C;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAC3C"}

package/dist/src/providers/coreApiProvider/interfaces/CoreApiProviderConfig.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CoreApiProviderConfig.interface.js.map

package/dist/src/providers/coreApiProvider/interfaces/CoreApiProviderConfig.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreApiProviderConfig.interface.js","sourceRoot":"","sources":["../../../../../src/providers/coreApiProvider/interfaces/CoreApiProviderConfig.interface.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,14 @@
+/**
+ * Optional route overrides used by the {@link CoreApiProvider}.
+ */
+export interface CoreApiProviderRoutes {
+    /**
+     * Path used when sending chat requests. Defaults to `/api/v1/chat/`.
+     */
+    readonly chat?: string;
+    /**
+     * Path used when polling asynchronous tool executions. Defaults to `/api/v1/actions/check`.
+     */
+    readonly actionStatus?: string;
+}
+//# sourceMappingURL=CoreApiProviderRoutes.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CoreApiProviderRoutes.interface.d.ts","sourceRoot":"","sources":["../../../../../src/providers/coreApiProvider/interfaces/CoreApiProviderRoutes.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAClC"}

package/dist/src/providers/coreApiProvider/interfaces/CoreApiProviderRoutes.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CoreApiProviderRoutes.interface.js.map

package/dist/src/providers/coreApiProvider/interfaces/CoreApiProviderRoutes.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreApiProviderRoutes.interface.js","sourceRoot":"","sources":["../../../../../src/providers/coreApiProvider/interfaces/CoreApiProviderRoutes.interface.ts"],"names":[],"mappings":""}

package/dist/src/providers/coreApiProvider/interfaces/index.d.ts

@@ -0,0 +1,3 @@
+export type { CoreApiProviderRoutes } from "./CoreApiProviderRoutes.interface.js";
+export type { CoreApiProviderConfig } from "./CoreApiProviderConfig.interface.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/providers/coreApiProvider/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/providers/coreApiProvider/interfaces/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/src/providers/coreApiProvider/interfaces/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/src/providers/coreApiProvider/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/providers/coreApiProvider/interfaces/index.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,16 @@
+import type { AxiosInstance, AxiosRequestConfig } from "axios";
+/**
+ * Factory for constructing configured Axios clients.
+ * Kept separate to enable reuse in tests and other providers.
+ */
+export type HttpClientFactory = (config?: AxiosRequestConfig) => AxiosInstance;
+/**
+ * Options for Core API requests
+ */
+export interface RequestOptions {
+    /**
+     * Abort signal used to cancel the request
+     */
+    readonly signal?: AbortSignal;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/providers/coreApiProvider/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAE/D;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,CAAC,EAAE,kBAAkB,KAAK,aAAa,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CACjC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/providers/coreApiProvider/types.ts"],"names":[],"mappings":""}

package/dist/src/providers/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./coreApiProvider/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC"}

package/dist/src/providers/index.js

@@ -0,0 +1,2 @@
+export * from "./coreApiProvider/index.js";
+//# sourceMappingURL=index.js.map

package/dist/src/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC"}