@agentica/core 0.27.2 → 0.28.0

package/lib/structures/IAgenticaController.d.ts

@@ -1,4 +1,14 @@
-import type { IHttpConnection, IHttpLlmApplication, IHttpLlmFunction, IHttpResponse, ILlmApplication, ILlmFunction, ILlmSchema, IMcpLlmApplication } from "@samchon/openapi";
+import type {
+  IHttpConnection,
+  IHttpLlmApplication,
+  IHttpLlmFunction,
+  IHttpResponse,
+  ILlmApplication,
+  ILlmFunction,
+  ILlmSchema,
+  IMcpLlmApplication,
+} from "@samchon/openapi";
+
 /**
  * Controller of the Agentica Agent.
  *
@@ -15,105 +25,130 @@ import type { IHttpConnection, IHttpLlmApplication, IHttpLlmFunction, IHttpRespo
  *
  * @author Samchon
  */
-export type IAgenticaController<Model extends ILlmSchema.Model> = IAgenticaController.IHttp<Model> | IAgenticaController.IClass<Model> | IAgenticaController.IMcp<Model>;
-export declare namespace IAgenticaController {
+export type IAgenticaController<Model extends ILlmSchema.Model> =
+  | IAgenticaController.IHttp<Model>
+  | IAgenticaController.IClass<Model>
+  | IAgenticaController.IMcp<Model>;
+
+export namespace IAgenticaController {
+  /**
+   * HTTP controller.
+   *
+   * You can make it by {@link validateHttpLlmApplication} function with
+   * the Swagger or OpenAPI document.
+   */
+  export interface IHttp<Model extends ILlmSchema.Model>
+    extends IBase<"http", IHttpLlmApplication<Model>> {
     /**
-     * HTTP controller.
+     * Connection to the server.
      *
-     * You can make it by {@link validateHttpLlmApplication} function with
-     * the Swagger or OpenAPI document.
+     * Connection to the API server including the URL and headers.
      */
-    export interface IHttp<Model extends ILlmSchema.Model> extends IBase<"http", IHttpLlmApplication<Model>> {
-        /**
-         * Connection to the server.
-         *
-         * Connection to the API server including the URL and headers.
-         */
-        connection: IHttpConnection;
-        /**
-         * Executor of the API function.
-         *
-         * @param props Properties of the API function call
-         * @returns HTTP response of the API function call
-         */
-        execute?: (props: {
-            /**
-             * Connection to the server.
-             */
-            connection: IHttpConnection;
-            /**
-             * Application schema.
-             */
-            application: IHttpLlmApplication<Model>;
-            /**
-             * Function schema.
-             */
-            function: IHttpLlmFunction<Model>;
-            /**
-             * Arguments of the function calling.
-             *
-             * It is an object of key-value pairs of the API function's parameters.
-             * The property keys are composed by below rules:
-             *
-             * - parameter names
-             * - query parameter as an object type if exists
-             * - body parameter if exists
-             */
-            arguments: object;
-        }) => Promise<IHttpResponse>;
-    }
+    connection: IHttpConnection;
+
     /**
-     * TypeScript class controller.
-     *
-     * You can make it by `typia.llm.application<App, Model>()` function.
+     * Executor of the API function.
      *
-     * - https://typia.io/docs/llm/application
+     * @param props Properties of the API function call
+     * @returns HTTP response of the API function call
      */
-    export interface IClass<Model extends ILlmSchema.Model> extends IBase<"class", ILlmApplication<Model>> {
-        /**
-         * Executor of the class function.
-         *
-         * Executor of the class function, by target class instance
-         * or callback function with given schema and arguments
-         * information.
-         */
-        execute: object | ((props: {
-            /**
-             * Target application schema.
-             */
-            application: ILlmApplication<Model>;
-            /**
-             * Target function schema.
-             */
-            function: ILlmFunction<Model>;
-            /**
-             * Arguments of the function calling.
-             */
-            arguments: object;
-        }) => Promise<unknown>);
-    }
+    execute?: (props: {
+      /**
+       * Connection to the server.
+       */
+      connection: IHttpConnection;
+
+      /**
+       * Application schema.
+       */
+      application: IHttpLlmApplication<Model>;
+
+      /**
+       * Function schema.
+       */
+      function: IHttpLlmFunction<Model>;
+
+      /**
+       * Arguments of the function calling.
+       *
+       * It is an object of key-value pairs of the API function's parameters.
+       * The property keys are composed by below rules:
+       *
+       * - parameter names
+       * - query parameter as an object type if exists
+       * - body parameter if exists
+       */
+      arguments: object;
+    }) => Promise<IHttpResponse>;
+  }
+
+  /**
+   * TypeScript class controller.
+   *
+   * You can make it by `typia.llm.application<App, Model>()` function.
+   *
+   * - https://typia.io/docs/llm/application
+   */
+  export interface IClass<Model extends ILlmSchema.Model>
+    extends IBase<"class", ILlmApplication<Model>> {
     /**
-     * MCP Server controller.
+     * Executor of the class function.
+     *
+     * Executor of the class function, by target class instance
+     * or callback function with given schema and arguments
+     * information.
      */
-    export interface IMcp<Model extends ILlmSchema.Model> extends IBase<"mcp", IMcpLlmApplication<Model>> {
-        /**
-         * MCP client for connection.
-         */
-        client: import("@modelcontextprotocol/sdk/client/index.d.ts").Client;
-    }
-    interface IBase<Protocol, Application> {
+    execute:
+      | object
+      | ((props: {
         /**
-         * Protocol discrminator.
+         * Target application schema.
          */
-        protocol: Protocol;
+        application: ILlmApplication<Model>;
+
         /**
-         * Name of the controller.
+         * Target function schema.
          */
-        name: string;
+        function: ILlmFunction<Model>;
+
         /**
-         * Application schema of function calling.
+         * Arguments of the function calling.
          */
-        application: Application;
-    }
-    export {};
+        arguments: object;
+      }) => Promise<unknown>);
+  }
+
+  /**
+   * MCP Server controller.
+   */
+  export interface IMcp<Model extends ILlmSchema.Model> extends IBase<"mcp", IMcpLlmApplication<Model>> {
+    /**
+     * MCP client for connection.
+     *
+     * @warning You have to install `@modelcontextprotocol/sdk` package
+     *          to use this type properly. If not, this type would work
+     *          as an `any` type, so that you can't validate it.
+     */
+    // @ts-ignore Type checking only when `@modelcontextprotocol/sdk` is installed.
+    //            This strategy is useful for someone who does not need MCP,
+    //            for someone who has not installed `@modelcontextprotocol/sdk`.
+    client: import("@modelcontextprotocol/sdk/client/index.d.ts").Client;
+  }
+
+  interface IBase<Protocol, Application> {
+    /**
+     * Protocol discrminator.
+     */
+    protocol: Protocol;
+
+    /**
+     * Name of the controller.
+     */
+    name: string;
+
+    /**
+     * Application schema of function calling.
+     */
+    application: Application;
+  }
 }

package/lib/structures/IAgenticaExecutor.d.ts

@@ -1,8 +1,7 @@
 import type { ILlmSchema } from "@samchon/openapi";
 import type { AgenticaContext } from "../context/AgenticaContext";
 import type { AgenticaOperation } from "../context/AgenticaOperation";
-import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
-import type { AgenticaHistory } from "../histories/AgenticaHistory";
+import type { AgenticaExecuteEvent } from "../events/AgenticaExecuteEvent";
 /**
  * Executor of the Agentic AI.
  *
@@ -56,7 +55,7 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
      * @returns List of prompts generated by the initializer
      * @default false
      */
-    initialize: boolean | null | ((ctx: AgenticaContext<Model>) => Promise<AgenticaHistory<Model>[]>);
+    initialize: boolean | null | ((ctx: AgenticaContext<Model>) => Promise<void>);
     /**
      * Function selector agent.
      *
@@ -84,7 +83,7 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
      * @param ctx Context of the agent
      * @returns List of prompts generated by the selector
      */
-    select: (ctx: AgenticaContext<Model>) => Promise<AgenticaHistory<Model>[]>;
+    select: (ctx: AgenticaContext<Model>) => Promise<void>;
     /**
      * Function caller agent.
      *
@@ -111,7 +110,7 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
      *          agent is the most general topic which can be universally
      *          applied to all domain fields.
      */
-    call: (ctx: AgenticaContext<Model>, operations: AgenticaOperation<Model>[]) => Promise<AgenticaHistory<Model>[]>;
+    call: (ctx: AgenticaContext<Model>, operations: AgenticaOperation<Model>[]) => Promise<AgenticaExecuteEvent<Model>[]>;
     /**
      * Describer agent of the function calling result.
      *
@@ -125,7 +124,7 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
      * @param executes List of function calling results
      * @returns List of prompts generated by the describer
      */
-    describe: boolean | null | ((ctx: AgenticaContext<Model>, executes: AgenticaExecuteHistory<Model>[]) => Promise<AgenticaHistory<Model>[]>);
+    describe: boolean | null | ((ctx: AgenticaContext<Model>, executes: AgenticaExecuteEvent<Model>[]) => Promise<void>);
     /**
      * Function canceler agent.
      *
@@ -148,5 +147,5 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
      * @param ctx Context of the agent
      * @returns List of prompts generated by the canceler
      */
-    cancel: (ctx: AgenticaContext<Model>) => Promise<AgenticaHistory<Model>[]>;
+    cancel: (ctx: AgenticaContext<Model>) => Promise<void>;
 }

