@agentica/core 0.44.0-dev.20260313-2 → 0.44.0

package/src/constants/AgenticaConstant.ts

@@ -1,4 +1,4 @@
-export namespace AgenticaConstant {
-  export const RETRY = 3;
-  export const ELITICISM = true;
-}
+export namespace AgenticaConstant {
+  export const RETRY = 3;
+  export const ELITICISM = true;
+}

package/src/constants/AgenticaDefaultPrompt.ts

@@ -1,44 +1,44 @@
-import { is_node } from "tstl";
-
-import type { IAgenticaConfig } from "../structures/IAgenticaConfig";
-import type { IMicroAgenticaConfig } from "../structures/IMicroAgenticaConfig";
-import type { IMicroAgenticaSystemPrompt } from "../structures/IMicroAgenticaSystemPrompt";
-
-import { Singleton } from "../utils/Singleton";
-
-import { AgenticaSystemPrompt } from "./AgenticaSystemPrompt";
-
-/**
- * @TODO maybe replace `process` property for lint pass
- */
-const getLocale = new Singleton(() =>
-  is_node()
-    // eslint-disable-next-line node/prefer-global/process
-    ? (process.env.LANG?.split(".")[0] ?? "en-US")
-    : navigator.language,
-);
-
-const getTimezone = new Singleton(
-  () => Intl.DateTimeFormat().resolvedOptions().timeZone,
-);
-
-export function write(config?: IAgenticaConfig | IMicroAgenticaConfig): string {
-  if (config?.systemPrompt?.common !== undefined) {
-    return (config.systemPrompt as IMicroAgenticaSystemPrompt).common!(config as unknown as IMicroAgenticaConfig);
-  }
-
-  const locale: string = config?.locale ?? getLocale.get();
-  const timezone: string = config?.timezone ?? getTimezone.get();
-
-  return AgenticaSystemPrompt.COMMON
-  // intended code
-
-    .replace("${locale}", locale)
-
-    .replace("${timezone}", timezone)
-
-    .replace("${datetime}", new Date().toISOString());
-}
-export const AgenticaDefaultPrompt = {
-  write,
-};
+import { is_node } from "tstl";
+
+import type { IAgenticaConfig } from "../structures/IAgenticaConfig";
+import type { IMicroAgenticaConfig } from "../structures/IMicroAgenticaConfig";
+import type { IMicroAgenticaSystemPrompt } from "../structures/IMicroAgenticaSystemPrompt";
+
+import { Singleton } from "../utils/Singleton";
+
+import { AgenticaSystemPrompt } from "./AgenticaSystemPrompt";
+
+/**
+ * @TODO maybe replace `process` property for lint pass
+ */
+const getLocale = new Singleton(() =>
+  is_node()
+    // eslint-disable-next-line node/prefer-global/process
+    ? (process.env.LANG?.split(".")[0] ?? "en-US")
+    : navigator.language,
+);
+
+const getTimezone = new Singleton(
+  () => Intl.DateTimeFormat().resolvedOptions().timeZone,
+);
+
+export function write(config?: IAgenticaConfig | IMicroAgenticaConfig): string {
+  if (config?.systemPrompt?.common !== undefined) {
+    return (config.systemPrompt as IMicroAgenticaSystemPrompt).common!(config as unknown as IMicroAgenticaConfig);
+  }
+
+  const locale: string = config?.locale ?? getLocale.get();
+  const timezone: string = config?.timezone ?? getTimezone.get();
+
+  return AgenticaSystemPrompt.COMMON
+  // intended code
+
+    .replace("${locale}", locale)
+
+    .replace("${timezone}", timezone)
+
+    .replace("${datetime}", new Date().toISOString());
+}
+export const AgenticaDefaultPrompt = {
+  write,
+};

package/src/constants/index.ts

@@ -1,2 +1,2 @@
-export * from "./AgenticaDefaultPrompt";
-export * from "./AgenticaSystemPrompt";
+export * from "./AgenticaDefaultPrompt";
+export * from "./AgenticaSystemPrompt";

package/src/context/AgenticaContext.ts

