@agentica/core 0.43.2 → 0.44.0-dev.20260313

package/src/json/IAgenticaHistoryJson.ts

@@ -1,165 +1,165 @@
-import type { tags } from "typia";
-
-import type { AgenticaUserMessageContent } from "../histories";
-
-import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
-import type { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelectionJson";
-
-/**
- * Agentic AI agent prompt.
- *
- * `IAgenticaHistoryJson` is an union type of all possible prompts that
- * can be generated by the AI chatbot of the {@link Agentica} class.
- *
- * In other words, `IAgenticaHistoryJson` is a type of chat history that
- * is occurred during the conversation between the user and the AI
- * chatbot in the {@link Agentica} class.
- *
- * If you want to continue the previous A.I. chatbot session, you can
- * accomplish it by assigning the {@link IAgenticaProps.histories}
- * property when creating a new {@link Agentica} instance.
- *
- * @author Samchon
- */
-export type IAgenticaHistoryJson =
-  | IAgenticaHistoryJson.ISelect
-  | IAgenticaHistoryJson.ICancel
-  | IAgenticaHistoryJson.IExecute
-  | IAgenticaHistoryJson.IDescribe
-  | IAgenticaHistoryJson.IAssistantMessage
-  | IAgenticaHistoryJson.ISystemMessage
-  | IAgenticaHistoryJson.IUserMessage;
-export namespace IAgenticaHistoryJson {
-  export type Type = IAgenticaHistoryJson["type"];
-  export interface Mapper {
-    select: ISelect;
-    cancel: ICancel;
-    execute: IExecute;
-    describe: IDescribe;
-    assistantMessage: IAssistantMessage;
-    systemMessage: ISystemMessage;
-    userMessage: IUserMessage;
-  }
-
-  /**
-   * User message.
-   *
-   * User message about the user's input.
-   */
-  export interface IUserMessage extends IBase<"userMessage"> {
-    /**
-     * User input.
-     */
-    contents: Array<AgenticaUserMessageContent>;
-  }
-
-  /**
-   * System message.
-   */
-  export interface ISystemMessage extends IBase<"systemMessage"> {
-    /**
-     * The text content.
-     */
-    text: string;
-  }
-
-  /**
-   * Assistant message.
-   */
-  export interface IAssistantMessage extends IBase<"assistantMessage"> {
-    /**
-     * The text content.
-     */
-    text: string;
-  }
-
-  /**
-   * Select prompt.
-   *
-   * Selection prompt about candidate functions to call.
-   */
-  export interface ISelect extends IBase<"select"> {
-    /**
-     * Operations that have been selected.
-     */
-    selection: IAgenticaOperationSelectionJson;
-  }
-
-  /**
-   * Cancel prompt.
-   *
-   * Cancellation prompt about the candidate functions to be discarded.
-   */
-  export interface ICancel extends IBase<"cancel"> {
-    /**
-     * Operations that have been cancelled.
-     */
-    selection: IAgenticaOperationSelectionJson;
-  }
-
-  /**
-   * Execute prompt.
-   *
-   * Execution prompt about the LLM function calling.
-   */
-  export interface IExecute extends IBase<"execute"> {
-    /**
-     * Target operation to call.
-     */
-    operation: IAgenticaOperationJson;
-
-    /**
-     * Arguments of the LLM function calling.
-     */
-    arguments: Record<string, any>;
-
-    /**
-     * Return value.
-     */
-    value: unknown;
-
-    /**
-     * Whether the execution was successful or not.
-     *
-     * If the success value is false, it means that an error has
-     * occurred during the execution.
-     */
-    success: boolean;
-  }
-
-  /**
-   * Description prompt.
-   *
-   * Description prompt about the return value of the LLM function calling.
-   */
-  export interface IDescribe extends IBase<"describe"> {
-    /**
-     * Executions of the LLM function calling.
-     *
-     * This prompt describes the return value of them.
-     */
-    executes: IExecute[];
-
-    /**
-     * Description text.
-     */
-    text: string;
-  }
-
-  interface IBase<Type extends string> {
-    /**
-     * Primary key of the history.
-     */
-    id: string;
-
-    /**
-     * Discriminator type.
-     */
-    type: Type;
-
-    /**
-     * Creation timestamp of the history.
-     */
-    created_at: string & tags.Format<"date-time">;
-  }
-}
+import type { tags } from "typia";
+
+import type { AgenticaUserMessageContent } from "../histories";
+
+import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
+import type { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelectionJson";
+
+/**
+ * Agentic AI agent prompt.
+ *
+ * `IAgenticaHistoryJson` is an union type of all possible prompts that
+ * can be generated by the AI chatbot of the {@link Agentica} class.
+ *
+ * In other words, `IAgenticaHistoryJson` is a type of chat history that
+ * is occurred during the conversation between the user and the AI
+ * chatbot in the {@link Agentica} class.
+ *
+ * If you want to continue the previous A.I. chatbot session, you can
+ * accomplish it by assigning the {@link IAgenticaProps.histories}
+ * property when creating a new {@link Agentica} instance.
+ *
+ * @author Samchon
+ */
+export type IAgenticaHistoryJson
+  = | IAgenticaHistoryJson.ISelect
+    | IAgenticaHistoryJson.ICancel
+    | IAgenticaHistoryJson.IExecute
+    | IAgenticaHistoryJson.IDescribe
+    | IAgenticaHistoryJson.IAssistantMessage
+    | IAgenticaHistoryJson.ISystemMessage
+    | IAgenticaHistoryJson.IUserMessage;
+export namespace IAgenticaHistoryJson {
+  export type Type = IAgenticaHistoryJson["type"];
+  export interface Mapper {
+    select: ISelect;
+    cancel: ICancel;
+    execute: IExecute;
+    describe: IDescribe;
+    assistantMessage: IAssistantMessage;
+    systemMessage: ISystemMessage;
+    userMessage: IUserMessage;
+  }
+
+  /**
+   * User message.
+   *
+   * User message about the user's input.
+   */
+  export interface IUserMessage extends IBase<"userMessage"> {
+    /**
+     * User input.
+     */
+    contents: Array<AgenticaUserMessageContent>;
+  }
+
+  /**
+   * System message.
+   */
+  export interface ISystemMessage extends IBase<"systemMessage"> {
+    /**
+     * The text content.
+     */
+    text: string;
+  }
+
+  /**
+   * Assistant message.
+   */
+  export interface IAssistantMessage extends IBase<"assistantMessage"> {
+    /**
+     * The text content.
+     */
+    text: string;
+  }
+
+  /**
+   * Select prompt.
+   *
+   * Selection prompt about candidate functions to call.
+   */
+  export interface ISelect extends IBase<"select"> {
+    /**
+     * Operations that have been selected.
+     */
+    selection: IAgenticaOperationSelectionJson;
+  }
+
+  /**
+   * Cancel prompt.
+   *
+   * Cancellation prompt about the candidate functions to be discarded.
+   */
+  export interface ICancel extends IBase<"cancel"> {
+    /**
+     * Operations that have been cancelled.
+     */
+    selection: IAgenticaOperationSelectionJson;
+  }
+
+  /**
+   * Execute prompt.
+   *
+   * Execution prompt about the LLM function calling.
+   */
+  export interface IExecute extends IBase<"execute"> {
+    /**
+     * Target operation to call.
+     */
+    operation: IAgenticaOperationJson;
+
+    /**
+     * Arguments of the LLM function calling.
+     */
+    arguments: Record<string, any>;
+
+    /**
+     * Return value.
+     */
+    value: unknown;
+
+    /**
+     * Whether the execution was successful or not.
+     *
+     * If the success value is false, it means that an error has
+     * occurred during the execution.
+     */
+    success: boolean;
+  }
+
+  /**
+   * Description prompt.
+   *
+   * Description prompt about the return value of the LLM function calling.
+   */
+  export interface IDescribe extends IBase<"describe"> {
+    /**
+     * Executions of the LLM function calling.
+     *
+     * This prompt describes the return value of them.
+     */
+    executes: IExecute[];
+
+    /**
+     * Description text.
+     */
+    text: string;
+  }
+
+  interface IBase<Type extends string> {
+    /**
+     * Primary key of the history.
+     */
+    id: string;
+
+    /**
+     * Discriminator type.
+     */
+    type: Type;
+
+    /**
+     * Creation timestamp of the history.
+     */
+    created_at: string & tags.Format<"date-time">;
+  }
+}

package/src/json/IAgenticaHistoryJson.type.ts

@@ -1,19 +1,19 @@
-import type { AgenticaHistory } from "../histories";
-import type { Pass } from "../utils/types";
-
-import { check, checks } from "../utils/types";
-
-import type { IAgenticaHistoryJson } from "./IAgenticaHistoryJson";
-
-checks([
-  check<
-    AgenticaHistory.Type,
-    IAgenticaHistoryJson.Type,
-    Pass
-  >(),
-  check<
-    AgenticaHistory.Type,
-    keyof IAgenticaHistoryJson.Mapper,
-    Pass
-  >(),
-]);
+import type { AgenticaHistory } from "../histories";
+import type { Pass } from "../utils/types";
+
+import { check, checks } from "../utils/types";
+
+import type { IAgenticaHistoryJson } from "./IAgenticaHistoryJson";
+
+checks([
+  check<
+    AgenticaHistory.Type,
+    IAgenticaHistoryJson.Type,
+    Pass
+  >(),
+  check<
+    AgenticaHistory.Type,
+    keyof IAgenticaHistoryJson.Mapper,
+    Pass
+  >(),
+]);

package/src/json/IAgenticaOperationJson.ts

@@ -1,36 +1,36 @@
-/**
- * Operation information in the Agentica Agent.
- *
- * `IAgenticaOperation` 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 interface IAgenticaOperationJson {
-  /**
-   * Protocol discriminator.
-   */
-  protocol: "class" | "http" | "mcp";
-
-  /**
-   * Belonged controller of the target function.
-   */
-  controller: string;
-
-  /**
-   * Target function to call.
-   */
-  function: string;
-
-  /**
-   * Identifier name.
-   */
-  name: string;
-}
+/**
+ * Operation information in the Agentica Agent.
+ *
+ * `IAgenticaOperation` 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 interface IAgenticaOperationJson {
+  /**
+   * Protocol discriminator.
+   */
+  protocol: "class" | "http" | "mcp";
+
+  /**
+   * Belonged controller of the target function.
+   */
+  controller: string;
+
+  /**
+   * Target function to call.
+   */
+  function: string;
+
+  /**
+   * Identifier name.
+   */
+  name: string;
+}

