@agentica/core 0.43.3 → 0.44.0-dev.20260313

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;
+}

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;
+  }
+}