@@ -1,136 +1,136 @@
-import type OpenAI from "openai";
-
-import type { AgenticaEvent } from "../events/AgenticaEvent";
-import type { AgenticaEventSource } from "../events/AgenticaEventSource";
-import type { AgenticaHistory } from "../histories/AgenticaHistory";
-import type { AgenticaUserMessageHistory } from "../histories/AgenticaUserMessageHistory";
-import type { IAgenticaConfig } from "../structures/IAgenticaConfig";
-
-import type { AgenticaContextRequestResult } from "./AgenticaContextRequestResult";
-import type { AgenticaOperationCollection } from "./AgenticaOperationCollection";
-import type { AgenticaOperationSelection } from "./AgenticaOperationSelection";
-
-/**
- * Context of the Agentic AI agent.
- *
- * `AgenticaContext` is a structure defining the context of the
- * internal agents composing the {@link Agentica}, like function
- * selector, executor, and describer, and so on. For example, if an
- * agent has been configured to utilize the OpenAI, the context will
- * be delivered to the below components.
- *
- * - {@link orchestrate.execute}
- *   - {@link orchestrate.initialize}
- *   - {@link orchestrate.select}
- *   - {@link orchestrate.call}
- *   - {@link orchestrate.describe}
- *   - {@link orchestrate.cancel}
- *
- * Also, as its name is context, it contains every information that
- * is required to interact with the AI vendor like OpenAI. It
- * contains every operations for LLM function calling, and
- * configuration used for the agent construction. And it contains
- * the prompt histories, and facade controller functions for
- * interacting with the {@link Agentica} like {@link dispatch}.
- *
- * In such reasons, if you're planning to customize some internal
- * agents, or add new agents with new process routine, you have to
- * understand this context structure. Otherwise you don't have any
- * plan to customize the internal agents, this context information is
- * not important for you.
- *
- * @author Samchon
- */
-export interface AgenticaContext {
-  // ----
-  // APPLICATION
-  // ----
-  /**
-   * Collection of operations.
-   *
-   * Collection of operations from every controllers, and their
-   * groups composed by the divide and conquer rule for the
-   * efficient operation selection if configured.
-   */
-  operations: AgenticaOperationCollection;
-
-  /**
-   * Configuration of the agent.
-   *
-   * Configuration of the agent, that is used when constructing the
-   * {@link Agentica} instance.
-   *
-   * @todo Write detaily after supporting the agent customization feature
-   */
-  config: IAgenticaConfig | undefined;
-
-  // ----
-  // STATES
-  // ----
-  /**
-   * Prompt histories.
-   */
-  histories: AgenticaHistory[];
-
-  /**
-   * Stacked operations.
-   *
-   * In other words, list of candidate operations for the LLM function calling.
-   */
-  stack: AgenticaOperationSelection[];
-
-  /**
-   * The user input history.
-   *
-   * The user input history written by the user through the
-   * {@link Agentica.conversate} function.
-   */
-  prompt: AgenticaUserMessageHistory;
-
-  /**
-   * Abort signal.
-   */
-  abortSignal?: AbortSignal;
-
-  /**
-   * Whether the agent is ready.
-   *
-   * Returns a boolean value indicates whether the agent is ready to
-   * perform the function calling.
-   *
-   * If the agent has called the {@link AgenticaContext.initialize},
-   * it returns `true`. Otherwise the {@link initialize} has never been
-   * called, returns `false`.
-   */
-  ready: () => boolean;
-
-  // ----
-  // HANDLERS
-  // ----
-  /**
-   * Dispatch event.
-   *
-   * Dispatch event so that the agent can be handle the event
-   * through the {@link Agentica.on} function.
-   *
-   * @param event Event to deliver
-   */
-  dispatch: (event: AgenticaEvent) => Promise<void>;
-
-  /**
-   * Request to the OpenAI server.
-   *
-   * @param source The source agent of the agent
-   * @param body The request body to the OpenAI server
-   * @returns Response from the OpenAI server
-   */
-  request: (
-    source: AgenticaEventSource,
-    body: Omit<OpenAI.ChatCompletionCreateParamsStreaming, "model" | "stream">,
-  ) => Promise<AgenticaContextRequestResult>;
-
-  /**
-   * Initialize the agent.
-   */
-  initialize: () => Promise<void>;
-}
+import type OpenAI from "openai";
+
+import type { AgenticaEvent } from "../events/AgenticaEvent";
+import type { AgenticaEventSource } from "../events/AgenticaEventSource";
+import type { AgenticaHistory } from "../histories/AgenticaHistory";
+import type { AgenticaUserMessageHistory } from "../histories/AgenticaUserMessageHistory";
+import type { IAgenticaConfig } from "../structures/IAgenticaConfig";
+
+import type { AgenticaContextRequestResult } from "./AgenticaContextRequestResult";
+import type { AgenticaOperationCollection } from "./AgenticaOperationCollection";
+import type { AgenticaOperationSelection } from "./AgenticaOperationSelection";
+
+/**
+ * Context of the Agentic AI agent.
+ *
+ * `AgenticaContext` is a structure defining the context of the
+ * internal agents composing the {@link Agentica}, like function
+ * selector, executor, and describer, and so on. For example, if an
+ * agent has been configured to utilize the OpenAI, the context will
+ * be delivered to the below components.
+ *
+ * - {@link orchestrate.execute}
+ *   - {@link orchestrate.initialize}
+ *   - {@link orchestrate.select}
+ *   - {@link orchestrate.call}
+ *   - {@link orchestrate.describe}
+ *   - {@link orchestrate.cancel}
+ *
+ * Also, as its name is context, it contains every information that
+ * is required to interact with the AI vendor like OpenAI. It
+ * contains every operations for LLM function calling, and
+ * configuration used for the agent construction. And it contains
+ * the prompt histories, and facade controller functions for
+ * interacting with the {@link Agentica} like {@link dispatch}.
+ *
+ * In such reasons, if you're planning to customize some internal
+ * agents, or add new agents with new process routine, you have to
+ * understand this context structure. Otherwise you don't have any
+ * plan to customize the internal agents, this context information is
+ * not important for you.
+ *
+ * @author Samchon
+ */
+export interface AgenticaContext {
+  // ----
+  // APPLICATION
+  // ----
+  /**
+   * Collection of operations.
+   *
+   * Collection of operations from every controllers, and their
+   * groups composed by the divide and conquer rule for the
+   * efficient operation selection if configured.
+   */
+  operations: AgenticaOperationCollection;
+
+  /**
+   * Configuration of the agent.
+   *
+   * Configuration of the agent, that is used when constructing the
+   * {@link Agentica} instance.
+   *
+   * @todo Write detaily after supporting the agent customization feature
+   */
+  config: IAgenticaConfig | undefined;
+
+  // ----
+  // STATES
+  // ----
+  /**
+   * Prompt histories.
+   */
+  histories: AgenticaHistory[];
+
+  /**
+   * Stacked operations.
+   *
+   * In other words, list of candidate operations for the LLM function calling.
+   */
+  stack: AgenticaOperationSelection[];
+
+  /**
+   * The user input history.
+   *
+   * The user input history written by the user through the
+   * {@link Agentica.conversate} function.
+   */
+  prompt: AgenticaUserMessageHistory;
+
+  /**
+   * Abort signal.
+   */
+  abortSignal?: AbortSignal;
+
+  /**
+   * Whether the agent is ready.
+   *
+   * Returns a boolean value indicates whether the agent is ready to
+   * perform the function calling.
+   *
+   * If the agent has called the {@link AgenticaContext.initialize},
+   * it returns `true`. Otherwise the {@link initialize} has never been
+   * called, returns `false`.
+   */
+  ready: () => boolean;
+
+  // ----
+  // HANDLERS
+  // ----
+  /**
+   * Dispatch event.
+   *
+   * Dispatch event so that the agent can be handle the event
+   * through the {@link Agentica.on} function.
+   *
+   * @param event Event to deliver
+   */
+  dispatch: (event: AgenticaEvent) => Promise<void>;
+
+  /**
+   * Request to the OpenAI server.
+   *
+   * @param source The source agent of the agent
+   * @param body The request body to the OpenAI server
+   * @returns Response from the OpenAI server
+   */
+  request: (
+    source: AgenticaEventSource,
+    body: Omit<OpenAI.ChatCompletionCreateParamsStreaming, "model" | "stream">,
+  ) => Promise<AgenticaContextRequestResult>;
+
+  /**
+   * Initialize the agent.
+   */
+  initialize: () => Promise<void>;
+}

