@illalabs/sdk 0.0.0 → 0.1.0

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/CoreApiProvider.d.ts

@@ -0,0 +1,35 @@
+import type { CoreApiChatRequest, CoreApiChatResponse, LongPollingActionRequest, LongPollingActionResponse } from "@illalabs/interfaces";
+import type { AxiosInstance } from "axios";
+import type { ICoreApiProvider } from "../../interfaces/index.js";
+import type { CoreApiProviderConfig, RequestOptions } from "./index.js";
+/**
+ * Axios based Core API provider implementation
+ */
+export declare class CoreApiProvider implements ICoreApiProvider {
+    /**
+     * Axios instance configured for the Core API
+     */
+    protected readonly client: AxiosInstance;
+    /**
+     * @param config Core API provider configuration
+     */
+    constructor({ baseURL, timeout, headers, httpClientFactory }: 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>;
+    /**
+     * 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,EAER,kBAAkB,EAClB,mBAAmB,EACnB,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,cAAc,EAAE,MAAM,YAAY,CAAC;AAIxE;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACpD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAEzC;;OAEG;gBACS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,qBAAqB;IAcnF;;OAEG;IACU,WAAW,CACpB,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAChC,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IAsB/B;;OAEG;IACU,gBAAgB,CACzB,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC,EAC1C,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,yBAAyB,CAAC;IA0BrC;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE;IAM/E,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,iBAAiB;CAO5B"}

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

@@ -0,0 +1,93 @@
+import axios from "axios";
+import { CoreApiAuthenticationMissing } from "./errors/index.js";
+/**
+ * Axios based Core API provider implementation
+ */
+export class CoreApiProvider {
+    /**
+     * Axios instance configured for the Core API
+     */
+    client;
+    /**
+     * @param config Core API provider configuration
+     */
+    constructor({ baseURL, timeout, headers, httpClientFactory }) {
+        const authHeaders = this.ensureAuthHeaders(headers);
+        const resolveClientFactory = httpClientFactory ??
+            ((configuration) => axios.create(configuration));
+        this.client = resolveClientFactory({
+            baseURL: this.resolveBaseUrl(baseURL),
+            timeout,
+            headers: this.buildDefaultHeaders(authHeaders),
+        });
+    }
+    /**
+     * Sends a chat message to the Core API
+     */
+    async sendMessage(body, options = {}) {
+        const requestConfig = this.buildRequestConfig(options);
+        const response = await this.client.post("/api/v1/chat", body, requestConfig);
+        return response.data;
+        //TODO: Handle errors
+        // try{
+        //    this.client.post<CoreApiChatSuccessResponse>(...);
+        //    return response.data;
+        // }
+        // catch(error){
+        // All errors will end up here because Axios throws for 4XX and 5XX status codes
+        // if (error instanceof AxiosError) {
+        //    const errorResponse: CoreApiChatErrorResponse = ChatErrorHandler.handle(error);
+        //    return errorResponse;
+        // }
+    }
+    /**
+     * Polls the Core API for transaction status
+     */
+    async awaitTransaction(params, options = {}) {
+        const requestConfig = this.buildRequestConfig(options);
+        const response = await this.client.get("/api/v1/actions/check", {
+            ...requestConfig,
+            params: {
+                toolName: params.toolName,
+                protocol: params.protocol,
+                args: params.args,
+            },
+        });
+        return response.data;
+        //TODO: Handle errors
+        // try{
+        //    this.client.get<LongPollingActionSuccessResponse>(...);
+        //    return response.data;
+        // }
+        // catch(error){
+        // All errors will end up here because Axios throws for 4XX and 5XX status codes
+        // if (error instanceof AxiosError) {
+        //    const errorResponse: LongPollingActionErrorResponse = ExecutionCheckerErrorHandler.handle(error);
+        //    return errorResponse;
+        // }
+    }
+    /**
+     * Builds request configuration shared across endpoints
+     */
+    buildRequestConfig(options) {
+        return {
+            signal: options.signal,
+        };
+    }
+    resolveBaseUrl(baseURL) {
+        return baseURL ?? "https://app.illa.network";
+    }
+    buildDefaultHeaders(headers) {
+        return {
+            "Content-Type": "application/json",
+            ...headers,
+        };
+    }
+    ensureAuthHeaders(headers) {
+        if (headers?.["x-auth-token"] === 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":"AAQA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAEjE;;GAEG;AACH,MAAM,OAAO,eAAe;IACxB;;OAEG;IACgB,MAAM,CAAgB;IAEzC;;OAEG;IACH,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAyB;QAC/E,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;IACP,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,WAAW,CACpB,IAAgC,EAChC,UAA0B,EAAE;QAE5B,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACnC,cAAc,EACd,IAAI,EACJ,aAAa,CAChB,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACrB,qBAAqB;QACrB,OAAO;QACP,wDAAwD;QACxD,2BAA2B;QAC3B,IAAI;QACJ,gBAAgB;QAChB,gFAAgF;QAChF,qCAAqC;QACrC,qFAAqF;QACrF,2BAA2B;QAC3B,IAAI;IACR,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,gBAAgB,CACzB,MAA0C,EAC1C,UAA0B,EAAE;QAE5B,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAEvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAA4B,uBAAuB,EAAE;YACvF,GAAG,aAAa;YAChB,MAAM,EAAE;gBACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,IAAI,EAAE,MAAM,CAAC,IAAI;aACpB;SACJ,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC,IAAI,CAAC;QACrB,qBAAqB;QACrB,OAAO;QACP,6DAA6D;QAC7D,2BAA2B;QAC3B,IAAI;QACJ,gBAAgB;QAChB,gFAAgF;QAChF,qCAAqC;QACrC,uGAAuG;QACvG,2BAA2B;QAC3B,IAAI;IACR,CAAC;IAED;;OAEG;IACO,kBAAkB,CAAC,OAAuB;QAChD,OAAO;YACH,MAAM,EAAE,OAAO,CAAC,MAAM;SACzB,CAAC;IACN,CAAC;IAEO,cAAc,CAAC,OAAyC;QAC5D,OAAO,OAAO,IAAI,0BAA0B,CAAC;IACjD,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,cAAc,CAAC,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,IAAI,4BAA4B,EAAE,CAAC;QAC7C,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ"}

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

@@ -0,0 +1,24 @@
+import type { CoreApiAuthHeaders } from "@illalabs/interfaces";
+import type { HttpClientFactory } from "./types.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;
+}
+//# sourceMappingURL=CoreApiProviderConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CoreApiProviderConfig.d.ts","sourceRoot":"","sources":["../../../../src/providers/coreApiProvider/CoreApiProviderConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;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;CAClD"}