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

package/dist/src/asyncToolChecker/errors/AsyncToolCheckerTimeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncToolCheckerTimeout.d.ts","sourceRoot":"","sources":["../../../../src/asyncToolChecker/errors/AsyncToolCheckerTimeout.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAC9C;;OAEG;IACH,SAAgB,WAAW,EAAE,MAAM,CAAC;IAEpC;;;;;OAKG;gBACgB,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKjE"}

package/dist/src/asyncToolChecker/errors/AsyncToolCheckerTimeout.js

@@ -0,0 +1,21 @@
+/**
+ * Error emitted when an asynchronous polling operation exceeds the configured maximum duration.
+ */
+export class AsyncToolCheckerTimeout extends Error {
+    /**
+     * Maximum duration, expressed in seconds, that was exceeded.
+     */
+    maxDuration;
+    /**
+     * Creates a new {@link AsyncToolCheckerTimeout} instance.
+     *
+     * @param maxDuration Maximum duration, in seconds, permitted for the polling loop.
+     * @param options Error options.
+     */
+    constructor(maxDuration, options) {
+        super(`Async tool checker exceeded maximum duration of ${maxDuration} seconds.`, options);
+        this.name = "AsyncToolCheckerTimeout";
+        this.maxDuration = maxDuration;
+    }
+}
+//# sourceMappingURL=AsyncToolCheckerTimeout.js.map

package/dist/src/asyncToolChecker/errors/AsyncToolCheckerTimeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncToolCheckerTimeout.js","sourceRoot":"","sources":["../../../../src/asyncToolChecker/errors/AsyncToolCheckerTimeout.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAC9C;;OAEG;IACa,WAAW,CAAS;IAEpC;;;;;OAKG;IACH,YAAmB,WAAmB,EAAE,OAAsB;QAC1D,KAAK,CAAC,mDAAmD,WAAW,WAAW,EAAE,OAAO,CAAC,CAAC;QAC1F,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACnC,CAAC;CACJ"}

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

@@ -0,0 +1,4 @@
+export { AsyncToolCheckerMethodNotImplemented } from "./AsyncToolCheckerMethodNotImplemented.js";
+export { AsyncToolCheckerTimeout } from "./AsyncToolCheckerTimeout.js";
+export { AsyncToolCheckerMaxRetriesExceeded } from "./AsyncToolCheckerMaxRetriesExceeded.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/asyncToolChecker/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oCAAoC,EAAE,MAAM,2CAA2C,CAAC;AACjG,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC"}

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

@@ -0,0 +1,4 @@
+export { AsyncToolCheckerMethodNotImplemented } from "./AsyncToolCheckerMethodNotImplemented.js";
+export { AsyncToolCheckerTimeout } from "./AsyncToolCheckerTimeout.js";
+export { AsyncToolCheckerMaxRetriesExceeded } from "./AsyncToolCheckerMaxRetriesExceeded.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/asyncToolChecker/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oCAAoC,EAAE,MAAM,2CAA2C,CAAC;AACjG,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC"}

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

@@ -0,0 +1,6 @@
+export { AsyncToolChecker } from "./AsyncToolChecker.js";
+export type { AsyncCheckerEvents, AsyncToolCheckerCheckParams, AsyncToolCheckerOptions, EventSubscription, PollingConfig, StatusChangedEvent, } from "../interfaces/index.js";
+export { AsyncToolCheckerMaxRetriesExceeded, AsyncToolCheckerMethodNotImplemented, AsyncToolCheckerTimeout, } from "./errors/index.js";
+export * from "./types.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/asyncToolChecker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACR,kBAAkB,EAClB,2BAA2B,EAC3B,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACH,kCAAkC,EAClC,oCAAoC,EACpC,uBAAuB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC"}

package/dist/src/asyncToolChecker/index.js

@@ -0,0 +1,5 @@
+export { AsyncToolChecker } from "./AsyncToolChecker.js";
+export { AsyncToolCheckerMaxRetriesExceeded, AsyncToolCheckerMethodNotImplemented, AsyncToolCheckerTimeout, } from "./errors/index.js";
+export * from "./types.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/asyncToolChecker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AASzD,OAAO,EACH,kCAAkC,EAClC,oCAAoC,EACpC,uBAAuB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC"}

package/dist/src/asyncToolChecker/types.d.ts

