@haylee-ai/chat-sdk 1.0.1

package/dist/index.cjs

@@ -0,0 +1,322 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AuthenticationError: () => AuthenticationError,
+  AuthorizationError: () => AuthorizationError,
+  BaseEvent: () => BaseEvent,
+  CreateMessageDto: () => CreateMessageDto,
+  EndEvent: () => EndEvent,
+  EventKind: () => EventKind,
+  HayleeAI: () => HayleeAI,
+  HayleeAIClient: () => HayleeAIClient,
+  HayleeAIError: () => HayleeAIError,
+  IHistoryPayload: () => IHistoryPayload,
+  LlmTokenContent: () => LlmTokenContent,
+  LlmTokenEvent: () => LlmTokenEvent,
+  MessageService: () => MessageService,
+  NotFoundError: () => NotFoundError,
+  Role: () => Role,
+  ToolStatus: () => ToolStatus,
+  ValidationError: () => ValidationError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/_internal/client.ts
+var import_fetch_event_source = require("@microsoft/fetch-event-source");
+var HayleeAIClient = class {
+  /**
+   * @property baseURL - the base URL to make requests to
+   */
+  baseURL;
+  /**
+   * @param options - Auth, and baseURL
+   */
+  constructor(options) {
+    this.baseURL = options.baseUrl || "http://localhost:3000/api/v1/chat";
+  }
+  /**
+   * Internal stream callout
+   * @param payload - Message DTO
+   * @param [signal] - Abort signal
+   */
+  async *_stream(payload, signal) {
+    const queue = [];
+    let resolve = null;
+    let done = false;
+    (0, import_fetch_event_source.fetchEventSource)(`${this.baseURL}`, {
+      headers: {
+        "Content-Type": "application/json"
+      },
+      credentials: "include",
+      method: "POST",
+      body: JSON.stringify(payload),
+      openWhenHidden: true,
+      onmessage(ev) {
+        queue.push(ev.data);
+        resolve?.();
+      },
+      onclose() {
+        done = true;
+        resolve?.();
+      },
+      onerror(err) {
+        done = true;
+        resolve?.();
+        throw err;
+      },
+      signal
+    });
+    if (signal) {
+      signal.addEventListener("abort", () => {
+        done = true;
+        resolve?.();
+      });
+    }
+    while (!done || queue.length > 0) {
+      if (queue.length === 0) {
+        await new Promise((r) => {
+          resolve = r;
+        });
+      }
+      while (queue.length > 0) {
+        yield queue.shift();
+      }
+    }
+  }
+};
+
+// src/messages/types.ts
+var EventKind = /* @__PURE__ */ ((EventKind2) => {
+  EventKind2["LLM_TOKEN"] = "llm_token";
+  EventKind2["TOOLS"] = "tools";
+  return EventKind2;
+})(EventKind || {});
+var BaseEvent = class {
+  /*
+   * @property kind - Used to separate streams
+   */
+  kind;
+  /**
+   * @property node - Source node in langgraph
+   */
+  node;
+};
+var LlmTokenContent = class {
+  /**
+   * @property type - Always text
+   */
+  type;
+  /**
+   * @property text - The text content
+   */
+  text;
+};
+var LlmTokenEvent = class extends BaseEvent {
+  /**
+   * @property content - An array of LlmTokenContent. Always an array. Non-empty or empty. Make sure to handle all items in the array.
+   */
+  content;
+  /**
+   * @property model - The LLM model used.
+   */
+  model;
+};
+var EndEvent = class {
+  success;
+};
+var ToolStatus = /* @__PURE__ */ ((ToolStatus2) => {
+  ToolStatus2["START"] = "START";
+  ToolStatus2["END"] = "END";
+  ToolStatus2["ERROR"] = "ERROR";
+  return ToolStatus2;
+})(ToolStatus || {});
+
+// src/errors/base.ts
+var HayleeAIError = class _HayleeAIError extends Error {
+  name = "HayleeAIError";
+  constructor(message) {
+    super(message);
+    Object.setPrototypeOf(this, _HayleeAIError.prototype);
+  }
+};
+
+// src/errors/parse.error.ts
+var ParseError = class _ParseError extends HayleeAIError {
+  constructor(message, details) {
+    super(message);
+    this.details = details;
+    Object.setPrototypeOf(this, _ParseError.prototype);
+  }
+  name = "ParseError";
+};
+
+// src/_shared/parse.helper.ts
+function parseEvent(data) {
+  try {
+    return JSON.parse(data);
+  } catch {
+    throw new ParseError("Failed to parse event data to JSON.");
+  }
+}
+
+// src/messages/message.service.ts
+var MessageService = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * @param payload - The create message payload
+   * @param options - Config for streaming
+   */
+  async stream(payload, options) {
+    for await (const ev of this.client._stream(payload, options?.signal)) {
+      if (!ev || !ev.trim()) continue;
+      try {
+        const event = parseEvent(ev);
+        switch (event.kind) {
+          case "llm_token" /* LLM_TOKEN */: {
+            options?.onLlmToken?.(event);
+            break;
+          }
+          case "tools" /* TOOLS */: {
+            const typedEvent = event;
+            if (typedEvent.status == "START" /* START */) {
+              options?.onToolStart?.(typedEvent);
+            } else if (typedEvent.status == "END" /* END */) {
+              options?.onToolEnd?.(typedEvent);
+            }
+            break;
+          }
+        }
+      } catch (err) {
+        options?.onEnd?.({ success: false });
+        console.error("Failed to parse event data to JSON.", err);
+        options?.onError?.(err);
+      }
+    }
+    options?.onEnd?.({ success: true });
+  }
+};
+
+// src/errors/validation.error.ts
+var ValidationError = class _ValidationError extends HayleeAIError {
+  constructor(message, details) {
+    super(message);
+    this.details = details;
+    Object.setPrototypeOf(this, _ValidationError.prototype);
+  }
+  name = "ValidationError";
+};
+
+// src/errors/not-found.error.ts
+var NotFoundError = class _NotFoundError extends HayleeAIError {
+  name = "NotFoundError";
+  constructor(message) {
+    super(message);
+    Object.setPrototypeOf(this, _NotFoundError.prototype);
+  }
+};
+
+// src/errors/authorization.error.ts
+var AuthorizationError = class _AuthorizationError extends HayleeAIError {
+  name = "AuthorizationError";
+  constructor(message) {
+    super(message);
+    Object.setPrototypeOf(this, _AuthorizationError.prototype);
+  }
+};
+
+// src/errors/authentication.error.ts
+var AuthenticationError = class _AuthenticationError extends HayleeAIError {
+  name = "AuthenticationError";
+  constructor(message) {
+    super(message);
+    Object.setPrototypeOf(this, _AuthenticationError.prototype);
+  }
+};
+
+// src/types/chat.interface.ts
+var import_class_validator = require("class-validator");
+var CreateMessageDto = class {
+  message;
+  /* Array of messages */
+  conversation_history;
+};
+__decorateClass([
+  (0, import_class_validator.IsString)()
+], CreateMessageDto.prototype, "message", 2);
+var Role = /* @__PURE__ */ ((Role2) => {
+  Role2["HUMAN"] = "human";
+  Role2["AI"] = "ai";
+  return Role2;
+})(Role || {});
+var IHistoryPayload = class {
+  role;
+  content;
+};
+__decorateClass([
+  (0, import_class_validator.IsEnum)(Role)
+], IHistoryPayload.prototype, "role", 2);
+__decorateClass([
+  (0, import_class_validator.IsString)()
+], IHistoryPayload.prototype, "content", 2);
+
+// src/index.ts
+var HayleeAI = class extends HayleeAIClient {
+  messages;
+  /**
+   * @param options - HayleeAIChatClientOptions 
+   */
+  constructor(options) {
+    super(options);
+    this.messages = new MessageService(this);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuthenticationError,
+  AuthorizationError,
+  BaseEvent,
+  CreateMessageDto,
+  EndEvent,
+  EventKind,
+  HayleeAI,
+  HayleeAIClient,
+  HayleeAIError,
+  IHistoryPayload,
+  LlmTokenContent,
+  LlmTokenEvent,
+  MessageService,
+  NotFoundError,
+  Role,
+  ToolStatus,
+  ValidationError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/_internal/client.ts","../src/messages/types.ts","../src/errors/base.ts","../src/errors/parse.error.ts","../src/_shared/parse.helper.ts","../src/messages/message.service.ts","../src/errors/validation.error.ts","../src/errors/not-found.error.ts","../src/errors/authorization.error.ts","../src/errors/authentication.error.ts","../src/types/chat.interface.ts"],"sourcesContent":["import { HayleeAIClient, HayleeAIChatClientOptions } from \"./_internal/client\";\nimport { MessageService } from \"./messages\";\n\n/**\n * Instantiate a new HayleeAI connection\n */\nclass HayleeAI extends HayleeAIClient {\n    public messages: MessageService;\n\n    /**\n     * @param options - HayleeAIChatClientOptions \n     */\n    constructor(options: HayleeAIChatClientOptions){\n        super(options);\n        this.messages = new MessageService(this);\n    }\n}\n\nexport {\n    HayleeAI,\n    HayleeAIChatClientOptions \n}\nexport * from \"./errors\";\nexport * from \"./messages\";\nexport * from \"./types/chat.interface\";\nexport * from \"./_internal/client\";\n","import { CreateMessageDto } from \"@/types/chat.interface\";\nimport { fetchEventSource } from \"@microsoft/fetch-event-source\";\n\n/**\n * Options for the HayleeAI Client \n * @property apiKey - API key for authentication\n * @property baseUrl - Optional base URL, defaults to production\n */\nexport type HayleeAIChatClientOptions = {\n    baseUrl?: string;\n}\n\n/**\n * Internal HayleeAI Client. Do not use unless necessary.\n * @class HayleeAIClient \n * @property baseURL - Base URL to make requests to\n */\nexport class HayleeAIClient {\n    /**\n     * @property baseURL - the base URL to make requests to\n     */\n    private baseURL: string;\n    /**\n     * @param options - Auth, and baseURL\n     */\n    constructor(options: HayleeAIChatClientOptions) {\n        this.baseURL = options.baseUrl || \"http://localhost:3000/api/v1/chat\";\n    }\n\n    /**\n     * Internal stream callout\n     * @param payload - Message DTO\n     * @param [signal] - Abort signal\n     */\n    async *_stream(payload: CreateMessageDto, signal?: AbortSignal) {\n        const queue: string[] = [];\n        let resolve: (() => void) | null = null;\n        let done = false;\n\n        fetchEventSource(`${this.baseURL}`, {\n            headers: {\n                'Content-Type': 'application/json',\n            },\n            credentials: 'include',\n            method: 'POST',\n            body: JSON.stringify(payload),\n            openWhenHidden: true,\n            onmessage(ev) {\n                queue.push(ev.data);\n                resolve?.(); // wake up the generator\n            },\n            onclose() {\n                done = true;\n                resolve?.();\n            },\n            onerror(err) {\n                done = true;\n                resolve?.();\n                throw err;\n            },\n            signal\n        });\n\n        if (signal) {\n            signal.addEventListener(\"abort\", () => {\n                done = true;\n                resolve?.();\n            });\n        }\n\n        while (!done || queue.length > 0) {\n            if (queue.length === 0) {\n                //wait until onmessage pushes something\n                await new Promise<void>(r => { resolve = r; });\n            }\n            while (queue.length > 0) {\n                yield queue.shift()!;\n            }\n        }\n    }}\n","export enum EventKind {\n    LLM_TOKEN = \"llm_token\",\n    TOOLS = \"tools\"\n}\n\n/**\n * Base event for Streaming\n * @class BaseEvent\n * @property kind - Used to separate streams\n * @property node - Source node in langgraph\n */\nexport class BaseEvent {\n    /*\n     * @property kind - Used to separate streams\n     */\n    kind!: EventKind;\n    /**\n     * @property node - Source node in langgraph\n     */\n    node!: string;\n}\n\n\n/**\n * @class LLmTokenContent\n */\nexport class LlmTokenContent {\n    /**\n     * @property type - Always text\n     */\n    type!: \"text\";\n    /**\n     * @property text - The text content\n     */\n    text!: string;\n}\n\nexport class LlmTokenEvent extends BaseEvent {\n    /**\n     * @property content - An array of LlmTokenContent. Always an array. Non-empty or empty. Make sure to handle all items in the array.\n     */\n    content!: LlmTokenContent[];\n    /**\n     * @property model - The LLM model used.\n     */\n    model!: string;\n}\n\nexport class EndEvent {\n    success!: boolean;\n}\n\nexport interface ToolEvent extends BaseEvent {\n    content?: ToolContent;\n    name: string;\n    tool_call_id?: string;\n    status: ToolStatus;\n    results: ToolResultContent[];\n}\n\nexport enum ToolStatus {\n    START = \"START\",\n    END = \"END\",\n    ERROR = \"ERROR\"\n}\n\nexport interface ToolContent {\n    params: unknown;\n}\n\nexport interface ToolResultContent {\n    /* type is text or json */\n    type: string;\n    /* can be string or object or array, ANY */\n    content: any;\n}\n\n","export class HayleeAIError  extends Error {\n    public readonly name: string = \"HayleeAIError\";\n\n    constructor(message: string) {\n        super(message);\n        Object.setPrototypeOf(this, HayleeAIError.prototype);\n    }\n}\n","import { HayleeAIError } from \"./base\";\n\nexport class ParseError extends HayleeAIError {\n    public readonly name: string = \"ParseError\";\n    constructor(message: string, public details?: any){\n        super(message);\n        Object.setPrototypeOf(this, ParseError.prototype);\n    }\n}\n","import { ParseError } from \"@/errors/parse.error\";\n\nexport function parseEvent<T>(data: string): T {\n    try {\n        return JSON.parse(data) as T;\n    } catch {\n        throw new ParseError(\"Failed to parse event data to JSON.\");\n    }\n}\n","import { CreateMessageDto } from \"../types/chat.interface\";\nimport { parseEvent } from \"@/_shared/parse.helper\";\nimport { BaseEvent, EndEvent, EventKind, LlmTokenEvent, ToolEvent, ToolStatus } from \"./types\";\nimport { HayleeAIClient } from \"@/_internal/client\";\n\n/**\n * @property onLlmToken - Streams llm tokens for output\n * @property onSearchUpdate - Streams pending / done updates along with search results if status is DONE\n * @property onError - Streams errors on runtime\n * @property signal - AbortSignal for terminating the upstream stream\n */\nexport interface MessageServiceOptions {\n    /**\n     * Streams llm tokens for output\n     * @param ev - LlmTokenEvent\n     */\n    onLlmToken?(ev: LlmTokenEvent): void;\n    /**\n     * triggers upon stream end\n     * @param ev - EndEvent\n     * */\n    onEnd?(ev: EndEvent): void;\n    /**\n     * Streams tool start updates\n     * @param ev - ToolEvent\n     */\n    onToolStart?(ev: ToolEvent): void;\n    /**\n     * Streams tool end updates\n     * @param ev - ToolEvent\n     */\n    onToolEnd?(ev: ToolEvent): void;\n    /**\n     * Streams errors on runtime\n     * @param err - Error or unknown value\n     */\n    onError?(err: unknown): void;\n    /**\n     * @property signal - Abort signal to abort the stream\n     */\n    signal?: AbortSignal;\n}\n\nexport class MessageService {\n\n    constructor(private readonly client: HayleeAIClient) {}\n\n    /**\n     * @param payload - The create message payload\n     * @param options - Config for streaming\n     */\n    async stream(payload: CreateMessageDto, options?: MessageServiceOptions) {\n\n        for await (const ev of this.client._stream(payload, options?.signal)) {\n            if(!ev || !ev.trim()) continue;\n            try {\n                const event = parseEvent<BaseEvent>(ev);\n\n                switch(event.kind) {\n                    case EventKind.LLM_TOKEN: {\n                        options?.onLlmToken?.(event as LlmTokenEvent);\n                        break;\n                    }\n                    case EventKind.TOOLS: {\n                        const typedEvent = event as ToolEvent;\n                        if(typedEvent.status == ToolStatus.START) {\n                            options?.onToolStart?.(typedEvent);\n                        } else if (typedEvent.status == ToolStatus.END) {\n                            options?.onToolEnd?.(typedEvent);\n                        }\n                        break;\n                    }\n                }\n            } catch (err) {\n                options?.onEnd?.({ success: false });\n                //throw new ParseError(\"Failed to parse event data to JSON.\")\n                console.error(\"Failed to parse event data to JSON.\", err);\n                options?.onError?.(err);\n            }\n        }\n        options?.onEnd?.({ success: true });\n    }\n\n}\n","import { HayleeAIError } from \"./base\";\n\nexport class ValidationError extends HayleeAIError {\n    public readonly name: string = \"ValidationError\";\n    constructor(message: string, public details?: any){\n        super(message);\n        Object.setPrototypeOf(this, ValidationError.prototype);\n    }\n}\n","import { HayleeAIError } from \"./base\";\n\nexport class NotFoundError extends HayleeAIError {\n    public readonly name: string = \"NotFoundError\";\n\n    constructor(message: string) {\n        super(message);\n        Object.setPrototypeOf(this, NotFoundError.prototype);\n    }\n}\n","import { HayleeAIError } from \"./base\";\n\nexport class AuthorizationError extends HayleeAIError {\n    public readonly name: string = \"AuthorizationError\";\n\n    constructor(message: string) {\n        super(message);\n        Object.setPrototypeOf(this, AuthorizationError.prototype);\n    }\n}\n\n\n","import { HayleeAIError } from \"./base\";\n\nexport class AuthenticationError extends HayleeAIError {\n    public readonly name: string = \"AuthenticationError\";\n\n    constructor(message: string) {\n        super(message);\n        Object.setPrototypeOf(this, AuthenticationError.prototype);\n    }\n}\n\n","import { IsEnum, IsString } from \"class-validator\";\n\n/** \n * DTO for creating a message\n * @property message - User message\n * @property conversation_history - Array of messages\n */\nexport class CreateMessageDto {\n    /* Message to send */\n    @IsString()\n    message!: string;\n    /* Array of messages */\n    conversation_history!: IHistoryPayload[];\n}\n\n/*\n * @enum Role - Role of message\n */\nexport enum Role {\n    HUMAN = \"human\",\n    AI = \"ai\"\n}\n\n\n/**\n * History payload\n * @property role - Role of message sender\n * @property content - Content of message\n */\nexport class IHistoryPayload {\n    @IsEnum(Role)\n    role!: Role;\n    @IsString()\n    content!: string;\n};\n"],"mappings":"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","names":["EventKind","ToolStatus","Role"]}

