@illalabs/sdk 0.3.3-canary.ae6ff112 → 0.4.0-canary.1a04c18e

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

@@ -2,7 +2,7 @@ import type { CoreApiChatRequest, CoreApiChatResponse, LongPollingActionRequest,
 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";
+import type { RequestOptions, StreamingRequestOptions } from "./types.js";
 /**
  * Axios based Core API provider implementation
  */
@@ -15,14 +15,53 @@ export declare class CoreApiProvider implements ICoreApiProvider {
      * Routes used by the provider when issuing requests.
      */
     protected readonly routes: Required<CoreApiProviderRoutes>;
+    /**
+     * Base URL for the API (stored for streaming requests that use fetch)
+     */
+    private readonly baseUrl;
+    /**
+     * Auth headers for streaming requests that use fetch
+     */
+    private readonly authHeaders;
     /**
      * @param config Core API provider configuration
      */
     constructor({ baseURL, timeout, headers, httpClientFactory, routes }: CoreApiProviderConfig);
     /**
      * Sends a chat message to the Core API
+     *
+     * @param body - The request body
+     * @param options - Request options including abort signal and onRequestId callback
+     * @returns The API response
      */
     sendMessage(body: CoreApiChatRequest["body"], options?: RequestOptions): Promise<CoreApiChatResponse>;
+    /**
+     * Sends a chat message with streaming response via SSE.
+     *
+     * Instead of waiting for the full response, this method streams telemetry events
+     * in real-time as they occur during orchestration. The final result is delivered
+     * through the `onComplete` callback.
+     *
+     * This eliminates the need for a separate telemetry subscription - events and
+     * the result are delivered through a single HTTP connection.
+     *
+     * @param body - The request body (same as sendMessage)
+     * @param options - Streaming options with event callbacks
+     * @returns A promise that resolves when the stream ends (either successfully or with error)
+     *
+     * @example
+     * ```typescript
+     * await provider.sendMessageStreaming(
+     *   { prompt, userContext },
+     *   {
+     *     onEvent: (event) => console.log('Event:', event.type),
+     *     onComplete: (result) => console.log('Done:', result.text),
+     *     onError: (error) => console.error('Error:', error),
+     *   }
+     * );
+     * ```
+     */
+    sendMessageStreaming(body: CoreApiChatRequest["body"], options?: StreamingRequestOptions): Promise<void>;
     /**
      * Polls the Core API for transaction status
      */

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,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"}
+{"version":3,"file":"CoreApiProvider.d.ts","sourceRoot":"","sources":["../../../../src/providers/coreApiProvider/CoreApiProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIR,kBAAkB,EAClB,mBAAmB,EAEnB,wBAAwB,EACxB,yBAAyB,EAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,OAAO,CAAC;AAI/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,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAW7F;;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;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IAEjD;;OAEG;gBACS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAE,qBAAqB;IAqB3F;;;;;;OAMG;IACU,WAAW,CACpB,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAChC,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IAiC/B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACU,oBAAoB,CAC7B,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAChC,OAAO,GAAE,uBAA4B,GACtC,OAAO,CAAC,IAAI,CAAC;IA6EhB;;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,7 @@
 import axios from "axios";
+import { stringify } from "viem";
+import { generateUUID } from "../../chat/utils/index.js";
+import { parseSSEStream, StreamingHttpError, StreamingResponseBodyNull, StreamingServerError, } from "../../streaming/index.js";
 import { AsyncToolCheckerErrorHandler, ChatErrorHandler } from "./CoreApiErrorHandler.js";
 import { CoreApiAuthenticationMissing } from "./errors/index.js";
 /**
@@ -13,15 +16,25 @@ export class CoreApiProvider {
      * Routes used by the provider when issuing requests.
      */
     routes;
+    /**
+     * Base URL for the API (stored for streaming requests that use fetch)
+     */
+    baseUrl;
+    /**
+     * Auth headers for streaming requests that use fetch
+     */
+    authHeaders;
     /**
      * @param config Core API provider configuration
      */
     constructor({ baseURL, timeout, headers, httpClientFactory, routes }) {
         const authHeaders = this.ensureAuthHeaders(headers);
+        this.authHeaders = authHeaders;
+        this.baseUrl = this.resolveBaseUrl(baseURL);
         const resolveClientFactory = httpClientFactory ??
             ((configuration) => axios.create(configuration));
         this.client = resolveClientFactory({
-            baseURL: this.resolveBaseUrl(baseURL),
+            baseURL: this.baseUrl,
             timeout,
             headers: this.buildDefaultHeaders(authHeaders),
         });
@@ -32,11 +45,29 @@ export class CoreApiProvider {
     }
     /**
      * Sends a chat message to the Core API
+     *
+     * @param body - The request body
+     * @param options - Request options including abort signal and onRequestId callback
+     * @returns The API response
      */
     async sendMessage(body, options = {}) {
         const requestConfig = this.buildRequestConfig(options);
+        // Generate a requestId for telemetry if not already provided
+        const requestId = body.requestId ?? generateUUID();
+        const bodyWithRequestId = {
+            ...body,
+            requestId,
+        };
         try {
-            const response = await this.client.post(this.routes.chat, body, requestConfig);
+            const requestPromise = this.client.post(this.routes.chat, bodyWithRequestId, requestConfig);
+            // Notify caller of the requestId after request is initiated
+            // This allows connecting to telemetry stream while request is in flight
+            if (options.onRequestId) {
+                // Use queueMicrotask to ensure callback runs after request starts
+                // but before we block on await
+                queueMicrotask(() => options.onRequestId(requestId));
+            }
+            const response = await requestPromise;
             return response.data;
         }
         catch (error) {
@@ -44,6 +75,97 @@ export class CoreApiProvider {
             return errorResponse;
         }
     }
+    /**
+     * Sends a chat message with streaming response via SSE.
+     *
+     * Instead of waiting for the full response, this method streams telemetry events
+     * in real-time as they occur during orchestration. The final result is delivered
+     * through the `onComplete` callback.
+     *
+     * This eliminates the need for a separate telemetry subscription - events and
+     * the result are delivered through a single HTTP connection.
+     *
+     * @param body - The request body (same as sendMessage)
+     * @param options - Streaming options with event callbacks
+     * @returns A promise that resolves when the stream ends (either successfully or with error)
+     *
+     * @example
+     * ```typescript
+     * await provider.sendMessageStreaming(
+     *   { prompt, userContext },
+     *   {
+     *     onEvent: (event) => console.log('Event:', event.type),
+     *     onComplete: (result) => console.log('Done:', result.text),
+     *     onError: (error) => console.error('Error:', error),
+     *   }
+     * );
+     * ```
+     */
+    async sendMessageStreaming(body, options = {}) {
+        const requestId = body.requestId ?? generateUUID();
+        const bodyWithRequestId = {
+            ...body,
+            requestId,
+        };
+        // Notify caller of the requestId for API consistency with sendMessage
+        options.onRequestId?.(requestId);
+        const url = `${this.baseUrl}${this.routes.chat}`;
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Accept: "text/event-stream",
+                    ...this.authHeaders,
+                },
+                body: stringify(bodyWithRequestId),
+                signal: options.signal,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                let errorMessage;
+                try {
+                    const errorJson = JSON.parse(errorText);
+                    errorMessage = errorJson.message ?? `HTTP ${response.status}`;
+                }
+                catch {
+                    errorMessage = errorText || `HTTP ${response.status}`;
+                }
+                throw new StreamingHttpError(response.status, errorMessage);
+            }
+            if (!response.body) {
+                throw new StreamingResponseBodyNull();
+            }
+            // Parse SSE stream and dispatch events to callbacks
+            for await (const event of parseSSEStream(response.body, options.signal)) {
+                switch (event.type) {
+                    case "telemetry": {
+                        const telemetryEvent = event.data;
+                        options.onEvent?.(telemetryEvent);
+                        // Handle text_delta events for streaming text display
+                        if (telemetryEvent.type === "text_delta") {
+                            options.onTextDelta?.(telemetryEvent.data.delta);
+                        }
+                        break;
+                    }
+                    case "result":
+                        options.onComplete?.(event.data);
+                        break;
+                    case "error":
+                        options.onError?.(new StreamingServerError(event.data.requestId, event.data.data.message, event.data.data.code));
+                        break;
+                    case "stream_end":
+                        // Stream ended, nothing more to do
+                        break;
+                }
+            }
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            options.onError?.(err);
+            throw err;
+        }
+    }
     /**
      * Polls the Core API for transaction status
      */

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

@@ -1 +1 @@
-{"version":3,"file":"CoreApiProvider.js","sourceRoot":"","sources":["../../../../src/providers/coreApiProvider/CoreApiProvider.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAEjE;;GAEG;AACH,MAAM,OAAO,eAAe;IACxB;;OAEG;IACgB,MAAM,CAAgB;IAEzC;;OAEG;IACgB,MAAM,CAAkC;IAE3D;;OAEG;IACH,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAyB;QACvF,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAEpD,MAAM,oBAAoB,GACtB,iBAAiB;YACjB,CAAC,CAAC,aAAkC,EAAiB,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;QAEzF,IAAI,CAAC,MAAM,GAAG,oBAAoB,CAAC;YAC/B,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;YACrC,OAAO;YACP,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC;SACjD,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,GAAG;YACV,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,eAAe;YACrC,YAAY,EAAE,MAAM,EAAE,YAAY,IAAI,uBAAuB;SAChE,CAAC;IACN,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,WAAW,CACpB,IAAgC,EAChC,UAA0B,EAAE;QAE5B,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACnC,IAAI,CAAC,MAAM,CAAC,IAAI,EAChB,IAAI,EACJ,aAAa,CAChB,CAAC;YAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,aAAa,GAA6B,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/E,OAAO,aAAa,CAAC;QACzB,CAAC;IACL,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,gBAAgB,CACzB,MAA0C,EAC1C,UAA0B,EAAE;QAE5B,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAClC,IAAI,CAAC,MAAM,CAAC,YAAY,EACxB;gBACI,GAAG,aAAa;gBAChB,MAAM,EAAE;oBACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,IAAI,EAAE,MAAM,CAAC,IAAI;iBACpB;aACJ,CACJ,CAAC;YAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,aAAa,GACf,4BAA4B,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/C,OAAO,aAAa,CAAC;QACzB,CAAC;IACL,CAAC;IAED,kBAAkB;IACX,SAAS;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACO,kBAAkB,CAAC,OAAuB;QAChD,OAAO;YACH,MAAM,EAAE,OAAO,CAAC,MAAM;SACzB,CAAC;IACN,CAAC;IAEO,cAAc,CAAC,OAAyC;QAC5D,sDAAsD;QACtD,OAAO,OAAO,IAAI,6BAA6B,CAAC;IACpD,CAAC;IAEO,mBAAmB,CAAC,OAA2B;QACnD,OAAO;YACH,cAAc,EAAE,kBAAkB;YAClC,GAAG,OAAO;SACb,CAAC;IACN,CAAC;IAEO,iBAAiB,CAAC,OAA4B;QAClD,IAAI,OAAO,EAAE,CAAC,WAAW,CAAC,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,IAAI,4BAA4B,EAAE,CAAC;QAC7C,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ"}
+{"version":3,"file":"CoreApiProvider.js","sourceRoot":"","sources":["../../../../src/providers/coreApiProvider/CoreApiProvider.ts"],"names":[],"mappings":"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"}

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

@@ -1,6 +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 type { HttpClientFactory, RequestOptions, StreamingRequestOptions } from "./types.js";
 export * from "./errors/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC7F,cAAc,mBAAmB,CAAC"}

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

@@ -1,3 +1,4 @@
+import type { TelemetryEvent, ValidatedResultEventData } from "@illalabs/interfaces";
 import type { AxiosInstance, AxiosRequestConfig } from "axios";
 /**
  * Factory for constructing configured Axios clients.
@@ -12,5 +13,48 @@ export interface RequestOptions {
      * Abort signal used to cancel the request
      */
     readonly signal?: AbortSignal;
+    /**
+     * Callback invoked with the requestId after the request is initiated.
+     * This enables connecting to telemetry streams for real-time event updates.
+     * The callback is called asynchronously after the HTTP request starts.
+     */
+    readonly onRequestId?: (requestId: string) => void;
+}
+/**
+ * Options for streaming chat requests.
+ * Streaming mode sends telemetry events and the final result through a single SSE connection.
+ */
+export interface StreamingRequestOptions {
+    /**
+     * Abort signal used to cancel the request
+     */
+    readonly signal?: AbortSignal;
+    /**
+     * Callback invoked with the requestId after the request is initiated.
+     * Provides API consistency with the non-streaming sendMessage method.
+     * The callback is called synchronously before the fetch request starts.
+     */
+    readonly onRequestId?: (requestId: string) => void;
+    /**
+     * Called when a telemetry event is received during orchestration.
+     * Events are emitted in real-time as they occur on the server.
+     */
+    readonly onEvent?: (event: TelemetryEvent) => void;
+    /**
+     * Called when a text delta is received from the LLM.
+     * This enables real-time display of LLM-generated text as it streams in.
+     * @param delta - The text chunk received from the LLM
+     */
+    readonly onTextDelta?: (delta: string) => void;
+    /**
+     * Called when the orchestration completes successfully.
+     * The result contains the final chat response with messages, text, and pending tools.
+     * Type is inferred from resultEventDataSchema for compile-time safety.
+     */
+    readonly onComplete?: (result: ValidatedResultEventData) => void;
+    /**
+     * Called when an error occurs during streaming or orchestration.
+     */
+    readonly onError?: (error: Error) => void;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/providers/coreApiProvider/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrF,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;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACpC;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnD;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAEnD;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAE/C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAEjE;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC7C"}