@illalabs/sdk 0.0.0 → 0.1.0-canary.dcf8499b

package/dist/src/internal.js

@@ -0,0 +1,14 @@
+/**
+ * Internal exports for the Illa SDK package
+ *
+ * This file includes all public exports plus any internal utilities
+ * needed for testing and development. External consumers should use
+ * the main index.ts entry point instead.
+ */
+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";
+//# sourceMappingURL=internal.js.map

package/dist/src/internal.js.map

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

package/dist/src/prompt/Prompt.d.ts

@@ -0,0 +1,61 @@
+import type { MessageType } from "@illalabs/interfaces";
+import type { NormalizedPromptSnapshot, PromptOptions, PromptRole, PromptSnapshot } from "./types.js";
+/**
+ * Represents a message payload that can be sent to the Core API.
+ *
+ * The {@link Prompt} class abstracts the differences between plain text
+ * messages and tool execution results while guaranteeing runtime validation
+ * for tool responses.
+ */
+export declare class Prompt {
+    private readonly snapshot;
+    /**
+     * Creates a new {@link Prompt} instance from the provided options.
+     *
+     * @param options Configuration options containing either text or tool result data.
+     * @throws {PromptConfigurationConflict} When both text and toolResult are provided, or neither is provided.
+     */
+    constructor(options: PromptOptions);
+    /**
+     * Retrieves a deep copy of the prompt's internal snapshot.
+     *
+     * @returns A cloned snapshot containing the prompt's current state.
+     */
+    getSnapshot(): PromptSnapshot;
+    /**
+     * Converts the prompt snapshot into a normalized format suitable for API transmission.
+     *
+     * @param role The role to assign to the message (e.g., "user", "assistant", "tool").
+     * @returns A normalized snapshot containing both the prompt payload and message format.
+     */
+    getNormalizedSnapshot(role: PromptRole): NormalizedPromptSnapshot;
+    /**
+     * Converts the prompt into a message history entry with the specified role.
+     *
+     * @param role The role to assign to the message (e.g., "user", "assistant", "tool").
+     * @returns A message object compatible with the message history format.
+     */
+    toMessage(role: PromptRole): MessageType;
+    /**
+     * Converts the prompt to a string representation.
+     *
+     * @returns For text prompts, returns the text content. For tool results, returns a JSON string representation.
+     */
+    toString(): string;
+    /**
+     * Creates a prompt snapshot from the provided options, ensuring exactly one input type is specified.
+     *
+     * @param options Configuration options containing either text or tool result data.
+     * @returns A validated prompt snapshot.
+     * @throws {PromptConfigurationConflict} When both text and toolResult are provided, or neither is provided.
+     */
+    private static createSnapshot;
+    /**
+     * Creates a deep copy of a prompt snapshot to prevent external mutation.
+     *
+     * @param snapshot The snapshot to clone.
+     * @returns A new snapshot with the same values as the input.
+     */
+    private static cloneSnapshot;
+}
+//# sourceMappingURL=Prompt.d.ts.map

package/dist/src/prompt/Prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prompt.d.ts","sourceRoot":"","sources":["../../../src/prompt/Prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,sBAAsB,CAAC;AAIxE,OAAO,KAAK,EACR,wBAAwB,EACxB,aAAa,EACb,UAAU,EACV,cAAc,EACjB,MAAM,YAAY,CAAC;AAIpB;;;;;;GAMG;AACH,qBAAa,MAAM;IACf,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAE1C;;;;;OAKG;gBACgB,OAAO,EAAE,aAAa;IAIzC;;;;OAIG;IACI,WAAW,IAAI,cAAc;IAIpC;;;;;OAKG;IACI,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,wBAAwB;IAoBxE;;;;;OAKG;IACI,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW;IAI/C;;;;OAIG;IACI,QAAQ,IAAI,MAAM;IAQzB;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAyB7B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;CAa/B"}

package/dist/src/prompt/Prompt.js

