@agentica/core 0.15.6 → 0.16.0

package/src/events/AgenticaSelectEvent.ts

@@ -1,8 +1,8 @@
 import type { ILlmSchema } from "@samchon/openapi";
 
 import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import type { AgenticaSelectHistory } from "../histories/AgenticaSelectHistory";
 import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-import type { AgenticaSelectPrompt } from "../prompts/AgenticaSelectPrompt";
 
 import type { AgenticaEventBase } from "./AgenticaEventBase";
 
@@ -11,5 +11,5 @@ export interface AgenticaSelectEvent<
 > extends AgenticaEventBase<"select"> {
   selection: AgenticaOperationSelection<Model>;
   toJSON: () => IAgenticaEventJson.ISelect;
-  toPrompt: () => AgenticaSelectPrompt<Model>;
+  toHistory: () => AgenticaSelectHistory<Model>;
 }

package/src/events/AgenticaTextEvent.ts

@@ -1,5 +1,5 @@
+import type { AgenticaTextHistory } from "../histories/AgenticaTextHistory";
 import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-import type { AgenticaTextPrompt } from "../prompts/AgenticaTextPrompt";
 
 import type { AgenticaEventBase } from "./AgenticaEventBase";
 
@@ -10,5 +10,5 @@ export interface AgenticaTextEvent<
   stream: ReadableStream<string>;
   join: () => Promise<string>;
   toJSON: () => IAgenticaEventJson.IText;
-  toPrompt: () => AgenticaTextPrompt;
+  toHistory: () => AgenticaTextHistory;
 }

package/src/events/MicroAgenticaEvent.ts

@@ -0,0 +1,41 @@
+import type { ILlmSchema } from "@samchon/openapi";
+
+import type { AgenticaCallEvent } from "./AgenticaCallEvent";
+import type { AgenticaDescribeEvent } from "./AgenticaDescribeEvent";
+import type { AgenticaExecuteEvent } from "./AgenticaExecuteEvent";
+import type { AgenticaRequestEvent } from "./AgenticaRequestEvent";
+import type { AgenticaResponseEvent } from "./AgenticaResponseEvent";
+import type { AgenticaTextEvent } from "./AgenticaTextEvent";
+import type { AgenticaValidateEvent } from "./AgenticaValidateEvent";
+
+/**
+ * Micro Agentica agent event.
+ *
+ * `MicroAgenticaEvent` is an union type of all possible events that
+ * can be emitted by the AI chatbot of the {@link MicroAgentica} class.
+ *
+ * You can discriminate the subtype by checking the {@link type} property.
+ *
+ * @author Samchon
+ */
+export type MicroAgenticaEvent<Model extends ILlmSchema.Model> =
+  | AgenticaCallEvent<Model>
+  | AgenticaDescribeEvent<Model>
+  | AgenticaExecuteEvent<Model>
+  | AgenticaRequestEvent
+  | AgenticaResponseEvent
+  | AgenticaTextEvent
+  | AgenticaValidateEvent<Model>;
+export namespace MicroAgenticaEvent {
+  export type Type = MicroAgenticaEvent<any>["type"];
+  export interface Mapper<Model extends ILlmSchema.Model> {
+    call: AgenticaCallEvent<Model>;
+    describe: AgenticaDescribeEvent<Model>;
+    execute: AgenticaExecuteEvent<Model>;
+    request: AgenticaRequestEvent;
+    response: AgenticaResponseEvent;
+    text: AgenticaTextEvent;
+    validate: AgenticaValidateEvent<Model>;
+  }
+  export type Source = "call" | "describe";
+}

package/src/factory/events.ts

@@ -16,10 +16,10 @@ import type { AgenticaResponseEvent } from "../events/AgenticaResponseEvent";
 import type { AgenticaSelectEvent } from "../events/AgenticaSelectEvent";
 import type { AgenticaTextEvent } from "../events/AgenticaTextEvent";
 import type { AgenticaValidateEvent } from "../events/AgenticaValidateEvent";
