@agentica/core 0.12.0 → 0.12.2-dev.20250314

package/src/context/AgenticaOperation.ts

@@ -1,66 +1,66 @@
-import { IHttpLlmFunction, ILlmFunction, ILlmSchema } from "@samchon/openapi";
-
-import { IAgenticaOperationJson } from "../json/IAgenticaOperationJson";
-import { IAgenticaController } from "../structures/IAgenticaController";
-
-/**
- * Operation information in the Agentica Agent.
- *
- * `AgenticaOperation` is a type represents an operation that would
- * be selected by the A.I. chatbot of {@link Agentica} class to
- * perform the LLM (Large Language Model) function calling.
- *
- * Also, it is an union type that is discriminated by the {@link protocol}
- * property. If the protocol value is `http`, it means that the HTTP API
- * operation would be called by the A.I. chatbot. Otherwise, if the protocol
- * value is `class`, it means that the operation has come from a
- * TypeScript class.
- *
- * @author Samchon
- */
-export type AgenticaOperation<Model extends ILlmSchema.Model> =
-  | AgenticaOperation.Class<Model>
-  | AgenticaOperation.Http<Model>;
-export namespace AgenticaOperation {
-  export type Class<Model extends ILlmSchema.Model> = Base<
-    "class",
-    IAgenticaController.IClass<Model>,
-    ILlmFunction<Model>
-  >;
-  export type Http<Model extends ILlmSchema.Model> = Base<
-    "http",
-    IAgenticaController.IHttp<Model>,
-    IHttpLlmFunction<Model>
-  >;
-
-  interface Base<
-    Protocol extends "http" | "class",
-    Controller extends object,
-    Function extends object,
-  > {
-    /**
-     * Protocol discriminator.
-     */
-    protocol: Protocol;
-
-    /**
-     * Belonged controller of the target function.
-     */
-    controller: Controller;
-
-    /**
-     * Target function to call.
-     */
-    function: Function;
-
-    /**
-     * Identifier name.
-     */
-    name: string;
-
-    /**
-     * Convert to primitive JSON object.
-     */
-    toJSON(): IAgenticaOperationJson;
-  }
-}
+import { IHttpLlmFunction, ILlmFunction, ILlmSchema } from "@samchon/openapi";
+
+import { IAgenticaOperationJson } from "../json/IAgenticaOperationJson";
+import { IAgenticaController } from "../structures/IAgenticaController";
+
+/**
+ * Operation information in the Agentica Agent.
+ *
+ * `AgenticaOperation` is a type represents an operation that would
+ * be selected by the A.I. chatbot of {@link Agentica} class to
+ * perform the LLM (Large Language Model) function calling.
+ *
+ * Also, it is an union type that is discriminated by the {@link protocol}
+ * property. If the protocol value is `http`, it means that the HTTP API
+ * operation would be called by the A.I. chatbot. Otherwise, if the protocol
+ * value is `class`, it means that the operation has come from a
+ * TypeScript class.
+ *
+ * @author Samchon
+ */
+export type AgenticaOperation<Model extends ILlmSchema.Model> =
+  | AgenticaOperation.Class<Model>
+  | AgenticaOperation.Http<Model>;
+export namespace AgenticaOperation {
+  export type Class<Model extends ILlmSchema.Model> = Base<
+    "class",
+    IAgenticaController.IClass<Model>,
+    ILlmFunction<Model>
+  >;
+  export type Http<Model extends ILlmSchema.Model> = Base<
+    "http",
+    IAgenticaController.IHttp<Model>,
+    IHttpLlmFunction<Model>
+  >;
+
+  interface Base<
+    Protocol extends "http" | "class",
+    Controller extends object,
+    Function extends object,
+  > {
+    /**
+     * Protocol discriminator.
+     */
+    protocol: Protocol;
+
+    /**
+     * Belonged controller of the target function.
+     */
+    controller: Controller;
+
+    /**
+     * Target function to call.
+     */
+    function: Function;
+
+    /**
+     * Identifier name.
+     */
+    name: string;
+
+    /**
+     * Convert to primitive JSON object.
+     */
+    toJSON(): IAgenticaOperationJson;
+  }
+}

package/src/context/AgenticaOperationBase.ts

