@agentica/benchmark 0.43.2 → 0.44.0-dev.20260313

package/src/structures/IAgenticaCallBenchmarkEvent.ts

@@ -1,118 +1,118 @@
-/**
- * @module
- * This file contains the implementation of the IAgenticaCallBenchmarkEvent class.
- *
- * @author Wrtn Technologies
- */
-import type { AgenticaHistory, AgenticaTokenUsage } from "@agentica/core";
-
-import type { IAgenticaCallBenchmarkScenario } from "./IAgenticaCallBenchmarkScenario";
-
-/**
- * Event of LLM function selection benchmark.
- *
- * `IAgenticaCallBenchmarkEvent` is an union type of the events occurred
- * during the LLM function calling benchmark, representing one phase of
- * the benchmark testing about a scenario.
- *
- * In other words, when {@link AgenticaCallBenchmark} executes the
- * benchmark, it will run the benchmark will test a scenario repeately with
- * the given configuration {@link AgenticaCallBenchmark.IConfig.repeat}.
- * And in the repeated benchmark about a scenario,
- * `IAgenticaCallBenchmarkEvent` is one of the repeated testing.
- *
- * For reference, `IAgenticaCallBenchmarkEvent` 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` or `caller` agents had not selected or
- * called the expected operations. The last type, `error`, means that
- * an error had been occurred during the benchmark testing.
- *
- * @author Samchon
- */
-export type IAgenticaCallBenchmarkEvent =
-  | IAgenticaCallBenchmarkEvent.ISuccess
-  | IAgenticaCallBenchmarkEvent.IFailure
-  | IAgenticaCallBenchmarkEvent.IError;
-export namespace IAgenticaCallBenchmarkEvent {
-  /**
-   * Success event type.
-   *
-   * The `success` event type represents that the benchmark
-   * testing is fully meet the expected scenario.
-   */
-  export interface ISuccess
-    extends IEventBase<"success"> {
-    /**
-     * Whether succeeded to function selection.
-     */
-    select: true;
-
-    /**
-     * Whether succeeded to function call.
-     */
-    call: true;
-  }
-
-  /**
-   * Failure event type.
-   *
-   * The `failure` event type represents that the `selector`
-   * or `caller` agents have not selected or called following the
-   * expected scenario in the benchmark testing.
-   */
-  export interface IFailure
-    extends IEventBase<"failure"> {
-    /**
-     * Whether succeeded to function selection.
-     */
-    select: boolean;
-
-    /**
-     * Whether succeeded to function call.
-     */
-    call: boolean;
-  }
-
-  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: IAgenticaCallBenchmarkScenario;
-
-    /**
-     * Prompt histories.
-     *
-     * List of prompts occurred during the benchmark testing.
-     */
-    prompts: AgenticaHistory[];
-
-    /**
-     * Usage of the token during the benchmark.
-     */
-    usage: AgenticaTokenUsage;
-
-    /**
-     * When the benchmark testing started.
-     */
-    started_at: Date;
-
-    /**
-     * When the benchmark testing completed.
-     */
-    completed_at: Date;
-  }
-}
+/**
+ * @module
+ * This file contains the implementation of the IAgenticaCallBenchmarkEvent class.
+ *
+ * @author Wrtn Technologies
+ */
+import type { AgenticaHistory, AgenticaTokenUsage } from "@agentica/core";
+
+import type { IAgenticaCallBenchmarkScenario } from "./IAgenticaCallBenchmarkScenario";
+
+/**
+ * Event of LLM function selection benchmark.
+ *
+ * `IAgenticaCallBenchmarkEvent` is an union type of the events occurred
+ * during the LLM function calling benchmark, representing one phase of
+ * the benchmark testing about a scenario.
+ *
+ * In other words, when {@link AgenticaCallBenchmark} executes the
+ * benchmark, it will run the benchmark will test a scenario repeately with
+ * the given configuration {@link AgenticaCallBenchmark.IConfig.repeat}.
+ * And in the repeated benchmark about a scenario,
+ * `IAgenticaCallBenchmarkEvent` is one of the repeated testing.
+ *
+ * For reference, `IAgenticaCallBenchmarkEvent` 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` or `caller` agents had not selected or
+ * called the expected operations. The last type, `error`, means that
+ * an error had been occurred during the benchmark testing.
+ *
+ * @author Samchon
+ */
+export type IAgenticaCallBenchmarkEvent
+  = | IAgenticaCallBenchmarkEvent.ISuccess
+    | IAgenticaCallBenchmarkEvent.IFailure
+    | IAgenticaCallBenchmarkEvent.IError;
+export namespace IAgenticaCallBenchmarkEvent {
+  /**
+   * Success event type.
+   *
+   * The `success` event type represents that the benchmark
+   * testing is fully meet the expected scenario.
+   */
+  export interface ISuccess
+    extends IEventBase<"success"> {
+    /**
+     * Whether succeeded to function selection.
+     */
+    select: true;
+
+    /**
+     * Whether succeeded to function call.
+     */
+    call: true;
+  }
+
+  /**
+   * Failure event type.
+   *
+   * The `failure` event type represents that the `selector`
+   * or `caller` agents have not selected or called following the
+   * expected scenario in the benchmark testing.
+   */
+  export interface IFailure
+    extends IEventBase<"failure"> {
+    /**
+     * Whether succeeded to function selection.
+     */
+    select: boolean;
+
+    /**
+     * Whether succeeded to function call.
+     */
+    call: boolean;
+  }
+
+  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: IAgenticaCallBenchmarkScenario;
+
+    /**
+     * Prompt histories.
+     *
+     * List of prompts occurred during the benchmark testing.
+     */
+    prompts: AgenticaHistory[];
+
+    /**
+     * Usage of the token during the benchmark.
+     */
+    usage: AgenticaTokenUsage;
+
+    /**
+     * When the benchmark testing started.
+     */
+    started_at: Date;
+
+    /**
+     * When the benchmark testing completed.
+     */
+    completed_at: Date;
+  }
+}

