@agentica/core 0.43.2 → 0.44.0-dev.20260313

package/src/histories/AgenticaExecuteHistory.ts

@@ -1,64 +1,64 @@
-import type { IHttpResponse } from "@samchon/openapi";
-
-import type { AgenticaOperation } from "../context/AgenticaOperation";
-import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
-
-import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
-
-/**
- * Execute prompt.
- *
- * @author Samchon
- */
-export type AgenticaExecuteHistory =
-  | AgenticaExecuteHistory.Class
-  | AgenticaExecuteHistory.Http;
-export namespace AgenticaExecuteHistory {
-  /**
-   * Class protocol case.
-   */
-  export interface Class extends Base<"class", AgenticaOperation.Class, unknown> {}
-
-  /**
-   * HTTP protocol case.
-   */
-  export interface Http extends Base<"http", AgenticaOperation.Http, IHttpResponse> {}
-
-  interface Base<
-    Protocol extends "http" | "class",
-    Operation extends AgenticaOperation,
-    Value,
-  > extends AgenticaHistoryBase<"execute", IAgenticaHistoryJson.IExecute> {
-    /**
-     * Protocol of the operation.
-     */
-    protocol: Protocol;
-
-    /**
-     * Target operation that has been called.
-     */
-    operation: Operation;
-
-    /**
-     * Arguments of the function calling.
-     */
-    arguments: Record<string, unknown>;
-
-    /**
-     * Return value.
-     *
-     * If the protocol is "class", the return value of the class function.
-     *
-     * Otherwise "http", the return value is an HTTP response.
-     */
-    value: Value;
-
-    /**
-     * 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;
-  }
-}
+import type { IHttpResponse } from "@typia/interface";
+
+import type { AgenticaOperation } from "../context/AgenticaOperation";
+import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
+
+import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
+
+/**
+ * Execute prompt.
+ *
+ * @author Samchon
+ */
+export type AgenticaExecuteHistory
+  = | AgenticaExecuteHistory.Class
+    | AgenticaExecuteHistory.Http;
+export namespace AgenticaExecuteHistory {
+  /**
+   * Class protocol case.
+   */
+  export interface Class extends Base<"class", AgenticaOperation.Class, unknown> {}
+
+  /**
+   * HTTP protocol case.
+   */
+  export interface Http extends Base<"http", AgenticaOperation.Http, IHttpResponse> {}
+
+  interface Base<
+    Protocol extends "http" | "class",
+    Operation extends AgenticaOperation,
+    Value,
+  > extends AgenticaHistoryBase<"execute", IAgenticaHistoryJson.IExecute> {
+    /**
+     * Protocol of the operation.
+     */
+    protocol: Protocol;
+
+    /**
+     * Target operation that has been called.
+     */
+    operation: Operation;
+
+    /**
+     * Arguments of the function calling.
+     */
+    arguments: Record<string, unknown>;
+
+    /**
+     * Return value.
+     *
+     * If the protocol is "class", the return value of the class function.
+     *
+     * Otherwise "http", the return value is an HTTP response.
+     */
+    value: Value;
+
+    /**
+     * 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;
+  }
+}

package/src/histories/AgenticaHistory.ts

@@ -1,28 +1,28 @@
-import type { AgenticaAssistantMessageHistory } from "./AgenticaAssistantMessageHistory";
-import type { AgenticaCancelHistory } from "./AgenticaCancelHistory";
-import type { AgenticaDescribeHistory } from "./AgenticaDescribeHistory";
-import type { AgenticaExecuteHistory } from "./AgenticaExecuteHistory";
-import type { AgenticaSelectHistory } from "./AgenticaSelectHistory";
-import type { AgenticaSystemMessageHistory } from "./AgenticaSystemMessageHistory";
-import type { AgenticaUserMessageHistory } from "./AgenticaUserMessageHistory";
-
-export type AgenticaHistory =
-  | AgenticaCancelHistory
-  | AgenticaDescribeHistory
-  | AgenticaExecuteHistory
-  | AgenticaSelectHistory
-  | AgenticaAssistantMessageHistory
-  | AgenticaUserMessageHistory
-  | AgenticaSystemMessageHistory;
-export namespace AgenticaHistory {
-  export type Type = AgenticaHistory["type"];
-  export interface Mapper {
-    select: AgenticaSelectHistory;
-    cancel: AgenticaCancelHistory;
-    execute: AgenticaExecuteHistory;
-    describe: AgenticaDescribeHistory;
-    assistantMessage: AgenticaAssistantMessageHistory;
-    systemMessage: AgenticaSystemMessageHistory;
-    userMessage: AgenticaUserMessageHistory;
-  }
-}
+import type { AgenticaAssistantMessageHistory } from "./AgenticaAssistantMessageHistory";
+import type { AgenticaCancelHistory } from "./AgenticaCancelHistory";
+import type { AgenticaDescribeHistory } from "./AgenticaDescribeHistory";
+import type { AgenticaExecuteHistory } from "./AgenticaExecuteHistory";
+import type { AgenticaSelectHistory } from "./AgenticaSelectHistory";
+import type { AgenticaSystemMessageHistory } from "./AgenticaSystemMessageHistory";
+import type { AgenticaUserMessageHistory } from "./AgenticaUserMessageHistory";
+
+export type AgenticaHistory
+  = | AgenticaCancelHistory
+    | AgenticaDescribeHistory
+    | AgenticaExecuteHistory
+    | AgenticaSelectHistory
+    | AgenticaAssistantMessageHistory
+    | AgenticaUserMessageHistory
+    | AgenticaSystemMessageHistory;
+export namespace AgenticaHistory {
+  export type Type = AgenticaHistory["type"];
+  export interface Mapper {
+    select: AgenticaSelectHistory;
+    cancel: AgenticaCancelHistory;
+    execute: AgenticaExecuteHistory;
+    describe: AgenticaDescribeHistory;
+    assistantMessage: AgenticaAssistantMessageHistory;
+    systemMessage: AgenticaSystemMessageHistory;
+    userMessage: AgenticaUserMessageHistory;
+  }
+}

package/src/histories/AgenticaHistoryBase.ts

@@ -1,35 +1,35 @@
-import type { tags } from "typia";
-
-/**
- * Base type for all histories in Agentica.
- *
- * `AgenticaHistoryBase` is a base type for every history types
- * in Agentica. It is generated by {@link Agentica.conversate} function,
- * and used for restoring the previous conversation history when
- * constructing the {@link Agentica} instance.
- *
- * @template Type Discriminator type
- * @template Json Primitive type of the history
- * @author Samchon
- */
-export interface AgenticaHistoryBase<
-  Type extends string,
-  Json extends { type: Type },
-> {
-  /**
-   * Primary key of the history.
-   */
-  id: string;
-
-  /**
-   * Discriminator type.
-   */
-  type: Type;
-
-  /**
-   * Creation timestamp of the history.
-   */
-  created_at: string & tags.Format<"date-time">;
-
-  toJSON: () => Json;
-}
+import type { tags } from "typia";
+
+/**
+ * Base type for all histories in Agentica.
+ *
+ * `AgenticaHistoryBase` is a base type for every history types
+ * in Agentica. It is generated by {@link Agentica.conversate} function,
+ * and used for restoring the previous conversation history when
+ * constructing the {@link Agentica} instance.
+ *
+ * @template Type Discriminator type
+ * @template Json Primitive type of the history
+ * @author Samchon
+ */
+export interface AgenticaHistoryBase<
+  Type extends string,
+  Json extends { type: Type },
+> {
+  /**
+   * Primary key of the history.
+   */
+  id: string;
+
+  /**
+   * Discriminator type.
+   */
+  type: Type;
+
+  /**
+   * Creation timestamp of the history.
+   */
+  created_at: string & tags.Format<"date-time">;
+
+  toJSON: () => Json;
+}

package/src/histories/AgenticaSelectHistory.ts

@@ -1,8 +1,8 @@
-import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
-import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
-
-import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
-
-export interface AgenticaSelectHistory extends AgenticaHistoryBase<"select", IAgenticaHistoryJson.ISelect> {
-  selection: AgenticaOperationSelection;
-}
+import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
+
+import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
+
+export interface AgenticaSelectHistory extends AgenticaHistoryBase<"select", IAgenticaHistoryJson.ISelect> {
+  selection: AgenticaOperationSelection;
+}

package/src/histories/AgenticaSystemMessageHistory.ts

@@ -1,10 +1,10 @@
-import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
-
-import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
-
-export interface AgenticaSystemMessageHistory extends AgenticaHistoryBase<
-  "systemMessage",
-  IAgenticaHistoryJson.ISystemMessage
-> {
-  text: string;
-}
+import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
+
+import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
+
+export interface AgenticaSystemMessageHistory extends AgenticaHistoryBase<
+  "systemMessage",
+  IAgenticaHistoryJson.ISystemMessage
+> {
+  text: string;
+}

package/src/histories/AgenticaUserMessageHistory.ts

@@ -1,11 +1,11 @@
-import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
-
-import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
-import type { AgenticaUserMessageContent } from "./contents/AgenticaUserMessageContent";
-
-export interface AgenticaUserMessageHistory extends AgenticaHistoryBase<
-  "userMessage",
-  IAgenticaHistoryJson.IUserMessage
-> {
-  contents: AgenticaUserMessageContent[];
-}
+import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
+
+import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
+import type { AgenticaUserMessageContent } from "./contents/AgenticaUserMessageContent";
+
+export interface AgenticaUserMessageHistory extends AgenticaHistoryBase<
+  "userMessage",
+  IAgenticaHistoryJson.IUserMessage
+> {
+  contents: AgenticaUserMessageContent[];
+}

package/src/histories/MicroAgenticaHistory.ts

@@ -1,19 +1,19 @@
-import type { AgenticaAssistantMessageHistory } from "./AgenticaAssistantMessageHistory";
-import type { AgenticaDescribeHistory } from "./AgenticaDescribeHistory";
-import type { AgenticaExecuteHistory } from "./AgenticaExecuteHistory";
-import type { AgenticaUserMessageHistory } from "./AgenticaUserMessageHistory";
-
-export type MicroAgenticaHistory =
-  | AgenticaDescribeHistory
-  | AgenticaExecuteHistory
-  | AgenticaAssistantMessageHistory
-  | AgenticaUserMessageHistory;
-export namespace MicroAgenticaHistory {
-  export type Type = MicroAgenticaHistory["type"];
-  export interface Mapper {
-    describe: AgenticaDescribeHistory;
-    execute: AgenticaExecuteHistory;
-    userMessage: AgenticaUserMessageHistory;
-    assistantMessage: AgenticaAssistantMessageHistory;
-  }
-}
+import type { AgenticaAssistantMessageHistory } from "./AgenticaAssistantMessageHistory";
+import type { AgenticaDescribeHistory } from "./AgenticaDescribeHistory";
+import type { AgenticaExecuteHistory } from "./AgenticaExecuteHistory";
+import type { AgenticaUserMessageHistory } from "./AgenticaUserMessageHistory";
+
+export type MicroAgenticaHistory
+  = | AgenticaDescribeHistory
+    | AgenticaExecuteHistory
+    | AgenticaAssistantMessageHistory
+    | AgenticaUserMessageHistory;
+export namespace MicroAgenticaHistory {
+  export type Type = MicroAgenticaHistory["type"];
+  export interface Mapper {
+    describe: AgenticaDescribeHistory;
+    execute: AgenticaExecuteHistory;
+    userMessage: AgenticaUserMessageHistory;
+    assistantMessage: AgenticaAssistantMessageHistory;
+  }
+}

package/src/histories/contents/AgenticaUserMessageAudioContent.ts

@@ -1,21 +1,21 @@
-import type { AgenticaUserMessageContentBase } from "./AgenticaUserMessageContentBase";
-
-/**
- * Audio content by user.
- *
- * @reference https://platform.openai.com/docs/guides/audio
- * @warning We not recommend it because audio data only support base64
- *          so it's too big data
- * @author SunRabbit
- */
-export interface AgenticaUserMessageAudioContent extends AgenticaUserMessageContentBase<"audio"> {
-  /**
-   * Base64 encoded audio data.
-   */
-  data: string;
-
-  /**
-   * The format of the encoded audio data. Currently supports "wav" and "mp3".
-   */
-  format: "wav" | "mp3";
-}
+import type { AgenticaUserMessageContentBase } from "./AgenticaUserMessageContentBase";
+
+/**
+ * Audio content by user.
+ *
+ * @reference https://platform.openai.com/docs/guides/audio
+ * @warning We not recommend it because audio data only support base64
+ *          so it's too big data
+ * @author SunRabbit
+ */
+export interface AgenticaUserMessageAudioContent extends AgenticaUserMessageContentBase<"audio"> {
+  /**
+   * Base64 encoded audio data.
+   */
+  data: string;
+
+  /**
+   * The format of the encoded audio data. Currently supports "wav" and "mp3".
+   */
+  format: "wav" | "mp3";
+}

package/src/histories/contents/AgenticaUserMessageContent.ts

@@ -1,19 +1,19 @@
-import type { AgenticaUserMessageAudioContent } from "./AgenticaUserMessageAudioContent";
-import type { AgenticaUserMessageFileContent } from "./AgenticaUserMessageFileContent";
-import type { AgenticaUserMessageImageContent } from "./AgenticaUserMessageImageContent";
-import type { AgenticaUserMessageTextContent } from "./AgenticaUserMessageTextContent";
-
-export type AgenticaUserMessageContent =
-  | AgenticaUserMessageAudioContent
-  | AgenticaUserMessageFileContent
-  | AgenticaUserMessageImageContent
-  | AgenticaUserMessageTextContent;
-export namespace AgenticaUserMessageContent {
-  export type Type = AgenticaUserMessageContent["type"];
-  export interface Mapper {
-    audio: AgenticaUserMessageAudioContent;
-    file: AgenticaUserMessageFileContent;
-    image: AgenticaUserMessageImageContent;
-    text: AgenticaUserMessageTextContent;
-  }
-}
+import type { AgenticaUserMessageAudioContent } from "./AgenticaUserMessageAudioContent";
+import type { AgenticaUserMessageFileContent } from "./AgenticaUserMessageFileContent";
+import type { AgenticaUserMessageImageContent } from "./AgenticaUserMessageImageContent";
+import type { AgenticaUserMessageTextContent } from "./AgenticaUserMessageTextContent";
+
+export type AgenticaUserMessageContent
+  = | AgenticaUserMessageAudioContent
+    | AgenticaUserMessageFileContent
+    | AgenticaUserMessageImageContent
+    | AgenticaUserMessageTextContent;
+export namespace AgenticaUserMessageContent {
+  export type Type = AgenticaUserMessageContent["type"];
+  export interface Mapper {
+    audio: AgenticaUserMessageAudioContent;
+    file: AgenticaUserMessageFileContent;
+    image: AgenticaUserMessageImageContent;
+    text: AgenticaUserMessageTextContent;
+  }
+}

package/src/histories/contents/AgenticaUserMessageContentBase.ts

@@ -1,6 +1,6 @@
-export interface AgenticaUserMessageContentBase<Type extends string> {
-  /**
-   * Discriminator for the type of content.
-   */
-  type: Type;
-}
+export interface AgenticaUserMessageContentBase<Type extends string> {
+  /**
+   * Discriminator for the type of content.
+   */
+  type: Type;
+}

package/src/histories/contents/AgenticaUserMessageFileContent.ts

@@ -1,25 +1,25 @@
-import type { AgenticaUserMessageContentBase } from "./AgenticaUserMessageContentBase";
-
-/**
- * File content by user.
- *
- * @reference https://platform.openai.com/docs/api-reference/uploads/create
- * @author SunRabbit
- */
-export interface AgenticaUserMessageFileContent extends AgenticaUserMessageContentBase<"file"> {
-  /**
-   * Reference to the pre-uploaded file or the base64 data itself.
-   */
-  file: AgenticaUserMessageFileContent.IId | AgenticaUserMessageFileContent.IBase64;
-}
-export namespace AgenticaUserMessageFileContent {
-  export interface IId {
-    type: "id";
-    id: string;
-  }
-  export interface IBase64 {
-    type: "base64";
-    name: string;
-    data: string;
-  }
-}
+import type { AgenticaUserMessageContentBase } from "./AgenticaUserMessageContentBase";
+
+/**
+ * File content by user.
+ *
+ * @reference https://platform.openai.com/docs/api-reference/uploads/create
+ * @author SunRabbit
+ */
+export interface AgenticaUserMessageFileContent extends AgenticaUserMessageContentBase<"file"> {
+  /**
+   * Reference to the pre-uploaded file or the base64 data itself.
+   */
+  file: AgenticaUserMessageFileContent.IId | AgenticaUserMessageFileContent.IBase64;
+}
+export namespace AgenticaUserMessageFileContent {
+  export interface IId {
+    type: "id";
+    id: string;
+  }
+  export interface IBase64 {
+    type: "base64";
+    name: string;
+    data: string;
+  }
+}

package/src/histories/contents/AgenticaUserMessageImageContent.ts

@@ -1,33 +1,33 @@
-import type { tags } from "typia";
-
-import type { AgenticaUserMessageContentBase } from "./AgenticaUserMessageContentBase";
-
-/**
- * Image content by user.
- *
- * @reference https://platform.openai.com/docs/guides/vision
- * @author SunRabbit
- */
-export interface AgenticaUserMessageImageContent extends AgenticaUserMessageContentBase<"image"> {
-  /**
-   * Image URL or base64 data itself.
-   */
-  image: AgenticaUserMessageImageContent.IUrl | AgenticaUserMessageImageContent.IBase64;
-
-  /**
-   * Specifies the detail level of the image.
-   *
-   * @reference https://platform.openai.com/docs/guides/vision#low-or-high-fidelity-image-understanding
-   */
-  detail?: "auto" | "high" | "low" | undefined;
-}
-export namespace AgenticaUserMessageImageContent {
-  export interface IUrl {
-    type: "url";
-    url: string & tags.Format<"url">;
-  }
-  export interface IBase64 {
-    type: "base64";
-    data: string;
-  }
-}
+import type { tags } from "typia";
+
+import type { AgenticaUserMessageContentBase } from "./AgenticaUserMessageContentBase";
+
+/**
+ * Image content by user.
+ *
+ * @reference https://platform.openai.com/docs/guides/vision
+ * @author SunRabbit
+ */
+export interface AgenticaUserMessageImageContent extends AgenticaUserMessageContentBase<"image"> {
+  /**
+   * Image URL or base64 data itself.
+   */
+  image: AgenticaUserMessageImageContent.IUrl | AgenticaUserMessageImageContent.IBase64;
+
+  /**
+   * Specifies the detail level of the image.
+   *
+   * @reference https://platform.openai.com/docs/guides/vision#low-or-high-fidelity-image-understanding
+   */
+  detail?: "auto" | "high" | "low" | undefined;
+}
+export namespace AgenticaUserMessageImageContent {
+  export interface IUrl {
+    type: "url";
+    url: string & tags.Format<"url">;
+  }
+  export interface IBase64 {
+    type: "base64";
+    data: string;
+  }
+}

package/src/histories/contents/AgenticaUserMessageTextContent.ts

@@ -1,15 +1,15 @@
-import type { AgenticaUserMessageContentBase } from "./AgenticaUserMessageContentBase";
-
-/**
- * Text content by user.
- *
- * @reference https://platform.openai.com/docs/guides/text-generation
- * @author Samchon
- * @author SunRabbit
- */
-export interface AgenticaUserMessageTextContent extends AgenticaUserMessageContentBase<"text"> {
-  /**
-   * The text content.
-   */
-  text: string;
-}
+import type { AgenticaUserMessageContentBase } from "./AgenticaUserMessageContentBase";
+
+/**
+ * Text content by user.
+ *
+ * @reference https://platform.openai.com/docs/guides/text-generation
+ * @author Samchon
+ * @author SunRabbit
+ */
+export interface AgenticaUserMessageTextContent extends AgenticaUserMessageContentBase<"text"> {
+  /**
+   * The text content.
+   */
+  text: string;
+}

package/src/histories/contents/index.ts

@@ -1,5 +1,5 @@
-export * from "./AgenticaUserMessageAudioContent";
-export * from "./AgenticaUserMessageContent";
-export * from "./AgenticaUserMessageFileContent";
-export * from "./AgenticaUserMessageImageContent";
-export * from "./AgenticaUserMessageTextContent";
+export * from "./AgenticaUserMessageAudioContent";
+export * from "./AgenticaUserMessageContent";
+export * from "./AgenticaUserMessageFileContent";
+export * from "./AgenticaUserMessageImageContent";
+export * from "./AgenticaUserMessageTextContent";

package/src/histories/index.ts

@@ -1,10 +1,10 @@
-export * from "./AgenticaAssistantMessageHistory";
-export * from "./AgenticaCancelHistory";
-export * from "./AgenticaDescribeHistory";
-export * from "./AgenticaExecuteHistory";
-export * from "./AgenticaHistory";
-export * from "./AgenticaSelectHistory";
-export * from "./AgenticaSystemMessageHistory";
-export * from "./AgenticaUserMessageHistory";
-export * from "./contents";
-export * from "./MicroAgenticaHistory";
+export * from "./AgenticaAssistantMessageHistory";
+export * from "./AgenticaCancelHistory";
+export * from "./AgenticaDescribeHistory";
+export * from "./AgenticaExecuteHistory";
+export * from "./AgenticaHistory";
+export * from "./AgenticaSelectHistory";
+export * from "./AgenticaSystemMessageHistory";
+export * from "./AgenticaUserMessageHistory";
+export * from "./contents";
+export * from "./MicroAgenticaHistory";