@agentica/core 0.12.1 → 0.12.2-dev.20250314

package/src/chatgpt/ChatGptUsageAggregator.ts

@@ -1,62 +1,62 @@
-import { CompletionUsage } from "openai/resources";
-
-export namespace ChatGptUsageAggregator {
-  export const sumCompletionTokenDetail = (
-    x: CompletionUsage.CompletionTokensDetails,
-    y: CompletionUsage.CompletionTokensDetails,
-  ): CompletionUsage.CompletionTokensDetails => {
-    return {
-      accepted_prediction_tokens:
-        (x.accepted_prediction_tokens ?? 0) +
-        (y.accepted_prediction_tokens ?? 0),
-      reasoning_tokens: (x.reasoning_tokens ?? 0) + (y.reasoning_tokens ?? 0),
-      rejected_prediction_tokens:
-        (x.rejected_prediction_tokens ?? 0) +
-        (y.rejected_prediction_tokens ?? 0),
-    };
-  };
-
-  export const sumPromptTokenDetail = (
-    x: CompletionUsage.PromptTokensDetails,
-    y: CompletionUsage.PromptTokensDetails,
-  ): CompletionUsage.PromptTokensDetails => {
-    return {
-      audio_tokens: (x.audio_tokens ?? 0) + (y.audio_tokens ?? 0),
-      cached_tokens: (x.cached_tokens ?? 0) + (y.cached_tokens ?? 0),
-    };
-  };
-
-  export const sum = (
-    x: CompletionUsage,
-    y: CompletionUsage,
-  ): CompletionUsage => {
-    return {
-      prompt_tokens: (x.prompt_tokens ?? 0) + (y.prompt_tokens ?? 0),
-      completion_tokens:
-        (x.completion_tokens ?? 0) + (y.completion_tokens ?? 0),
-      total_tokens: (x.total_tokens ?? 0) + (y.total_tokens ?? 0),
-      completion_tokens_details: sumCompletionTokenDetail(
-        x.completion_tokens_details ?? {
-          accepted_prediction_tokens: 0,
-          reasoning_tokens: 0,
-          rejected_prediction_tokens: 0,
-        },
-        y.completion_tokens_details ?? {
-          accepted_prediction_tokens: 0,
-          reasoning_tokens: 0,
-          rejected_prediction_tokens: 0,
-        },
-      ),
-      prompt_tokens_details: sumPromptTokenDetail(
-        x.prompt_tokens_details ?? {
-          audio_tokens: 0,
-          cached_tokens: 0,
-        },
-        y.prompt_tokens_details ?? {
-          audio_tokens: 0,
-          cached_tokens: 0,
-        },
-      ),
-    };
-  };
-}
+import { CompletionUsage } from "openai/resources";
+
+export namespace ChatGptUsageAggregator {
+  export const sumCompletionTokenDetail = (
+    x: CompletionUsage.CompletionTokensDetails,
+    y: CompletionUsage.CompletionTokensDetails,
+  ): CompletionUsage.CompletionTokensDetails => {
+    return {
+      accepted_prediction_tokens:
+        (x.accepted_prediction_tokens ?? 0) +
+        (y.accepted_prediction_tokens ?? 0),
+      reasoning_tokens: (x.reasoning_tokens ?? 0) + (y.reasoning_tokens ?? 0),
+      rejected_prediction_tokens:
+        (x.rejected_prediction_tokens ?? 0) +
+        (y.rejected_prediction_tokens ?? 0),
+    };
+  };
+
+  export const sumPromptTokenDetail = (
+    x: CompletionUsage.PromptTokensDetails,
+    y: CompletionUsage.PromptTokensDetails,
+  ): CompletionUsage.PromptTokensDetails => {
+    return {
+      audio_tokens: (x.audio_tokens ?? 0) + (y.audio_tokens ?? 0),
+      cached_tokens: (x.cached_tokens ?? 0) + (y.cached_tokens ?? 0),
+    };
+  };
+
+  export const sum = (
+    x: CompletionUsage,
+    y: CompletionUsage,
+  ): CompletionUsage => {
+    return {
+      prompt_tokens: (x.prompt_tokens ?? 0) + (y.prompt_tokens ?? 0),
+      completion_tokens:
+        (x.completion_tokens ?? 0) + (y.completion_tokens ?? 0),
+      total_tokens: (x.total_tokens ?? 0) + (y.total_tokens ?? 0),
+      completion_tokens_details: sumCompletionTokenDetail(
+        x.completion_tokens_details ?? {
+          accepted_prediction_tokens: 0,
+          reasoning_tokens: 0,
+          rejected_prediction_tokens: 0,
+        },
+        y.completion_tokens_details ?? {
+          accepted_prediction_tokens: 0,
+          reasoning_tokens: 0,
+          rejected_prediction_tokens: 0,
+        },
+      ),
+      prompt_tokens_details: sumPromptTokenDetail(
+        x.prompt_tokens_details ?? {
+          audio_tokens: 0,
+          cached_tokens: 0,
+        },
+        y.prompt_tokens_details ?? {
+          audio_tokens: 0,
+          cached_tokens: 0,
+        },
+      ),
+    };
+  };
+}