@@ -0,0 +1,118 @@
+import { ToolResultSchema } from "@illalabs/interfaces";
+import { stringify } from "viem";
+import { PromptConfigurationConflict } from "./errors/index.js";
+import { cloneToolResult, normalizeTextPrompt, normalizeToolResult } from "./utils/index.js";
+/**
+ * Represents a message payload that can be sent to the Core API.
+ *
+ * The {@link Prompt} class abstracts the differences between plain text
+ * messages and tool execution results while guaranteeing runtime validation
+ * for tool responses.
+ */
+export class Prompt {
+    snapshot;
+    /**
+     * Creates a new {@link Prompt} instance from the provided options.
+     *
+     * @param options Configuration options containing either text or tool result data.
+     * @throws {PromptConfigurationConflict} When both text and toolResult are provided, or neither is provided.
+     */
+    constructor(options) {
+        this.snapshot = Prompt.createSnapshot(options);
+    }
+    /**
+     * Retrieves a deep copy of the prompt's internal snapshot.
+     *
+     * @returns A cloned snapshot containing the prompt's current state.
+     */
+    getSnapshot() {
+        return Prompt.cloneSnapshot(this.snapshot);
+    }
+    /**
+     * Converts the prompt snapshot into a normalized format suitable for API transmission.
+     *
+     * @param role The role to assign to the message (e.g., "user", "assistant", "tool").
+     * @returns A normalized snapshot containing both the prompt payload and message format.
+     */
+    getNormalizedSnapshot(role) {
+        if (this.snapshot.kind === "text") {
+            const normalized = normalizeTextPrompt(this.snapshot.text, role);
+            return {
+                kind: "text",
+                prompt: normalized.prompt,
+                message: normalized.message,
+            };
+        }
+        const normalized = normalizeToolResult(this.snapshot.toolResult, role);
+        return {
+            kind: "tool-result",
+            prompt: normalized.prompt,
+            message: normalized.message,
+        };
+    }
+    /**
+     * Converts the prompt into a message history entry with the specified role.
+     *
+     * @param role The role to assign to the message (e.g., "user", "assistant", "tool").
+     * @returns A message object compatible with the message history format.
+     */
+    toMessage(role) {
+        return this.getNormalizedSnapshot(role).message;
+    }
+    /**
+     * Converts the prompt to a string representation.
+     *
+     * @returns For text prompts, returns the text content. For tool results, returns a JSON string representation.
+     */
+    toString() {
+        if (this.snapshot.kind === "text") {
+            return this.snapshot.text ?? "";
+        }
+        return stringify(this.snapshot.toolResult);
+    }
+    /**
+     * Creates a prompt snapshot from the provided options, ensuring exactly one input type is specified.
+     *
+     * @param options Configuration options containing either text or tool result data.
+     * @returns A validated prompt snapshot.
+     * @throws {PromptConfigurationConflict} When both text and toolResult are provided, or neither is provided.
+     */
+    static createSnapshot(options) {
+        const { text, toolResult } = options;
+        const hasText = text !== undefined;
+        const hasToolResult = toolResult !== undefined;
+        if (hasText === hasToolResult) {
+            throw new PromptConfigurationConflict();
+        }
+        if (hasText) {
+            return {
+                kind: "text",
+                text,
+            };
+        }
+        const validated = ToolResultSchema.parse(toolResult);
+        return {
+            kind: "tool-result",
+            toolResult: validated,
+        };
+    }
+    /**
+     * Creates a deep copy of a prompt snapshot to prevent external mutation.
+     *
+     * @param snapshot The snapshot to clone.
+     * @returns A new snapshot with the same values as the input.
+     */
+    static cloneSnapshot(snapshot) {
+        if (snapshot.kind === "text") {
+            return {
+                kind: "text",
+                text: snapshot.text,
+            };
+        }
+        return {
+            kind: "tool-result",
+            toolResult: cloneToolResult(snapshot.toolResult),
+        };
+    }
+}
+//# sourceMappingURL=Prompt.js.map