@@ -0,0 +1,24 @@
+import type { ActionStatus, BaseLongPollingArgs, LongPollingActionErrorResponse, LongPollingActionParams } from "@illalabs/interfaces";
+/**
+ * Descriptor containing parameters for an action whose execution can be awaited.
+ */
+export type AwaitableActionDescriptor<T extends BaseLongPollingArgs = BaseLongPollingArgs> = LongPollingActionParams<T>;
+/**
+ * Successful result emitted after awaiting a long running tool execution.
+ */
+export type AwaitActionSuccess<TPayload = unknown, TError = unknown> = {
+    readonly isError: false;
+    readonly response: ActionStatus<TPayload, TError>;
+};
+/**
+ * Error result emitted when awaiting a long running tool execution fails.
+ */
+export type AwaitActionFailure = {
+    readonly isError: true;
+    readonly error: LongPollingActionErrorResponse;
+};
+/**
+ * Discriminated union representing the result of awaiting a long running tool execution.
+ */
+export type AwaitActionResult<TPayload = unknown, TError = unknown> = AwaitActionSuccess<TPayload, TError> | AwaitActionFailure;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/asyncToolChecker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/asyncToolChecker/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,YAAY,EACZ,mBAAmB,EACnB,8BAA8B,EAC9B,uBAAuB,EAC1B,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,SAAS,mBAAmB,GAAG,mBAAmB,IACrF,uBAAuB,CAAC,CAAC,CAAC,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,QAAQ,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI;IACnE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;CACrD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,8BAA8B,CAAC;CAClD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,QAAQ,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,IAC5D,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,GACpC,kBAAkB,CAAC"}

package/dist/src/asyncToolChecker/types.js

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

package/dist/src/asyncToolChecker/types.js.map

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

package/dist/src/asyncToolChecker/utils/index.d.ts

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

package/dist/src/asyncToolChecker/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/asyncToolChecker/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/asyncToolChecker/utils/index.js

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

package/dist/src/asyncToolChecker/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/asyncToolChecker/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/asyncToolChecker/utils/isErrorResponse.d.ts

@@ -0,0 +1,11 @@
+import type { LongPollingActionErrorResponse, LongPollingActionResponse } from "@illalabs/interfaces";
+/**
+ * Type guard to determine if a long polling response represents an error state.
+ *
+ * @typeParam TPayload - Payload type associated with successful responses.
+ * @param response Response from the Core API long polling endpoint.
+ *
+ * @returns True if the response contains an error, false otherwise.
+ */
+export declare function isErrorResponse<TPayload = unknown>(response: LongPollingActionResponse<TPayload>): response is LongPollingActionErrorResponse;
+//# sourceMappingURL=isErrorResponse.d.ts.map

package/dist/src/asyncToolChecker/utils/isErrorResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isErrorResponse.d.ts","sourceRoot":"","sources":["../../../../src/asyncToolChecker/utils/isErrorResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,8BAA8B,EAC9B,yBAAyB,EAC5B,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,GAAG,OAAO,EAC9C,QAAQ,EAAE,yBAAyB,CAAC,QAAQ,CAAC,GAC9C,QAAQ,IAAI,8BAA8B,CAE5C"}

package/dist/src/asyncToolChecker/utils/isErrorResponse.js

@@ -0,0 +1,12 @@
+/**
+ * Type guard to determine if a long polling response represents an error state.
+ *
+ * @typeParam TPayload - Payload type associated with successful responses.
+ * @param response Response from the Core API long polling endpoint.
+ *
+ * @returns True if the response contains an error, false otherwise.
+ */
+export function isErrorResponse(response) {
+    return response.statusCode !== undefined;
+}
+//# sourceMappingURL=isErrorResponse.js.map

package/dist/src/asyncToolChecker/utils/isErrorResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isErrorResponse.js","sourceRoot":"","sources":["../../../../src/asyncToolChecker/utils/isErrorResponse.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC3B,QAA6C;IAE7C,OAAQ,QAA2C,CAAC,UAAU,KAAK,SAAS,CAAC;AACjF,CAAC"}

package/dist/src/asyncToolChecker/utils/normalizeTimeout.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Normalizes a timeout value expressed in seconds.
+ *
+ * @param value Timeout expressed in seconds.
+ *
+ * @returns Timeout converted to milliseconds. Values less than zero are coerced to zero.
+ */
+export declare function normalizeTimeout(value: number): number;
+//# sourceMappingURL=normalizeTimeout.d.ts.map

package/dist/src/asyncToolChecker/utils/normalizeTimeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeTimeout.d.ts","sourceRoot":"","sources":["../../../../src/asyncToolChecker/utils/normalizeTimeout.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtD"}

package/dist/src/asyncToolChecker/utils/normalizeTimeout.js