package/src/context/AgenticaContextRequestResult.ts

@@ -1,14 +1,14 @@
-import type OpenAI from "openai";
-
-export type AgenticaContextRequestResult = AgenticaContextRequestResult.Stream | AgenticaContextRequestResult.NoneStream;
-
-export namespace AgenticaContextRequestResult {
-  export interface Stream {
-    type: "stream";
-    value: ReadableStream<OpenAI.Chat.Completions.ChatCompletionChunk>;
-  }
-  export interface NoneStream {
-    type: "none-stream";
-    value: OpenAI.ChatCompletion;
-  }
-}
+import type OpenAI from "openai";
+
+export type AgenticaContextRequestResult = AgenticaContextRequestResult.Stream | AgenticaContextRequestResult.NoneStream;
+
+export namespace AgenticaContextRequestResult {
+  export interface Stream {
+    type: "stream";
+    value: ReadableStream<OpenAI.Chat.Completions.ChatCompletionChunk>;
+  }
+  export interface NoneStream {
+    type: "none-stream";
+    value: OpenAI.ChatCompletion;
+  }
+}

package/src/context/AgenticaOperation.ts

@@ -1,73 +1,73 @@
-import type { IHttpLlmFunction } from "@typia/interface";
-import type { ILlmFunction } from "typia";
-
-import type { IAgenticaOperationJson } from "../json/IAgenticaOperationJson";
-import type { IAgenticaController } from "../structures/IAgenticaController";
-
-/**
- * Operation information in the Agentica Agent.
- *
- * `AgenticaOperation` 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 type AgenticaOperation
-  = | AgenticaOperation.Class
-    | AgenticaOperation.Http
-    | AgenticaOperation.Mcp;
-export namespace AgenticaOperation {
-  export type Class = Base<
-    "class",
-    IAgenticaController.IClass,
-    ILlmFunction
-  >;
-  export type Http = Base<
-    "http",
-    IAgenticaController.IHttp,
-    IHttpLlmFunction
-  >;
-  export type Mcp = Base<
-    "mcp",
-    IAgenticaController.IMcp,
-    ILlmFunction
-  >;
-
-  interface Base<
-    Protocol extends "http" | "class" | "mcp",
-    Controller extends object,
-    Function extends object,
-  > {
-    /**
-     * Protocol discriminator.
-     */
-    protocol: Protocol;
-
-    /**
-     * Belonged controller of the target function.
-     */
-    controller: Controller;
-
-    /**
-     * Target function to call.
-     */
-    function: Function;
-
-    /**
-     * Identifier name.
-     */
-    name: string;
-
-    /**
-     * Convert to primitive JSON object.
-     */
-    toJSON: () => IAgenticaOperationJson;
-  }
-}
+import type { IHttpLlmFunction } from "@typia/interface";
+import type { ILlmFunction } from "typia";
+
+import type { IAgenticaOperationJson } from "../json/IAgenticaOperationJson";
+import type { IAgenticaController } from "../structures/IAgenticaController";
+
+/**
+ * Operation information in the Agentica Agent.
+ *
+ * `AgenticaOperation` 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 type AgenticaOperation
+  = | AgenticaOperation.Class
+    | AgenticaOperation.Http
+    | AgenticaOperation.Mcp;
+export namespace AgenticaOperation {
+  export type Class = Base<
+    "class",
+    IAgenticaController.IClass,
+    ILlmFunction
+  >;
+  export type Http = Base<
+    "http",
+    IAgenticaController.IHttp,
+    IHttpLlmFunction
+  >;
+  export type Mcp = Base<
+    "mcp",
+    IAgenticaController.IMcp,
+    ILlmFunction
+  >;
+
+  interface Base<
+    Protocol extends "http" | "class" | "mcp",
+    Controller extends object,
+    Function extends object,
+  > {
+    /**
+     * Protocol discriminator.
+     */
+    protocol: Protocol;
+
+    /**
+     * Belonged controller of the target function.
+     */
+    controller: Controller;
+
+    /**
+     * Target function to call.
+     */
+    function: Function;
+
+    /**
+     * Identifier name.
+     */
+    name: string;
+
+    /**
+     * Convert to primitive JSON object.
+     */
+    toJSON: () => IAgenticaOperationJson;
+  }
+}

