@agentica/core 0.44.0-dev.20260313 → 0.44.0

package/src/context/AgenticaTokenUsage.ts

@@ -1,186 +1,186 @@
-import type { CompletionUsage } from "openai/resources";
-
-import typia from "typia";
-
-import type { IAgenticaTokenUsageJson } from "../json/IAgenticaTokenUsageJson";
-
-import { AgenticaTokenUsageAggregator } from "./internal/AgenticaTokenUsageAggregator";
-
-export class AgenticaTokenUsage implements IAgenticaTokenUsageJson {
-  /**
-   * Aggregated token usage.
-   */
-  public readonly aggregate: AgenticaTokenUsage.IComponent;
-
-  /**
-   * Token uasge of initializer agent.
-   */
-  public readonly initialize: AgenticaTokenUsage.IComponent;
-
-  /**
-   * Token usage of function selector agent.
-   */
-  public readonly select: AgenticaTokenUsage.IComponent;
-
-  /**
-   * Token usage of function canceler agent.
-   */
-  public readonly cancel: AgenticaTokenUsage.IComponent;
-
-  /**
-   * Token usage of function caller agent.
-   */
-  public readonly call: AgenticaTokenUsage.IComponent;
-
-  /**
-   * Token usage of function calling describer agent.
-   */
-  public readonly describe: AgenticaTokenUsage.IComponent;
-
-  public constructor(props?: IAgenticaTokenUsageJson) {
-    if (props === undefined) {
-      const zero = AgenticaTokenUsage.zero();
-      this.aggregate = zero.aggregate;
-      this.initialize = zero.initialize;
-      this.select = zero.select;
-      this.cancel = zero.cancel;
-      this.call = zero.call;
-      this.describe = zero.describe;
-    }
-    else {
-      this.aggregate = props.aggregate;
-      this.initialize = props.initialize;
-      this.select = props.select;
-      this.cancel = props.cancel;
-      this.call = props.call;
-      this.describe = props.describe;
-    }
-  }
-
-  public increment(y: IAgenticaTokenUsageJson): void {
-    const increment = (
-      x: IAgenticaTokenUsageJson.IComponent,
-      y: IAgenticaTokenUsageJson.IComponent,
-    ): void => {
-      x.total += y.total;
-      x.input.total += y.input.total;
-      x.input.cached += y.input.cached;
-      x.output.total += y.output.total;
-      x.output.reasoning += y.output.reasoning;
-      x.output.accepted_prediction += y.output.accepted_prediction;
-      x.output.rejected_prediction += y.output.rejected_prediction;
-    };
-    increment(this.aggregate, y.aggregate);
-    increment(this.initialize, y.initialize);
-    increment(this.select, y.select);
-    increment(this.cancel, y.cancel);
-    increment(this.call, y.call);
-    increment(this.describe, y.describe);
-  }
-
-  public use(
-    kind: Exclude<keyof IAgenticaTokenUsageJson, "aggregate">,
-    completionUsage: CompletionUsage,
-  ): void {
-    AgenticaTokenUsageAggregator.aggregate({
-      kind,
-      completionUsage,
-      usage: this,
-    });
-  }
-
-  public toJSON(): IAgenticaTokenUsageJson {
-    return typia.misc.clone<IAgenticaTokenUsageJson>(this);
-  }
-
-  public static zero(): AgenticaTokenUsage {
-    const component = (): IAgenticaTokenUsageJson.IComponent => ({
-      total: 0,
-      input: {
-        total: 0,
-        cached: 0,
-      },
-      output: {
-        total: 0,
-        reasoning: 0,
-        accepted_prediction: 0,
-        rejected_prediction: 0,
-      },
-    });
-    return new AgenticaTokenUsage({
-      aggregate: component(),
-      initialize: component(),
-      select: component(),
-      cancel: component(),
-      call: component(),
-      describe: component(),
-    });
-  }
-
-  public static plus(
-    x: AgenticaTokenUsage,
-    y: AgenticaTokenUsage,
-  ): AgenticaTokenUsage {
-    const z: AgenticaTokenUsage = new AgenticaTokenUsage(x.toJSON());
-    z.increment(y.toJSON());
-    return z;
-  }
-}
-export namespace AgenticaTokenUsage {
-  export interface IComponent {
-    /**
-     * Total token usage.
-     */
-    total: number;
-
-    /**
-     * Input token usage of detailed.
-     */
-    input: IInput;
-
-    /**
-     * Output token usage of detailed.
-     */
-    output: IOutput;
-  }
-
-  /**
-   * Input token usage of detailed.
-   */
-  export interface IInput {
-    /**
-     * Total amount of input token uasge.
-     */
-    total: number;
-
-    /**
-     * Cached token usage.
-     */
-    cached: number;
-  }
-
-  /**
-   * Output token usage of detailed.
-   */
-  export interface IOutput {
-    /**
-     * Total amount of output token usage.
-     */
-    total: number;
-
-    /**
-     * Reasoning token usage.
-     */
-    reasoning: number;
-
-    /**
-     * Prediction token usage.
-     */
-    accepted_prediction: number;
-
-    /**
-     * Rejected prediction token usage.
-     */
-    rejected_prediction: number;
-  }
-}
+import type { CompletionUsage } from "openai/resources";
+
+import typia from "typia";
+
+import type { IAgenticaTokenUsageJson } from "../json/IAgenticaTokenUsageJson";
+
+import { AgenticaTokenUsageAggregator } from "./internal/AgenticaTokenUsageAggregator";
+
+export class AgenticaTokenUsage implements IAgenticaTokenUsageJson {
+  /**
+   * Aggregated token usage.
+   */
+  public readonly aggregate: AgenticaTokenUsage.IComponent;
+
+  /**
+   * Token uasge of initializer agent.
+   */
+  public readonly initialize: AgenticaTokenUsage.IComponent;
+
+  /**
+   * Token usage of function selector agent.
+   */
+  public readonly select: AgenticaTokenUsage.IComponent;
+
+  /**
+   * Token usage of function canceler agent.
+   */
+  public readonly cancel: AgenticaTokenUsage.IComponent;
+
+  /**
+   * Token usage of function caller agent.
+   */
+  public readonly call: AgenticaTokenUsage.IComponent;
+
+  /**
+   * Token usage of function calling describer agent.
+   */
+  public readonly describe: AgenticaTokenUsage.IComponent;
+
+  public constructor(props?: IAgenticaTokenUsageJson) {
+    if (props === undefined) {
+      const zero = AgenticaTokenUsage.zero();
+      this.aggregate = zero.aggregate;
+      this.initialize = zero.initialize;
+      this.select = zero.select;
+      this.cancel = zero.cancel;
+      this.call = zero.call;
+      this.describe = zero.describe;
+    }
+    else {
+      this.aggregate = props.aggregate;
+      this.initialize = props.initialize;
+      this.select = props.select;
+      this.cancel = props.cancel;
+      this.call = props.call;
+      this.describe = props.describe;
+    }
+  }
+
+  public increment(y: IAgenticaTokenUsageJson): void {
+    const increment = (
+      x: IAgenticaTokenUsageJson.IComponent,
+      y: IAgenticaTokenUsageJson.IComponent,
+    ): void => {
+      x.total += y.total;
+      x.input.total += y.input.total;
+      x.input.cached += y.input.cached;
+      x.output.total += y.output.total;
+      x.output.reasoning += y.output.reasoning;
+      x.output.accepted_prediction += y.output.accepted_prediction;
+      x.output.rejected_prediction += y.output.rejected_prediction;
+    };
+    increment(this.aggregate, y.aggregate);
+    increment(this.initialize, y.initialize);
+    increment(this.select, y.select);
+    increment(this.cancel, y.cancel);
+    increment(this.call, y.call);
+    increment(this.describe, y.describe);
+  }
+
+  public use(
+    kind: Exclude<keyof IAgenticaTokenUsageJson, "aggregate">,
+    completionUsage: CompletionUsage,
+  ): void {
+    AgenticaTokenUsageAggregator.aggregate({
+      kind,
+      completionUsage,
+      usage: this,
+    });
+  }
+
+  public toJSON(): IAgenticaTokenUsageJson {
+    return typia.misc.clone<IAgenticaTokenUsageJson>(this);
+  }
+
+  public static zero(): AgenticaTokenUsage {
+    const component = (): IAgenticaTokenUsageJson.IComponent => ({
+      total: 0,
+      input: {
+        total: 0,
+        cached: 0,
+      },
+      output: {
+        total: 0,
+        reasoning: 0,
+        accepted_prediction: 0,
+        rejected_prediction: 0,
+      },
+    });
+    return new AgenticaTokenUsage({
+      aggregate: component(),
+      initialize: component(),
+      select: component(),
+      cancel: component(),
+      call: component(),
+      describe: component(),
+    });
+  }
+
+  public static plus(
+    x: AgenticaTokenUsage,
+    y: AgenticaTokenUsage,
+  ): AgenticaTokenUsage {
+    const z: AgenticaTokenUsage = new AgenticaTokenUsage(x.toJSON());
+    z.increment(y.toJSON());
+    return z;
+  }
+}
+export namespace AgenticaTokenUsage {
+  export interface IComponent {
+    /**
+     * Total token usage.
+     */
+    total: number;
+
+    /**
+     * Input token usage of detailed.
+     */
+    input: IInput;
+
+    /**
+     * Output token usage of detailed.
+     */
+    output: IOutput;
+  }
+
+  /**
+   * Input token usage of detailed.
+   */
+  export interface IInput {
+    /**
+     * Total amount of input token uasge.
+     */
+    total: number;
+
+    /**
+     * Cached token usage.
+     */
+    cached: number;
+  }
+
+  /**
+   * Output token usage of detailed.
+   */
+  export interface IOutput {
+    /**
+     * Total amount of output token usage.
+     */
+    total: number;
+
+    /**
+     * Reasoning token usage.
+     */
+    reasoning: number;
+
+    /**
+     * Prediction token usage.
+     */
+    accepted_prediction: number;
+
+    /**
+     * Rejected prediction token usage.
+     */
+    rejected_prediction: number;
+  }
+}

