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

package/src/structures/IAgenticaSelectBenchmarkEvent.ts

@@ -1,122 +1,122 @@
-/**
- * @module
- * This file contains the implementation of the IAgenticaSelectBenchmarkEvent class.
- *
- * @author Wrtn Technologies
- */
-import type {
-  AgenticaAssistantMessageHistory,
-  AgenticaOperationSelection,
-  AgenticaTokenUsage,
-} from "@agentica/core";
-
-import type { IAgenticaSelectBenchmarkScenario } from "./IAgenticaSelectBenchmarkScenario";
-
-/**
- * Event of LLM function selection benchmark.
- *
- * `IAgenticaSelectBenchmarkEvent` is an union type of the events occurred
- * during the LLM function selection benchmark, representing one phase of
- * the benchmark testing about a scenario.
- *
- * In other words, when {@link AgenticaSelectBenchmark} executes the
- * benchmark, it will run the benchmark will test a scenario repeately with
- * the given configuration {@link AgenticaSelectBenchmark.IConfig.repeat}.
- * And in the repeated benchmark about a scenario,
- * `IAgenticaSelectBenchmarkEvent` is one of the repeated testing.
- *
- * For reference, `IAgenticaSelectBenchmarkEvent` is categorized into three
- * types: `success`, `failure`, and `error`. The `success` means the
- * benchmark testing is fully meet the expected scenario, and `failure`
- * means that the `selector` had not selected the expected operations. The
- * last type, `error`, means that an error had been occurred during the
- * benchmark testing.
- *
- * @author Samchon
- */
-export type IAgenticaSelectBenchmarkEvent
-  = | IAgenticaSelectBenchmarkEvent.ISuccess
-    | IAgenticaSelectBenchmarkEvent.IFailure
-    | IAgenticaSelectBenchmarkEvent.IError;
-export namespace IAgenticaSelectBenchmarkEvent {
-  /**
-   * Success event type.
-   *
-   * The `success` event type represents that the benchmark testing is
-   * fully meet the expected scenario.
-   */
-  export interface ISuccess extends IEventBase<"success"> {
-    /**
-     * Usage of the token during the benchmark.
-     */
-    usage: AgenticaTokenUsage;
-
-    /**
-     * Selected operations in the benchmark.
-     */
-    selected: AgenticaOperationSelection[];
-
-    /**
-     * Prompt messages from the assistant.
-     */
-    assistantPrompts: AgenticaAssistantMessageHistory[];
-  }
-
-  /**
-   * Failure event type.
-   *
-   * The `failure` event type represents that the `selector` had not
-   * selected the expected scenario in the benchmark testing.
-   */
-  export interface IFailure extends IEventBase<"failure"> {
-    /**
-     * Usage of the token during the benchmark.
-     */
-    usage: AgenticaTokenUsage;
-
-    /**
-     * Selected operations in the benchmark.
-     */
-    selected: AgenticaOperationSelection[];
-
-    /**
-     * Prompt messages from the assistant.
-     */
-    assistantPrompts: AgenticaAssistantMessageHistory[];
-  }
-
-  /**
-   * Error event type.
-   *
-   * The `error` event type repsents that an error had been occurred
-   * during the benchmark testing.
-   */
-  export interface IError extends IEventBase<"error"> {
-    /**
-     * Error occurred during the benchmark.
-     */
-    error: unknown;
-  }
-
-  interface IEventBase<Type extends string> {
-    /**
-     * Discriminant type.
-     */
-    type: Type;
-
-    /**
-     * Expected scenario.
-     */
-    scenario: IAgenticaSelectBenchmarkScenario;
-
-    /**
-     * When the benchmark testing started.
-     */
-    started_at: Date;
-
-    /**
-     * When the benchmark testing completed.
-     */
-    completed_at: Date;
-  }
-}
+/**
+ * @module
+ * This file contains the implementation of the IAgenticaSelectBenchmarkEvent class.
+ *
+ * @author Wrtn Technologies
+ */
+import type {
+  AgenticaAssistantMessageHistory,
+  AgenticaOperationSelection,
+  AgenticaTokenUsage,
+} from "@agentica/core";
+
+import type { IAgenticaSelectBenchmarkScenario } from "./IAgenticaSelectBenchmarkScenario";
+
+/**
+ * Event of LLM function selection benchmark.
+ *
+ * `IAgenticaSelectBenchmarkEvent` is an union type of the events occurred
+ * during the LLM function selection benchmark, representing one phase of
+ * the benchmark testing about a scenario.
+ *
+ * In other words, when {@link AgenticaSelectBenchmark} executes the
+ * benchmark, it will run the benchmark will test a scenario repeately with
+ * the given configuration {@link AgenticaSelectBenchmark.IConfig.repeat}.
+ * And in the repeated benchmark about a scenario,
+ * `IAgenticaSelectBenchmarkEvent` is one of the repeated testing.
+ *
+ * For reference, `IAgenticaSelectBenchmarkEvent` is categorized into three
+ * types: `success`, `failure`, and `error`. The `success` means the
+ * benchmark testing is fully meet the expected scenario, and `failure`
+ * means that the `selector` had not selected the expected operations. The
+ * last type, `error`, means that an error had been occurred during the
+ * benchmark testing.
+ *
+ * @author Samchon
+ */
+export type IAgenticaSelectBenchmarkEvent
+  = | IAgenticaSelectBenchmarkEvent.ISuccess
+    | IAgenticaSelectBenchmarkEvent.IFailure
+    | IAgenticaSelectBenchmarkEvent.IError;
+export namespace IAgenticaSelectBenchmarkEvent {
+  /**
+   * Success event type.
+   *
+   * The `success` event type represents that the benchmark testing is
+   * fully meet the expected scenario.
+   */
+  export interface ISuccess extends IEventBase<"success"> {
+    /**
+     * Usage of the token during the benchmark.
+     */
+    usage: AgenticaTokenUsage;
+
+    /**
+     * Selected operations in the benchmark.
+     */
+    selected: AgenticaOperationSelection[];
+
+    /**
+     * Prompt messages from the assistant.
+     */
+    assistantPrompts: AgenticaAssistantMessageHistory[];
+  }
+
+  /**
+   * Failure event type.
+   *
+   * The `failure` event type represents that the `selector` had not
+   * selected the expected scenario in the benchmark testing.
+   */
+  export interface IFailure extends IEventBase<"failure"> {
+    /**
+     * Usage of the token during the benchmark.
+     */
+    usage: AgenticaTokenUsage;
+
+    /**
+     * Selected operations in the benchmark.
+     */
+    selected: AgenticaOperationSelection[];
+
+    /**
+     * Prompt messages from the assistant.
+     */
+    assistantPrompts: AgenticaAssistantMessageHistory[];
+  }
+
+  /**
+   * Error event type.
+   *
+   * The `error` event type repsents that an error had been occurred
+   * during the benchmark testing.
+   */
+  export interface IError extends IEventBase<"error"> {
+    /**
+     * Error occurred during the benchmark.
+     */
+    error: unknown;
+  }
+
+  interface IEventBase<Type extends string> {
+    /**
+     * Discriminant type.
+     */
+    type: Type;
+
+    /**
+     * Expected scenario.
+     */
+    scenario: IAgenticaSelectBenchmarkScenario;
+
+    /**
+     * When the benchmark testing started.
+     */
+    started_at: Date;
+
+    /**
+     * When the benchmark testing completed.
+     */
+    completed_at: Date;
+  }
+}

