@agentica/core 0.23.0 → 0.25.0

package/src/histories/AgenticaHistory.ts

@@ -1,27 +1,27 @@
 import type { ILlmSchema } from "@samchon/openapi";
 
+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 { AgenticaTextHistory } from "./AgenticaTextHistory";
-import type { AgenticaUserInputHistory } from "./AgenticaUserInputHistory";
+import type { AgenticaUserMessageHistory } from "./AgenticaUserMessageHistory";
 
 export type AgenticaHistory<Model extends ILlmSchema.Model> =
   | AgenticaCancelHistory<Model>
   | AgenticaDescribeHistory<Model>
   | AgenticaExecuteHistory<Model>
   | AgenticaSelectHistory<Model>
-  | AgenticaTextHistory
-  | AgenticaUserInputHistory;
+  | AgenticaAssistantMessageHistory
+  | AgenticaUserMessageHistory;
 export namespace AgenticaHistory {
   export type Type = AgenticaHistory<any>["type"];
   export interface Mapper<Model extends ILlmSchema.Model> {
+    assistantMessage: AgenticaAssistantMessageHistory;
+    userMessage: AgenticaUserMessageHistory;
+    select: AgenticaSelectHistory<Model>;
     cancel: AgenticaCancelHistory<Model>;
-    describe: AgenticaDescribeHistory<Model>;
     execute: AgenticaExecuteHistory<Model>;
-    select: AgenticaSelectHistory<Model>;
-    text: AgenticaTextHistory;
-    user_input: AgenticaUserInputHistory;
+    describe: AgenticaDescribeHistory<Model>;
   }
 }

package/src/histories/AgenticaUserMessageHistory.ts

@@ -0,0 +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[];
+}

package/src/histories/MicroAgenticaHistory.ts

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

package/src/histories/contents/AgenticaUserMessageAudioContent.ts

@@ -0,0 +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";
+}

package/src/histories/contents/AgenticaUserMessageContent.ts

@@ -0,0 +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;
+  }
+}

package/src/histories/contents/AgenticaUserMessageContentBase.ts

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

package/src/histories/contents/AgenticaUserMessageFileContent.ts

@@ -0,0 +1,27 @@
+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 data itself.
+   *
+   * @todo Properly define independent interface
+   */
+  file: AgenticaUserMessageFileContent.IReference | AgenticaUserMessageFileContent.IData;
+}
+export namespace AgenticaUserMessageFileContent {
+  export interface IReference {
+    type: "reference";
+    id: string;
+  }
+  export interface IData {
+    type: "data";
+    name: string;
+    data: string;
+  }
+}

package/src/histories/contents/AgenticaUserMessageImageContent.ts

@@ -0,0 +1,23 @@
+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.
+   */
+  url: string & tags.Format<"url">;
+
+  /**
+   * 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;
+}

package/src/histories/contents/AgenticaUserMessageTextContent.ts

@@ -0,0 +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;
+}

package/src/histories/contents/index.ts

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

package/src/histories/index.ts

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

package/src/index.ts

@@ -1,62 +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";
-export * from "./events/AgenticaExecuteEvent";
-export * from "./events/AgenticaRequestEvent";
-export * from "./events/AgenticaResponseEvent";
-export * from "./events/AgenticaSelectEvent";
-export * from "./events/AgenticaTextEvent";
-export * from "./events/AgenticaValidateEvent";
-export * from "./events/MicroAgenticaEvent";
 
+export * from "./context";
+export * from "./events";
 export * as factory from "./factory";
-
-export * from "./functional/assertHttpController";
-export * from "./functional/assertHttpLlmApplication";
-export * from "./functional/assertMcpController";
-export * from "./functional/validateHttpController";
-export * from "./functional/validateHttpLlmApplication";
-export * from "./functional/validateMcpController";
-// @TODO: implement validateMcpLlmApplication
-
-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/IAgenticaTokenUsageJson";
-export * from "./json/IMicroAgenticaEventJson";
-export * from "./json/IMicroAgenticaHistoryJson";
+export * from "./functional";
+export * from "./histories";
+export * from "./json";
 export * from "./MicroAgentica";
 export * as orchestrate from "./orchestrate";
-
-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";
+export * from "./structures";
 
 /**
  * @internal

package/src/json/IAgenticaEventJson.ts

@@ -1,7 +1,8 @@
 import type OpenAI from "openai";
+import type { IValidation } from "typia";
 
 import type { AgenticaEventSource } from "../events/AgenticaEventSource";
-import type { AgenticaUserInputHistory } from "../histories/AgenticaUserInputHistory";
+import type { AgenticaUserMessageContent } from "../histories";
 
 import type { IAgenticaHistoryJson } from "./IAgenticaHistoryJson";
 import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
@@ -25,26 +26,38 @@ export type IAgenticaEventJson =
   | IAgenticaEventJson.IInitialize
   | IAgenticaEventJson.IRequest
   | IAgenticaEventJson.ISelect
-  | IAgenticaEventJson.IText
-  | IAgenticaEventJson.IValidate;
+  | IAgenticaEventJson.IValidate
+  | IAgenticaEventJson.IAssistantMessage
+  | IAgenticaEventJson.IUserMessage;
 export namespace IAgenticaEventJson {
   export type Type = IAgenticaEventJson["type"];
   export interface Mapper {
+    userMessage: IUserMessage;
+    assistantMessage: IAssistantMessage;
     initialize: IInitialize;
     select: ISelect;
     cancel: ICancel;
     call: ICall;
     execute: IExecute;
     describe: IDescribe;
-    text: IText;
     request: IRequest;
   }
 
   /**
-   * Event of user input.
+   * Event of assistant message.
    */