package/src/context/AgenticaOperationCollection.ts

@@ -1,49 +1,49 @@
-import type { AgenticaOperation } from "./AgenticaOperation";
-
-/**
- * Collection of operations used in the Agentica Agent.
- *
- * `IAgenticaOperationCollection` is an interface type representing
- * a collection of operations for several purposes used in the
- * {@link Agentica} internally.
- *
- * @author Samchon
- */
-export interface AgenticaOperationCollection {
-  /**
-   * List of every operations.
-   */
-  array: AgenticaOperation[];
-  /**
-   * Divided operations.
-   *
-   * If you've configured the {@link IAgenticaConfig.capacity} property,
-   * the  A.I. chatbot ({@link Agentica}) will separate the operations
-   * into the several groups to divide and conquer and LLM function selecting
-   * for accuracy.
-   *
-   * In that case, this property `divided`'s length would be dtermined by
-   * dividing the number of operations ({@link array}'s length) by the
-   * {@link IAgenticaConfig.capacity}.
-   *
-   * Otherwise, if the {@link IAgenticaConfig.capacity} has not been
-   * configured, this `divided` property would be the `undefined` value.
-   */
-  divided?: AgenticaOperation[][] | undefined;
-
-  /**
-   * Flat dictionary of operations.
-   *
-   * Dictionary of operations with their {@link IAgenticaOperation.name}.
-   */
-  flat: Map<string, AgenticaOperation>;
-
-  /**
-   * Group dictionary of operations.
-   *
-   * Dictionary of operations with their
-   * {@link IAgenticaOperation.controller.name} and
-   * {@link IAgenticaOperation.function.name}.
-   */
-  group: Map<string, Map<string, AgenticaOperation>>;
-}
+import type { AgenticaOperation } from "./AgenticaOperation";
+
+/**
+ * Collection of operations used in the Agentica Agent.
+ *
+ * `IAgenticaOperationCollection` is an interface type representing
+ * a collection of operations for several purposes used in the
+ * {@link Agentica} internally.
+ *
+ * @author Samchon
+ */
+export interface AgenticaOperationCollection {
+  /**
+   * List of every operations.
+   */
+  array: AgenticaOperation[];
+  /**
+   * Divided operations.
+   *
+   * If you've configured the {@link IAgenticaConfig.capacity} property,
+   * the  A.I. chatbot ({@link Agentica}) will separate the operations
+   * into the several groups to divide and conquer and LLM function selecting
+   * for accuracy.
+   *
+   * In that case, this property `divided`'s length would be dtermined by
+   * dividing the number of operations ({@link array}'s length) by the
+   * {@link IAgenticaConfig.capacity}.
+   *
+   * Otherwise, if the {@link IAgenticaConfig.capacity} has not been
+   * configured, this `divided` property would be the `undefined` value.
+   */
+  divided?: AgenticaOperation[][] | undefined;
+
+  /**
+   * Flat dictionary of operations.
+   *
+   * Dictionary of operations with their {@link IAgenticaOperation.name}.
+   */
+  flat: Map<string, AgenticaOperation>;
+
+  /**
+   * Group dictionary of operations.
+   *
+   * Dictionary of operations with their
+   * {@link IAgenticaOperation.controller.name} and
+   * {@link IAgenticaOperation.function.name}.
+   */
+  group: Map<string, Map<string, AgenticaOperation>>;
+}

package/src/context/AgenticaOperationSelection.ts

@@ -1,9 +1,9 @@
-import type { IAgenticaOperationSelectionJson } from "../json/IAgenticaOperationSelectionJson";
-
-import type { AgenticaOperation } from "./AgenticaOperation";
-
-export interface AgenticaOperationSelection {
-  operation: AgenticaOperation;
-  reason: string;
-  toJSON: () => IAgenticaOperationSelectionJson;
-}
+import type { IAgenticaOperationSelectionJson } from "../json/IAgenticaOperationSelectionJson";
+
+import type { AgenticaOperation } from "./AgenticaOperation";
+
+export interface AgenticaOperationSelection {
+  operation: AgenticaOperation;
+  reason: string;
+  toJSON: () => IAgenticaOperationSelectionJson;
+}