@@ -0,0 +1,14 @@
+/**
+ * Normalizes a timeout value expressed in seconds.
+ *
+ * @param value Timeout expressed in seconds.
+ *
+ * @returns Timeout converted to milliseconds. Values less than zero are coerced to zero.
+ */
+export function normalizeTimeout(value) {
+    if (!Number.isFinite(value)) {
+        return 0;
+    }
+    return Math.max(0, value) * 1000;
+}
+//# sourceMappingURL=normalizeTimeout.js.map

package/dist/src/asyncToolChecker/utils/normalizeTimeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeTimeout.js","sourceRoot":"","sources":["../../../../src/asyncToolChecker/utils/normalizeTimeout.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,CAAC;IACb,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;AACrC,CAAC"}

package/dist/src/caching/InMemoryCache.d.ts

@@ -0,0 +1,14 @@
+import type { CacheEntryOptions, ICache } from "../interfaces/cache.interface.js";
+/**
+ * Default cache implementation that keeps values in memory.
+ */
+export declare class InMemoryCache implements ICache {
+    private readonly store;
+    /** @inheritdoc */
+    get<TValue>(key: string): Promise<TValue | undefined>;
+    /** @inheritdoc */
+    set(key: string, value: unknown, options?: CacheEntryOptions): Promise<void>;
+    /** @inheritdoc */
+    del(key: string): Promise<void>;
+}
+//# sourceMappingURL=InMemoryCache.d.ts.map

package/dist/src/caching/InMemoryCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryCache.d.ts","sourceRoot":"","sources":["../../../src/caching/InMemoryCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAMlF;;GAEG;AACH,qBAAa,aAAc,YAAW,MAAM;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2C;IAEjE,kBAAkB;IACL,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAclE,kBAAkB;IACL,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7F,kBAAkB;IACL,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/C"}

package/dist/src/caching/InMemoryCache.js

@@ -0,0 +1,31 @@
+/**
+ * Default cache implementation that keeps values in memory.
+ */
+export class InMemoryCache {
+    store = new Map();
+    /** @inheritdoc */
+    async get(key) {
+        const entry = this.store.get(key);
+        if (entry === undefined) {
+            return undefined;
+        }
+        if (entry.expiresAt !== undefined && entry.expiresAt <= Date.now()) {
+            this.store.delete(key);
+            return undefined;
+        }
+        return entry.value;
+    }
+    /** @inheritdoc */
+    async set(key, value, options = {}) {
+        const expiresAt = options.ttl !== undefined ? Date.now() + options.ttl : undefined;
+        this.store.set(key, {
+            value,
+            expiresAt,
+        });
+    }
+    /** @inheritdoc */
+    async del(key) {
+        this.store.delete(key);
+    }
+}
+//# sourceMappingURL=InMemoryCache.js.map

package/dist/src/caching/InMemoryCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryCache.js","sourceRoot":"","sources":["../../../src/caching/InMemoryCache.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,OAAO,aAAa;IACL,KAAK,GAAG,IAAI,GAAG,EAAgC,CAAC;IAEjE,kBAAkB;IACX,KAAK,CAAC,GAAG,CAAS,GAAW;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACjE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,OAAO,KAAK,CAAC,KAAe,CAAC;IACjC,CAAC;IAED,kBAAkB;IACX,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAc,EAAE,UAA6B,EAAE;QACzE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;QAEnF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAChB,KAAK;YACL,SAAS;SACZ,CAAC,CAAC;IACP,CAAC;IAED,kBAAkB;IACX,KAAK,CAAC,GAAG,CAAC,GAAW;QACxB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;CACJ"}

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