package/dist/index.d.cts

@@ -0,0 +1,201 @@
+/**
+ * DTO for creating a message
+ * @property message - User message
+ * @property conversation_history - Array of messages
+ */
+declare class CreateMessageDto {
+    message: string;
+    conversation_history: IHistoryPayload[];
+}
+declare enum Role {
+    HUMAN = "human",
+    AI = "ai"
+}
+/**
+ * History payload
+ * @property role - Role of message sender
+ * @property content - Content of message
+ */
+declare class IHistoryPayload {
+    role: Role;
+    content: string;
+}
+
+/**
+ * Options for the HayleeAI Client
+ * @property apiKey - API key for authentication
+ * @property baseUrl - Optional base URL, defaults to production
+ */
+type HayleeAIChatClientOptions = {
+    baseUrl?: string;
+};
+/**
+ * Internal HayleeAI Client. Do not use unless necessary.
+ * @class HayleeAIClient
+ * @property baseURL - Base URL to make requests to
+ */
+declare class HayleeAIClient {
+    /**
+     * @property baseURL - the base URL to make requests to
+     */
+    private baseURL;
+    /**
+     * @param options - Auth, and baseURL
+     */
+    constructor(options: HayleeAIChatClientOptions);
+    /**
+     * Internal stream callout
+     * @param payload - Message DTO
+     * @param [signal] - Abort signal
+     */
+    _stream(payload: CreateMessageDto, signal?: AbortSignal): AsyncGenerator<string, void, unknown>;
+}
+
+declare enum EventKind {
+    LLM_TOKEN = "llm_token",
+    TOOLS = "tools"
+}
+/**
+ * Base event for Streaming
+ * @class BaseEvent
+ * @property kind - Used to separate streams
+ * @property node - Source node in langgraph
+ */
+declare class BaseEvent {
+    kind: EventKind;
+    /**
+     * @property node - Source node in langgraph
+     */
+    node: string;
+}
+/**
+ * @class LLmTokenContent
+ */
+declare class LlmTokenContent {
+    /**
+     * @property type - Always text
+     */
+    type: "text";
+    /**
+     * @property text - The text content
+     */
+    text: string;
+}
+declare class LlmTokenEvent extends BaseEvent {
+    /**
+     * @property content - An array of LlmTokenContent. Always an array. Non-empty or empty. Make sure to handle all items in the array.
+     */
+    content: LlmTokenContent[];
+    /**
+     * @property model - The LLM model used.
+     */
+    model: string;
+}
+declare class EndEvent {
+    success: boolean;
+}
+interface ToolEvent extends BaseEvent {
+    content?: ToolContent;
+    name: string;
+    tool_call_id?: string;
+    status: ToolStatus;
+    results: ToolResultContent[];
+}
+declare enum ToolStatus {
+    START = "START",
+    END = "END",
+    ERROR = "ERROR"
+}
+interface ToolContent {
+    params: unknown;
+}
+interface ToolResultContent {
+    type: string;
+    content: any;
+}
+
+/**
+ * @property onLlmToken - Streams llm tokens for output
+ * @property onSearchUpdate - Streams pending / done updates along with search results if status is DONE
+ * @property onError - Streams errors on runtime
+ * @property signal - AbortSignal for terminating the upstream stream
+ */
+interface MessageServiceOptions {
+    /**
+     * Streams llm tokens for output
+     * @param ev - LlmTokenEvent
+     */
+    onLlmToken?(ev: LlmTokenEvent): void;
+    /**
+     * triggers upon stream end
+     * @param ev - EndEvent
+     * */
+    onEnd?(ev: EndEvent): void;
+    /**
+     * Streams tool start updates
+     * @param ev - ToolEvent
+     */
+    onToolStart?(ev: ToolEvent): void;
+    /**
+     * Streams tool end updates
+     * @param ev - ToolEvent
+     */
+    onToolEnd?(ev: ToolEvent): void;
+    /**
+     * Streams errors on runtime
+     * @param err - Error or unknown value
+     */
+    onError?(err: unknown): void;
+    /**
+     * @property signal - Abort signal to abort the stream
+     */
+    signal?: AbortSignal;
+}
+declare class MessageService {
+    private readonly client;
+    constructor(client: HayleeAIClient);
+    /**
+     * @param payload - The create message payload
+     * @param options - Config for streaming
+     */
+    stream(payload: CreateMessageDto, options?: MessageServiceOptions): Promise<void>;
+}
+
+declare class HayleeAIError extends Error {
+    readonly name: string;
+    constructor(message: string);
+}
+
+declare class ValidationError extends HayleeAIError {
+    details?: any | undefined;
+    readonly name: string;
+    constructor(message: string, details?: any | undefined);
+}
+
+declare class NotFoundError extends HayleeAIError {
+    readonly name: string;
+    constructor(message: string);
+}
+
+declare class AuthorizationError extends HayleeAIError {
+    readonly name: string;
+    constructor(message: string);
+}
+
+declare class AuthenticationError extends HayleeAIError {
+    readonly name: string;
+    constructor(message: string);
+}
+
+/**
+ * Instantiate a new HayleeAI connection
+ */
+declare class HayleeAI extends HayleeAIClient {
+    messages: MessageService;
+    /**
+     * @param options - HayleeAIChatClientOptions
+     */
+    constructor(options: HayleeAIChatClientOptions);
+}
+
+export { AuthenticationError, AuthorizationError, BaseEvent, CreateMessageDto, EndEvent, EventKind, HayleeAI, type HayleeAIChatClientOptions, HayleeAIClient, HayleeAIError, IHistoryPayload, LlmTokenContent, LlmTokenEvent, MessageService, type MessageServiceOptions, NotFoundError, Role, type ToolContent, type ToolEvent, type ToolResultContent, ToolStatus, ValidationError };