@agentica/core 0.24.0 → 0.26.0

package/lib/transformers/{AgenticaHistoryTransformer.js → transformHistory.js}

@@ -1,12 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgenticaHistoryTransformer = void 0;
+exports.transformHistory = transformHistory;
 const histories_1 = require("../factory/histories");
 const operations_1 = require("../factory/operations");
-function transform(props) {
-    // TEXT
-    if (props.history.type === "text") {
-        return transformText({
+/**
+ * @internal
+ */
+function transformHistory(props) {
+    // USER
+    if (props.history.type === "userMessage") {
+        return transformUserMessage({
+            history: props.history,
+        });
+    }
+    // ASSISTANT
+    else if (props.history.type === "assistantMessage") {
+        return transformAssistantMessage({
+            history: props.history,
+        });
+    }
+    // SYSTEM
+    else if (props.history.type === "systemMessage") {
+        return transformSystemMessage({
             history: props.history,
         });
     }
@@ -30,16 +45,19 @@ function transform(props) {
             history: props.history,
         });
     }
-    else if (props.history.type === "describe") {
-        return transformDescribe({
-            operations: props.operations,
-            history: props.history,
-        });
-    }
-    throw new Error("Invalid prompt type.");
+    return transformDescribe({
+        operations: props.operations,
+        history: props.history,
+    });
+}
+function transformAssistantMessage(props) {
+    return (0, histories_1.createAssistantMessageHistory)(props.history);
+}
+function transformSystemMessage(props) {
+    return (0, histories_1.createSystemMessageHistory)(props.history);
 }
-function transformText(props) {
-    return (0, histories_1.createTextHistory)(props.history);
+function transformUserMessage(props) {
+    return (0, histories_1.createUserMessageHistory)(props.history);
 }
 function transformSelect(props) {
     return (0, histories_1.createSelectHistory)({
@@ -98,12 +116,4 @@ function findOperation(props) {
     }
     return found;
 }
-exports.AgenticaHistoryTransformer = {
-    transform,
-    transformText,
-    transformSelect,
-    transformCancel,
-    transformExecute,
-    transformDescribe,
-};
-//# sourceMappingURL=AgenticaHistoryTransformer.js.map
+//# sourceMappingURL=transformHistory.js.map

package/lib/transformers/transformHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformHistory.js","sourceRoot":"","sources":["../../src/transformers/transformHistory.ts"],"names":[],"mappings":"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"}

package/lib/utils/ChatGptCompletionMessageUtil.js

@@ -44,7 +44,7 @@ const ChatGptTokenUsageAggregator_1 = require("./ChatGptTokenUsageAggregator");
 function transformCompletionChunk(source) {
     const str = source instanceof Uint8Array ? ByteArrayUtil_1.ByteArrayUtil.toUtf8(source) : source;
     const result = JSON.parse(str);
-    const valid = (() => { const _io0 = input => "string" === typeof input.id && (Array.isArray(input.choices) && input.choices.every(elem => "object" === typeof elem && null !== elem && _io1(elem))) && "number" === typeof input.created && "string" === typeof input.model && "chat.completion.chunk" === input.object && (null === input.service_tier || undefined === input.service_tier || "scale" === input.service_tier || "default" === input.service_tier) && (undefined === input.system_fingerprint || "string" === typeof input.system_fingerprint) && (null === input.usage || undefined === input.usage || "object" === typeof input.usage && null !== input.usage && _io9(input.usage)); const _io1 = input => "object" === typeof input.delta && null !== input.delta && false === Array.isArray(input.delta) && _io2(input.delta) && (null === input.finish_reason || "length" === input.finish_reason || "function_call" === input.finish_reason || "stop" === input.finish_reason || "tool_calls" === input.finish_reason || "content_filter" === input.finish_reason) && "number" === typeof input.index && (null === input.logprobs || undefined === input.logprobs || "object" === typeof input.logprobs && null !== input.logprobs && _io6(input.logprobs)); const _io2 = input => (null === input.content || undefined === input.content || "string" === typeof input.content) && (undefined === input.function_call || "object" === typeof input.function_call && null !== input.function_call && false === Array.isArray(input.function_call) && _io3(input.function_call)) && (null === input.refusal || undefined === input.refusal || "string" === typeof input.refusal) && (undefined === input.role || "assistant" === input.role || "user" === input.role || "developer" === input.role || "system" === input.role || "tool" === input.role) && (undefined === input.tool_calls || Array.isArray(input.tool_calls) && input.tool_calls.every(elem => "object" === typeof elem && null !== elem && _io4(elem))); const _io3 = input => (undefined === input.arguments || "string" === typeof input.arguments) && (undefined === input.name || "string" === typeof input.name); const _io4 = input => "number" === typeof input.index && (undefined === input.id || "string" === typeof input.id) && (undefined === input["function"] || "object" === typeof input["function"] && null !== input["function"] && false === Array.isArray(input["function"]) && _io5(input["function"])) && (undefined === input.type || "function" === input.type); const _io5 = input => (undefined === input.arguments || "string" === typeof input.arguments) && (undefined === input.name || "string" === typeof input.name); const _io6 = input => (null === input.content || Array.isArray(input.content) && input.content.every(elem => "object" === typeof elem && null !== elem && _io7(elem))) && (null === input.refusal || Array.isArray(input.refusal) && input.refusal.every(elem => "object" === typeof elem && null !== elem && _io7(elem))); const _io7 = input => "string" === typeof input.token && (null === input.bytes || Array.isArray(input.bytes) && input.bytes.every(elem => "number" === typeof elem)) && "number" === typeof input.logprob && (Array.isArray(input.top_logprobs) && input.top_logprobs.every(elem => "object" === typeof elem && null !== elem && _io8(elem))); const _io8 = input => "string" === typeof input.token && (null === input.bytes || Array.isArray(input.bytes) && input.bytes.every(elem => "number" === typeof elem)) && "number" === typeof input.logprob; const _io9 = input => "number" === typeof input.completion_tokens && "number" === typeof input.prompt_tokens && "number" === typeof input.total_tokens && (undefined === input.completion_tokens_details || "object" === typeof input.completion_tokens_details && null !== input.completion_tokens_details && false === Array.isArray(input.completion_tokens_details) && _io10(input.completion_tokens_details)) && (undefined === input.prompt_tokens_details || "object" === typeof input.prompt_tokens_details && null !== input.prompt_tokens_details && false === Array.isArray(input.prompt_tokens_details) && _io11(input.prompt_tokens_details)); const _io10 = input => (undefined === input.accepted_prediction_tokens || "number" === typeof input.accepted_prediction_tokens) && (undefined === input.audio_tokens || "number" === typeof input.audio_tokens) && (undefined === input.reasoning_tokens || "number" === typeof input.reasoning_tokens) && (undefined === input.rejected_prediction_tokens || "number" === typeof input.rejected_prediction_tokens); const _io11 = input => (undefined === input.audio_tokens || "number" === typeof input.audio_tokens) && (undefined === input.cached_tokens || "number" === typeof input.cached_tokens); const _vo0 = (input, _path, _exceptionable = true) => ["string" === typeof input.id || _report(_exceptionable, {
+    const valid = (() => { const _io0 = input => "string" === typeof input.id && (Array.isArray(input.choices) && input.choices.every(elem => "object" === typeof elem && null !== elem && _io1(elem))) && "number" === typeof input.created && "string" === typeof input.model && "chat.completion.chunk" === input.object && (null === input.service_tier || undefined === input.service_tier || "scale" === input.service_tier || "default" === input.service_tier) && (undefined === input.system_fingerprint || "string" === typeof input.system_fingerprint) && (null === input.usage || undefined === input.usage || "object" === typeof input.usage && null !== input.usage && _io9(input.usage)); const _io1 = input => "object" === typeof input.delta && null !== input.delta && false === Array.isArray(input.delta) && _io2(input.delta) && (null === input.finish_reason || "length" === input.finish_reason || "function_call" === input.finish_reason || "stop" === input.finish_reason || "tool_calls" === input.finish_reason || "content_filter" === input.finish_reason) && "number" === typeof input.index && (null === input.logprobs || undefined === input.logprobs || "object" === typeof input.logprobs && null !== input.logprobs && _io6(input.logprobs)); const _io2 = input => (null === input.content || undefined === input.content || "string" === typeof input.content) && (undefined === input.function_call || "object" === typeof input.function_call && null !== input.function_call && false === Array.isArray(input.function_call) && _io3(input.function_call)) && (null === input.refusal || undefined === input.refusal || "string" === typeof input.refusal) && (undefined === input.role || "user" === input.role || "developer" === input.role || "system" === input.role || "assistant" === input.role || "tool" === input.role) && (undefined === input.tool_calls || Array.isArray(input.tool_calls) && input.tool_calls.every(elem => "object" === typeof elem && null !== elem && _io4(elem))); const _io3 = input => (undefined === input.arguments || "string" === typeof input.arguments) && (undefined === input.name || "string" === typeof input.name); const _io4 = input => "number" === typeof input.index && (undefined === input.id || "string" === typeof input.id) && (undefined === input["function"] || "object" === typeof input["function"] && null !== input["function"] && false === Array.isArray(input["function"]) && _io5(input["function"])) && (undefined === input.type || "function" === input.type); const _io5 = input => (undefined === input.arguments || "string" === typeof input.arguments) && (undefined === input.name || "string" === typeof input.name); const _io6 = input => (null === input.content || Array.isArray(input.content) && input.content.every(elem => "object" === typeof elem && null !== elem && _io7(elem))) && (null === input.refusal || Array.isArray(input.refusal) && input.refusal.every(elem => "object" === typeof elem && null !== elem && _io7(elem))); const _io7 = input => "string" === typeof input.token && (null === input.bytes || Array.isArray(input.bytes) && input.bytes.every(elem => "number" === typeof elem)) && "number" === typeof input.logprob && (Array.isArray(input.top_logprobs) && input.top_logprobs.every(elem => "object" === typeof elem && null !== elem && _io8(elem))); const _io8 = input => "string" === typeof input.token && (null === input.bytes || Array.isArray(input.bytes) && input.bytes.every(elem => "number" === typeof elem)) && "number" === typeof input.logprob; const _io9 = input => "number" === typeof input.completion_tokens && "number" === typeof input.prompt_tokens && "number" === typeof input.total_tokens && (undefined === input.completion_tokens_details || "object" === typeof input.completion_tokens_details && null !== input.completion_tokens_details && false === Array.isArray(input.completion_tokens_details) && _io10(input.completion_tokens_details)) && (undefined === input.prompt_tokens_details || "object" === typeof input.prompt_tokens_details && null !== input.prompt_tokens_details && false === Array.isArray(input.prompt_tokens_details) && _io11(input.prompt_tokens_details)); const _io10 = input => (undefined === input.accepted_prediction_tokens || "number" === typeof input.accepted_prediction_tokens) && (undefined === input.audio_tokens || "number" === typeof input.audio_tokens) && (undefined === input.reasoning_tokens || "number" === typeof input.reasoning_tokens) && (undefined === input.rejected_prediction_tokens || "number" === typeof input.rejected_prediction_tokens); const _io11 = input => (undefined === input.audio_tokens || "number" === typeof input.audio_tokens) && (undefined === input.cached_tokens || "number" === typeof input.cached_tokens); const _vo0 = (input, _path, _exceptionable = true) => ["string" === typeof input.id || _report(_exceptionable, {
             path: _path + ".id",
             expected: "string",
             value: input.id
@@ -132,7 +132,7 @@ function transformCompletionChunk(source) {
             path: _path + ".refusal",
             expected: "(null | string | undefined)",
             value: input.refusal
-        }), undefined === input.role || "assistant" === input.role || "user" === input.role || "developer" === input.role || "system" === input.role || "tool" === input.role || _report(_exceptionable, {
+        }), undefined === input.role || "user" === input.role || "developer" === input.role || "system" === input.role || "assistant" === input.role || "tool" === input.role || _report(_exceptionable, {
             path: _path + ".role",
             expected: "(\"assistant\" | \"developer\" | \"system\" | \"tool\" | \"user\" | undefined)",
             value: input.role

package/lib/utils/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * from ts-toolbelt repository
+ * https://github.com/millsp/ts-toolbelt/blob/master/sources/Test.ts
+ */
+type Equals<A1, A2> = (<A>() => A extends A2 ? 1 : 0) extends <A>() => A extends A1 ? 1 : 0 ? 1 : 0;
+type Boolean = 0 | 1;
+/**
+ * Test should pass
+ */
+export type Pass = 1;
+/**
+ * Test should fail
+ */
+export type Fail = 0;
+/**
+ * Check or test the validity of a type
+ * @param debug to debug with parameter hints (`ctrl+p`, `ctrl+shift+space`)
+ * @example
+ * ```ts
+ * // see in `tst` folder
+ * ```
+ */
+export declare function check<Type, Expect, Outcome extends Boolean>(debug?: Type): Equals<Equals<Type, Expect>, Outcome>;
+/**
+ * Validates a batch of [[check]]
+ * @param _checks a batch of [[check]]
+ * @example
+ * ```ts
+ * // see in `tst` folder
+ * ```
+ */
+export declare function checks(_checks: 1[]): void;
+export {};

package/lib/utils/types.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.check = check;
+exports.checks = checks;
+/**
+ * Check or test the validity of a type
+ * @param debug to debug with parameter hints (`ctrl+p`, `ctrl+shift+space`)
+ * @example
+ * ```ts
+ * // see in `tst` folder
+ * ```
+ */
+function check(debug) {
+    if (debug !== undefined) {
+        // eslint-disable-next-line no-console
+        console.log(debug);
+    }
+    return 1;
+}
+/**
+ * Validates a batch of [[check]]
+ * @param _checks a batch of [[check]]
+ * @example
+ * ```ts
+ * // see in `tst` folder
+ * ```
+ */
+function checks(_checks) { }
+//# sourceMappingURL=types.js.map

package/lib/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":";;AA8BA,sBASC;AAUD,wBAA8C;AA3B9C;;;;;;;GAOG;AACH,SAAgB,KAAK,CACnB,KAAY;IAEZ,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,CAA0C,CAAC;AACpD,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,MAAM,CAAC,OAAY,IAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentica/core",
-  "version": "0.24.0",
+  "version": "0.26.0",
   "description": "Agentic AI Library specialized in LLM Function Calling",
   "author": "Wrtn Technologies",
   "license": "MIT",
@@ -36,14 +36,13 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@modelcontextprotocol/sdk": "^1.9.0",
-    "@samchon/openapi": "^4.2.0",
+    "@samchon/openapi": "^4.3.0",
     "openai": "^4.80.0",
-    "typia": "^9.0.1"
+    "typia": "^9.3.0"
   },
   "dependencies": {
-    "@samchon/openapi": "^4.2.0",
-    "typia": "^9.0.1",
+    "@samchon/openapi": "^4.3.0",
+    "typia": "^9.3.0",
     "uuid": "^11.0.4"
   },
   "devDependencies": {
@@ -51,9 +50,10 @@
     "@nestia/e2e": "^6.0.1",
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^12.1.2",
-    "@ryoppippi/unplugin-typia": "^2.2.1",
+    "@ryoppippi/unplugin-typia": "^2.6.2",
     "@types/node": "^22.13.4",
     "@types/uuid": "^10.0.0",
+    "@wrtnlabs/calculator-mcp": "^0.2.1",
     "openai": "^4.80.0",
     "rimraf": "^6.0.1",
     "rollup": "^4.34.8",

package/src/Agentica.ts

@@ -6,8 +6,9 @@ import type { AgenticaOperationCollection } from "./context/AgenticaOperationCol
 import type { AgenticaOperationSelection } from "./context/AgenticaOperationSelection";
 import type { AgenticaEvent } from "./events/AgenticaEvent";
 import type { AgenticaRequestEvent } from "./events/AgenticaRequestEvent";
+import type { AgenticaUserMessageContent } from "./histories";
 import type { AgenticaHistory } from "./histories/AgenticaHistory";
-import type { AgenticaUserInputHistory } from "./histories/AgenticaUserInputHistory";
+import type { AgenticaUserMessageHistory } from "./histories/AgenticaUserMessageHistory";
 import type { IAgenticaConfig } from "./structures/IAgenticaConfig";
 import type { IAgenticaController } from "./structures/IAgenticaController";
 import type { IAgenticaProps } from "./structures/IAgenticaProps";
@@ -16,10 +17,10 @@ import type { IAgenticaVendor } from "./structures/IAgenticaVendor";
 import { AgenticaTokenUsage } from "./context/AgenticaTokenUsage";
 import { AgenticaOperationComposer } from "./context/internal/AgenticaOperationComposer";
 import { AgenticaTokenUsageAggregator } from "./context/internal/AgenticaTokenUsageAggregator";
-import { createUserInputHistory } from "./factory";
-import { createInitializeEvent, createRequestEvent, createUserInputEvent } from "./factory/events";
+import { createUserMessageHistory } from "./factory";
+import { createInitializeEvent, createRequestEvent, createUserMessageEvent } from "./factory/events";
 import { execute } from "./orchestrate/execute";
-import { AgenticaHistoryTransformer } from "./transformers/AgenticaHistoryTransformer";
+import { transformHistory } from "./transformers/transformHistory";
 import { __map_take } from "./utils/__map_take";
 import { ChatGptCompletionMessageUtil } from "./utils/ChatGptCompletionMessageUtil";
 import { streamDefaultReaderToAsyncGenerator, StreamUtil } from "./utils/StreamUtil";
@@ -86,7 +87,7 @@ export class Agentica<Model extends ILlmSchema.Model> {
     this.stack_ = [];
     this.listeners_ = new Map();
     this.histories_ = (props.histories ?? []).map(input =>
-      AgenticaHistoryTransformer.transform({
+      transformHistory({
         operations: this.operations_.group,
         history: input,
       }),
@@ -130,12 +131,12 @@ export class Agentica<Model extends ILlmSchema.Model> {
    * @returns List of newly created chat prompts
    */
   public async conversate(
-    content: string | AgenticaUserInputHistory.Contents | Array<AgenticaUserInputHistory.Contents>,
+    content: string | AgenticaUserMessageContent | Array<AgenticaUserMessageContent>,
     options: {
       abortSignal?: AbortSignal;
     } = {},
   ): Promise<AgenticaHistory<Model>[]> {
-    const prompt: AgenticaUserInputHistory = createUserInputHistory({
+    const prompt: AgenticaUserMessageHistory = createUserMessageHistory({
       contents: Array.isArray(content)
         ? content
         : typeof content === "string"
@@ -147,7 +148,7 @@ export class Agentica<Model extends ILlmSchema.Model> {
     });
 
     this.dispatch(
-      createUserInputEvent({
+      createUserMessageEvent({
         contents: prompt.contents,
       }),
     ).catch(() => {});
@@ -226,7 +227,7 @@ export class Agentica<Model extends ILlmSchema.Model> {
    * @internal
    */
   public getContext(props: {
-    prompt: AgenticaUserInputHistory;
+    prompt: AgenticaUserMessageHistory;
     usage: AgenticaTokenUsage;
     abortSignal?: AbortSignal;
   }): AgenticaContext<Model> {

package/src/MicroAgentica.ts

@@ -5,8 +5,9 @@ import type { AgenticaOperationCollection } from "./context/AgenticaOperationCol
 import type { MicroAgenticaContext } from "./context/MicroAgenticaContext";
 import type { AgenticaRequestEvent } from "./events/AgenticaRequestEvent";
 import type { MicroAgenticaEvent } from "./events/MicroAgenticaEvent";
+import type { AgenticaUserMessageContent } from "./histories";
 import type { AgenticaExecuteHistory } from "./histories/AgenticaExecuteHistory";
-import type { AgenticaUserInputHistory } from "./histories/AgenticaUserInputHistory";
+import type { AgenticaUserMessageHistory } from "./histories/AgenticaUserMessageHistory";
 import type { MicroAgenticaHistory } from "./histories/MicroAgenticaHistory";
 import type { IAgenticaController } from "./structures/IAgenticaController";
 import type { IAgenticaVendor } from "./structures/IAgenticaVendor";
@@ -16,10 +17,10 @@ import type { IMicroAgenticaProps } from "./structures/IMicroAgenticaProps";
 import { AgenticaTokenUsage } from "./context/AgenticaTokenUsage";
 import { AgenticaOperationComposer } from "./context/internal/AgenticaOperationComposer";
 import { AgenticaTokenUsageAggregator } from "./context/internal/AgenticaTokenUsageAggregator";
-import { createUserInputHistory } from "./factory";
-import { createRequestEvent, createUserInputEvent } from "./factory/events";
+import { createUserMessageHistory } from "./factory";
+import { createRequestEvent, createUserMessageEvent } from "./factory/events";
 import { call, describe } from "./orchestrate";
-import { AgenticaHistoryTransformer } from "./transformers/AgenticaHistoryTransformer";
+import { transformHistory } from "./transformers/transformHistory";
 import { __map_take } from "./utils/__map_take";
 import { ChatGptCompletionMessageUtil } from "./utils/ChatGptCompletionMessageUtil";
 import { streamDefaultReaderToAsyncGenerator, StreamUtil } from "./utils/StreamUtil";
@@ -74,7 +75,7 @@ export class MicroAgentica<Model extends ILlmSchema.Model> {
       config: props.config,
     });
     this.histories_ = (props.histories ?? []).map(input =>
-      AgenticaHistoryTransformer.transform({
+      transformHistory({
         operations: this.operations_.group,
         history: input,
       }),
@@ -108,8 +109,10 @@ export class MicroAgentica<Model extends ILlmSchema.Model> {
    * @param content The content to talk
    * @returns List of newly created histories
    */
-  public async conversate(content: string | AgenticaUserInputHistory.Contents | Array<AgenticaUserInputHistory.Contents>): Promise<MicroAgenticaHistory<Model>[]> {
-    const talk = createUserInputHistory({
+  public async conversate(
+    content: string | AgenticaUserMessageContent | Array<AgenticaUserMessageContent>,
+  ): Promise<MicroAgenticaHistory<Model>[]> {
+    const talk = createUserMessageHistory({
       contents: Array.isArray(content)
         ? content
         : typeof content === "string"
@@ -120,7 +123,7 @@ export class MicroAgentica<Model extends ILlmSchema.Model> {
           : [content],
     });
     this.dispatch(
-      createUserInputEvent({
+      createUserMessageEvent({
         contents: talk.contents,
       }),
     ).catch(() => {});
@@ -207,7 +210,7 @@ export class MicroAgentica<Model extends ILlmSchema.Model> {
    * @internal
    */
   public getContext(props: {
-    prompt: AgenticaUserInputHistory;
+    prompt: AgenticaUserMessageHistory;
     usage: AgenticaTokenUsage;
   }): MicroAgenticaContext<Model> {
     const dispatch = this.dispatch.bind(this);

package/src/context/AgenticaContext.ts

@@ -4,7 +4,7 @@ import type OpenAI from "openai";
 import type { AgenticaEvent } from "../events/AgenticaEvent";
 import type { AgenticaEventSource } from "../events/AgenticaEventSource";
 import type { AgenticaHistory } from "../histories/AgenticaHistory";
-import type { AgenticaUserInputHistory } from "../histories/AgenticaUserInputHistory";
+import type { AgenticaUserMessageHistory } from "../histories/AgenticaUserMessageHistory";
 import type { IAgenticaConfig } from "../structures/IAgenticaConfig";
 
 import type { AgenticaOperationCollection } from "./AgenticaOperationCollection";
@@ -85,7 +85,7 @@ export interface AgenticaContext<Model extends ILlmSchema.Model> {
    * The user input history written by the user through the
    * {@link Agentica.conversate} function.
    */
-  prompt: AgenticaUserInputHistory;
+  prompt: AgenticaUserMessageHistory;
 
   /**
    * Abort signal.

package/src/context/MicroAgenticaContext.ts

@@ -2,7 +2,7 @@ import type { ILlmSchema } from "@samchon/openapi";
 import type OpenAI from "openai";
 
 import type { MicroAgenticaEvent } from "../events/MicroAgenticaEvent";
-import type { AgenticaUserInputHistory } from "../histories/AgenticaUserInputHistory";
+import type { AgenticaUserMessageHistory } from "../histories/AgenticaUserMessageHistory";
 import type { MicroAgenticaHistory } from "../histories/MicroAgenticaHistory";
 import type { IMicroAgenticaConfig } from "../structures/IMicroAgenticaConfig";
 
@@ -66,7 +66,7 @@ export interface MicroAgenticaContext<Model extends ILlmSchema.Model> {
    * Text conversation written the by user through the
    * {@link Agentica.conversate} function.
    */
-  prompt: AgenticaUserInputHistory;
+  prompt: AgenticaUserMessageHistory;
 
   // ----
   // HANDLERS

package/src/context/index.ts

@@ -0,0 +1,5 @@
+export * from "./AgenticaContext";
+export * from "./AgenticaOperation";
+export * from "./AgenticaOperationCollection";
+export * from "./AgenticaOperationSelection";
+export * from "./AgenticaTokenUsage";

package/src/context/internal/AgenticaOperationComposer.spec.ts

@@ -1,7 +1,8 @@
 import type { IChatGptSchema, IHttpLlmFunction, ILlmFunction, IMcpLlmFunction, IValidation } from "@samchon/openapi";
 
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory";
+import { createServer } from "@wrtnlabs/calculator-mcp";
 
 import type { IAgenticaConfig } from "../../structures/IAgenticaConfig";
 import type { IAgenticaController } from "../../structures/IAgenticaController";
@@ -86,10 +87,19 @@ async function createMockMcpController(name: string, functions: IMcpLlmFunction<
 
 describe("a AgenticaOperationComposer", () => {
   beforeAll(async () => {
-    await client.connect(new StdioClientTransport({
-      command: "npx",
-      args: ["-y", "@wrtnlabs/calculator-mcp"],
-    }));
+    // eslint-disable-next-line ts/no-unsafe-call
+    const server = await createServer({
+      name: "calculator",
+      version: "1.0.0",
+    });
+
+    const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+
+    await Promise.all([
+      client.connect(clientTransport),
+      // eslint-disable-next-line ts/no-unsafe-call
+      server.connect(serverTransport),
+    ]);
   });
   describe("compose", () => {
     it("should compose operations from controllers", async () => {

package/src/events/AgenticaAssistantMessageEvent.ts

@@ -0,0 +1,12 @@
+import type { AgenticaAssistantMessageHistory } from "../histories/AgenticaAssistantMessageHistory";
+import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+
+export interface AgenticaAssistantMessageEvent
+  extends AgenticaEventBase<"assistantMessage"> {
+  stream: AsyncGenerator<string, undefined, undefined>;
+  join: () => Promise<string>;
+  toJSON: () => IAgenticaEventJson.IAssistantMessage;
+  toHistory: () => AgenticaAssistantMessageHistory;
+}

package/src/events/AgenticaEvent.ts

@@ -1,5 +1,6 @@
 import type { ILlmSchema } from "@samchon/openapi";
 
+import type { AgenticaAssistantMessageEvent } from "./AgenticaAssistantMessageEvent";
 import type { AgenticaCallEvent } from "./AgenticaCallEvent";
 import type { AgenticaCancelEvent } from "./AgenticaCancelEvent";
 import type { AgenticaDescribeEvent } from "./AgenticaDescribeEvent";
@@ -8,8 +9,7 @@ import type { AgenticaInitializeEvent } from "./AgenticaInitializeEvent";
 import type { AgenticaRequestEvent } from "./AgenticaRequestEvent";
 import type { AgenticaResponseEvent } from "./AgenticaResponseEvent";
 import type { AgenticaSelectEvent } from "./AgenticaSelectEvent";
-import type { AgenticaTextEvent } from "./AgenticaTextEvent";
-import type { AgenticaUserInputEvent } from "./AgenticaUserInputEvent";
+import type { AgenticaUserMessageEvent } from "./AgenticaUserMessageEvent";
 import type { AgenticaValidateEvent } from "./AgenticaValidateEvent";
 
 /**
@@ -23,31 +23,31 @@ import type { AgenticaValidateEvent } from "./AgenticaValidateEvent";
  * @author Samchon
  */
 export type AgenticaEvent<Model extends ILlmSchema.Model> =
+  | AgenticaUserMessageEvent
+  | AgenticaAssistantMessageEvent
+  | AgenticaInitializeEvent
+  | AgenticaSelectEvent<Model>
   | AgenticaCallEvent<Model>
   | AgenticaCancelEvent<Model>
-  | AgenticaDescribeEvent<Model>
   | AgenticaExecuteEvent<Model>
-  | AgenticaInitializeEvent
-  | AgenticaRequestEvent
-  | AgenticaResponseEvent
-  | AgenticaSelectEvent<Model>
-  | AgenticaTextEvent
+  | AgenticaDescribeEvent<Model>
   | AgenticaValidateEvent<Model>
-  | AgenticaUserInputEvent;
+  | AgenticaRequestEvent
+  | AgenticaResponseEvent;
 export namespace AgenticaEvent {
   export type Type = AgenticaEvent<any>["type"];
   export interface Mapper<Model extends ILlmSchema.Model> {
+    userMessage: AgenticaUserMessageEvent;
+    assistantMessage: AgenticaAssistantMessageEvent;
+    select: AgenticaSelectEvent<Model>;
+    initialize: AgenticaInitializeEvent;
     call: AgenticaCallEvent<Model>;
     cancel: AgenticaCancelEvent<Model>;
-    describe: AgenticaDescribeEvent<Model>;
     execute: AgenticaExecuteEvent<Model>;
-    initialize: AgenticaInitializeEvent;
+    describe: AgenticaDescribeEvent<Model>;
+    validate: AgenticaValidateEvent<Model>;
     request: AgenticaRequestEvent;
     response: AgenticaResponseEvent;
-    select: AgenticaSelectEvent<Model>;
-    text: AgenticaTextEvent;
-    validate: AgenticaValidateEvent<Model>;
-    user_input: AgenticaUserInputEvent;
   }
   export type Source =
     | "initialize"

package/src/events/AgenticaEvent.type.ts

@@ -0,0 +1,19 @@
+import type { AgenticaHistory } from "../histories";
+import type { Pass } from "../utils/types";
+
+import { check, checks } from "../utils/types";
+
+import type { AgenticaEvent } from "./AgenticaEvent";
+
+checks([
+  check<
+    Exclude<AgenticaHistory.Type, "systemMessage"> extends AgenticaEvent.Type ? true : false,
+    true,
+    Pass
+  >(),
+  check<
+    Exclude<AgenticaHistory.Type, "systemMessage"> extends keyof AgenticaEvent.Mapper<any> ? true : false,
+    true,
+    Pass
+  >(),
+]);

package/src/events/AgenticaUserMessageEvent.ts

@@ -0,0 +1,12 @@
+import type { AgenticaUserMessageContent } from "../histories";
+import type { AgenticaUserMessageHistory } from "../histories/AgenticaUserMessageHistory";
+import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+
+export interface AgenticaUserMessageEvent
+  extends AgenticaEventBase<"userMessage"> {
+  contents: Array<AgenticaUserMessageContent>;
+  toJSON: () => IAgenticaEventJson.IUserMessage;
+  toHistory: () => AgenticaUserMessageHistory;
+}

package/src/events/MicroAgenticaEvent.ts

@@ -1,12 +1,12 @@
 import type { ILlmSchema } from "@samchon/openapi";
 
+import type { AgenticaAssistantMessageEvent } from "./AgenticaAssistantMessageEvent";
 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 { AgenticaUserInputEvent } from "./AgenticaUserInputEvent";
+import type { AgenticaUserMessageEvent } from "./AgenticaUserMessageEvent";
 import type { AgenticaValidateEvent } from "./AgenticaValidateEvent";
 
 /**
@@ -20,25 +20,25 @@ import type { AgenticaValidateEvent } from "./AgenticaValidateEvent";
  * @author Samchon
  */
 export type MicroAgenticaEvent<Model extends ILlmSchema.Model> =
+  | AgenticaUserMessageEvent
+  | AgenticaAssistantMessageEvent
   | AgenticaCallEvent<Model>
-  | AgenticaDescribeEvent<Model>
   | AgenticaExecuteEvent<Model>
+  | AgenticaDescribeEvent<Model>
   | AgenticaRequestEvent
   | AgenticaResponseEvent
-  | AgenticaTextEvent
-  | AgenticaValidateEvent<Model>
-  | AgenticaUserInputEvent;
+  | AgenticaValidateEvent<Model>;
 export namespace MicroAgenticaEvent {
   export type Type = MicroAgenticaEvent<any>["type"];
   export interface Mapper<Model extends ILlmSchema.Model> {
+    userMessage: AgenticaUserMessageEvent;
+    assistantMessage: AgenticaAssistantMessageEvent;
     call: AgenticaCallEvent<Model>;
-    describe: AgenticaDescribeEvent<Model>;
     execute: AgenticaExecuteEvent<Model>;
+    describe: AgenticaDescribeEvent<Model>;
     request: AgenticaRequestEvent;
     response: AgenticaResponseEvent;
-    text: AgenticaTextEvent;
     validate: AgenticaValidateEvent<Model>;
-    user_input: AgenticaUserInputEvent;
   }
   export type Source = "call" | "describe";
 }

package/src/events/index.ts

@@ -0,0 +1,14 @@
+export * from "./AgenticaAssistantMessageEvent";
+export * from "./AgenticaCallEvent";
+export * from "./AgenticaCancelEvent";
+export * from "./AgenticaDescribeEvent";
+export * from "./AgenticaEvent";
+export * from "./AgenticaEventSource";
+export * from "./AgenticaExecuteEvent";
+export * from "./AgenticaInitializeEvent";
+export * from "./AgenticaRequestEvent";
+export * from "./AgenticaResponseEvent";
+export * from "./AgenticaSelectEvent";
+export * from "./AgenticaUserMessageEvent";
+export * from "./AgenticaValidateEvent";
+export * from "./MicroAgenticaEvent";