+import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
 import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-import type { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
 
-import { createExecutePrompt, createSelectPrompt } from "./prompts";
+import { createExecuteHistory, createSelectHistory } from "./histories";
 
 /* -----------------------------------------------------------
   FUNCTION SELECTS
@@ -44,7 +44,7 @@ export function createSelectEvent<Model extends ILlmSchema.Model>(props: {
       type: "select",
       selection: props.selection.toJSON(),
     }),
-    toPrompt: () => createSelectPrompt({
+    toHistory: () => createSelectHistory({
       id: v4(),
       selections: [props.selection],
     }),
@@ -126,8 +126,8 @@ export function createExecuteEvent<Model extends ILlmSchema.Model>(props: {
       arguments: props.arguments,
       value: props.value,
     }),
-    toPrompt: () =>
-      createExecutePrompt(props) as AgenticaExecutePrompt.Class<Model>,
+    toHistory: () =>
+      createExecuteHistory(props) as AgenticaExecuteHistory.Class<Model>,
   };
 }
 
@@ -152,7 +152,7 @@ export function createTextEvent<Role extends "user" | "assistant">(props: {
       done: props.done(),
       text: props.get(),
     }),
-    toPrompt: () => ({
+    toHistory: () => ({
       type: "text",
       role: props.role,
       text: props.get(),
@@ -166,7 +166,7 @@ export function createTextEvent<Role extends "user" | "assistant">(props: {
 }
 
 export function createDescribeEvent<Model extends ILlmSchema.Model>(props: {
-  executes: AgenticaExecutePrompt<Model>[];
+  executes: AgenticaExecuteHistory<Model>[];
   stream: ReadableStream<string>;
   done: () => boolean;
   get: () => string;
@@ -183,7 +183,7 @@ export function createDescribeEvent<Model extends ILlmSchema.Model>(props: {
       done: props.done(),
       text: props.get(),
     }),
-    toPrompt: () => ({
+    toHistory: () => ({
       type: "describe",
       executes: props.executes,
       text: props.get(),

package/src/factory/{prompts.ts → histories.ts}

@@ -4,14 +4,14 @@ import type OpenAI from "openai";
 import type { AgenticaCancelPrompt } from "../context/AgenticaCancelPrompt";
 import type { AgenticaOperation } from "../context/AgenticaOperation";
 import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
-import type { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
-import type { AgenticaDescribePrompt } from "../prompts/AgenticaDescribePrompt";
-import type { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
-import type { AgenticaPrompt } from "../prompts/AgenticaPrompt";
-import type { AgenticaSelectPrompt } from "../prompts/AgenticaSelectPrompt";
-import type { AgenticaTextPrompt } from "../prompts/AgenticaTextPrompt";
+import type { AgenticaDescribeHistory } from "../histories/AgenticaDescribeHistory";
+import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
+import type { AgenticaHistory } from "../histories/AgenticaHistory";
+import type { AgenticaSelectHistory } from "../histories/AgenticaSelectHistory";
+import type { AgenticaTextHistory } from "../histories/AgenticaTextHistory";
+import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
 
-export function decodePrompt<Model extends ILlmSchema.Model>(history: AgenticaPrompt<Model>): OpenAI.ChatCompletionMessageParam[] {
+export function decodeHistory<Model extends ILlmSchema.Model>(history: AgenticaHistory<Model>): OpenAI.ChatCompletionMessageParam[] {
   // NO NEED TO DECODE DESCRIBE
   if (history.type === "describe") {
     return [];
@@ -98,11 +98,11 @@ export function decodePrompt<Model extends ILlmSchema.Model>(history: AgenticaPr
 /* -----------------------------------------------------------
   TEXT PROMPTS
 ----------------------------------------------------------- */
-export function createTextPrompt<Role extends "assistant" | "user" = "assistant" | "user">(props: {
+export function createTextHistory<Role extends "assistant" | "user" = "assistant" | "user">(props: {
   role: Role;
   text: string;
-}): AgenticaTextPrompt<Role> {
-  const prompt: IAgenticaPromptJson.IText<Role> = {
+}): AgenticaTextHistory<Role> {
+  const prompt: IAgenticaHistoryJson.IText<Role> = {
     type: "text",
     role: props.role,
     text: props.text,
@@ -113,10 +113,10 @@ export function createTextPrompt<Role extends "assistant" | "user" = "assistant"
   };
 }
 
-export function createDescribePrompt<Model extends ILlmSchema.Model>(props: {
-  executes: AgenticaExecutePrompt<Model>[];
+export function createDescribeHistory<Model extends ILlmSchema.Model>(props: {
+  executes: AgenticaExecuteHistory<Model>[];
   text: string;
-}): AgenticaDescribePrompt<Model> {
+}): AgenticaDescribeHistory<Model> {
   return {
     type: "describe",
     text: props.text,
@@ -132,10 +132,10 @@ export function createDescribePrompt<Model extends ILlmSchema.Model>(props: {
 /* -----------------------------------------------------------
   FUNCTION CALLING PROMPTS
 ----------------------------------------------------------- */
-export function createSelectPrompt<Model extends ILlmSchema.Model>(props: {
+export function createSelectHistory<Model extends ILlmSchema.Model>(props: {
   id: string;
   selections: AgenticaOperationSelection<Model>[];
-}): AgenticaSelectPrompt<Model> {
+}): AgenticaSelectHistory<Model> {
   return {
     type: "select",
     id: props.id,
@@ -148,7 +148,7 @@ export function createSelectPrompt<Model extends ILlmSchema.Model>(props: {
   };
 }
 
-export function createCancelPrompt<Model extends ILlmSchema.Model>(props: {
+export function createCancelHistory<Model extends ILlmSchema.Model>(props: {
   id: string;
   selections: AgenticaOperationSelection<Model>[];
 }): AgenticaCancelPrompt<Model> {
@@ -164,14 +164,14 @@ export function createCancelPrompt<Model extends ILlmSchema.Model>(props: {
   };
 }
 
-export function createExecutePrompt<
+export function createExecuteHistory<
   Model extends ILlmSchema.Model,
 >(props: {
   id: string;
   operation: AgenticaOperation<Model>;
   arguments: Record<string, any>;
   value: unknown;
-}): AgenticaExecutePrompt<Model> {
+}): AgenticaExecuteHistory<Model> {
   return {
     type: "execute",
     protocol: props.operation.protocol as "class",

package/src/factory/index.ts

@@ -1,3 +1,3 @@
 export * from "./events";
+export * from "./histories";
 export * from "./operations";
-export * from "./prompts";

package/src/histories/AgenticaCancelHistory.ts

@@ -0,0 +1,13 @@
+import type { ILlmSchema } from "@samchon/openapi";
+
+import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
+
+import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
+
+export interface AgenticaCancelHistory<
+  Model extends ILlmSchema.Model,
+> extends AgenticaHistoryBase<"cancel", IAgenticaHistoryJson.ICancel> {
+  id: string;
+  selections: AgenticaOperationSelection<Model>[];
+}

package/src/histories/AgenticaDescribeHistory.ts

@@ -0,0 +1,22 @@
+import type { ILlmSchema } from "@samchon/openapi";
+
+import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
+
+import type { AgenticaExecuteHistory } from "./AgenticaExecuteHistory";
+import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
+
+export interface AgenticaDescribeHistory<
+  Model extends ILlmSchema.Model,
+> extends AgenticaHistoryBase<"describe", IAgenticaHistoryJson.IDescribe> {
+  /**
+   * Executions of the LLM function calling.
+   *
+   * This prompt describes the return value of them.
+   */
+  executes: AgenticaExecuteHistory<Model>[];
+
+  /**
+   * Description text.
+   */
+  text: string;
+}

package/src/{prompts/AgenticaExecutePrompt.ts → histories/AgenticaExecuteHistory.ts}

@@ -1,19 +1,19 @@
 import type { IHttpResponse, ILlmSchema } from "@samchon/openapi";
 
 import type { AgenticaOperation } from "../context/AgenticaOperation";
-import type { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
+import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
 
-import type { AgenticaPromptBase } from "./AgenticaPromptBase";
+import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
 
 /**
  * Execute prompt.
  *
  * @author Samchon
  */
-export type AgenticaExecutePrompt<Model extends ILlmSchema.Model> =
-  | AgenticaExecutePrompt.Class<Model>
-  | AgenticaExecutePrompt.Http<Model>;
-export namespace AgenticaExecutePrompt {
+export type AgenticaExecuteHistory<Model extends ILlmSchema.Model> =
+  | AgenticaExecuteHistory.Class<Model>
+  | AgenticaExecuteHistory.Http<Model>;
+export namespace AgenticaExecuteHistory {
   /**
    * Class protocol case.
    */
@@ -30,7 +30,7 @@ export namespace AgenticaExecutePrompt {
     Protocol extends "http" | "class",
     Operation extends AgenticaOperation<any>,
     Value,
-  > extends AgenticaPromptBase<"execute", IAgenticaPromptJson.IExecute> {
+  > extends AgenticaHistoryBase<"execute", IAgenticaHistoryJson.IExecute> {
     /**
      * ID of the LLM tool call result.
      */

package/src/histories/AgenticaHistory.ts

@@ -0,0 +1,25 @@
+import type { ILlmSchema } from "@samchon/openapi";
+
+import type { AgenticaCancelPrompt } from "../context/AgenticaCancelPrompt";
+
+import type { AgenticaDescribeHistory } from "./AgenticaDescribeHistory";
+import type { AgenticaExecuteHistory } from "./AgenticaExecuteHistory";
+import type { AgenticaSelectHistory } from "./AgenticaSelectHistory";
+import type { AgenticaTextHistory } from "./AgenticaTextHistory";
+
+export type AgenticaHistory<Model extends ILlmSchema.Model> =
+  | AgenticaCancelPrompt<Model>
+  | AgenticaDescribeHistory<Model>
+  | AgenticaExecuteHistory<Model>
+  | AgenticaSelectHistory<Model>
+  | AgenticaTextHistory;
+export namespace AgenticaHistory {
+  export type Type = AgenticaHistory<any>["type"];
+  export interface Mapper<Model extends ILlmSchema.Model> {
+    cancel: AgenticaCancelPrompt<Model>;
+    describe: AgenticaDescribeHistory<Model>;
+    execute: AgenticaExecuteHistory<Model>;
+    select: AgenticaSelectHistory<Model>;
+    text: AgenticaTextHistory;
+  }
+}

package/src/{prompts/AgenticaPromptBase.ts → histories/AgenticaHistoryBase.ts}

@@ -1,16 +1,16 @@
 /**
- * Base type for all prompts in Agentica.
+ * Base type for all histories in Agentica.
  *
- * `AgenticaPromptBase` is a base type for every prompt types
+ * `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 prompt
+ * @template Json Primitive type of the history
  * @author Samchon
  */
-export interface AgenticaPromptBase<
+export interface AgenticaHistoryBase<
   Type extends string,
   Json extends { type: Type },
 > {

package/src/histories/AgenticaSelectHistory.ts

@@ -0,0 +1,13 @@
+import type { ILlmSchema } from "@samchon/openapi";
+
+import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
+
+import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
+
+export interface AgenticaSelectHistory<
+  Model extends ILlmSchema.Model,
+> extends AgenticaHistoryBase<"select", IAgenticaHistoryJson.ISelect> {
+  id: string;
+  selections: AgenticaOperationSelection<Model>[];
+}

package/src/histories/AgenticaTextHistory.ts

@@ -0,0 +1,10 @@
+import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
+
+import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
+
+export interface AgenticaTextHistory<
+  Role extends "assistant" | "user" = "assistant" | "user",
+> extends AgenticaHistoryBase<"text", IAgenticaHistoryJson.IText> {
+  role: Role;
+  text: string;
+}

package/src/histories/MicroAgenticaHistory.ts

@@ -0,0 +1,18 @@
+import type { ILlmSchema } from "@samchon/openapi";
+
+import type { AgenticaDescribeHistory } from "./AgenticaDescribeHistory";
+import type { AgenticaExecuteHistory } from "./AgenticaExecuteHistory";
+import type { AgenticaTextHistory } from "./AgenticaTextHistory";
+
+export type MicroAgenticaHistory<Model extends ILlmSchema.Model> =
+  | AgenticaDescribeHistory<Model>
+  | AgenticaExecuteHistory<Model>
+  | AgenticaTextHistory;
+export namespace MicroAgenticaHistory {
+  export type Type = MicroAgenticaHistory<any>["type"];
+  export interface Mapper<Model extends ILlmSchema.Model> {
+    describe: AgenticaDescribeHistory<Model>;
+    execute: AgenticaExecuteHistory<Model>;
+    text: AgenticaTextHistory;
+  }
+}

package/src/index.ts

@@ -1,13 +1,14 @@
 export * from "./Agentica";
-
 export * from "./context/AgenticaContext";
+
 export * from "./context/AgenticaOperation";
+
 export * from "./context/AgenticaOperationCollection";
 export * from "./context/AgenticaOperationSelection";
 export * from "./context/AgenticaTokenUsage";
-
 export * from "./events/AgenticaCallEvent";
 export * from "./events/AgenticaCancelEvent";
+
 export * from "./events/AgenticaDescribeEvent";
 export * from "./events/AgenticaEvent";
 export * from "./events/AgenticaEventSource";
@@ -17,34 +18,36 @@ export * from "./events/AgenticaResponseEvent";
 export * from "./events/AgenticaSelectEvent";
 export * from "./events/AgenticaTextEvent";
 export * from "./events/AgenticaValidateEvent";
-
+export * from "./events/MicroAgenticaEvent";
 export * as factory from "./factory";
-
 export * from "./functional/assertHttpLlmApplication";
+
 export * from "./functional/validateHttpLlmApplication";
+export * from "./histories/AgenticaCancelHistory";
+export * from "./histories/AgenticaDescribeHistory";
+export * from "./histories/AgenticaExecuteHistory";
+export * from "./histories/AgenticaHistory";
+export * from "./histories/AgenticaSelectHistory";
+export * from "./histories/AgenticaTextHistory";
+
+export * from "./histories/MicroAgenticaHistory";
+
 export * from "./json/IAgenticaEventJson";
+export * from "./json/IAgenticaHistoryJson";
 export * from "./json/IAgenticaOperationJson";
 export * from "./json/IAgenticaOperationSelectionJson";
-export * from "./json/IAgenticaPromptJson";
-
 export * from "./json/IAgenticaTokenUsageJson";
-
+export * from "./MicroAgentica";
 export * as orchestrate from "./orchestrate";
 
-export * from "./prompts/AgenticaCancelPrompt";
-export * from "./prompts/AgenticaDescribePrompt";
-export * from "./prompts/AgenticaExecutePrompt";
-export * from "./prompts/AgenticaPrompt";
-export * from "./prompts/AgenticaSelectPrompt";
-
-export * from "./prompts/AgenticaTextPrompt";
 export * from "./structures/IAgenticaConfig";
 export * from "./structures/IAgenticaController";
 export * from "./structures/IAgenticaExecutor";
 export * from "./structures/IAgenticaProps";
 export * from "./structures/IAgenticaSystemPrompt";
-
 export * from "./structures/IAgenticaVendor";
+export * from "./structures/IMicroAgenticaConfig";
+export * from "./structures/IMicroAgenticaProps";
 
 /**
  * @internal

package/src/json/IAgenticaEventJson.ts

@@ -2,16 +2,17 @@ import type OpenAI from "openai";
 
 import type { AgenticaEventSource } from "../events/AgenticaEventSource";
 
+import type { IAgenticaHistoryJson } from "./IAgenticaHistoryJson";
 import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
 import type { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelectionJson";
-import type { IAgenticaPromptJson } from "./IAgenticaPromptJson";
 
 /**
- * Nestia A.I. chatbot event.
+ * Agentic AI agent event.
  *
  * `IAgenticaEventJson` is an union type of all possible events that can
- * be emitted by the A.I. chatbot of the {@link Agentica} class. You
- * can discriminate the subtype by checking the {@link type} property.
+ * be emitted by the A.I. chatbot of the {@link Agentica} class.
+ *
+ * You can discriminate the subtype by checking the {@link type} property.
  *
  * @author Samchon
  */
@@ -119,7 +120,7 @@ export namespace IAgenticaEventJson {
      *
      * This prompt describes the return value of them.
      */
-    executes: IAgenticaPromptJson.IExecute[];
+    executes: IAgenticaHistoryJson.IExecute[];
 
     /**
      * Description text.

package/src/json/{IAgenticaPromptJson.ts → IAgenticaHistoryJson.ts}

@@ -2,14 +2,14 @@ import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
 import type { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelectionJson";
 
 /**
- * Nestia A.I. chatbot prompt.
+ * Agentic AI agent prompt.
  *
- * `IWrtnChatPrompt` is an union type of all possible prompts that can
- * be generated by the A.I. chatbot of the {@link Agentica} class.
+ * `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, `IWrtnChatPrompt` is a type of chat history that
- * is occurred during the conversation between the user and the A.I. chatbot
- * in 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}
@@ -17,13 +17,13 @@ import type { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelect
  *
  * @author Samchon
  */
-export type IAgenticaPromptJson =
-  | IAgenticaPromptJson.IText
-  | IAgenticaPromptJson.ISelect
-  | IAgenticaPromptJson.ICancel
-  | IAgenticaPromptJson.IExecute
-  | IAgenticaPromptJson.IDescribe;
-export namespace IAgenticaPromptJson {
+export type IAgenticaHistoryJson =
+  | IAgenticaHistoryJson.IText
+  | IAgenticaHistoryJson.ISelect
+  | IAgenticaHistoryJson.ICancel
+  | IAgenticaHistoryJson.IExecute
+  | IAgenticaHistoryJson.IDescribe;
+export namespace IAgenticaHistoryJson {
   /**
    * Select prompt.
    *

package/src/json/IAgenticaOperationSelectionJson.ts

@@ -1,7 +1,7 @@
 import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
 
 /**
- * Nestia agent operation selection.
+ * Agentica agent operation selection.
  *
  * `IAgenticaOperationSelection` is a type represents an operation
  * which has been selected by the A.I. chatbot of {@link Agentica}
@@ -14,6 +14,13 @@ import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
  * @author Samchon
  */
 export interface IAgenticaOperationSelectionJson {
+  /**
+   * The reason of the selection.
+   */
   reason: string;
+
+  /**
+   * Selected operation.
+   */
   operation: IAgenticaOperationJson;
 }

package/src/json/IMicroAgenticaEventJson.ts

@@ -0,0 +1,21 @@
+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.ICall
+  | IAgenticaEventJson.IDescribe
+  | IAgenticaEventJson.IExecute
+  | IAgenticaEventJson.IInitialize
+  | IAgenticaEventJson.IRequest
+  | IAgenticaEventJson.IText
+  | IAgenticaEventJson.IValidate;

package/src/json/IMicroAgenticaHistoryJson.ts

@@ -0,0 +1,23 @@
+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.IText
+  | IAgenticaHistoryJson.IExecute
+  | IAgenticaHistoryJson.IDescribe;