@agentica/core 0.21.0 → 0.23.0

package/src/histories/MicroAgenticaHistory.ts

@@ -3,11 +3,13 @@ import type { ILlmSchema } from "@samchon/openapi";
 import type { AgenticaDescribeHistory } from "./AgenticaDescribeHistory";
 import type { AgenticaExecuteHistory } from "./AgenticaExecuteHistory";
 import type { AgenticaTextHistory } from "./AgenticaTextHistory";
+import type { AgenticaUserInputHistory } from "./AgenticaUserInputHistory";
 
 export type MicroAgenticaHistory<Model extends ILlmSchema.Model> =
   | AgenticaDescribeHistory<Model>
   | AgenticaExecuteHistory<Model>
-  | AgenticaTextHistory;
+  | AgenticaTextHistory
+  | AgenticaUserInputHistory;
 export namespace MicroAgenticaHistory {
   export type Type = MicroAgenticaHistory<any>["type"];
   export interface Mapper<Model extends ILlmSchema.Model> {

package/src/index.ts

@@ -22,9 +22,12 @@ export * from "./events/MicroAgenticaEvent";
 
 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";

package/src/json/IAgenticaEventJson.ts

@@ -1,6 +1,7 @@
 import type OpenAI from "openai";
 
 import type { AgenticaEventSource } from "../events/AgenticaEventSource";
+import type { AgenticaUserInputHistory } from "../histories/AgenticaUserInputHistory";
 
 import type { IAgenticaHistoryJson } from "./IAgenticaHistoryJson";
 import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
@@ -39,6 +40,13 @@ export namespace IAgenticaEventJson {
     request: IRequest;
   }
 
+  /**
+   * Event of user input.
+   */
+  export interface IUserInput extends IBase<"user_input"> {
+    contents: Array<AgenticaUserInputHistory.Contents>;
+  }
+
   /**
    * Event of initializing the chatbot.
    */
@@ -140,7 +148,7 @@ export namespace IAgenticaEventJson {
     /**
      * Role of the orator.
      */
-    role: "assistant" | "user";
+    role: "assistant";
 
     /**
      * Conversation text.

package/src/json/IAgenticaHistoryJson.ts

@@ -1,3 +1,5 @@
+import type { AgenticaUserInputHistory } from "../histories/AgenticaUserInputHistory";
+
 import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
 import type { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelectionJson";
 
@@ -18,12 +20,24 @@ import type { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelect
  * @author Samchon
  */
 export type IAgenticaHistoryJson =
+  | IAgenticaHistoryJson.IUserInput
   | IAgenticaHistoryJson.IText
   | IAgenticaHistoryJson.ISelect
   | IAgenticaHistoryJson.ICancel
   | IAgenticaHistoryJson.IExecute
   | IAgenticaHistoryJson.IDescribe;
 export namespace IAgenticaHistoryJson {
+  /**
+   * User input prompt.
+   *
+   * User input prompt about the user's input.
+   */
+  export interface IUserInput extends IBase<"user_input"> {
+    /**
+     * User input.
+     */
+    contents: Array<AgenticaUserInputHistory.Contents>;
+  }
   /**
    * Select prompt.
    *
@@ -107,13 +121,11 @@ export namespace IAgenticaHistoryJson {
   /**
    * Text prompt.
    */
-  export interface IText<
-    Role extends "assistant" | "user" = "assistant" | "user",
-  > extends IBase<"text"> {
+  export interface IText extends IBase<"text"> {
     /**
      * Role of the orator.
      */
-    role: Role;
+    role: "assistant";
 
     /**
      * The text content.

package/src/orchestrate/call.ts

@@ -54,7 +54,7 @@ export async function call<Model extends ILlmSchema.Model>(
       // USER INPUT
       {
         role: "user",
-        content: ctx.prompt.text,
+        content: ctx.prompt.contents,
       },
       // SYSTEM PROMPT
       ...(ctx.config?.systemPrompt?.execute === null
@@ -181,13 +181,11 @@ export async function call<Model extends ILlmSchema.Model>(
       && choice.message.content.length !== 0
     ) {
       closures.push(async () => {
-        const value: AgenticaTextHistory = createTextHistory({
-          role: "assistant",
-          text: choice.message.content!,
-        });
+        const value: AgenticaTextHistory = createTextHistory(
+          { text: choice.message.content! },
+        );
         ctx.dispatch(
           createTextEvent({
-            role: "assistant",
             get: () => value.text,
             done: () => true,
             stream: toAsyncGenerator(value.text),
@@ -473,7 +471,7 @@ async function correct<Model extends ILlmSchema.Model>(
         // USER INPUT
         {
           role: "user",
-          content: ctx.prompt.text,
+          content: ctx.prompt.contents,
         },
         // TYPE CORRECTION
         ...(ctx.config?.systemPrompt?.execute === null

package/src/orchestrate/cancel.ts

@@ -141,7 +141,7 @@ async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>,
         // USER INPUT
         {
           role: "user",
-          content: ctx.prompt.text,
+          content: ctx.prompt.contents,
         },
         // SYSTEM PROMPT
         {

package/src/orchestrate/initialize.ts

@@ -36,7 +36,7 @@ export async function initialize<Model extends ILlmSchema.Model>(ctx: AgenticaCo
         // USER INPUT
         {
           role: "user",
-          content: ctx.prompt.text,
+          content: ctx.prompt.contents,
         },
         {
           // SYSTEM PROMPT
@@ -108,7 +108,6 @@ export async function initialize<Model extends ILlmSchema.Model>(ctx: AgenticaCo
 
         ctx.dispatch(
           createTextEvent({
-            role: "assistant",
             stream: streamDefaultReaderToAsyncGenerator(mpsc.consumer.getReader()),
             done: () => mpsc.done(),
             get: () => textContext[choice.index]!.content,
@@ -145,10 +144,7 @@ export async function initialize<Model extends ILlmSchema.Model>(ctx: AgenticaCo
       && choice.message.content.length !== 0
     ) {
       prompts.push(
-        createTextHistory({
-          role: "assistant",
-          text: choice.message.content,
-        }),
+        createTextHistory({ text: choice.message.content }),
       );
     }
   }

package/src/orchestrate/select.ts

@@ -13,7 +13,6 @@ import type { __IChatSelectFunctionsApplication } from "../context/internal/__IC
 import type { AgenticaEvent } from "../events/AgenticaEvent";
 import type { AgenticaHistory } from "../histories/AgenticaHistory";
 import type { AgenticaSelectHistory } from "../histories/AgenticaSelectHistory";
-import type { AgenticaTextHistory } from "../histories/AgenticaTextHistory";
 
 import { AgenticaConstant } from "../constants/AgenticaConstant";
 import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
@@ -145,7 +144,7 @@ async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>,
         // USER INPUT
         {
           role: "user",
-          content: ctx.prompt.text,
+          content: ctx.prompt.contents,
         },
         // SYSTEM PROMPT
         {
@@ -260,15 +259,11 @@ async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>,
       && choice.message.content != null
       && choice.message.content.length !== 0
     ) {
-      const text: AgenticaTextHistory = createTextHistory({
-        role: "assistant",
-        text: choice.message.content,
-      });
+      const text = createTextHistory({ text: choice.message.content });
       prompts.push(text);
 
       ctx.dispatch(
         createTextEvent({
-          role: "assistant",
           stream: toAsyncGenerator(text.text),
           join: async () => Promise.resolve(text.text),
           done: () => true,

package/src/transformers/AgenticaEventTransformer.ts

@@ -175,7 +175,6 @@ function transformText(props: {
   event: IAgenticaEventJson.IText;
 }): AgenticaTextEvent {
   return createTextEvent({
-    role: props.event.role,
     stream: toAsyncGenerator(props.event.text),
     done: () => true,
     get: () => props.event.text,