package/src/json/IAgenticaOperationSelectionJson.ts

@@ -1,26 +1,26 @@
-import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
-
-/**
- * Agentica agent operation selection.
- *
- * `IAgenticaOperationSelection` is a type represents an operation
- * which has been selected by the A.I. chatbot of {@link Agentica}
- * class for the LLM (Large Language Model) function calling with
- * detailed {@link reason} of the selection (or cancellation).
- *
- * Also, `IAgenticaOperationSelection` is an union type that can
- * specify a subtype by checking the {@link protocol} property.
- *
- * @author Samchon
- */
-export interface IAgenticaOperationSelectionJson {
-  /**
-   * The reason of the selection.
-   */
-  reason: string;
-
-  /**
-   * Selected operation.
-   */
-  operation: IAgenticaOperationJson;
-}
+import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
+
+/**
+ * Agentica agent operation selection.
+ *
+ * `IAgenticaOperationSelection` is a type represents an operation
+ * which has been selected by the A.I. chatbot of {@link Agentica}
+ * class for the LLM (Large Language Model) function calling with
+ * detailed {@link reason} of the selection (or cancellation).
+ *
+ * Also, `IAgenticaOperationSelection` is an union type that can
+ * specify a subtype by checking the {@link protocol} property.
+ *
+ * @author Samchon
+ */
+export interface IAgenticaOperationSelectionJson {
+  /**
+   * The reason of the selection.
+   */
+  reason: string;
+
+  /**
+   * Selected operation.
+   */
+  operation: IAgenticaOperationJson;
+}