@agentica/core 0.25.0 → 0.26.0

package/lib/json/IAgenticaHistoryJson.d.ts

@@ -17,21 +17,22 @@ import type { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelect
  *
  * @author Samchon
  */
-export type IAgenticaHistoryJson = IAgenticaHistoryJson.IUserMessage | IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISelect | IAgenticaHistoryJson.ICancel | IAgenticaHistoryJson.IExecute | IAgenticaHistoryJson.IDescribe;
+export type IAgenticaHistoryJson = IAgenticaHistoryJson.ISelect | IAgenticaHistoryJson.ICancel | IAgenticaHistoryJson.IExecute | IAgenticaHistoryJson.IDescribe | IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage | IAgenticaHistoryJson.IUserMessage;
 export declare namespace IAgenticaHistoryJson {
     export type Type = IAgenticaHistoryJson["type"];
     export interface Mapper {
-        userMessage: IUserMessage;
-        assistantMessage: IAssistantMessage;
         select: ISelect;
         cancel: ICancel;
         execute: IExecute;
         describe: IDescribe;
+        assistantMessage: IAssistantMessage;
+        systemMessage: ISystemMessage;
+        userMessage: IUserMessage;
     }
     /**
-     * User prompt.
+     * User message.
      *
-     * User prompt about the user's input.
+     * User message about the user's input.
      */
     export interface IUserMessage extends IBase<"userMessage"> {
         /**
@@ -40,7 +41,16 @@ export declare namespace IAgenticaHistoryJson {
         contents: Array<AgenticaUserMessageContent>;
     }
     /**
-     * Assistant prompt.
+     * System message.
+     */
+    export interface ISystemMessage extends IBase<"systemMessage"> {
+        /**
+         * The text content.
+         */
+        text: string;
+    }
+    /**
+     * Assistant message.
      */
     export interface IAssistantMessage extends IBase<"assistantMessage"> {
         /**

package/lib/json/IAgenticaHistoryJson.type.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/json/IAgenticaHistoryJson.type.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const types_1 = require("../utils/types");
+(0, types_1.checks)([
+    (0, types_1.check)(),
+    (0, types_1.check)(),
+]);
+//# sourceMappingURL=IAgenticaHistoryJson.type.js.map

package/lib/json/IAgenticaHistoryJson.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAgenticaHistoryJson.type.js","sourceRoot":"","sources":["../../src/json/IAgenticaHistoryJson.type.ts"],"names":[],"mappings":";;AAGA,0CAA+C;AAI/C,IAAA,cAAM,EAAC;IACL,IAAA,aAAK,GAIF;IACH,IAAA,aAAK,GAIF;CACJ,CAAC,CAAC"}

package/lib/transformers/transformHistory.js

@@ -19,6 +19,12 @@ function transformHistory(props) {
             history: props.history,
         });
     }
+    // SYSTEM
+    else if (props.history.type === "systemMessage") {
+        return transformSystemMessage({
+            history: props.history,
+        });
+    }
     // SELECT & CANCEL
     else if (props.history.type === "select") {
         return transformSelect({
@@ -47,6 +53,9 @@ function transformHistory(props) {
 function transformAssistantMessage(props) {
     return (0, histories_1.createAssistantMessageHistory)(props.history);
 }
+function transformSystemMessage(props) {
+    return (0, histories_1.createSystemMessageHistory)(props.history);
+}
 function transformUserMessage(props) {
     return (0, histories_1.createUserMessageHistory)(props.history);
 }

package/lib/transformers/transformHistory.js.map

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

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.25.0",
+  "version": "0.26.0",
   "description": "Agentic AI Library specialized in LLM Function Calling",
   "author": "Wrtn Technologies",
   "license": "MIT",
@@ -50,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/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/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/factory/histories.ts

@@ -10,6 +10,7 @@ import type { AgenticaDescribeHistory } from "../histories/AgenticaDescribeHisto
 import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
 import type { AgenticaHistory } from "../histories/AgenticaHistory";
 import type { AgenticaSelectHistory } from "../histories/AgenticaSelectHistory";
+import type { AgenticaSystemMessageHistory } from "../histories/AgenticaSystemMessageHistory";
 import type { AgenticaUserMessageHistory } from "../histories/AgenticaUserMessageHistory";
 import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
 
@@ -91,7 +92,8 @@ export function decodeHistory<Model extends ILlmSchema.Model>(history: AgenticaH
       },
     ];
   }
-  else if (history.type === "assistantMessage") {
+
+  if (history.type === "assistantMessage") {
     return [
       {
         role: "assistant",
@@ -99,18 +101,38 @@ export function decodeHistory<Model extends ILlmSchema.Model>(history: AgenticaH
       },
     ];
   }
-  return [
-    {
-      role: "user",
-      content: history.contents.map(decodeUserMessageContent),
-    },
-  ];
+
+  if (history.type === "systemMessage") {
+    return [
+      {
+        role: "system",
+        content: history.text,
+      },
+    ];
+  }
+
+  if (history.type === "userMessage") {
+    const contents = history.contents;
+    return [
+      {
+        role: "user",
+        content: contents.map(decodeUserMessageContent),
+      },
+    ];
+  }
+
+  history satisfies never;
+  throw new Error(`Unsupported history type, value: ${JSON.stringify(history)}`);
 }
 
 /**
  * @internal
  */
 export function decodeUserMessageContent(content: AgenticaUserMessageContent): OpenAI.ChatCompletionContentPart {
+  if (content.type === "text") {
+    return content;
+  }
+
   if (content.type === "audio") {
     return {
       type: "input_audio",
@@ -120,7 +142,8 @@ export function decodeUserMessageContent(content: AgenticaUserMessageContent): O
       },
     };
   }
-  else if (content.type === "file") {
+
+  if (content.type === "file") {
     return {
       type: "file",
       file: content.file.type === "data"
@@ -133,7 +156,8 @@ export function decodeUserMessageContent(content: AgenticaUserMessageContent): O
           },
     };
   }
-  else if (content.type === "image") {
+
+  if (content.type === "image") {
     return {
       type: "image_url",
       image_url: {
@@ -142,7 +166,9 @@ export function decodeUserMessageContent(content: AgenticaUserMessageContent): O
       },
     };
   }
-  return content;
+
+  content satisfies never;
+  throw new Error(`Unsupported user message content type, value: ${JSON.stringify(content)}`);
 }
 
 /* -----------------------------------------------------------
@@ -183,6 +209,22 @@ export function createAssistantMessageHistory(props: {
   };
 }
 
+/**
+ * @internal
+ */
+export function createSystemMessageHistory(props: {
+  text: string;
+}): AgenticaSystemMessageHistory {
+  const prompt: IAgenticaHistoryJson.ISystemMessage = {
+    type: "systemMessage",
+    text: props.text,
+  };
+  return {
+    ...prompt,
+    toJSON: () => prompt,
+  };
+}
+
 /**
  * @internal
  */

package/src/histories/AgenticaHistory.ts

@@ -5,6 +5,7 @@ import type { AgenticaCancelHistory } from "./AgenticaCancelHistory";
 import type { AgenticaDescribeHistory } from "./AgenticaDescribeHistory";
 import type { AgenticaExecuteHistory } from "./AgenticaExecuteHistory";
 import type { AgenticaSelectHistory } from "./AgenticaSelectHistory";
+import type { AgenticaSystemMessageHistory } from "./AgenticaSystemMessageHistory";
 import type { AgenticaUserMessageHistory } from "./AgenticaUserMessageHistory";
 
 export type AgenticaHistory<Model extends ILlmSchema.Model> =
@@ -13,15 +14,17 @@ export type AgenticaHistory<Model extends ILlmSchema.Model> =
   | AgenticaExecuteHistory<Model>
   | AgenticaSelectHistory<Model>
   | AgenticaAssistantMessageHistory
-  | AgenticaUserMessageHistory;
+  | AgenticaUserMessageHistory
+  | AgenticaSystemMessageHistory;
 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>;
     execute: AgenticaExecuteHistory<Model>;
     describe: AgenticaDescribeHistory<Model>;
+    assistantMessage: AgenticaAssistantMessageHistory;
+    systemMessage: AgenticaSystemMessageHistory;
+    userMessage: AgenticaUserMessageHistory;
   }
 }

package/src/histories/AgenticaSystemMessageHistory.ts

@@ -0,0 +1,10 @@
+import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
+
+import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
+
+export interface AgenticaSystemMessageHistory extends AgenticaHistoryBase<
+  "systemMessage",
+  IAgenticaHistoryJson.ISystemMessage
+> {
+  text: string;
+}

package/src/histories/index.ts

@@ -4,6 +4,7 @@ export * from "./AgenticaDescribeHistory";
 export * from "./AgenticaExecuteHistory";
 export * from "./AgenticaHistory";
 export * from "./AgenticaSelectHistory";
+export * from "./AgenticaSystemMessageHistory";
 export * from "./AgenticaUserMessageHistory";
 export * from "./contents";
 export * from "./MicroAgenticaHistory";

package/src/json/IAgenticaEventJson.ts

@@ -25,10 +25,12 @@ export type IAgenticaEventJson =
   | IAgenticaEventJson.IExecute
   | IAgenticaEventJson.IInitialize
   | IAgenticaEventJson.IRequest
+  | IAgenticaEventJson.IResponse
   | IAgenticaEventJson.ISelect
   | IAgenticaEventJson.IValidate
   | IAgenticaEventJson.IAssistantMessage
   | IAgenticaEventJson.IUserMessage;
+
 export namespace IAgenticaEventJson {
   export type Type = IAgenticaEventJson["type"];
   export interface Mapper {
@@ -41,6 +43,8 @@ export namespace IAgenticaEventJson {
     execute: IExecute;
     describe: IDescribe;
     request: IRequest;
+    response: IResponse;
+    validate: IValidate;
   }
 
   /**
@@ -189,6 +193,26 @@ export namespace IAgenticaEventJson {
     options?: OpenAI.RequestOptions | undefined;
   }
 
+  /**
+   * Response event of LLM vendor API.
+   */
+  export interface IResponse extends IBase<"response"> {
+    /**
+     * The source agent of the response.
+     */
+    source: AgenticaEventSource;
+
+    /**
+     * Response body.
+     */
+    body: OpenAI.ChatCompletion;
+
+    /**
+     * Options for the request.
+     */
+    options?: OpenAI.RequestOptions | undefined;
+  }
+
   interface IBase<Type extends string> {
     /**
      * Discriminator type.

package/src/json/IAgenticaEventJson.type.ts

@@ -0,0 +1,19 @@
+import type { AgenticaEvent } from "../events";
+import type { Pass } from "../utils/types";
+
+import { check, checks } from "../utils/types";
+
+import type { IAgenticaEventJson } from "./IAgenticaEventJson";
+
+checks([
+  check<
+    AgenticaEvent.Type,
+    IAgenticaEventJson.Type,
+    Pass
+  >(),
+  check<
+    AgenticaEvent.Type,
+    keyof IAgenticaEventJson.Mapper,
+    Pass
+  >(),
+]);

package/src/json/IAgenticaHistoryJson.ts

@@ -20,27 +20,29 @@ import type { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelect
  * @author Samchon
  */
 export type IAgenticaHistoryJson =
-  | IAgenticaHistoryJson.IUserMessage
-  | IAgenticaHistoryJson.IAssistantMessage
   | IAgenticaHistoryJson.ISelect
   | IAgenticaHistoryJson.ICancel
   | IAgenticaHistoryJson.IExecute
-  | IAgenticaHistoryJson.IDescribe;
+  | IAgenticaHistoryJson.IDescribe
+  | IAgenticaHistoryJson.IAssistantMessage
+  | IAgenticaHistoryJson.ISystemMessage
+  | IAgenticaHistoryJson.IUserMessage;
 export namespace IAgenticaHistoryJson {
   export type Type = IAgenticaHistoryJson["type"];
   export interface Mapper {
-    userMessage: IUserMessage;
-    assistantMessage: IAssistantMessage;
     select: ISelect;
     cancel: ICancel;
     execute: IExecute;
     describe: IDescribe;
+    assistantMessage: IAssistantMessage;
+    systemMessage: ISystemMessage;
+    userMessage: IUserMessage;
   }
 
   /**
-   * User prompt.
+   * User message.
    *
-   * User prompt about the user's input.
+   * User message about the user's input.
    */
   export interface IUserMessage extends IBase<"userMessage"> {
     /**
@@ -50,7 +52,17 @@ export namespace IAgenticaHistoryJson {
   }
 
   /**
-   * Assistant prompt.
+   * System message.
+   */
+  export interface ISystemMessage extends IBase<"systemMessage"> {
+    /**
+     * The text content.
+     */
+    text: string;
+  }
+
+  /**
+   * Assistant message.
    */
   export interface IAssistantMessage extends IBase<"assistantMessage"> {
     /**

package/src/json/IAgenticaHistoryJson.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 { IAgenticaHistoryJson } from "./IAgenticaHistoryJson";
+
+checks([
+  check<
+    AgenticaHistory.Type,
+    IAgenticaHistoryJson.Type,
+    Pass
+  >(),
+  check<
+    AgenticaHistory.Type,
+    keyof IAgenticaHistoryJson.Mapper,
+    Pass
+  >(),
+]);

package/src/transformers/transformHistory.ts

@@ -8,9 +8,10 @@ import type { AgenticaDescribeHistory } from "../histories/AgenticaDescribeHisto
 import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
 import type { AgenticaHistory } from "../histories/AgenticaHistory";
 import type { AgenticaSelectHistory } from "../histories/AgenticaSelectHistory";
+import type { AgenticaSystemMessageHistory } from "../histories/AgenticaSystemMessageHistory";
 import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
 
-import { createAssistantMessageHistory, createCancelHistory, createDescribeHistory, createExecuteHistory, createSelectHistory, createUserMessageHistory } from "../factory/histories";
+import { createAssistantMessageHistory, createCancelHistory, createDescribeHistory, createExecuteHistory, createSelectHistory, createSystemMessageHistory, createUserMessageHistory } from "../factory/histories";
 import { createOperationSelection } from "../factory/operations";
 
 /**
@@ -32,6 +33,12 @@ export function transformHistory<Model extends ILlmSchema.Model>(props: {
       history: props.history,
     });
   }
+  // SYSTEM
+  else if (props.history.type === "systemMessage") {
+    return transformSystemMessage({
+      history: props.history,
+    });
+  }
   // SELECT & CANCEL
   else if (props.history.type === "select") {
     return transformSelect({
@@ -64,6 +71,12 @@ function transformAssistantMessage(props: {
   return createAssistantMessageHistory(props.history);
 }
 
+function transformSystemMessage(props: {
+  history: IAgenticaHistoryJson.ISystemMessage;
+}): AgenticaSystemMessageHistory {
+  return createSystemMessageHistory(props.history);
+}
+
 function transformUserMessage(props: {
   history: IAgenticaHistoryJson.IUserMessage;
 }): AgenticaUserMessageHistory {

package/src/utils/types.ts

@@ -0,0 +1,50 @@
+/**
+ * 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 function check<Type, Expect, Outcome extends Boolean>(
+  debug?: Type,
+): Equals<Equals<Type, Expect>, Outcome> {
+  if (debug !== undefined) {
+    // eslint-disable-next-line no-console
+    console.log(debug);
+  }
+
+  return 1 as Equals<Equals<Type, Expect>, Outcome>;
+}
+
+/**
+ * Validates a batch of [[check]]
+ * @param _checks a batch of [[check]]
+ * @example
+ * ```ts
+ * // see in `tst` folder
+ * ```
+ */
+export function checks(_checks: 1[]): void { }