@agentica/core 0.43.2 → 0.44.0-dev.20260313

package/src/json/IAgenticaTokenUsageJson.ts

@@ -1,107 +1,107 @@
-/**
- * Token usage information from the A.I. chatbot.
- *
- * `IAgenticaTokenUsageJson` is a structure representing the token usage
- * information from the {@link Agentica} class. And you can get the
- * token usage information by calling the {@link Agentica.getTokenUsage}
- * method.
- *
- * For reference, `IAgenticaTokenUsageJson` provides only the token usage
- * information, and does not contain any price or cost information. It is
- * because the price or cost can be changed by below reasons.
- *
- * - Type of {@link IAgenticaProps.vendor LLM vendor}
- * - {@link IAgenticaVendor.model} in the LLM vendor.
- * - Just by a policy change of the LLM vendor company.
- *
- * @author Samchon
- */
-export interface IAgenticaTokenUsageJson {
-  /**
-   * Aggregated token usage.
-   */
-  aggregate: IAgenticaTokenUsageJson.IComponent;
-
-  /**
-   * Token uasge of initializer agent.
-   */
-  initialize: IAgenticaTokenUsageJson.IComponent;
-
-  /**
-   * Token usage of function selector agent.
-   */
-  select: IAgenticaTokenUsageJson.IComponent;
-
-  /**
-   * Token usage of function canceler agent.
-   */
-  cancel: IAgenticaTokenUsageJson.IComponent;
-
-  /**
-   * Token usage of function caller agent.
-   */
-  call: IAgenticaTokenUsageJson.IComponent;
-
-  /**
-   * Token usage of function calling describer agent.
-   */
-  describe: IAgenticaTokenUsageJson.IComponent;
-}
-export namespace IAgenticaTokenUsageJson {
-  export interface IComponent {
-    /**
-     * Total token usage.
-     */
-    total: number;
-
-    /**
-     * Input token usage of detailed.
-     */
-    input: IInput;
-
-    /**
-     * Output token usage of detailed.
-     */
-    output: IOutput;
-  }
-
-  /**
-   * Input token usage of detailed.
-   */
-  export interface IInput {
-    /**
-     * Total amount of input token uasge.
-     */
-    total: number;
-
-    /**
-     * Cached token usage.
-     */
-    cached: number;
-  }
-
-  /**
-   * Output token usage of detailed.
-   */
-  export interface IOutput {
-    /**
-     * Total amount of output token usage.
-     */
-    total: number;
-
-    /**
-     * Reasoning token usage.
-     */
-    reasoning: number;
-
-    /**
-     * Prediction token usage.
-     */
-    accepted_prediction: number;
-
-    /**
-     * Rejected prediction token usage.
-     */
-    rejected_prediction: number;
-  }
-}
+/**
+ * Token usage information from the A.I. chatbot.
+ *
+ * `IAgenticaTokenUsageJson` is a structure representing the token usage
+ * information from the {@link Agentica} class. And you can get the
+ * token usage information by calling the {@link Agentica.getTokenUsage}
+ * method.
+ *
+ * For reference, `IAgenticaTokenUsageJson` provides only the token usage
+ * information, and does not contain any price or cost information. It is
+ * because the price or cost can be changed by below reasons.
+ *
+ * - Type of {@link IAgenticaProps.vendor LLM vendor}
+ * - {@link IAgenticaVendor.model} in the LLM vendor.
+ * - Just by a policy change of the LLM vendor company.
+ *
+ * @author Samchon
+ */
+export interface IAgenticaTokenUsageJson {
+  /**
+   * Aggregated token usage.
+   */
+  aggregate: IAgenticaTokenUsageJson.IComponent;
+
+  /**
+   * Token uasge of initializer agent.
+   */
+  initialize: IAgenticaTokenUsageJson.IComponent;
+
+  /**
+   * Token usage of function selector agent.
+   */
+  select: IAgenticaTokenUsageJson.IComponent;
+
+  /**
+   * Token usage of function canceler agent.
+   */
+  cancel: IAgenticaTokenUsageJson.IComponent;
+
+  /**
+   * Token usage of function caller agent.
+   */
+  call: IAgenticaTokenUsageJson.IComponent;
+
+  /**
+   * Token usage of function calling describer agent.
+   */
+  describe: IAgenticaTokenUsageJson.IComponent;
+}
+export namespace IAgenticaTokenUsageJson {
+  export interface IComponent {
+    /**
+     * Total token usage.
+     */
+    total: number;
+
+    /**
+     * Input token usage of detailed.
+     */
+    input: IInput;
+
+    /**
+     * Output token usage of detailed.
+     */
+    output: IOutput;
+  }
+
+  /**
+   * Input token usage of detailed.
+   */
+  export interface IInput {
+    /**
+     * Total amount of input token uasge.
+     */
+    total: number;
+
+    /**
+     * Cached token usage.
+     */
+    cached: number;
+  }
+
+  /**
+   * Output token usage of detailed.
+   */
+  export interface IOutput {
+    /**
+     * Total amount of output token usage.
+     */
+    total: number;
+
+    /**
+     * Reasoning token usage.
+     */
+    reasoning: number;
+
+    /**
+     * Prediction token usage.
+     */
+    accepted_prediction: number;
+
+    /**
+     * Rejected prediction token usage.
+     */
+    rejected_prediction: number;
+  }
+}