-  export interface IUserInput extends IBase<"user_input"> {
-    contents: Array<AgenticaUserInputHistory.Contents>;
+  export interface IAssistantMessage extends IBase<"assistantMessage"> {
+    /**
+     * Conversation text.
+     */
+    text: string;
+  }
+
+  /**
+   * Event of user message.
+   */
+  export interface IUserMessage extends IBase<"userMessage"> {
+    contents: Array<AgenticaUserMessageContent>;
   }
 
   /**
@@ -90,7 +103,22 @@ export namespace IAgenticaEventJson {
     arguments: Record<string, any>;
   }
 
-  export interface IValidate extends IBase<"validate"> {}
+  export interface IValidate extends IBase<"validate"> {
+    /**
+     * ID of the tool calling.
+     */
+    id: string;
+
+    /**
+     * Target operation to call.
+     */
+    operation: IAgenticaOperationJson;
+
+    /**
+     * Validation result as a failure.
+     */
+    result: IValidation.IFailure;
+  }
 
   /**
    * Event of function calling execution.
@@ -141,26 +169,6 @@ export namespace IAgenticaEventJson {
     done: boolean;
   }
 
-  /**
-   * Event of text message.
-   */
-  export interface IText extends IBase<"text"> {
-    /**
-     * Role of the orator.
-     */
-    role: "assistant";
-
-    /**
-     * Conversation text.
-     */
-    text: string;
-
-    /**
-     * Whether the streaming is completed or not.
-     */
-    done: boolean;
-  }
-
   /**
    * Request event of LLM vendor API.
    */

package/src/json/IAgenticaHistoryJson.ts