package/src/context/AgenticaCancelPrompt.ts

@@ -1,32 +1,32 @@
-import { ILlmSchema } from "@samchon/openapi";
-
-import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
-import { AgenticaPromptBase } from "../prompts/AgenticaPromptBase";
-import { AgenticaOperationSelection } from "./AgenticaOperationSelection";
-
-export class AgenticaCancelPrompt<
-  Model extends ILlmSchema.Model,
-> extends AgenticaPromptBase<"cancel", IAgenticaPromptJson.ICancel> {
-  public readonly id: string;
-  public readonly selections: AgenticaOperationSelection<Model>[];
-
-  public constructor(props: AgenticaCancelPrompt.IProps<Model>) {
-    super("cancel");
-    this.id = props.id;
-    this.selections = props.selections;
-  }
-
-  public toJSON(): IAgenticaPromptJson.ICancel {
-    return {
-      type: this.type,
-      id: this.id,
-      selections: this.selections.map((s) => s.toJSON()),
-    };
-  }
-}
-export namespace AgenticaCancelPrompt {
-  export interface IProps<Model extends ILlmSchema.Model> {
-    id: string;
-    selections: AgenticaOperationSelection<Model>[];
-  }
-}
+import { ILlmSchema } from "@samchon/openapi";
+
+import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
+import { AgenticaPromptBase } from "../prompts/AgenticaPromptBase";
+import { AgenticaOperationSelection } from "./AgenticaOperationSelection";
+
+export class AgenticaCancelPrompt<
+  Model extends ILlmSchema.Model,
+> extends AgenticaPromptBase<"cancel", IAgenticaPromptJson.ICancel> {
+  public readonly id: string;
+  public readonly selections: AgenticaOperationSelection<Model>[];
+
+  public constructor(props: AgenticaCancelPrompt.IProps<Model>) {
+    super("cancel");
+    this.id = props.id;
+    this.selections = props.selections;
+  }
+
+  public toJSON(): IAgenticaPromptJson.ICancel {
+    return {
+      type: this.type,
+      id: this.id,
+      selections: this.selections.map((s) => s.toJSON()),
+    };
+  }
+}
+export namespace AgenticaCancelPrompt {
+  export interface IProps<Model extends ILlmSchema.Model> {
+    id: string;
+    selections: AgenticaOperationSelection<Model>[];
+  }
+}

package/src/context/AgenticaClassOperation.ts

@@ -1,23 +1,23 @@
-import { ILlmApplication, ILlmFunction, ILlmSchema } from "@samchon/openapi";
-
-import { AgenticaOperationBase } from "./AgenticaOperationBase";
-
-export class AgenticaClassOperation<
-  Model extends ILlmSchema.Model,
-> extends AgenticaOperationBase<
-  "class",
-  ILlmApplication<Model>,
-  ILlmFunction<Model>
-> {
-  public constructor(props: AgenticaClassOperation.IProps<Model>) {
-    super(props);
-  }
-}
-export namespace AgenticaClassOperation {
-  export type IProps<Model extends ILlmSchema.Model> =
-    AgenticaOperationBase.IProps<
-      "class",
-      ILlmApplication<Model>,
-      ILlmFunction<Model>
-    >;
-}
+import { ILlmApplication, ILlmFunction, ILlmSchema } from "@samchon/openapi";
+
+import { AgenticaOperationBase } from "./AgenticaOperationBase";
+
+export class AgenticaClassOperation<
+  Model extends ILlmSchema.Model,
+> extends AgenticaOperationBase<
+  "class",
+  ILlmApplication<Model>,
+  ILlmFunction<Model>
+> {
+  public constructor(props: AgenticaClassOperation.IProps<Model>) {
+    super(props);
+  }
+}
+export namespace AgenticaClassOperation {
+  export type IProps<Model extends ILlmSchema.Model> =
+    AgenticaOperationBase.IProps<
+      "class",
+      ILlmApplication<Model>,
+      ILlmFunction<Model>
+    >;
+}

package/src/context/AgenticaContext.ts

