@agentica/core 0.12.1 → 0.12.2-dev.20250314

package/src/internal/StreamUtil.ts

@@ -1,64 +1,64 @@
-export namespace StreamUtil {
-  export const readAll = async <T>(stream: ReadableStream<T>): Promise<T[]> => {
-    const reader = stream.getReader();
-    const result: T[] = [];
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done) break;
-      result.push(value);
-    }
-    return result;
-  };
-
-  export const reduce = async <T, R = T>(
-    stream: ReadableStream<T>,
-    reducer: (acc: T | R, cur: T) => R,
-    initial?: R,
-  ): Promise<R | null> => {
-    const reader = stream.getReader();
-
-    let acc = (initial ?? null) as R | null | T;
-
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done) break;
-      if (acc === null) {
-        acc = value;
-        continue;
-      }
-
-      acc = reducer(acc, value);
-    }
-
-    return acc as R;
-  };
-
-  export const to = <T>(value: T): ReadableStream<T> => {
-    const stream = new ReadableStream<T>({
-      start: (controller) => {
-        controller.enqueue(value);
-        controller.close();
-      },
-    });
-
-    return stream;
-  };
-
-  export const transform = <T, R>(
-    stream: ReadableStream<T>,
-    transformer: (value: T) => R,
-  ): ReadableStream<R> => {
-    const reader = stream.getReader();
-
-    return new ReadableStream<R>({
-      pull: async (controller) => {
-        const { done, value } = await reader.read();
-        if (!done) {
-          controller.enqueue(transformer(value));
-        } else {
-          controller.close();
-        }
-      },
-    });
-  };
-}
+export namespace StreamUtil {
+  export const readAll = async <T>(stream: ReadableStream<T>): Promise<T[]> => {
+    const reader = stream.getReader();
+    const result: T[] = [];
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      result.push(value);
+    }
+    return result;
+  };
+
+  export const reduce = async <T, R = T>(
+    stream: ReadableStream<T>,
+    reducer: (acc: T | R, cur: T) => R,
+    initial?: R,
+  ): Promise<R | null> => {
+    const reader = stream.getReader();
+
+    let acc = (initial ?? null) as R | null | T;
+
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      if (acc === null) {
+        acc = value;
+        continue;
+      }
+
+      acc = reducer(acc, value);
+    }
+
+    return acc as R;
+  };
+
+  export const to = <T>(value: T): ReadableStream<T> => {
+    const stream = new ReadableStream<T>({
+      start: (controller) => {
+        controller.enqueue(value);
+        controller.close();
+      },
+    });
+
+    return stream;
+  };
+
+  export const transform = <T, R>(
+    stream: ReadableStream<T>,
+    transformer: (value: T) => R,
+  ): ReadableStream<R> => {
+    const reader = stream.getReader();
+
+    return new ReadableStream<R>({
+      pull: async (controller) => {
+        const { done, value } = await reader.read();
+        if (!done) {
+          controller.enqueue(transformer(value));
+        } else {
+          controller.close();
+        }
+      },
+    });
+  };
+}

package/src/internal/__map_take.ts

@@ -1,15 +1,15 @@
-/**
- * @internal
- */
-export const __map_take = <Key, T>(
-  dict: Map<Key, T>,
-  key: Key,
-  generator: () => T,
-): T => {
-  const oldbie: T | undefined = dict.get(key);
-  if (oldbie) return oldbie;
-
-  const value: T = generator();
-  dict.set(key, value);
-  return value;
-};
+/**
+ * @internal
+ */
+export const __map_take = <Key, T>(
+  dict: Map<Key, T>,
+  key: Key,
+  generator: () => T,
+): T => {
+  const oldbie: T | undefined = dict.get(key);
+  if (oldbie) return oldbie;
+
+  const value: T = generator();
+  dict.set(key, value);
+  return value;
+};

package/src/json/IAgenticaEventJson.ts

