@agentica/core 0.19.1 → 0.21.0

package/src/orchestrate/execute.ts

@@ -17,13 +17,15 @@ export function execute<Model extends ILlmSchema.Model>(executor: Partial<IAgent
 
     // FUNCTIONS ARE NOT LISTED YET
     if (ctx.ready() === false) {
-      if (executor?.initialize === null) {
+      if (executor?.initialize !== true && typeof executor?.initialize !== "function") {
         await ctx.initialize();
       }
       else {
         histories.push(
           ...(await (
-            executor?.initialize ?? initialize
+            typeof executor?.initialize === "function"
+              ? executor.initialize
+              : initialize
           )(ctx)),
         );
         if (ctx.ready() === false) {
@@ -63,11 +65,15 @@ export function execute<Model extends ILlmSchema.Model>(executor: Partial<IAgent
       const executes: AgenticaExecuteHistory<Model>[] = prompts.filter(
         prompt => prompt.type === "execute",
       );
-      histories.push(
-        ...(await (
-          executor?.describe ?? describe
-        )(ctx, executes)),
-      );
+      if (executor?.describe !== null && executor?.describe !== false) {
+        histories.push(
+          ...(await (
+            typeof executor?.describe === "function"
+              ? executor.describe
+              : describe
+          )(ctx, executes)),
+        );
+      }
       if (executes.length === 0 || ctx.stack.length === 0) {
         break;
       }

package/src/structures/IAgenticaController.ts

@@ -1,3 +1,4 @@
+import type { Client } from "@modelcontextprotocol/sdk/client/index.d.ts";
 import type {
   IHttpConnection,
   IHttpLlmApplication,
@@ -6,10 +7,9 @@ import type {
   ILlmApplication,
   ILlmFunction,
   ILlmSchema,
+  IMcpLlmApplication,
 } from "@samchon/openapi";
 
-import type { IMcpLlmApplication } from "./mcp/IMcpLlmApplication";
-
 /**
  * Controller of the Agentica Agent.
  *
@@ -29,7 +29,7 @@ import type { IMcpLlmApplication } from "./mcp/IMcpLlmApplication";
 export type IAgenticaController<Model extends ILlmSchema.Model> =
   | IAgenticaController.IHttp<Model>
   | IAgenticaController.IClass<Model>
-  | IAgenticaController.IMcp;
+  | IAgenticaController.IMcp<Model>;
 
 export namespace IAgenticaController {
   /**
@@ -122,7 +122,12 @@ export namespace IAgenticaController {
   /**
    * MCP Server controller.
    */
-  export interface IMcp extends IBase<"mcp", IMcpLlmApplication> { }
+  export interface IMcp<Model extends ILlmSchema.Model> extends IBase<"mcp", IMcpLlmApplication<Model>> {
+    /**
+     * MCP client for connection.
+     */
+    client: Client;
+  }
 
   interface IBase<Protocol, Application> {
     /**

package/src/structures/IAgenticaExecutor.ts

@@ -49,15 +49,17 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
    * conversate with the user.
    *
    * By the way, if you wanna skip the `initialize` agent, you can
-   * do it by configuring the {@link IAgenticaConfig.executor} as
-   * `null` value. In that case, the `initialize` agent will never be
-   * called, and {@link Agentica} just starts from the {@link select}
-   * agent.
+   * do it by configuring the {@link IAgenticaExecutor.initialize} as
+   * `undefined`, `false` or `null` value. In that case, the `initialize`
+   * agent will never be called, and {@link Agentica} just starts from the
+   * {@link select} agent.
    *
    * @param ctx Context of the agent
    * @returns List of prompts generated by the initializer
+   * @default false
    */
   initialize:
+    | boolean
     | null
     | ((ctx: AgenticaContext<Model>) => Promise<AgenticaHistory<Model>[]>);
 
@@ -124,14 +126,20 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
    * `Describe` agent explains the results of the function callings
    * to the user as markdown content.
    *
+   * If you configure this property as `false` or `null`, the describer
+   * agent will never be used.
+   *
    * @param ctx Context of the agent
    * @param executes List of function calling results
    * @returns List of prompts generated by the describer
    */
-  describe: (
-    ctx: AgenticaContext<Model>,
-    executes: AgenticaExecuteHistory<Model>[],
-  ) => Promise<AgenticaHistory<Model>[]>;
+  describe:
+    | boolean
+    | null
+    | ((
+      ctx: AgenticaContext<Model>,
+      executes: AgenticaExecuteHistory<Model>[],
+    ) => Promise<AgenticaHistory<Model>[]>);
 
   /**
    * Function canceler agent.

package/src/structures/IMicroAgenticaExecutor.ts

@@ -52,12 +52,18 @@ export interface IMicroAgenticaExecutor<Model extends ILlmSchema.Model> {
    * `Describe` agent explains the results of the function callings
    * to the user as markdown content.
    *
+   * If you configure this property as `false` or `null`, the describer
+   * agent never be used.
+   *
    * @param ctx Context of the agent
    * @param executes List of function calling results
    * @returns List of prompts generated by the describer
    */
-  describe: (
-    ctx: MicroAgenticaContext<Model>,
-    executes: AgenticaExecuteHistory<Model>[],
-  ) => Promise<MicroAgenticaHistory<Model>[]>;
+  describe:
+    | boolean
+    | null
+    | ((
+      ctx: MicroAgenticaContext<Model>,
+      executes: AgenticaExecuteHistory<Model>[],
+    ) => Promise<MicroAgenticaHistory<Model>[]>);
 }

package/src/structures/mcp/index.ts

@@ -1,3 +1 @@
-export * from "./IMcpLlmApplication";
-export * from "./IMcpLlmFunction";
 export * from "./IMcpLlmTransportProps";

package/lib/functional/assertMcpLlmApplication.d.ts

@@ -1,18 +0,0 @@
-import type { Client } from "@modelcontextprotocol/sdk/client/index.d.ts";
-import type { IMcpLlmApplication } from "../structures/mcp";
-/**
- * Create an MCP LLM application instance with type assertion.
- *
- * Create an {@link IMcpLlmApplication} instance which represents
- * an MCP (Model Context Protocol) LLM application.
- *
- * @param props Properties to create the MCP LLM application instance
- * @param props.name Name of the MCP implementation.
- * @param props.url URL of the MCP server.
- * @param props.version Describes version of an MCP implementation.
- * @returns MCP LLM application instance
- * @author Samchon
- */
-export declare function assertMcpLlmApplication(props: {
-    client: Client;
-}): Promise<IMcpLlmApplication>;

package/lib/functional/assertMcpLlmApplication.js

@@ -1,74 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertMcpLlmApplication = assertMcpLlmApplication;
-/**
- * Create an MCP LLM application instance with type assertion.
- *
- * Create an {@link IMcpLlmApplication} instance which represents
- * an MCP (Model Context Protocol) LLM application.
- *
- * @param props Properties to create the MCP LLM application instance
- * @param props.name Name of the MCP implementation.
- * @param props.url URL of the MCP server.
- * @param props.version Describes version of an MCP implementation.
- * @returns MCP LLM application instance
- * @author Samchon
- */
-function assertMcpLlmApplication(props) {
-    return __awaiter(this, void 0, void 0, function* () {
-        // for peerDependencies
-        const { ListToolsResultSchema } = yield Promise.resolve().then(() => __importStar(require("@modelcontextprotocol/sdk/types.js")));
-        const toolList = yield props.client.request({ method: "tools/list" }, ListToolsResultSchema);
-        return {
-            functions: toolList.tools.map(tool => ({
-                name: tool.name,
-                description: tool.description,
-                parameters: tool.inputSchema,
-            })),
-            client: props.client,
-        };
-    });
-}
-//# sourceMappingURL=assertMcpLlmApplication.js.map

package/lib/functional/assertMcpLlmApplication.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"assertMcpLlmApplication.js","sourceRoot":"","sources":["../../src/functional/assertMcpLlmApplication.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,0DAeC;AA5BD;;;;;;;;;;;;GAYG;AACH,SAAsB,uBAAuB,CAAC,KAE7C;;QACC,uBAAuB;QACvB,MAAM,EAAE,qBAAqB,EAAE,GAAG,wDAAa,oCAAoC,GAAC,CAAC;QAErF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,qBAAqB,CAAC,CAAC;QAC7F,OAAO;YACL,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACrC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,IAAI,CAAC,WAAW;aAC7B,CAAC,CAAC;YACH,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC;IACJ,CAAC;CAAA"}

package/lib/structures/mcp/IMcpLlmApplication.d.ts

@@ -1,9 +0,0 @@
-import type { Client } from "@modelcontextprotocol/sdk/client/index.d.ts";
-import type { IMcpLlmFunction } from "./IMcpLlmFunction";
-/**
- * MCP LLM application.
- */
-export interface IMcpLlmApplication {
-    client: Client;
-    functions: IMcpLlmFunction[];
-}

package/lib/structures/mcp/IMcpLlmApplication.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=IMcpLlmApplication.js.map

package/lib/structures/mcp/IMcpLlmApplication.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IMcpLlmApplication.js","sourceRoot":"","sources":["../../../src/structures/mcp/IMcpLlmApplication.ts"],"names":[],"mappings":""}

package/lib/structures/mcp/IMcpLlmFunction.d.ts

@@ -1,17 +0,0 @@
-/**
- * MCP LLM function.
- */
-export interface IMcpLlmFunction {
-    /**
-     * Name of the function.
-     */
-    name: string;
-    /**
-     * Description of the function.
-     */
-    description?: string;
-    /**
-     * Parameters of the function.
-     */
-    parameters: object;
-}

package/lib/structures/mcp/IMcpLlmFunction.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=IMcpLlmFunction.js.map

package/lib/structures/mcp/IMcpLlmFunction.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IMcpLlmFunction.js","sourceRoot":"","sources":["../../../src/structures/mcp/IMcpLlmFunction.ts"],"names":[],"mappings":""}

package/src/functional/assertMcpLlmApplication.ts

@@ -1,32 +0,0 @@
-import type { Client } from "@modelcontextprotocol/sdk/client/index.d.ts";
-
-import type { IMcpLlmApplication } from "../structures/mcp";
-/**
- * Create an MCP LLM application instance with type assertion.
- *
- * Create an {@link IMcpLlmApplication} instance which represents
- * an MCP (Model Context Protocol) LLM application.
- *
- * @param props Properties to create the MCP LLM application instance
- * @param props.name Name of the MCP implementation.
- * @param props.url URL of the MCP server.
- * @param props.version Describes version of an MCP implementation.
- * @returns MCP LLM application instance
- * @author Samchon
- */
-export async function assertMcpLlmApplication(props: {
-  client: Client;
-}): Promise<IMcpLlmApplication> {
-  // for peerDependencies
-  const { ListToolsResultSchema } = await import("@modelcontextprotocol/sdk/types.js");
-
-  const toolList = await props.client.request({ method: "tools/list" }, ListToolsResultSchema);
-  return {
-    functions: toolList.tools.map(tool => ({
-      name: tool.name,
-      description: tool.description,
-      parameters: tool.inputSchema,
-    })),
-    client: props.client,
-  };
-}

package/src/structures/mcp/IMcpLlmApplication.ts

@@ -1,10 +0,0 @@
-import type { Client } from "@modelcontextprotocol/sdk/client/index.d.ts";
-
-import type { IMcpLlmFunction } from "./IMcpLlmFunction";
-/**
- * MCP LLM application.
- */
-export interface IMcpLlmApplication {
-  client: Client;
-  functions: IMcpLlmFunction[];
-}

package/src/structures/mcp/IMcpLlmFunction.ts

@@ -1,19 +0,0 @@
-/**
- * MCP LLM function.
- */
-export interface IMcpLlmFunction {
-  /**
-   * Name of the function.
-   */
-  name: string;
-
-  /**
-   * Description of the function.
-   */
-  description?: string;
-
-  /**
-   * Parameters of the function.
-   */
-  parameters: object;
-}