@@ -1,130 +1,130 @@
-import { ILlmSchema } from "@samchon/openapi";
-import OpenAI from "openai";
-
-import { AgenticaEvent } from "../events/AgenticaEvent";
-import { AgenticaEventSource } from "../events/AgenticaEventSource";
-import { AgenticaPrompt } from "../prompts/AgenticaPrompt";
-import { AgenticaTextPrompt } from "../prompts/AgenticaTextPrompt";
-import { IAgenticaConfig } from "../structures/IAgenticaConfig";
-import { AgenticaOperationCollection } from "./AgenticaOperationCollection";
-import { AgenticaOperationSelection } from "./AgenticaOperationSelection";
-
-/**
- * Context of the Nestia A.I. agent.
- *
- * `IAgenticaContext` 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 ChatGptAgent}
- *   - {@link ChatGptInitializeFunctionAgent}
- *   - {@link ChatGptSelectFunctionAgent}
- *   - {@link ChatGptExecuteFunctionAgent}
- *   - {@link ChatGptDescribeFunctionAgent}
- *   - {@link ChatGptCancelFunctionAgent}
- *
- * 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<Model extends ILlmSchema.Model> {
-  //----
-  // 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<Model>;
-
-  /**
-   * 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<Model> | undefined;
-
-  //----
-  // STATES
-  //----
-  /**
-   * Prompt histories.
-   */
-  histories: AgenticaPrompt<Model>[];
-
-  /**
-   * Stacked operations.
-   *
-   * In other words, list of candidate operations for the LLM function calling.
-   */
-  stack: AgenticaOperationSelection<Model>[];
-
-  /**
-   * Text prompt of the user.
-   *
-   * Text conversation written the by user through the
-   * {@link Agentica.conversate} function.
-   */
-  prompt: AgenticaTextPrompt<"user">;
-
-  /**
-   * 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<Model>) => 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<ReadableStream<OpenAI.Chat.Completions.ChatCompletionChunk>>;
-
-  /**
-   * Initialize the agent.
-   */
-  initialize: () => Promise<void>;
-}
+import { ILlmSchema } from "@samchon/openapi";
+import OpenAI from "openai";
+
+import { AgenticaEvent } from "../events/AgenticaEvent";
+import { AgenticaEventSource } from "../events/AgenticaEventSource";
+import { AgenticaPrompt } from "../prompts/AgenticaPrompt";
+import { AgenticaTextPrompt } from "../prompts/AgenticaTextPrompt";
+import { IAgenticaConfig } from "../structures/IAgenticaConfig";
+import { AgenticaOperationCollection } from "./AgenticaOperationCollection";
+import { AgenticaOperationSelection } from "./AgenticaOperationSelection";
+
+/**
+ * Context of the Nestia A.I. agent.
+ *
+ * `IAgenticaContext` 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 ChatGptAgent}
+ *   - {@link ChatGptInitializeFunctionAgent}
+ *   - {@link ChatGptSelectFunctionAgent}
+ *   - {@link ChatGptExecuteFunctionAgent}
+ *   - {@link ChatGptDescribeFunctionAgent}
+ *   - {@link ChatGptCancelFunctionAgent}
+ *
+ * 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<Model extends ILlmSchema.Model> {
+  //----
+  // 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<Model>;
+
+  /**
+   * 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<Model> | undefined;
+
+  //----
+  // STATES
+  //----
+  /**
+   * Prompt histories.
+   */
+  histories: AgenticaPrompt<Model>[];
+
+  /**
+   * Stacked operations.
+   *
+   * In other words, list of candidate operations for the LLM function calling.
+   */
+  stack: AgenticaOperationSelection<Model>[];
+
+  /**
+   * Text prompt of the user.
+   *
+   * Text conversation written the by user through the
+   * {@link Agentica.conversate} function.
+   */
+  prompt: AgenticaTextPrompt<"user">;
+
+  /**
+   * 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<Model>) => 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<ReadableStream<OpenAI.Chat.Completions.ChatCompletionChunk>>;
+
+  /**
+   * Initialize the agent.
+   */
+  initialize: () => Promise<void>;
+}

package/src/context/AgenticaHttpOperation.ts

@@ -1,27 +1,27 @@
-import {
-  IHttpLlmApplication,
-  IHttpLlmFunction,
-  ILlmSchema,
-} from "@samchon/openapi";
-
-import { AgenticaOperationBase } from "./AgenticaOperationBase";
-
-export class AgenticaHttpOperation<
-  Model extends ILlmSchema.Model,
-> extends AgenticaOperationBase<
-  "http",
-  IHttpLlmApplication<Model>,
-  IHttpLlmFunction<Model>
-> {
-  public constructor(props: AgenticaHttpOperation.IProps<Model>) {
-    super(props);
-  }
-}
-export namespace AgenticaHttpOperation {
-  export type IProps<Model extends ILlmSchema.Model> =
-    AgenticaOperationBase.IProps<
-      "http",
-      IHttpLlmApplication<Model>,
-      IHttpLlmFunction<Model>
-    >;
-}
+import {
+  IHttpLlmApplication,
+  IHttpLlmFunction,
+  ILlmSchema,
+} from "@samchon/openapi";
+
+import { AgenticaOperationBase } from "./AgenticaOperationBase";
+
+export class AgenticaHttpOperation<
+  Model extends ILlmSchema.Model,
+> extends AgenticaOperationBase<
+  "http",
+  IHttpLlmApplication<Model>,
+  IHttpLlmFunction<Model>
+> {
+  public constructor(props: AgenticaHttpOperation.IProps<Model>) {
+    super(props);
+  }
+}
+export namespace AgenticaHttpOperation {
+  export type IProps<Model extends ILlmSchema.Model> =
+    AgenticaOperationBase.IProps<
+      "http",
+      IHttpLlmApplication<Model>,
+      IHttpLlmFunction<Model>
+    >;
+}