package/src/structures/IAgenticaCallBenchmarkResult.ts

@@ -1,75 +1,75 @@
-/**
- * @module
- * This file contains the implementation of the IAgenticaCallBenchmarkResult class.
- *
- * @author Wrtn Technologies
- */
-import type { AgenticaTokenUsage } from "@agentica/core";
-
-import type { IAgenticaCallBenchmarkEvent } from "./IAgenticaCallBenchmarkEvent";
-import type { IAgenticaCallBenchmarkScenario } from "./IAgenticaCallBenchmarkScenario";
-
-/**
- * Result of the LLM function calling benchmark.
- *
- * `IAgenticaCallBenchmarkResult` is a structure representing the result
- * of the LLM function calling benchmark executed by the
- * {@link AgenticaCallBenchmark.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 IAgenticaCallBenchmarkResult {
-  /**
-   * Experiments for each scenario.
-   */
-  experiments: IAgenticaCallBenchmarkResult.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 IAgenticaCallBenchmarkResult {
-  /**
-   * Experiment result about a scenario.
-   */
-  export interface IExperiment {
-    /**
-     * Scenario of the experiment.
-     */
-    scenario: IAgenticaCallBenchmarkScenario;
-
-    /**
-     * Events occurred during the benchmark in the scenario.
-     *
-     * When benchmarking a scenario, {@link AgenticaCallBenchmark} will
-     * test a scenario multiple times with the given
-     * {@link AgenticaCallBenchmark.IConfig.repeat repeat} count.
-     * And the event is one of the repeated benchmark results.
-     */
-    events: IAgenticaCallBenchmarkEvent[];
-
-    /**
-     * LLM token usage information.
-     */
-    usage: AgenticaTokenUsage;
-  }
-}
+/**
+ * @module
+ * This file contains the implementation of the IAgenticaCallBenchmarkResult class.
+ *
+ * @author Wrtn Technologies
+ */
+import type { AgenticaTokenUsage } from "@agentica/core";
+
+import type { IAgenticaCallBenchmarkEvent } from "./IAgenticaCallBenchmarkEvent";
+import type { IAgenticaCallBenchmarkScenario } from "./IAgenticaCallBenchmarkScenario";
+
+/**
+ * Result of the LLM function calling benchmark.
+ *
+ * `IAgenticaCallBenchmarkResult` is a structure representing the result
+ * of the LLM function calling benchmark executed by the
+ * {@link AgenticaCallBenchmark.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 IAgenticaCallBenchmarkResult {
+  /**
+   * Experiments for each scenario.
+   */
+  experiments: IAgenticaCallBenchmarkResult.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 IAgenticaCallBenchmarkResult {
+  /**
+   * Experiment result about a scenario.
+   */
+  export interface IExperiment {
+    /**
+     * Scenario of the experiment.
+     */
+    scenario: IAgenticaCallBenchmarkScenario;
+
+    /**
+     * Events occurred during the benchmark in the scenario.
+     *
+     * When benchmarking a scenario, {@link AgenticaCallBenchmark} will
+     * test a scenario multiple times with the given
+     * {@link AgenticaCallBenchmark.IConfig.repeat repeat} count.
+     * And the event is one of the repeated benchmark results.
+     */
+    events: IAgenticaCallBenchmarkEvent[];
+
+    /**
+     * LLM token usage information.
+     */
+    usage: AgenticaTokenUsage;
+  }
+}