@@ -0,0 +1,3 @@
+export type { CacheEntryOptions, ICache } from "../interfaces/cache.interface.js";
+export { InMemoryCache } from "./InMemoryCache.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/caching/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/caching/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/caching/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,64 @@
+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";
+/**
+ * Represents a conversational session with the Illa Core API.
+ */
+export declare class Chat {
+    private readonly id;
+    private readonly coreApiProvider;
+    private readonly contextManager;
+    private readonly asyncToolChecker?;
+    private readonly defaultRole;
+    private readonly userContext;
+    /**
+     * Creates a new {@link Chat} instance.
+     *
+     * @param options Chat construction options including dependencies.
+     */
+    constructor(options: ChatOptions);
+    /**
+     * Retrieves the identifier associated with this chat instance.
+     *
+     * @returns Chat identifier.
+     */
+    getId(): string;
+    get messages(): Promise<MessageHistoryType>;
+    /**
+     * Sends a prompt to the Core API and returns the processed result.
+     *
+     * @param prompt Prompt instance representing the message to be processed.
+     *
+     * @returns Structured chat result containing the processed response.
+     */
+    sendMessage(prompt: Prompt): Promise<SendMessageResult>;
+    private buildRequest;
+    private static isSuccessResponse;
+    /**
+     * Awaits the completion of a long running action triggered by the conversation.
+     *
+     * When the chat has no async tool checker configured, the method throws a
+     * {@link ChatAsyncToolCheckerUnavailable} error; otherwise it delegates the
+     * request to the checker and returns its result.
+     *
+     * @param descriptor Descriptor identifying the action to track.
+     *
+     * @throws {ChatAsyncToolCheckerUnavailable} When no async tool checker is configured.
+     *
+     * @returns Action status result emitted by the async tool checker.
+     */
+    awaitAction(descriptor: AwaitableActionDescriptor): Promise<AwaitActionResult>;
+    /**
+     * Retrieves the current chat context including messages and tool configuration.     *
+     * @returns Snapshot of the chat context.
+     */
+    getContext(): Promise<ChatContextSnapshot>;
+    /**
+     * Replaces the persisted chat context with the provided snapshot.
+     *
+     * @param snapshot Context snapshot to store.
+     */
+    setContext(snapshot: ChatContextSnapshot): Promise<void>;
+}
+//# sourceMappingURL=Chat.d.ts.map

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

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

@@ -0,0 +1,129 @@
+import { ChatAsyncToolCheckerUnavailable } from "./errors/index.js";
+import { generateUUID } from "./utils/index.js";
+/**
+ * Represents a conversational session with the Illa Core API.
+ */
+export class Chat {
+    id;
+    coreApiProvider;
+    contextManager;
+    asyncToolChecker;
+    defaultRole;
+    userContext;
+    /**
+     * Creates a new {@link Chat} instance.
+     *
+     * @param options Chat construction options including dependencies.
+     */
+    constructor(options) {
+        this.id = options.id ?? generateUUID();
+        this.coreApiProvider = options.coreApiProvider;
+        this.contextManager = options.contextManager;
+        this.asyncToolChecker = options.asyncToolChecker;
+        this.defaultRole = options.defaultRole ?? "user";
+        this.userContext = options.userContext;
+    }
+    /**
+     * Retrieves the identifier associated with this chat instance.
+     *
+     * @returns Chat identifier.
+     */
+    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.
+     *
+     * @param prompt Prompt instance representing the message to be processed.
+     *
+     * @returns Structured chat result containing the processed response.
+     */
+    async sendMessage(prompt) {
+        const promptSnapshot = prompt.getSnapshot();
+        const normalizedPrompt = prompt.getNormalizedSnapshot(this.defaultRole);
+        const originalContext = await this.contextManager.getContext(this.id);
+        const { body, messages: stagedMessages } = this.buildRequest(originalContext, normalizedPrompt);
+        const response = await this.coreApiProvider.sendMessage(body);
+        if (!Chat.isSuccessResponse(response)) {
+            return {
+                chatId: this.id,
+                prompt: body.prompt,
+                promptSnapshot,
+                messages: stagedMessages,
+                toolsConfig: originalContext.toolsConfig,
+                response,
+            };
+        }
+        await this.contextManager.setMessages(this.id, response.messages);
+        await this.contextManager.setToolsConfig(this.id, originalContext.toolsConfig);
+        return {
+            chatId: this.id,
+            prompt: body.prompt,
+            promptSnapshot,
+            messages: response.messages,
+            toolsConfig: originalContext.toolsConfig,
+            response,
+        };
+    }
+    buildRequest(context, normalizedPrompt) {
+        return {
+            body: {
+                toolsConfig: context.toolsConfig,
+                messages: context.messages,
+                userContext: this.userContext,
+                prompt: normalizedPrompt.message,
+            },
+            messages: context.messages,
+            toolsConfig: context.toolsConfig,
+        };
+    }
+    static isSuccessResponse(response) {
+        return "status" in response && response.status === 200;
+    }
+    /**
+     * Awaits the completion of a long running action triggered by the conversation.
+     *
+     * When the chat has no async tool checker configured, the method throws a
+     * {@link ChatAsyncToolCheckerUnavailable} error; otherwise it delegates the
+     * request to the checker and returns its result.
+     *
+     * @param descriptor Descriptor identifying the action to track.
+     *
+     * @throws {ChatAsyncToolCheckerUnavailable} When no async tool checker is configured.
+     *
+     * @returns Action status result emitted by the async tool checker.
+     */
+    async awaitAction(descriptor) {
+        if (this.asyncToolChecker === undefined) {
+            throw new ChatAsyncToolCheckerUnavailable({
+                chatId: this.getId(),
+                descriptor,
+            });
+        }
+        return this.asyncToolChecker.check({
+            toolName: descriptor.toolName,
+            protocol: descriptor.protocol,
+            descriptor: descriptor.args,
+        });
+    }
+    /**
+     * Retrieves the current chat context including messages and tool configuration.     *
+     * @returns Snapshot of the chat context.
+     */
+    async getContext() {
+        return this.contextManager.getContext(this.id);
+    }
+    /**
+     * Replaces the persisted chat context with the provided snapshot.
+     *
+     * @param snapshot Context snapshot to store.
+     */
+    async setContext(snapshot) {
+        await this.contextManager.setMessages(this.id, snapshot.messages);
+        await this.contextManager.setToolsConfig(this.id, snapshot.toolsConfig);
+    }
+}
+//# sourceMappingURL=Chat.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * Error emitted when attempting to await an action without configuring an async tool checker.
+ *
+ * The error may include a `context` property with additional debugging information
+ * such as the `chatId` and the original `descriptor` of the awaited action.
+ */
+export declare class ChatAsyncToolCheckerUnavailable extends Error {
+    /**
+     * Optional context describing the awaited action and chat details.
+     */
+    readonly context?: unknown;
+    /**
+     * Creates a new {@link ChatAsyncToolCheckerUnavailable} instance.
+     *
+     * @param context Additional context useful for debugging, e.g. `{ chatId: string, descriptor: unknown }`.
+     */
+    constructor(context?: unknown);
+}
+//# sourceMappingURL=ChatAsyncToolCheckerUnavailable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatAsyncToolCheckerUnavailable.d.ts","sourceRoot":"","sources":["../../../../src/chat/errors/ChatAsyncToolCheckerUnavailable.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,+BAAgC,SAAQ,KAAK;IACtD;;OAEG;IACH,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElC;;;;OAIG;gBACgB,OAAO,CAAC,EAAE,OAAO;CAUvC"}

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