package/src/structures/IAgenticaSelectBenchmarkResult.ts

@@ -1,75 +1,75 @@
-/**
- * @module
- * This file contains the implementation of the IAgenticaSelectBenchmarkResult class.
- *
- * @author Wrtn Technologies
- */
-import type { AgenticaTokenUsage } from "@agentica/core";
-
-import type { IAgenticaSelectBenchmarkEvent } from "./IAgenticaSelectBenchmarkEvent";
-import type { IAgenticaSelectBenchmarkScenario } from "./IAgenticaSelectBenchmarkScenario";
-
-/**
- * Result of the LLM function selection benchmark.
- *
- * `IAgenticaSelectBenchmarkResult` is a structure representing the result
- * of the LLM function selection benchmark executed by the
- * {@link AgenticaSelectBenchmark.execute execute} function.
- *
- * It contains every experiment results for each scenario, and aggregated
- * LLM token cost in the benchmark process.
- *
- * In each scenario, as the benchmark program experiments multiple times
- * about a scenario, it will contain multiple events. Also, because of the
- * characteristics of the LLM which is not predictable, the result can be
- * different in each event.
- *
- * @author Samchon
- */
-export interface IAgenticaSelectBenchmarkResult {
-  /**
-   * Experiments for each scenario.
-   */
-  experiments: IAgenticaSelectBenchmarkResult.IExperiment[];
-
-  /**
-   * Aggregated token usage information.
-   */
-  usage: AgenticaTokenUsage;
-
-  /**
-   * Start time of the benchmark.
-   */
-  started_at: Date;
-
-  /**
-   * End time of the benchmark.
-   */
-  completed_at: Date;
-}
-export namespace IAgenticaSelectBenchmarkResult {
-  /**
-   * Experiment result about a scenario.
-   */
-  export interface IExperiment {
-    /**
-     * Expected scenario.
-     */
-    scenario: IAgenticaSelectBenchmarkScenario;
-
-    /**
-     * Events occurred during the benchmark in the scenario.
-     *
-     * When benchmarking a scenario, {@link AgenticaSelectBenchmark} will
-     * test a scenario multiple times with the given
-     * {@link AgenticaSelectBenchmark.IConfig.repeat repeat} count.
-     * And the event is one of the repeated benchmark results.
-     */
-    events: IAgenticaSelectBenchmarkEvent[];
-
-    /**
-     * LLM token usage information.
-     */
-    usage: AgenticaTokenUsage;
-  }
-}
+/**
+ * @module
+ * This file contains the implementation of the IAgenticaSelectBenchmarkResult class.
+ *
+ * @author Wrtn Technologies
+ */
+import type { AgenticaTokenUsage } from "@agentica/core";
+
+import type { IAgenticaSelectBenchmarkEvent } from "./IAgenticaSelectBenchmarkEvent";
+import type { IAgenticaSelectBenchmarkScenario } from "./IAgenticaSelectBenchmarkScenario";
+
+/**
+ * Result of the LLM function selection benchmark.
+ *
+ * `IAgenticaSelectBenchmarkResult` is a structure representing the result
+ * of the LLM function selection benchmark executed by the
+ * {@link AgenticaSelectBenchmark.execute execute} function.
+ *
+ * It contains every experiment results for each scenario, and aggregated
+ * LLM token cost in the benchmark process.
+ *
+ * In each scenario, as the benchmark program experiments multiple times
+ * about a scenario, it will contain multiple events. Also, because of the
+ * characteristics of the LLM which is not predictable, the result can be
+ * different in each event.
+ *
+ * @author Samchon
+ */
+export interface IAgenticaSelectBenchmarkResult {
+  /**
+   * Experiments for each scenario.
+   */
+  experiments: IAgenticaSelectBenchmarkResult.IExperiment[];
+
+  /**
+   * Aggregated token usage information.
+   */
+  usage: AgenticaTokenUsage;
+
+  /**
+   * Start time of the benchmark.
+   */
+  started_at: Date;
+
+  /**
+   * End time of the benchmark.
+   */
+  completed_at: Date;
+}
+export namespace IAgenticaSelectBenchmarkResult {
+  /**
+   * Experiment result about a scenario.
+   */
+  export interface IExperiment {
+    /**
+     * Expected scenario.
+     */
+    scenario: IAgenticaSelectBenchmarkScenario;
+
+    /**
+     * Events occurred during the benchmark in the scenario.
+     *
+     * When benchmarking a scenario, {@link AgenticaSelectBenchmark} will
+     * test a scenario multiple times with the given
+     * {@link AgenticaSelectBenchmark.IConfig.repeat repeat} count.
+     * And the event is one of the repeated benchmark results.
+     */
+    events: IAgenticaSelectBenchmarkEvent[];
+
+    /**
+     * LLM token usage information.
+     */
+    usage: AgenticaTokenUsage;
+  }
+}

