@agentica/core 0.43.3 → 0.44.0-dev.20260313

package/src/functional/validateHttpController.ts

@@ -1,110 +1,113 @@
-import type { IHttpConnection, IHttpLlmApplication, IHttpLlmFunction, IHttpResponse, IValidation, OpenApiV3, OpenApiV3_1, SwaggerV2 } from "@samchon/openapi";
-
-import { HttpLlm, OpenApi } from "@samchon/openapi";
-import typia from "typia";
-
-import type { IAgenticaController } from "../structures/IAgenticaController";
-
-/**
- * Create an HTTP controller with type validation.
- *
- * Create an {@link IAgenticaController.IHttp} instance which represents
- * the HTTP controller from the given Swagger/OpenAPI document and the
- * target LLM model with connection information.
- *
- * By the way, even though this `validateHttpController` function
- * supports every version of Swagger/OpenAPI specification, there can
- * be a type error in the given document. In that case, the function
- * will return {@link IValidation.IFailure} instance with detailed
- * type error tracing information.
- *
- * @param props Properties to create the HTTP controller instance
- * @returns Validation result of the HTTP controller composition
- * @author Samchon
- */
-export function validateHttpController(props: {
-  /**
-   * Name of the controller.
-   */
-  name: string;
-
-  /**
-   * Swagger/OpenAPI document.
-   */
-  document:
-    | SwaggerV2.IDocument
-    | OpenApiV3.IDocument
-    | OpenApiV3_1.IDocument
-    | OpenApi.IDocument
-    | unknown;
-
-  /**
-   * Connection to the server.
-   *
-   * Connection to the API server including the URL and headers.
-   */
-  connection: IHttpConnection;
-
-  /**
-   * Options for the LLM function calling schema composition.
-   */
-  config?: Partial<IHttpLlmApplication.IConfig>;
-
-  /**
-   * 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;
-
-    /**
-     * Function schema.
-     */
-    function: IHttpLlmFunction;
-
-    /**
-     * 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>;
-}): IValidation<IAgenticaController.IHttp> {
-  const inspect = typia.validate<
-    | SwaggerV2.IDocument
-    | OpenApiV3.IDocument
-    | OpenApiV3_1.IDocument
-    | OpenApi.IDocument
-  >(props.document);
-  if (inspect.success === false) {
-    return inspect;
-  }
-  return {
-    success: true,
-    data: {
-      protocol: "http",
-      name: props.name,
-      application: HttpLlm.application({
-        document: OpenApi.convert(inspect.data),
-        config: props.config,
-      }),
-      execute: props.execute,
-      connection: props.connection,
-    },
-  };
-}
+import type { IHttpConnection, IHttpLlmApplication, IHttpLlmFunction, IHttpResponse, OpenApiV3, OpenApiV3_1, OpenApiV3_2, SwaggerV2 } from "@typia/interface";
+import type { IValidation, OpenApi } from "typia";
+
+import { HttpLlm, OpenApiConverter } from "@typia/utils";
+import typia from "typia";
+
+import type { IAgenticaController } from "../structures/IAgenticaController";
+
+/**
+ * Create an HTTP controller with type validation.
+ *
+ * Create an {@link IAgenticaController.IHttp} instance which represents
+ * the HTTP controller from the given Swagger/OpenAPI document and the
+ * target LLM model with connection information.
+ *
+ * By the way, even though this `validateHttpController` function
+ * supports every version of Swagger/OpenAPI specification, there can
+ * be a type error in the given document. In that case, the function
+ * will return {@link IValidation.IFailure} instance with detailed
+ * type error tracing information.
+ *
+ * @param props Properties to create the HTTP controller instance
+ * @returns Validation result of the HTTP controller composition
+ * @author Samchon
+ */
+export function validateHttpController(props: {
+  /**
+   * Name of the controller.
+   */
+  name: string;
+
+  /**
+   * Swagger/OpenAPI document.
+   */
+  document:
+    | SwaggerV2.IDocument
+    | OpenApiV3.IDocument
+    | OpenApiV3_1.IDocument
+    | OpenApiV3_2.IDocument
+    | OpenApi.IDocument
+    | unknown;
+
+  /**
+   * Connection to the server.
+   *
+   * Connection to the API server including the URL and headers.
+   */
+  connection: IHttpConnection;
+
+  /**
+   * Options for the LLM function calling schema composition.
+   */
+  config?: Partial<IHttpLlmApplication.IConfig>;
+
+  /**
+   * 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;
+
+    /**
+     * Function schema.
+     */
+    function: IHttpLlmFunction;
+
+    /**
+     * 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>;
+}): IValidation<IAgenticaController.IHttp> {
+  const inspect = typia.validate<
+    | SwaggerV2.IDocument
+    | OpenApiV3.IDocument
+    | OpenApiV3_1.IDocument
+    | OpenApiV3_2.IDocument
+    | OpenApi.IDocument
+  >(props.document);
+  if (inspect.success === false) {
+    return inspect;
+  }
+  return {
+    success: true,
+    data: {
+      protocol: "http",
+      name: props.name,
+      application: HttpLlm.application({
+        document: OpenApiConverter.upgradeDocument(inspect.data),
+        config: props.config,
+      }),
+      execute: props.execute,
+      connection: props.connection,
+    },
+  };
+}

package/src/functional/validateHttpLlmApplication.ts

@@ -1,70 +1,65 @@
-import type {
-  IHttpLlmApplication,
-  OpenApiV3,
-  OpenApiV3_1,
-  SwaggerV2,
-} from "@samchon/openapi";
-import type { IValidation } from "typia";
-
-import {
-  HttpLlm,
-  OpenApi,
-} from "@samchon/openapi";
-import typia from "typia";
-
-/**
- * Create an HTTP LLM application instance with type validation.
- *
- * Create an {@link IHttpLlmApplication} instance which represents
- * the LLM (Large Language Model) function calling application schema
- * from the given Swagger/OpenAPI document and the target LLM model.
- *
- * By the way, even though this `validateHttpLlmApplication` function
- * supports every version of Swagger/OpenAPI specification, there can
- * be a type error in the given document. In that case, the function
- * will return {@link IValidation.IFailure} instance with detailed
- * type error tracing information.
- *
- * @param props Properties to create the HTTP LLM application instance
- * @returns Validation result of the HTTP LLM application composition
- * @author Samchon
- * @deprecated Use {@link validateHttpController} instead.
- */
-export function validateHttpLlmApplication(props: {
-  /**
-   * Swagger/OpenAPI document.
-   */
-  document:
-    | SwaggerV2.IDocument
-    | OpenApiV3.IDocument
-    | OpenApiV3_1.IDocument
-    | OpenApi.IDocument
-    | unknown;
-
-  /**
-   * Options for the LLM function calling schema composition.
-   */
-  config?: Partial<IHttpLlmApplication.IConfig>;
-}): IValidation<IHttpLlmApplication> {
-  const inspect: IValidation<
-    | SwaggerV2.IDocument
-    | OpenApiV3.IDocument
-    | OpenApiV3_1.IDocument
-    | OpenApi.IDocument
-  > = typia.validate<
-    | SwaggerV2.IDocument
-    | OpenApiV3.IDocument
-    | OpenApiV3_1.IDocument
-    | OpenApi.IDocument
-  >(props.document);
-  if (inspect.success === false) {
-    return inspect;
-  }
-  return {
-    success: true,
-    data: HttpLlm.application({
-      document: OpenApi.convert(inspect.data),
-      config: props.config,
-    }),
-  };
-}
+import type { IHttpLlmApplication, OpenApiV3, OpenApiV3_1, OpenApiV3_2, SwaggerV2 } from "@typia/interface";
+import type { IValidation, OpenApi } from "typia";
+
+import { HttpLlm, OpenApiConverter } from "@typia/utils";
+import typia from "typia";
+
+/**
+ * Create an HTTP LLM application instance with type validation.
+ *
+ * Create an {@link IHttpLlmApplication} instance which represents
+ * the LLM (Large Language Model) function calling application schema
+ * from the given Swagger/OpenAPI document and the target LLM model.
+ *
+ * By the way, even though this `validateHttpLlmApplication` function
+ * supports every version of Swagger/OpenAPI specification, there can
+ * be a type error in the given document. In that case, the function
+ * will return {@link IValidation.IFailure} instance with detailed
+ * type error tracing information.
+ *
+ * @param props Properties to create the HTTP LLM application instance
+ * @returns Validation result of the HTTP LLM application composition
+ * @author Samchon
+ * @deprecated Use {@link validateHttpController} instead.
+ */
+export function validateHttpLlmApplication(props: {
+  /**
+   * Swagger/OpenAPI document.
+   */
+  document:
+    | SwaggerV2.IDocument
+    | OpenApiV3.IDocument
+    | OpenApiV3_1.IDocument
+    | OpenApiV3_2.IDocument
+    | OpenApi.IDocument
+    | unknown;
+
+  /**
+   * Options for the LLM function calling schema composition.
+   */
+  config?: Partial<IHttpLlmApplication.IConfig>;
+}): IValidation<IHttpLlmApplication> {
+  const inspect: IValidation<
+    | SwaggerV2.IDocument
+    | OpenApiV3.IDocument
+    | OpenApiV3_1.IDocument
+    | OpenApiV3_2.IDocument
+    | OpenApi.IDocument
+  > = typia.validate<
+    | SwaggerV2.IDocument
+    | OpenApiV3.IDocument
+    | OpenApiV3_1.IDocument
+    | OpenApiV3_2.IDocument
+    | OpenApi.IDocument
+  >(props.document);
+  if (inspect.success === false) {
+    return inspect;
+  }
+  return {
+    success: true,
+    data: HttpLlm.application({
+      document: OpenApiConverter.upgradeDocument(inspect.data),
+      config: props.config,
+    }),
+  };
+}

package/src/functional/validateMcpController.ts

@@ -1,50 +1,53 @@
-import type { IMcpLlmApplication, IMcpTool, IValidation } from "@samchon/openapi";
-
-import { McpLlm } from "@samchon/openapi";
-import typia from "typia";
-
-import type { IAgenticaController } from "../structures/IAgenticaController";
-
-/**
- * Create an MCP controller with type validation.
- *
- * Create an {@link IAgenticaController.IMcp} instance which represents
- * an MCP (Model Context Protocol) controller with LLM function calling
- * schemas and client connection.
- *
- * @param props Properties to create the MCP controller
- * @param props.name Name of the MCP implementation.
- * @param props.client Client connection to the MCP implementation.
- * @param props.model Model schema of the LLM function calling.
- * @param props.options Options to create the MCP controller.
- * @returns MCP LLM application instance
- * @author SunRabbit
- */
-export async function validateMcpController(props: {
-  name: string;
-  client: IAgenticaController.IMcp["client"];
-  config?: Partial<IMcpLlmApplication.IConfig>;
-}): Promise<IValidation<IAgenticaController.IMcp>> {
-  // for peerDependencies
-  const { ListToolsResultSchema } = await import("@modelcontextprotocol/sdk/types.js");
-
-  // get list of tools
-  const { tools } = await props.client.request({ method: "tools/list" }, ListToolsResultSchema);
-  const inspect = typia.validate<Array<IMcpTool>>(tools);
-  if (inspect.success === false) {
-    return inspect;
-  }
-
-  const application: IMcpLlmApplication = McpLlm.application({
-    tools: typia.assert<Array<IMcpTool>>(tools),
-  });
-  return {
-    success: true,
-    data: {
-      protocol: "mcp",
-      name: props.name,
-      client: props.client,
-      application,
-    },
-  };
-}
+import type { ILlmApplication, IValidation } from "typia";
+
+import typia from "typia";
+
+import type { IAgenticaController } from "../structures/IAgenticaController";
+import type { IMcpTool } from "../structures/IMcpTool";
+
+import { createMcpLlmApplication } from "./createMcpLlmApplication";
+
+/**
+ * Create an MCP controller with type validation.
+ *
+ * Create an {@link IAgenticaController.IMcp} instance which represents
+ * an MCP (Model Context Protocol) controller with LLM function calling
+ * schemas and client connection.
+ *
+ * @param props Properties to create the MCP controller
+ * @param props.name Name of the MCP implementation.
+ * @param props.client Client connection to the MCP implementation.
+ * @param props.model Model schema of the LLM function calling.
+ * @param props.options Options to create the MCP controller.
+ * @returns MCP LLM application instance
+ * @author SunRabbit
+ */
+export async function validateMcpController(props: {
+  name: string;
+  client: IAgenticaController.IMcp["client"];
+  config?: Partial<ILlmApplication.IConfig>;
+}): Promise<IValidation<IAgenticaController.IMcp>> {
+  // for peerDependencies
+  const { ListToolsResultSchema } = await import("@modelcontextprotocol/sdk/types.js");
+
+  // get list of tools
+  const { tools } = await props.client.request({ method: "tools/list" }, ListToolsResultSchema);
+  const inspect = typia.validate<Array<IMcpTool>>(tools);
+  if (inspect.success === false) {
+    return inspect;
+  }
+
+  const application: ILlmApplication = createMcpLlmApplication({
+    tools: typia.assert<Array<IMcpTool>>(tools),
+    config: props.config,
+  });
+  return {
+    success: true,
+    data: {
+      protocol: "mcp",
+      name: props.name,
+      client: props.client,
+      application,
+    },
+  };
+}

package/src/histories/AgenticaAssistantMessageHistory.ts

@@ -1,10 +1,10 @@
-import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
-
-import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
-
-export interface AgenticaAssistantMessageHistory extends AgenticaHistoryBase<
-  "assistantMessage",
-  IAgenticaHistoryJson.IAssistantMessage
-> {
-  text: string;
-}
+import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
+
+import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
+
+export interface AgenticaAssistantMessageHistory extends AgenticaHistoryBase<
+  "assistantMessage",
+  IAgenticaHistoryJson.IAssistantMessage
+> {
+  text: string;
+}

package/src/histories/AgenticaCancelHistory.ts

@@ -1,8 +1,8 @@
-import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
-import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
-
-import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
-
-export interface AgenticaCancelHistory extends AgenticaHistoryBase<"cancel", IAgenticaHistoryJson.ICancel> {
-  selection: AgenticaOperationSelection;
-}
+import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
+
+import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
+
+export interface AgenticaCancelHistory extends AgenticaHistoryBase<"cancel", IAgenticaHistoryJson.ICancel> {
+  selection: AgenticaOperationSelection;
+}

package/src/histories/AgenticaDescribeHistory.ts

@@ -1,18 +1,18 @@
-import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
-
-import type { AgenticaExecuteHistory } from "./AgenticaExecuteHistory";
-import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
-
-export interface AgenticaDescribeHistory extends AgenticaHistoryBase<"describe", IAgenticaHistoryJson.IDescribe> {
-  /**
-   * Executions of the LLM function calling.
-   *
-   * This prompt describes the return value of them.
-   */
-  executes: AgenticaExecuteHistory[];
-
-  /**
-   * Description text.
-   */
-  text: string;
-}
+import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
+
+import type { AgenticaExecuteHistory } from "./AgenticaExecuteHistory";
+import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
+
+export interface AgenticaDescribeHistory extends AgenticaHistoryBase<"describe", IAgenticaHistoryJson.IDescribe> {
+  /**
+   * Executions of the LLM function calling.
+   *
+   * This prompt describes the return value of them.
+   */
+  executes: AgenticaExecuteHistory[];
+
+  /**
+   * Description text.
+   */
+  text: string;
+}