@@ -1,178 +1,178 @@
-import OpenAI from "openai";
-
-import { AgenticaEventSource } from "../events/AgenticaEventSource";
-import { IAgenticaOperationJson } from "./IAgenticaOperationJson";
-import { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelectionJson";
-import { IAgenticaPromptJson } from "./IAgenticaPromptJson";
-
-/**
- * Nestia A.I. chatbot event.
- *
- * `IAgenticaEventJson` is an union type of all possible events that can
- * be emitted by the A.I. chatbot of the {@link Agentica} class. You
- * can discriminate the subtype by checking the {@link type} property.
- *
- * @author Samchon
- */
-export type IAgenticaEventJson =
-  | IAgenticaEventJson.ICall
-  | IAgenticaEventJson.ICancel
-  | IAgenticaEventJson.IDescribe
-  | IAgenticaEventJson.IExecute
-  | IAgenticaEventJson.IInitialize
-  | IAgenticaEventJson.IRequest
-  | IAgenticaEventJson.ISelect
-  | IAgenticaEventJson.IText;
-export namespace IAgenticaEventJson {
-  export type Type = IAgenticaEventJson["type"];
-  export type Mapper = {
-    initialize: IInitialize;
-    select: ISelect;
-    cancel: ICancel;
-    call: ICall;
-    execute: IExecute;
-    describe: IDescribe;
-    text: IText;
-    request: IRequest;
-  };
-
-  /**
-   * Event of initializing the chatbot.
-   */
-  // eslint-disable-next-line @typescript-eslint/no-empty-object-type
-  export interface IInitialize extends IBase<"initialize"> {}
-
-  /**
-   * Event of selecting a function to call.
-   */
-  export interface ISelect extends IBase<"select"> {
-    selection: IAgenticaOperationSelectionJson;
-  }
-
-  /**
-   * Event of canceling a function calling.
-   */
-  export interface ICancel extends IBase<"cancel"> {
-    selection: IAgenticaOperationSelectionJson;
-  }
-
-  /**
-   * Event of calling a function.
-   */
-  export interface ICall extends IBase<"call"> {
-    /**
-     * ID of the tool calling.
-     */
-    id: string;
-
-    /**
-     * Target operation to call.
-     */
-    operation: IAgenticaOperationJson;
-
-    /**
-     * Arguments of the function calling.
-     *
-     * If you modify this {@link arguments} property, it actually modifies
-     * the backend server's request. Therefore, be careful when you're
-     * trying to modify this property.
-     */
-    arguments: Record<string, any>;
-  }
-
-  /**
-   * Event of function calling execution.
-   */
-  export interface IExecute extends IBase<"execute"> {
-    /**
-     * ID of the tool calling.
-     */
-    id: string;
-
-    /**
-     * Target operation had called.
-     */
-    operation: IAgenticaOperationJson;
-
-    /**
-     * Arguments of the function calling.
-     */
-    arguments: object;
-
-    /**
-     * Return value.
-     */
-    value: any;
-  }
-
-  /**
-   * Event of description.
-   *
-   * Event describing return values of LLM function callings.
-   */
-  export interface IDescribe extends IBase<"describe"> {
-    /**
-     * Executions of the LLM function calling.
-     *
-     * This prompt describes the return value of them.
-     */
-    executes: IAgenticaPromptJson.IExecute[];
-
-    /**
-     * Description text.
-     */
-    text: string;
-
-    /**
-     * Whether the streaming is completed or not.
-     */
-    done: boolean;
-  }
-
-  /**
-   * Event of text message.
-   */
-  export interface IText extends IBase<"text"> {
-    /**
-     * Role of the orator.
-     */
-    role: "assistant" | "user";
-
-    /**
-     * Conversation text.
-     */
-    text: string;
-
-    /**
-     * Whether the streaming is completed or not.
-     */
-    done: boolean;
-  }
-
-  /**
-   * Request event of LLM vendor API.
-   */
-  export interface IRequest extends IBase<"request"> {
-    /**
-     * The source agent of the request.
-     */
-    source: AgenticaEventSource;
-
-    /**
-     * Request body.
-     */
-    body: OpenAI.ChatCompletionCreateParamsStreaming;
-
-    /**
-     * Options for the request.
-     */
-    options?: OpenAI.RequestOptions | undefined;
-  }
-
-  interface IBase<Type extends string> {
-    /**
-     * Discriminator type.
-     */
-    type: Type;
-  }
-}
+import OpenAI from "openai";
+
+import { AgenticaEventSource } from "../events/AgenticaEventSource";
+import { IAgenticaOperationJson } from "./IAgenticaOperationJson";
+import { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelectionJson";
+import { IAgenticaPromptJson } from "./IAgenticaPromptJson";
+
+/**
+ * Nestia A.I. chatbot event.
+ *
+ * `IAgenticaEventJson` is an union type of all possible events that can
+ * be emitted by the A.I. chatbot of the {@link Agentica} class. You
+ * can discriminate the subtype by checking the {@link type} property.
+ *
+ * @author Samchon
+ */
+export type IAgenticaEventJson =
+  | IAgenticaEventJson.ICall
+  | IAgenticaEventJson.ICancel
+  | IAgenticaEventJson.IDescribe
+  | IAgenticaEventJson.IExecute
+  | IAgenticaEventJson.IInitialize
+  | IAgenticaEventJson.IRequest
+  | IAgenticaEventJson.ISelect
+  | IAgenticaEventJson.IText;
+export namespace IAgenticaEventJson {
+  export type Type = IAgenticaEventJson["type"];
+  export type Mapper = {
+    initialize: IInitialize;
+    select: ISelect;
+    cancel: ICancel;
+    call: ICall;
+    execute: IExecute;
+    describe: IDescribe;
+    text: IText;
+    request: IRequest;
+  };
+
+  /**
+   * Event of initializing the chatbot.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+  export interface IInitialize extends IBase<"initialize"> {}
+
+  /**
+   * Event of selecting a function to call.
+   */
+  export interface ISelect extends IBase<"select"> {
+    selection: IAgenticaOperationSelectionJson;
+  }
+
+  /**
+   * Event of canceling a function calling.
+   */
+  export interface ICancel extends IBase<"cancel"> {
+    selection: IAgenticaOperationSelectionJson;
+  }
+
+  /**
+   * Event of calling a function.
+   */
+  export interface ICall extends IBase<"call"> {
+    /**
+     * ID of the tool calling.
+     */
+    id: string;
+
+    /**
+     * Target operation to call.
+     */
+    operation: IAgenticaOperationJson;
+
+    /**
+     * Arguments of the function calling.
+     *
+     * If you modify this {@link arguments} property, it actually modifies
+     * the backend server's request. Therefore, be careful when you're
+     * trying to modify this property.
+     */
+    arguments: Record<string, any>;
+  }
+
+  /**
+   * Event of function calling execution.
+   */
+  export interface IExecute extends IBase<"execute"> {
+    /**
+     * ID of the tool calling.
+     */
+    id: string;
+
+    /**
+     * Target operation had called.
+     */
+    operation: IAgenticaOperationJson;
+
+    /**
+     * Arguments of the function calling.
+     */
+    arguments: object;
+
+    /**
+     * Return value.
+     */
+    value: any;
+  }
+
+  /**
+   * Event of description.
+   *
+   * Event describing return values of LLM function callings.
+   */
+  export interface IDescribe extends IBase<"describe"> {
+    /**
+     * Executions of the LLM function calling.
+     *
+     * This prompt describes the return value of them.
+     */
+    executes: IAgenticaPromptJson.IExecute[];
+
+    /**
+     * Description text.
+     */
+    text: string;
+
+    /**
+     * Whether the streaming is completed or not.
+     */
+    done: boolean;
+  }
+
+  /**
+   * Event of text message.
+   */
+  export interface IText extends IBase<"text"> {
+    /**
+     * Role of the orator.
+     */
+    role: "assistant" | "user";
+
+    /**
+     * Conversation text.
+     */
+    text: string;
+
+    /**
+     * Whether the streaming is completed or not.
+     */
+    done: boolean;
+  }
+
+  /**
+   * Request event of LLM vendor API.
+   */
+  export interface IRequest extends IBase<"request"> {
+    /**
+     * The source agent of the request.
+     */
+    source: AgenticaEventSource;
+
+    /**
+     * Request body.
+     */
+    body: OpenAI.ChatCompletionCreateParamsStreaming;
+
+    /**
+     * Options for the request.
+     */
+    options?: OpenAI.RequestOptions | undefined;
+  }
+
+  interface IBase<Type extends string> {
+    /**
+     * Discriminator type.
+     */
+    type: Type;
+  }
+}

package/src/json/IAgenticaOperationJson.ts

@@ -1,36 +1,36 @@
-/**
- * Operation information in the Agentica Agent.
- *
- * `IAgenticaOperation` is a type represents an operation that would
- * be selected by the A.I. chatbot of {@link Agentica} class to
- * perform the LLM (Large Language Model) function calling.
- *
- * Also, it is an union type that is discriminated by the {@link protocol}
- * property. If the protocol value is `http`, it means that the HTTP API
- * operation would be called by the A.I. chatbot. Otherwise, if the protocol
- * value is `class`, it means that the operation has come from a
- * TypeScript class.
- *
- * @author Samchon
- */
-export interface IAgenticaOperationJson {
-  /**
-   * Protocol discriminator.
-   */
-  protocol: "class" | "http";
-
-  /**
-   * Belonged controller of the target function.
-   */
-  controller: string;
-
-  /**
-   * Target function to call.
-   */
-  function: string;
-
-  /**
-   * Identifier name.
-   */
-  name: string;
-}
+/**
+ * Operation information in the Agentica Agent.
+ *
+ * `IAgenticaOperation` is a type represents an operation that would
+ * be selected by the A.I. chatbot of {@link Agentica} class to
+ * perform the LLM (Large Language Model) function calling.
+ *
+ * Also, it is an union type that is discriminated by the {@link protocol}
+ * property. If the protocol value is `http`, it means that the HTTP API
+ * operation would be called by the A.I. chatbot. Otherwise, if the protocol
+ * value is `class`, it means that the operation has come from a
+ * TypeScript class.
+ *
+ * @author Samchon
+ */
+export interface IAgenticaOperationJson {
+  /**
+   * Protocol discriminator.
+   */
+  protocol: "class" | "http";
+
+  /**
+   * Belonged controller of the target function.
+   */
+  controller: string;
+
+  /**
+   * Target function to call.
+   */
+  function: string;
+
+  /**
+   * Identifier name.
+   */
+  name: string;
+}

package/src/json/IAgenticaOperationSelectionJson.ts

@@ -1,19 +1,19 @@
-import { IAgenticaOperationJson } from "./IAgenticaOperationJson";
-
-/**
- * Nestia agent operation selection.
- *
- * `IAgenticaOperationSelection` is a type represents an operation
- * which has been selected by the A.I. chatbot of {@link Agentica}
- * class for the LLM (Large Language Model) function calling with
- * detailed {@link reason} of the selection (or cancellation).
- *
- * Also, `IAgenticaOperationSelection` is an union type that can
- * specify a subtype by checking the {@link protocol} property.
- *
- * @author Samchon
- */
-export interface IAgenticaOperationSelectionJson {
-  reason: string;
-  operation: IAgenticaOperationJson;
-}
+import { IAgenticaOperationJson } from "./IAgenticaOperationJson";
+
+/**
+ * Nestia agent operation selection.
+ *
+ * `IAgenticaOperationSelection` is a type represents an operation
+ * which has been selected by the A.I. chatbot of {@link Agentica}
+ * class for the LLM (Large Language Model) function calling with
+ * detailed {@link reason} of the selection (or cancellation).
+ *
+ * Also, `IAgenticaOperationSelection` is an union type that can
+ * specify a subtype by checking the {@link protocol} property.
+ *
+ * @author Samchon
+ */
+export interface IAgenticaOperationSelectionJson {
+  reason: string;
+  operation: IAgenticaOperationJson;
+}