package/src/json/IMicroAgenticaEventJson.ts

@@ -1,22 +1,22 @@
-import type { IAgenticaEventJson } from "./IAgenticaEventJson";
-
-/**
- * Micro Agentic AI agent event.
- *
- * `IMicroAgenticaEventJson` is an union type of all possible events
- * that can be emitted by the A.I. chatbot of the {@link MicroAgentica}
- * class.
- *
- * You can discriminate the subtype by checking the {@link type} property.
- *
- * @author Samchon
- */
-export type IMicroAgenticaEventJson =
-  | IAgenticaEventJson.IUserMessage
-  | IAgenticaEventJson.IAssistantMessage
-  | IAgenticaEventJson.ICall
-  | IAgenticaEventJson.IDescribe
-  | IAgenticaEventJson.IExecute
-  | IAgenticaEventJson.IInitialize
-  | IAgenticaEventJson.IRequest
-  | IAgenticaEventJson.IValidate;
+import type { IAgenticaEventJson } from "./IAgenticaEventJson";
+
+/**
+ * Micro Agentic AI agent event.
+ *
+ * `IMicroAgenticaEventJson` is an union type of all possible events
+ * that can be emitted by the A.I. chatbot of the {@link MicroAgentica}
+ * class.
+ *
+ * You can discriminate the subtype by checking the {@link type} property.
+ *
+ * @author Samchon
+ */
+export type IMicroAgenticaEventJson
+  = | IAgenticaEventJson.IUserMessage
+    | IAgenticaEventJson.IAssistantMessage
+    | IAgenticaEventJson.ICall
+    | IAgenticaEventJson.IDescribe
+    | IAgenticaEventJson.IExecute
+    | IAgenticaEventJson.IInitialize
+    | IAgenticaEventJson.IRequest
+    | IAgenticaEventJson.IValidate;

package/src/json/IMicroAgenticaHistoryJson.ts

@@ -1,25 +1,25 @@
-import type { IAgenticaHistoryJson } from "./IAgenticaHistoryJson";
-
-/**
- * Micro Agentic AI agent prompt.
- *
- * `IMicroAgenticaPromptJson` is an union type of all possible prompts
- * that can be generated by the AI chatbot of the {@link MicroAgentica}
- * class.
- *
- * In other words, `IMicroAgenticaPromptJson` is a type of chat history
- * that is occurred during the conversation between the user and the
- * AI chatbot in the {@link MicroAgentica} class.
- *
- * If you want to continue the previous A.I. chatbot session, you can
- * accomplish it by assigning the {@link IMicroAgenticaProps.histories}
- * property when creating a new {@link MicroAgentica} instance.
- *
- * @author Samchon
- */
-export type IMicroAgenticaHistoryJson =
-  | IAgenticaHistoryJson.IExecute
-  | IAgenticaHistoryJson.IDescribe
-  | IAgenticaHistoryJson.IAssistantMessage
-  | IAgenticaHistoryJson.ISystemMessage
-  | IAgenticaHistoryJson.IUserMessage;
+import type { IAgenticaHistoryJson } from "./IAgenticaHistoryJson";
+
+/**
+ * Micro Agentic AI agent prompt.
+ *
+ * `IMicroAgenticaPromptJson` is an union type of all possible prompts
+ * that can be generated by the AI chatbot of the {@link MicroAgentica}
+ * class.
+ *
+ * In other words, `IMicroAgenticaPromptJson` is a type of chat history
+ * that is occurred during the conversation between the user and the
+ * AI chatbot in the {@link MicroAgentica} class.
+ *
+ * If you want to continue the previous A.I. chatbot session, you can
+ * accomplish it by assigning the {@link IMicroAgenticaProps.histories}
+ * property when creating a new {@link MicroAgentica} instance.
+ *
+ * @author Samchon
+ */
+export type IMicroAgenticaHistoryJson
+  = | IAgenticaHistoryJson.IExecute
+    | IAgenticaHistoryJson.IDescribe
+    | IAgenticaHistoryJson.IAssistantMessage
+    | IAgenticaHistoryJson.ISystemMessage
+    | IAgenticaHistoryJson.IUserMessage;

package/src/json/index.ts

@@ -1,7 +1,7 @@
-export * from "./IAgenticaEventJson";
-export * from "./IAgenticaHistoryJson";
-export * from "./IAgenticaOperationJson";
-export * from "./IAgenticaOperationSelectionJson";
-export * from "./IAgenticaTokenUsageJson";
-export * from "./IMicroAgenticaEventJson";
-export * from "./IMicroAgenticaHistoryJson";
+export * from "./IAgenticaEventJson";
+export * from "./IAgenticaHistoryJson";
+export * from "./IAgenticaOperationJson";
+export * from "./IAgenticaOperationSelectionJson";
+export * from "./IAgenticaTokenUsageJson";
+export * from "./IMicroAgenticaEventJson";
+export * from "./IMicroAgenticaHistoryJson";