@@ -0,0 +1,28 @@
+/**
+ * Error emitted when attempting to await an action without configuring an async tool checker.
+ *
+ * The error may include a `context` property with additional debugging information
+ * such as the `chatId` and the original `descriptor` of the awaited action.
+ */
+export class ChatAsyncToolCheckerUnavailable extends Error {
+    /**
+     * Optional context describing the awaited action and chat details.
+     */
+    context;
+    /**
+     * Creates a new {@link ChatAsyncToolCheckerUnavailable} instance.
+     *
+     * @param context Additional context useful for debugging, e.g. `{ chatId: string, descriptor: unknown }`.
+     */
+    constructor(context) {
+        super("Chat awaitAction requires an async tool checker to be configured.");
+        this.name = "ChatAsyncToolCheckerUnavailable";
+        if (context !== undefined) {
+            Object.defineProperty(this, "context", {
+                value: context,
+                enumerable: true,
+            });
+        }
+    }
+}
+//# sourceMappingURL=ChatAsyncToolCheckerUnavailable.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatAsyncToolCheckerUnavailable.js","sourceRoot":"","sources":["../../../../src/chat/errors/ChatAsyncToolCheckerUnavailable.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IACtD;;OAEG;IACa,OAAO,CAAW;IAElC;;;;OAIG;IACH,YAAmB,OAAiB;QAChC,KAAK,CAAC,mEAAmE,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;QAC9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE;gBACnC,KAAK,EAAE,OAAO;gBACd,UAAU,EAAE,IAAI;aACnB,CAAC,CAAC;QACP,CAAC;IACL,CAAC;CACJ"}

package/dist/src/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

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

@@ -0,0 +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;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"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/chat/index.d.ts

@@ -0,0 +1,5 @@
+export { Chat } from "./Chat.js";
+export type { ChatOptions } from "../interfaces/index.js";
+export * from "./errors/index.js";
+export type { ChatContextInput } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/chat/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,cAAc,mBAAmB,CAAC;AAClC,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/chat/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/chat/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { ChatContextSnapshot } from "../interfaces/index.js";
+/**
+ * Context replacement payload accepted by the chat facade.
+ *
+ * This type re-exports the existing {@link ChatContextSnapshot} for improved discoverability
+ * when working within the chat module.
+ */
+export type ChatContextInput = ChatContextSnapshot;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/chat/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC"}

package/dist/src/chat/types.js

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