package/dist/src/prompt/Prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prompt.js","sourceRoot":"","sources":["../../../src/prompt/Prompt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAQjC,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE7F;;;;;;GAMG;AACH,MAAM,OAAO,MAAM;IACE,QAAQ,CAAiB;IAE1C;;;;;OAKG;IACH,YAAmB,OAAsB;QACrC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACI,WAAW;QACd,OAAO,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACI,qBAAqB,CAAC,IAAgB;QACzC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAChC,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAEjE,OAAO;gBACH,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,OAAO,EAAE,UAAU,CAAC,OAAO;aAC9B,CAAC;QACN,CAAC;QAED,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAEvE,OAAO;YACH,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,OAAO,EAAE,UAAU,CAAC,OAAO;SAC9B,CAAC;IACN,CAAC;IAED;;;;;OAKG;IACI,SAAS,CAAC,IAAgB;QAC7B,OAAO,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACX,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;QACpC,CAAC;QAED,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,cAAc,CAAC,OAAsB;QAChD,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAErC,MAAM,OAAO,GAAG,IAAI,KAAK,SAAS,CAAC;QACnC,MAAM,aAAa,GAAG,UAAU,KAAK,SAAS,CAAC;QAE/C,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;YAC5B,MAAM,IAAI,2BAA2B,EAAE,CAAC;QAC5C,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACV,OAAO;gBACH,IAAI,EAAE,MAAM;gBACZ,IAAI;aACP,CAAC;QACN,CAAC;QAED,MAAM,SAAS,GAAmB,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAErE,OAAO;YACH,IAAI,EAAE,aAAa;YACnB,UAAU,EAAE,SAAS;SACxB,CAAC;IACN,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,aAAa,CAAC,QAAwB;QACjD,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,OAAO;gBACH,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ,CAAC,IAAI;aACtB,CAAC;QACN,CAAC;QAED,OAAO;YACH,IAAI,EAAE,aAAa;YACnB,UAAU,EAAE,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC;SACnD,CAAC;IACN,CAAC;CACJ"}

package/dist/src/prompt/errors/PromptConfigurationConflict.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Raised when a prompt receives an invalid configuration.
+ *
+ * This error occurs when both text and toolResult are provided,
+ * or when neither option is defined.
+ */
+export declare class PromptConfigurationConflict extends Error {
+    constructor();
+}
+//# sourceMappingURL=PromptConfigurationConflict.d.ts.map

package/dist/src/prompt/errors/PromptConfigurationConflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptConfigurationConflict.d.ts","sourceRoot":"","sources":["../../../../src/prompt/errors/PromptConfigurationConflict.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;;CAKrD"}

package/dist/src/prompt/errors/PromptConfigurationConflict.js

@@ -0,0 +1,13 @@
+/**
+ * Raised when a prompt receives an invalid configuration.
+ *
+ * This error occurs when both text and toolResult are provided,
+ * or when neither option is defined.
+ */
+export class PromptConfigurationConflict extends Error {
+    constructor() {
+        super("Prompt requires either text or toolResult, but not both");
+        this.name = "PromptConfigurationConflict";
+    }
+}
+//# sourceMappingURL=PromptConfigurationConflict.js.map