package/src/context/MicroAgenticaContext.ts

@@ -1,99 +1,99 @@
-import type OpenAI from "openai";
-
-import type { MicroAgenticaEvent } from "../events/MicroAgenticaEvent";
-import type { AgenticaUserMessageHistory } from "../histories/AgenticaUserMessageHistory";
-import type { MicroAgenticaHistory } from "../histories/MicroAgenticaHistory";
-import type { IMicroAgenticaConfig } from "../structures/IMicroAgenticaConfig";
-
-import type { AgenticaContextRequestResult } from "./AgenticaContextRequestResult";
-import type { AgenticaOperationCollection } from "./AgenticaOperationCollection";
-
-/**
- * Context of the Micro Agentic AI agent.
- *
- * `MicroAgenticaContext` is a structure defining the context of the
- * internal agents composing the {@link MicroAgentica}.
- *
- * 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 MicroAgentica} 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 MicroAgenticaContext {
-  // ----
-  // 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: IMicroAgenticaConfig | undefined;
-
-  // ----
-  // STATES
-  // ----
-  /**
-   * Prompt histories.
-   */
-  histories: MicroAgenticaHistory[];
-
-  /**
-   * Text prompt of the user.
-   *
-   * Text conversation written the by user through the
-   * {@link Agentica.conversate} function.
-   */
-  prompt: AgenticaUserMessageHistory;
-
-  /**
-   * Abort signal.
-   */
-  abortSignal?: AbortSignal;
-  // ----
-  // HANDLERS
-  // ----
-  /**
-   * Dispatch event.
-   *
-   * Dispatch event so that the agent can be handle the event
-   * through the {@link MicroAgentica.on} function.
-   *
-   * @param event Event to deliver
-   */
-  dispatch: (event: MicroAgenticaEvent) => 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: MicroAgenticaEvent.Source,
-    body: Omit<OpenAI.ChatCompletionCreateParamsStreaming, "model" | "stream">,
-  ) => Promise<AgenticaContextRequestResult>;
-}
+import type OpenAI from "openai";
+
+import type { MicroAgenticaEvent } from "../events/MicroAgenticaEvent";
+import type { AgenticaUserMessageHistory } from "../histories/AgenticaUserMessageHistory";
+import type { MicroAgenticaHistory } from "../histories/MicroAgenticaHistory";
+import type { IMicroAgenticaConfig } from "../structures/IMicroAgenticaConfig";
+
+import type { AgenticaContextRequestResult } from "./AgenticaContextRequestResult";
+import type { AgenticaOperationCollection } from "./AgenticaOperationCollection";
+
+/**
+ * Context of the Micro Agentic AI agent.
+ *
+ * `MicroAgenticaContext` is a structure defining the context of the
+ * internal agents composing the {@link MicroAgentica}.
+ *
+ * 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 MicroAgentica} 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 MicroAgenticaContext {
+  // ----
+  // 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: IMicroAgenticaConfig | undefined;
+
+  // ----
+  // STATES
+  // ----
+  /**
+   * Prompt histories.
+   */
+  histories: MicroAgenticaHistory[];
+
+  /**
+   * Text prompt of the user.
+   *
+   * Text conversation written the by user through the
+   * {@link Agentica.conversate} function.
+   */
+  prompt: AgenticaUserMessageHistory;
+
+  /**
+   * Abort signal.
+   */
+  abortSignal?: AbortSignal;
+  // ----
+  // HANDLERS
+  // ----
+  /**
+   * Dispatch event.
+   *
+   * Dispatch event so that the agent can be handle the event
+   * through the {@link MicroAgentica.on} function.
+   *
+   * @param event Event to deliver
+   */
+  dispatch: (event: MicroAgenticaEvent) => 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: MicroAgenticaEvent.Source,
+    body: Omit<OpenAI.ChatCompletionCreateParamsStreaming, "model" | "stream">,
+  ) => Promise<AgenticaContextRequestResult>;
+}

package/src/context/index.ts

@@ -1,5 +1,5 @@
-export * from "./AgenticaContext";
-export * from "./AgenticaOperation";
-export * from "./AgenticaOperationCollection";
-export * from "./AgenticaOperationSelection";
-export * from "./AgenticaTokenUsage";
+export * from "./AgenticaContext";
+export * from "./AgenticaOperation";
+export * from "./AgenticaOperationCollection";
+export * from "./AgenticaOperationSelection";
+export * from "./AgenticaTokenUsage";