@@ -1,4 +1,4 @@
-import type { AgenticaUserInputHistory } from "../histories/AgenticaUserInputHistory";
+import type { AgenticaUserMessageContent } from "../histories";
 
 import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
 import type { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelectionJson";
@@ -20,24 +20,45 @@ import type { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelect
  * @author Samchon
  */
 export type IAgenticaHistoryJson =
-  | IAgenticaHistoryJson.IUserInput
-  | IAgenticaHistoryJson.IText
+  | IAgenticaHistoryJson.IUserMessage
+  | IAgenticaHistoryJson.IAssistantMessage
   | IAgenticaHistoryJson.ISelect
   | IAgenticaHistoryJson.ICancel
   | IAgenticaHistoryJson.IExecute
   | IAgenticaHistoryJson.IDescribe;
 export namespace IAgenticaHistoryJson {
+  export type Type = IAgenticaHistoryJson["type"];
+  export interface Mapper {
+    userMessage: IUserMessage;
+    assistantMessage: IAssistantMessage;
+    select: ISelect;
+    cancel: ICancel;
+    execute: IExecute;
+    describe: IDescribe;
+  }
+
   /**
-   * User input prompt.
+   * User prompt.
    *
-   * User input prompt about the user's input.
+   * User prompt about the user's input.
    */
-  export interface IUserInput extends IBase<"user_input"> {
+  export interface IUserMessage extends IBase<"userMessage"> {
     /**
      * User input.
      */
-    contents: Array<AgenticaUserInputHistory.Contents>;
+    contents: Array<AgenticaUserMessageContent>;
   }
+
+  /**
+   * Assistant prompt.
+   */
+  export interface IAssistantMessage extends IBase<"assistantMessage"> {
+    /**
+     * The text content.
+     */
+    text: string;
+  }
+
   /**
    * Select prompt.
    *
@@ -118,21 +139,6 @@ export namespace IAgenticaHistoryJson {
     text: string;
   }
 
-  /**
-   * Text prompt.
-   */
-  export interface IText extends IBase<"text"> {
-    /**
-     * Role of the orator.
-     */
-    role: "assistant";
-
-    /**
-     * The text content.
-     */
-    text: string;
-  }
-
   interface IBase<Type extends string> {
     /**
      * Discriminator type.

package/src/json/IMicroAgenticaEventJson.ts

@@ -12,10 +12,11 @@ import type { IAgenticaEventJson } from "./IAgenticaEventJson";
  * @author Samchon
  */
 export type IMicroAgenticaEventJson =
+  | IAgenticaEventJson.IUserMessage
+  | IAgenticaEventJson.IAssistantMessage
   | IAgenticaEventJson.ICall
   | IAgenticaEventJson.IDescribe
   | IAgenticaEventJson.IExecute
   | IAgenticaEventJson.IInitialize
   | IAgenticaEventJson.IRequest
-  | IAgenticaEventJson.IText
   | IAgenticaEventJson.IValidate;

package/src/json/IMicroAgenticaHistoryJson.ts

@@ -18,6 +18,7 @@ import type { IAgenticaHistoryJson } from "./IAgenticaHistoryJson";
  * @author Samchon
  */
 export type IMicroAgenticaHistoryJson =
-  | IAgenticaHistoryJson.IText
+  | IAgenticaHistoryJson.IUserMessage
+  | IAgenticaHistoryJson.IAssistantMessage
   | IAgenticaHistoryJson.IExecute
   | IAgenticaHistoryJson.IDescribe;

package/src/json/index.ts

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

package/src/orchestrate/call.ts

@@ -17,18 +17,18 @@ import type { AgenticaContext } from "../context/AgenticaContext";
 import type { AgenticaOperation } from "../context/AgenticaOperation";
 import type { MicroAgenticaContext } from "../context/MicroAgenticaContext";
 import type { AgenticaCallEvent } from "../events/AgenticaCallEvent";
+import type { AgenticaAssistantMessageHistory } from "../histories/AgenticaAssistantMessageHistory";
 import type { AgenticaCancelHistory } from "../histories/AgenticaCancelHistory";
 import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
 import type { AgenticaHistory } from "../histories/AgenticaHistory";
-import type { AgenticaTextHistory } from "../histories/AgenticaTextHistory";
 import type { MicroAgenticaHistory } from "../histories/MicroAgenticaHistory";
 
 import { AgenticaConstant } from "../constants/AgenticaConstant";
 import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
 import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
 import { isAgenticaContext } from "../context/internal/isAgenticaContext";
-import { createCallEvent, createExecuteEvent, createTextEvent, createValidateEvent } from "../factory/events";
-import { createCancelHistory, createExecuteHistory, createTextHistory, decodeHistory } from "../factory/histories";
+import { creatAssistantEvent, createCallEvent, createExecuteEvent, createValidateEvent } from "../factory/events";
+import { createAssistantMessageHistory, createCancelHistory, createExecuteHistory, decodeHistory, decodeUserMessageContent } from "../factory/histories";
 import { createOperationSelection } from "../factory/operations";
 import { ChatGptCompletionMessageUtil } from "../utils/ChatGptCompletionMessageUtil";
 import { StreamUtil, toAsyncGenerator } from "../utils/StreamUtil";
@@ -54,7 +54,7 @@ export async function call<Model extends ILlmSchema.Model>(
       // USER INPUT
       {
         role: "user",
-        content: ctx.prompt.contents,
+        content: ctx.prompt.contents.map(decodeUserMessageContent),
       },
       // SYSTEM PROMPT
       ...(ctx.config?.systemPrompt?.execute === null
@@ -104,7 +104,7 @@ export async function call<Model extends ILlmSchema.Model>(
       Array<
         | AgenticaExecuteHistory<Model>
         | AgenticaCancelHistory<Model>
-        | AgenticaTextHistory
+        | AgenticaAssistantMessageHistory
       >
     >
   > = [];
@@ -181,11 +181,11 @@ export async function call<Model extends ILlmSchema.Model>(
       && choice.message.content.length !== 0
     ) {
       closures.push(async () => {
-        const value: AgenticaTextHistory = createTextHistory(
+        const value: AgenticaAssistantMessageHistory = createAssistantMessageHistory(
           { text: choice.message.content! },
         );
         ctx.dispatch(
-          createTextEvent({
+          creatAssistantEvent({
             get: () => value.text,
             done: () => true,
             stream: toAsyncGenerator(value.text),
@@ -471,7 +471,7 @@ async function correct<Model extends ILlmSchema.Model>(
         // USER INPUT
         {
           role: "user",
-          content: ctx.prompt.contents,
+          content: ctx.prompt.contents.map(decodeUserMessageContent),
         },
         // TYPE CORRECTION
         ...(ctx.config?.systemPrompt?.execute === null

package/src/orchestrate/cancel.ts

@@ -16,7 +16,7 @@ import type { AgenticaCancelHistory } from "../histories/AgenticaCancelHistory";
 import { AgenticaConstant } from "../constants/AgenticaConstant";
 import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
 import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
-import { createCancelHistory, decodeHistory } from "../factory/histories";
+import { createCancelHistory, decodeHistory, decodeUserMessageContent } from "../factory/histories";
 import { ChatGptCompletionMessageUtil } from "../utils/ChatGptCompletionMessageUtil";
 import { StreamUtil } from "../utils/StreamUtil";
 
@@ -141,7 +141,7 @@ async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>,
         // USER INPUT
         {
           role: "user",
-          content: ctx.prompt.contents,
+          content: ctx.prompt.contents.map(decodeUserMessageContent),
         },
         // SYSTEM PROMPT
         {

package/src/orchestrate/initialize.ts

@@ -9,8 +9,8 @@ import type { AgenticaHistory } from "../histories/AgenticaHistory";
 
 import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
 import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
-import { createTextEvent } from "../factory/events";
-import { createTextHistory, decodeHistory } from "../factory/histories";
+import { creatAssistantEvent } from "../factory/events";
+import { createAssistantMessageHistory, decodeHistory, decodeUserMessageContent } from "../factory/histories";
 import { ChatGptCompletionMessageUtil } from "../utils/ChatGptCompletionMessageUtil";
 import { MPSC } from "../utils/MPSC";
 import { streamDefaultReaderToAsyncGenerator, StreamUtil } from "../utils/StreamUtil";
@@ -36,7 +36,7 @@ export async function initialize<Model extends ILlmSchema.Model>(ctx: AgenticaCo
         // USER INPUT
         {
           role: "user",
-          content: ctx.prompt.contents,
+          content: ctx.prompt.contents.map(decodeUserMessageContent),
         },
         {
           // SYSTEM PROMPT
@@ -107,7 +107,7 @@ export async function initialize<Model extends ILlmSchema.Model>(ctx: AgenticaCo
         mpsc.produce(choice.delta.content);
 
         ctx.dispatch(
-          createTextEvent({
+          creatAssistantEvent({
             stream: streamDefaultReaderToAsyncGenerator(mpsc.consumer.getReader()),
             done: () => mpsc.done(),
             get: () => textContext[choice.index]!.content,
@@ -144,7 +144,7 @@ export async function initialize<Model extends ILlmSchema.Model>(ctx: AgenticaCo
       && choice.message.content.length !== 0
     ) {
       prompts.push(
-        createTextHistory({ text: choice.message.content }),
+        createAssistantMessageHistory({ text: choice.message.content }),
       );
     }
   }

package/src/orchestrate/select.ts

@@ -17,8 +17,8 @@ import type { AgenticaSelectHistory } from "../histories/AgenticaSelectHistory";
 import { AgenticaConstant } from "../constants/AgenticaConstant";
 import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
 import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
-import { createTextEvent } from "../factory/events";
-import { createSelectHistory, createTextHistory, decodeHistory } from "../factory/histories";
+import { creatAssistantEvent } from "../factory/events";
+import { createAssistantMessageHistory, createSelectHistory, decodeHistory, decodeUserMessageContent } from "../factory/histories";
 import { createOperationSelection } from "../factory/operations";
 import { ChatGptCompletionMessageUtil } from "../utils/ChatGptCompletionMessageUtil";
 import { StreamUtil, toAsyncGenerator } from "../utils/StreamUtil";
@@ -144,7 +144,7 @@ async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>,
         // USER INPUT
         {
           role: "user",
-          content: ctx.prompt.contents,
+          content: ctx.prompt.contents.map(decodeUserMessageContent),
         },
         // SYSTEM PROMPT
         {
@@ -259,11 +259,11 @@ async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>,
       && choice.message.content != null
       && choice.message.content.length !== 0
     ) {
-      const text = createTextHistory({ text: choice.message.content });
+      const text = createAssistantMessageHistory({ text: choice.message.content });
       prompts.push(text);
 
       ctx.dispatch(
-        createTextEvent({
+        creatAssistantEvent({
           stream: toAsyncGenerator(text.text),
           join: async () => Promise.resolve(text.text),
           done: () => true,