package/dist/src/prompt/errors/PromptConfigurationConflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptConfigurationConflict.js","sourceRoot":"","sources":["../../../../src/prompt/errors/PromptConfigurationConflict.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAClD;QACI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC9C,CAAC;CACJ"}

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,4 @@
+export { Prompt } from "./Prompt.js";
+export { PromptConfigurationConflict } from "./errors/index.js";
+export type { PromptKind, PromptOptions, PromptSnapshot, PromptRole, NormalizedPromptSnapshot, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/prompt/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,YAAY,EACR,UAAU,EACV,aAAa,EACb,cAAc,EACd,UAAU,EACV,wBAAwB,GAC3B,MAAM,YAAY,CAAC"}

package/dist/src/prompt/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/prompt/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,57 @@
+import type { MessageType, ToolResultType } from "@illalabs/interfaces";
+/**
+ * Enumerates the supported prompt payload variants.
+ */
+export type PromptKind = "text" | "tool-result";
+/**
+ * Enumerates the possible roles that can be assigned to a prompt message.
+ *
+ * - `"user"`: End-user messages
+ * - `"assistant"`: AI/system responses
+ * - `"tool"`: Tool execution results returned to the conversation flow
+ */
+export type PromptRole = "user" | "assistant" | "tool";
+/**
+ * Helper type that excludes properties from TSource that exist in TExcluded.
+ */
+type Without<TSource, TExcluded> = {
+    [Key in Exclude<keyof TSource, keyof TExcluded>]?: never;
+};
+/**
+ * XOR of two object types: one or the other, but not both.
+ */
+type XOR<TLeft, TRight> = (Without<TLeft, TRight> & TRight) | (Without<TRight, TLeft> & TLeft);
+/**
+ * Configuration used to instantiate a {@link Prompt} instance.
+ * Either `text` or `toolResult` must be provided, but not both.
+ */
+export type PromptOptions = XOR<{
+    readonly text: string;
+}, {
+    readonly toolResult: ToolResultType;
+}>;
+/**
+ * Resulting payload snapshot produced by a {@link Prompt} instance.
+ */
+export type PromptSnapshot = {
+    readonly kind: "text";
+    readonly text: string;
+} | {
+    readonly kind: "tool-result";
+    readonly toolResult: ToolResultType;
+};
+/**
+ * Normalized prompt snapshot containing both the prompt payload and corresponding message format.
+ * This structure is suitable for transmission to the Core API.
+ */
+export type NormalizedPromptSnapshot = {
+    readonly kind: "text";
+    readonly prompt: string;
+    readonly message: MessageType;
+} | {
+    readonly kind: "tool-result";
+    readonly prompt: ToolResultType;
+    readonly message: MessageType;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/prompt/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,aAAa,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAEvD;;GAEG;AACH,KAAK,OAAO,CAAC,OAAO,EAAE,SAAS,IAAI;KAC9B,GAAG,IAAI,OAAO,CAAC,MAAM,OAAO,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK;CAC3D,CAAC;AAEF;;GAEG;AACH,KAAK,GAAG,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC;AAE/F;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAA;CAAE,CAAC,CAAC;AAEpG;;GAEG;AACH,MAAM,MAAM,cAAc,GACpB;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB,GACD;IACI,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;CACvC,CAAC;AAER;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAC9B;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CACjC,GACD;IACI,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CACjC,CAAC"}

package/dist/src/prompt/types.js

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

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

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

package/dist/src/prompt/utils/cloneToolResult.d.ts

@@ -0,0 +1,12 @@
+import type { ToolResultType } from "@illalabs/interfaces";
+/**
+ * Creates a deep clone of a tool result object to prevent external mutation.
+ *
+ * This function clones all potentially complex fields (result and error) while
+ * preserving primitive identifiers (toolCallId and toolName).
+ *
+ * @param toolResult The tool result to clone.
+ * @returns A deep copy of the tool result with all complex fields cloned.
+ */
+export declare function cloneToolResult(toolResult: ToolResultType): ToolResultType;
+//# sourceMappingURL=cloneToolResult.d.ts.map

package/dist/src/prompt/utils/cloneToolResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloneToolResult.d.ts","sourceRoot":"","sources":["../../../../src/prompt/utils/cloneToolResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,cAAc,GAAG,cAAc,CAiB1E"}

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

@@ -0,0 +1,28 @@
+import { deepClone } from "./deepClone.js";
+/**
+ * Creates a deep clone of a tool result object to prevent external mutation.
+ *
+ * This function clones all potentially complex fields (result and error) while
+ * preserving primitive identifiers (toolCallId and toolName).
+ *
+ * @param toolResult The tool result to clone.
+ * @returns A deep copy of the tool result with all complex fields cloned.
+ */
+export function cloneToolResult(toolResult) {
+    const cloned = {
+        toolCallId: toolResult.toolCallId,
+        toolName: toolResult.toolName,
+        result: toolResult.result !== undefined ? deepClone(toolResult.result) : undefined,
+    };
+    // Deep clone error only if it's a non-null object
+    if (toolResult.error !== undefined) {
+        if (typeof toolResult.error === "object" && toolResult.error !== null) {
+            cloned.error = deepClone(toolResult.error);
+        }
+        else {
+            cloned.error = toolResult.error;
+        }
+    }
+    return cloned;
+}
+//# sourceMappingURL=cloneToolResult.js.map

package/dist/src/prompt/utils/cloneToolResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloneToolResult.js","sourceRoot":"","sources":["../../../../src/prompt/utils/cloneToolResult.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,UAA0B;IACtD,MAAM,MAAM,GAAmB;QAC3B,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,MAAM,EAAE,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;KACrF,CAAC;IAEF,kDAAkD;IAClD,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,QAAQ,IAAI,UAAU,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACpE,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;QACpC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/src/prompt/utils/deepClone.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Creates a deep clone of a value to prevent external mutation.
+ * Uses structuredClone if available, otherwise falls back to viem's stringify for serialization.
+ *
+ * @param value The value to clone.
+ * @returns A deep copy of the input value.
+ */
+export declare function deepClone<T>(value: T): T;
+//# sourceMappingURL=deepClone.d.ts.map

package/dist/src/prompt/utils/deepClone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepClone.d.ts","sourceRoot":"","sources":["../../../../src/prompt/utils/deepClone.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAKxC"}

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

@@ -0,0 +1,15 @@
+import { stringify } from "viem";
+/**
+ * Creates a deep clone of a value to prevent external mutation.
+ * Uses structuredClone if available, otherwise falls back to viem's stringify for serialization.
+ *
+ * @param value The value to clone.
+ * @returns A deep copy of the input value.
+ */
+export function deepClone(value) {
+    if (typeof structuredClone !== "undefined") {
+        return structuredClone(value);
+    }
+    return JSON.parse(stringify(value));
+}
+//# sourceMappingURL=deepClone.js.map

package/dist/src/prompt/utils/deepClone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepClone.js","sourceRoot":"","sources":["../../../../src/prompt/utils/deepClone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAI,KAAQ;IACjC,IAAI,OAAO,eAAe,KAAK,WAAW,EAAE,CAAC;QACzC,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAM,CAAC;AAC7C,CAAC"}

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

@@ -0,0 +1,5 @@
+export { cloneToolResult } from "./cloneToolResult.js";
+export { deepClone } from "./deepClone.js";
+export { normalizeTextPrompt } from "./normalizeTextPrompt.js";
+export { normalizeToolResult } from "./normalizeToolResult.js";
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,5 @@
+export { cloneToolResult } from "./cloneToolResult.js";
+export { deepClone } from "./deepClone.js";
+export { normalizeTextPrompt } from "./normalizeTextPrompt.js";
+export { normalizeToolResult } from "./normalizeToolResult.js";
+//# sourceMappingURL=index.js.map

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

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

package/dist/src/prompt/utils/normalizeTextPrompt.d.ts

@@ -0,0 +1,14 @@
+import type { MessageType } from "@illalabs/interfaces";
+import type { PromptRole } from "../types.js";
+/**
+ * Transforms a text prompt into both prompt and message formats for API communication.
+ *
+ * @param text The text prompt to normalize.
+ * @param role The role to assign to the generated message.
+ * @returns An object containing the prompt payload and formatted message.
+ */
+export declare function normalizeTextPrompt(text: string, role: PromptRole): {
+    readonly prompt: string;
+    readonly message: MessageType;
+};
+//# sourceMappingURL=normalizeTextPrompt.d.ts.map

package/dist/src/prompt/utils/normalizeTextPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeTextPrompt.d.ts","sourceRoot":"","sources":["../../../../src/prompt/utils/normalizeTextPrompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,GACjB;IACC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CACjC,CAaA"}

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

@@ -0,0 +1,22 @@
+/**
+ * Transforms a text prompt into both prompt and message formats for API communication.
+ *
+ * @param text The text prompt to normalize.
+ * @param role The role to assign to the generated message.
+ * @returns An object containing the prompt payload and formatted message.
+ */
+export function normalizeTextPrompt(text, role) {
+    return {
+        prompt: text,
+        message: {
+            role,
+            content: [
+                {
+                    type: "text",
+                    text,
+                },
+            ],
+        },
+    };
+}
+//# sourceMappingURL=normalizeTextPrompt.js.map

package/dist/src/prompt/utils/normalizeTextPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeTextPrompt.js","sourceRoot":"","sources":["../../../../src/prompt/utils/normalizeTextPrompt.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAC/B,IAAY,EACZ,IAAgB;IAKhB,OAAO;QACH,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE;YACL,IAAI;YACJ,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAM;oBACZ,IAAI;iBACP;aACJ;SACJ;KACJ,CAAC;AACN,CAAC"}

package/dist/src/prompt/utils/normalizeToolResult.d.ts

@@ -0,0 +1,14 @@
+import type { MessageType, ToolResultType } from "@illalabs/interfaces";
+import type { PromptRole } from "../types.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 declare function normalizeToolResult(toolResult: ToolResultType, role: PromptRole): {
+    readonly prompt: ToolResultType;
+    readonly message: MessageType;
+};
+//# sourceMappingURL=normalizeToolResult.d.ts.map

package/dist/src/prompt/utils/normalizeToolResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeToolResult.d.ts","sourceRoot":"","sources":["../../../../src/prompt/utils/normalizeToolResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,UAAU,GACjB;IACC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CACjC,CAkBA"}

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