package/lib/structures/IAgenticaVendor.d.ts

@@ -1,4 +1,5 @@
 import type OpenAI from "openai";
+import type { Semaphore } from "tstl";
 /**
  * LLM service vendor for Agentica Chat.
  *
@@ -33,4 +34,17 @@ export interface IAgenticaVendor {
      * Options for the request.
      */
     options?: OpenAI.RequestOptions | undefined;
+    /**
+     * Number of concurrent requests allowed.
+     *
+     * If you configure this property, {@link Agentica} will constrain the
+     * number of concurrent requests to the LLM vendor. If you want to
+     * share the semaphore instance with other agents, you can directly
+     * assign the {@link Semaphore} instance to this property.
+     *
+     * Otherwise, it will not limit the number of concurrent
+     * requests, and the {@link Agentica} will send requests
+     * asynchronously without any limit.
+     */
+    semaphore?: Semaphore | number | undefined;
 }

package/lib/structures/IMicroAgenticaExecutor.d.ts

@@ -1,7 +1,6 @@
 import type { ILlmSchema } from "@samchon/openapi";
 import type { MicroAgenticaContext } from "../context/MicroAgenticaContext";
 import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
-import type { MicroAgenticaHistory } from "../histories/MicroAgenticaHistory";
 /**
  * Executor of the Micro Agentic AI.
  *
@@ -42,7 +41,7 @@ export interface IMicroAgenticaExecutor<Model extends ILlmSchema.Model> {
      *          agent is the most general topic which can be universally
      *          applied to all domain fields.
      */