package/src/structures/IAgenticaCallBenchmarkScenario.ts

@@ -1,45 +1,45 @@
-/**
- * @module
- * This file contains the implementation of the IAgenticaCallBenchmarkScenario class.
- *
- * @author Wrtn Technologies
- */
-import type { IAgenticaBenchmarkExpected } from "./IAgenticaBenchmarkExpected";
-
-/**
- * Scenario of function calling.
- *
- * `IAgenticaCallBenchmarkScenario` is a data structure which
- * represents a function calling 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 `caller` agent through the {@link text}
- * conversation.
- *
- * @author Samchon
- */
-export interface IAgenticaCallBenchmarkScenario {
-  /**
-   * Name of the scenario.
-   *
-   * It must be unique within the benchmark scenarios.
-   */
-  name: string;
-
-  /**
-   * The prompt text from user.
-   */
-  text: string;
-
-  /**
-   * Expected function calling sequence.
-   *
-   * Sequence of operations (API operation or class function) that
-   * should be called by both `selector` and `caller` agents from
-   * the user's {@link text} conversation for the LLM
-   * (Large Language Model) function calling.
-   */
-  expected: IAgenticaBenchmarkExpected;
-}
+/**
+ * @module
+ * This file contains the implementation of the IAgenticaCallBenchmarkScenario class.
+ *
+ * @author Wrtn Technologies
+ */
+import type { IAgenticaBenchmarkExpected } from "./IAgenticaBenchmarkExpected";
+
+/**
+ * Scenario of function calling.
+ *
+ * `IAgenticaCallBenchmarkScenario` is a data structure which
+ * represents a function calling 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 `caller` agent through the {@link text}
+ * conversation.
+ *
+ * @author Samchon
+ */
+export interface IAgenticaCallBenchmarkScenario {
+  /**
+   * Name of the scenario.
+   *
+   * It must be unique within the benchmark scenarios.
+   */
+  name: string;
+
+  /**
+   * The prompt text from user.
+   */
+  text: string;
+
+  /**
+   * Expected function calling sequence.
+   *
+   * Sequence of operations (API operation or class function) that
+   * should be called by both `selector` and `caller` agents from
+   * the user's {@link text} conversation for the LLM
+   * (Large Language Model) function calling.
+   */
+  expected: IAgenticaBenchmarkExpected;
+}