package/src/structures/IAgenticaSelectBenchmarkScenario.ts

@@ -1,45 +1,45 @@
-/**
- * @module
- * This file contains the implementation of the IAgenticaSelectBenchmarkScenario class.
- *
- * @author Wrtn Technologies
- */
-import type { IAgenticaBenchmarkExpected } from "./IAgenticaBenchmarkExpected";
-
-/**
- * Scenario of function selection.
- *
- * `IAgenticaSelectBenchmarkScenario` is a data structure which
- * represents a function selection benchmark scenario. It contains two
- * properties; {@linkk text} and {@link operations}.
- *
- * The {@link text} means the conversation text from the user, and
- * the other {@link operations} are the expected operations that
- * should be selected by the `selector` agent through the {@link text}
- * conversation.
- *
- * @author Samchon
- */
-export interface IAgenticaSelectBenchmarkScenario {
-  /**
-   * Name of the scenario.
-   *
-   * It must be unique within the benchmark scenarios.
-   */
-  name: string;
-
-  /**
-   * The prompt text from user.
-   */
-  text: string;
-
-  /**
-   * Expected function selection sequence.
-   *
-   * Sequence of operations (API operation or class function) that
-   * should be selected by the `selector` agent from the user's
-   * {@link text} conversation for the LLM (Large Language Model)
-   * function selection.
-   */
-  expected: IAgenticaBenchmarkExpected;
-}
+/**
+ * @module
+ * This file contains the implementation of the IAgenticaSelectBenchmarkScenario class.
+ *
+ * @author Wrtn Technologies
+ */
+import type { IAgenticaBenchmarkExpected } from "./IAgenticaBenchmarkExpected";
+
+/**
+ * Scenario of function selection.
+ *
+ * `IAgenticaSelectBenchmarkScenario` is a data structure which
+ * represents a function selection benchmark scenario. It contains two
+ * properties; {@linkk text} and {@link operations}.
+ *
+ * The {@link text} means the conversation text from the user, and
+ * the other {@link operations} are the expected operations that
+ * should be selected by the `selector` agent through the {@link text}
+ * conversation.
+ *
+ * @author Samchon
+ */
+export interface IAgenticaSelectBenchmarkScenario {
+  /**
+   * Name of the scenario.
+   *
+   * It must be unique within the benchmark scenarios.
+   */
+  name: string;
+
+  /**
+   * The prompt text from user.
+   */
+  text: string;
+
+  /**
+   * Expected function selection sequence.
+   *
+   * Sequence of operations (API operation or class function) that
+   * should be selected by the `selector` agent from the user's
+   * {@link text} conversation for the LLM (Large Language Model)
+   * function selection.
+   */
+  expected: IAgenticaBenchmarkExpected;
+}

package/src/utils/MathUtil.ts

@@ -1,16 +1,16 @@
-/**
- * @module
- * This file contains functions to work with MathUtil.
- *
- * @author Wrtn Technologies
- */
-
-export const MathUtil = {
-  /**
-   * Round a number to 2 decimal places.
-   *
-   * @param value - The number to round.
-   * @returns The rounded number.
-   */
-  round: (value: number): number => Math.floor(value * 100) / 100,
-};
+/**
+ * @module
+ * This file contains functions to work with MathUtil.
+ *
+ * @author Wrtn Technologies
+ */
+
+export const MathUtil = {
+  /**
+   * Round a number to 2 decimal places.
+   *
+   * @param value - The number to round.
+   * @returns The rounded number.
+   */
+  round: (value: number): number => Math.floor(value * 100) / 100,
+};