-    call: (ctx: MicroAgenticaContext<Model>) => Promise<MicroAgenticaHistory<Model>[]>;
+    call: (ctx: MicroAgenticaContext<Model>) => Promise<AgenticaExecuteHistory<Model>[]>;
     /**
      * Describer agent of the function calling result.
      *
@@ -56,5 +55,5 @@ export interface IMicroAgenticaExecutor<Model extends ILlmSchema.Model> {
      * @param executes List of function calling results
      * @returns List of prompts generated by the describer
      */
-    describe: boolean | null | ((ctx: MicroAgenticaContext<Model>, executes: AgenticaExecuteHistory<Model>[]) => Promise<MicroAgenticaHistory<Model>[]>);
+    describe: boolean | null | ((ctx: MicroAgenticaContext<Model>, executes: AgenticaExecuteHistory<Model>[]) => Promise<void>);
 }

package/lib/transformers/transformHistory.js

@@ -62,30 +62,33 @@ function transformUserMessage(props) {
 function transformSelect(props) {
     return (0, histories_1.createSelectHistory)({
         id: props.history.id,
-        selections: props.history.selections.map(select => (0, operations_1.createOperationSelection)({
+        created_at: props.history.created_at,
+        selection: (0, operations_1.createOperationSelection)({
             operation: findOperation({
                 operations: props.operations,
-                input: select.operation,
+                input: props.history.selection.operation,
             }),
-            reason: select.reason,
-        })),
+            reason: props.history.selection.reason,
+        }),
     });
 }
 function transformCancel(props) {
     return (0, histories_1.createCancelHistory)({
         id: props.history.id,
-        selections: props.history.selections.map(select => (0, operations_1.createOperationSelection)({
+        created_at: props.history.created_at,
+        selection: (0, operations_1.createOperationSelection)({
             operation: findOperation({
                 operations: props.operations,
-                input: select.operation,
+                input: props.history.selection.operation,
             }),
-            reason: select.reason,
-        })),
+            reason: props.history.selection.reason,
+        }),
     });
 }
 function transformExecute(props) {
     return (0, histories_1.createExecuteHistory)({
         id: props.history.id,
+        created_at: props.history.created_at,
         operation: findOperation({
             operations: props.operations,
             input: props.history.operation,
@@ -100,6 +103,8 @@ function transformExecute(props) {
 }
 function transformDescribe(props) {
     return (0, histories_1.createDescribeHistory)({
+        id: props.history.id,
+        created_at: props.history.created_at,
         text: props.history.text,
         executes: props.history.executes.map(next => transformExecute({
             operations: props.operations,

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/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 || "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, {
+    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 || "auto" === input.service_tier || "default" === input.service_tier || "flex" === 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
@@ -76,9 +76,9 @@ function transformCompletionChunk(source) {
             path: _path + ".object",
             expected: "\"chat.completion.chunk\"",
             value: input.object
-        }), null === input.service_tier || undefined === input.service_tier || "scale" === input.service_tier || "default" === input.service_tier || _report(_exceptionable, {
+        }), null === input.service_tier || undefined === input.service_tier || "auto" === input.service_tier || "default" === input.service_tier || "flex" === input.service_tier || _report(_exceptionable, {
             path: _path + ".service_tier",
-            expected: "(\"default\" | \"scale\" | null | undefined)",
+            expected: "(\"auto\" | \"default\" | \"flex\" | null | undefined)",
             value: input.service_tier
         }), undefined === input.system_fingerprint || "string" === typeof input.system_fingerprint || _report(_exceptionable, {
             path: _path + ".system_fingerprint",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentica/core",
-  "version": "0.27.2",
+  "version": "0.28.0",
   "description": "Agentic AI Library specialized in LLM Function Calling",
   "author": "Wrtn Technologies",
   "license": "MIT",
@@ -36,35 +36,37 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@samchon/openapi": "^4.3.0",
-    "openai": "^4.80.0",
-    "typia": "^9.3.0"
+    "@samchon/openapi": "^4.3.3",
+    "openai": "^5.2.0",
+    "typia": "^9.3.1"
   },
   "dependencies": {
-    "@samchon/openapi": "^4.3.0",
-    "typia": "^9.3.0",
+    "@samchon/openapi": "^4.3.3",
+    "tstl": "^3.0.0",
+    "typia": "^9.3.1",
     "uuid": "^11.0.4"
   },
   "devDependencies": {
-    "@modelcontextprotocol/sdk": "^1.9.0",
+    "@modelcontextprotocol/sdk": "^1.12.0",
     "@nestia/e2e": "^6.0.1",
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^12.1.2",
-    "@ryoppippi/unplugin-typia": "^2.6.2",
-    "@types/node": "^22.13.4",
+    "@ryoppippi/unplugin-typia": "^2.6.4",
+    "@types/node": "^22.13.9",
     "@types/uuid": "^10.0.0",
     "@wrtnlabs/calculator-mcp": "^0.2.1",
-    "openai": "^4.80.0",
+    "openai": "^5.2.0",
     "rimraf": "^6.0.1",
     "rollup": "^4.34.8",
     "ts-node": "^10.9.2",
     "ts-patch": "^3.3.0",
+    "tstl": "^3.0.0",
     "typedoc": "^0.27.7",
     "typescript": "~5.8.3",
     "vitest": "^3.0.9"
   },
   "scripts": {
-    "build": "rimraf lib && pnpm build:prompt && tsc && rollup -c",
+    "build": "rimraf lib && pnpm build:prompt && tsc && rollup -c && node build/post.js",
     "build:prompt": "node build/prompt.js",
     "dev": "rimraf lib && tsc --watch",
     "lint": "eslint .",