@@ -1,57 +1,57 @@
-import { IAgenticaOperationJson } from "../json/IAgenticaOperationJson";
-
-export abstract class AgenticaOperationBase<
-  Protocol extends "http" | "class",
-  Controller extends object,
-  Function extends object,
-> {
-  /**
-   * Protocol discriminator.
-   */
-  public readonly protocol: Protocol;
-
-  /**
-   * Belonged controller of the target function.
-   */
-  public readonly controller: Controller;
-
-  /**
-   * Target function to call.
-   */
-  public readonly function: Function;
-
-  /**
-   * Identifier name.
-   */
-  public readonly name: string;
-
-  protected constructor(
-    props: AgenticaOperationBase.IProps<Protocol, Controller, Function>,
-  ) {
-    this.protocol = props.protocol;
-    this.controller = props.controller;
-    this.function = props.function;
-    this.name = props.name;
-  }
-
-  public toJSON(): IAgenticaOperationJson {
-    return {
-      protocol: this.protocol,
-      controller: this.controller.constructor.name,
-      function: this.function.constructor.name,
-      name: this.name,
-    };
-  }
-}
-export namespace AgenticaOperationBase {
-  export interface IProps<
-    Protocol extends "http" | "class",
-    Controller extends object,
-    Function extends object,
-  > {
-    protocol: Protocol;
-    controller: Controller;
-    function: Function;
-    name: string;
-  }
-}
+import { IAgenticaOperationJson } from "../json/IAgenticaOperationJson";
+
+export abstract class AgenticaOperationBase<
+  Protocol extends "http" | "class",
+  Controller extends object,
+  Function extends object,
+> {
+  /**
+   * Protocol discriminator.
+   */
+  public readonly protocol: Protocol;
+
+  /**
+   * Belonged controller of the target function.
+   */
+  public readonly controller: Controller;
+
+  /**
+   * Target function to call.
+   */
+  public readonly function: Function;
+
+  /**
+   * Identifier name.
+   */
+  public readonly name: string;
+
+  protected constructor(
+    props: AgenticaOperationBase.IProps<Protocol, Controller, Function>,
+  ) {
+    this.protocol = props.protocol;
+    this.controller = props.controller;
+    this.function = props.function;
+    this.name = props.name;
+  }
+
+  public toJSON(): IAgenticaOperationJson {
+    return {
+      protocol: this.protocol,
+      controller: this.controller.constructor.name,
+      function: this.function.constructor.name,
+      name: this.name,
+    };
+  }
+}
+export namespace AgenticaOperationBase {
+  export interface IProps<
+    Protocol extends "http" | "class",
+    Controller extends object,
+    Function extends object,
+  > {
+    protocol: Protocol;
+    controller: Controller;
+    function: Function;
+    name: string;
+  }
+}

package/src/context/AgenticaOperationCollection.ts

@@ -1,52 +1,52 @@
-import { ILlmSchema } from "@samchon/openapi";
-
-import { AgenticaOperation } from "./AgenticaOperation";
-
-/**
- * Collection of operations used in the Nestia 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<Model extends ILlmSchema.Model> {
-  /**
-   * List of every operations.
-   */
-  array: AgenticaOperation<Model>[];
-
-  /**
-   * 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<Model>[][] | undefined;
-
-  /**
-   * Flat dictionary of operations.
-   *
-   * Dictionary of operations with their {@link IAgenticaOperation.name}.
-   */
-  flat: Map<string, AgenticaOperation<Model>>;
-
-  /**
-   * Group dictionary of operations.
-   *
-   * Dictionary of operations with their
-   * {@link IAgenticaOperation.controller.name} and
-   * {@link IAgenticaOperation.function.name}.
-   */
-  group: Map<string, Map<string, AgenticaOperation<Model>>>;
-}
+import { ILlmSchema } from "@samchon/openapi";
+
+import { AgenticaOperation } from "./AgenticaOperation";
+
+/**
+ * Collection of operations used in the Nestia 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<Model extends ILlmSchema.Model> {
+  /**
+   * List of every operations.
+   */
+  array: AgenticaOperation<Model>[];
+
+  /**
+   * 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<Model>[][] | undefined;
+
+  /**
+   * Flat dictionary of operations.
+   *
+   * Dictionary of operations with their {@link IAgenticaOperation.name}.
+   */
+  flat: Map<string, AgenticaOperation<Model>>;
+
+  /**
+   * Group dictionary of operations.
+   *
+   * Dictionary of operations with their
+   * {@link IAgenticaOperation.controller.name} and
+   * {@link IAgenticaOperation.function.name}.
+   */
+  group: Map<string, Map<string, AgenticaOperation<Model>>>;
+}

package/src/context/AgenticaOperationSelection.ts

@@ -1,27 +1,27 @@
-import { ILlmSchema } from "@samchon/openapi";
-
-import { IAgenticaOperationSelectionJson } from "../json/IAgenticaOperationSelectionJson";
-import { AgenticaOperation } from "./AgenticaOperation";
-
-export class AgenticaOperationSelection<Model extends ILlmSchema.Model> {
-  public readonly operation: AgenticaOperation<Model>;
-  public readonly reason: string;
-
-  public constructor(props: AgenticaOperationSelection.IProps<Model>) {
-    this.operation = props.operation;
-    this.reason = props.reason;
-  }
-
-  public toJSON(): IAgenticaOperationSelectionJson {
-    return {
-      operation: this.operation.toJSON(),
-      reason: this.reason,
-    };
-  }
-}
-export namespace AgenticaOperationSelection {
-  export interface IProps<Model extends ILlmSchema.Model> {
-    operation: AgenticaOperation<Model>;
-    reason: string;
-  }
-}
+import { ILlmSchema } from "@samchon/openapi";
+
+import { IAgenticaOperationSelectionJson } from "../json/IAgenticaOperationSelectionJson";
+import { AgenticaOperation } from "./AgenticaOperation";
+
+export class AgenticaOperationSelection<Model extends ILlmSchema.Model> {
+  public readonly operation: AgenticaOperation<Model>;
+  public readonly reason: string;
+
+  public constructor(props: AgenticaOperationSelection.IProps<Model>) {
+    this.operation = props.operation;
+    this.reason = props.reason;
+  }
+
+  public toJSON(): IAgenticaOperationSelectionJson {
+    return {
+      operation: this.operation.toJSON(),
+      reason: this.reason,
+    };
+  }
+}
+export namespace AgenticaOperationSelection {
+  export interface IProps<Model extends ILlmSchema.Model> {
+    operation: AgenticaOperation<Model>;
+    reason: string;
+  }
+}