@agentica/core 0.8.3 → 0.9.0-dev.20250302

package/src/chatgpt/ChatGptAgent.ts

@@ -1,71 +1,75 @@
-import { IAgenticaContext } from "../structures/IAgenticaContext";
-import { IAgenticaExecutor } from "../structures/IAgenticaExecutor";
-import { IAgenticaPrompt } from "../structures/IAgenticaPrompt";
-import { ChatGptCallFunctionAgent } from "./ChatGptCallFunctionAgent";
-import { ChatGptCancelFunctionAgent } from "./ChatGptCancelFunctionAgent";
-import { ChatGptDescribeFunctionAgent } from "./ChatGptDescribeFunctionAgent";
-import { ChatGptInitializeFunctionAgent } from "./ChatGptInitializeFunctionAgent";
-import { ChatGptSelectFunctionAgent } from "./ChatGptSelectFunctionAgent";
-
-export namespace ChatGptAgent {
-  export const execute =
-    (executor: Partial<IAgenticaExecutor> | null) =>
-    async (ctx: IAgenticaContext): Promise<IAgenticaPrompt[]> => {
-      const histories: IAgenticaPrompt[] = [];
-
-      // FUNCTIONS ARE NOT LISTED YET
-      if (ctx.ready() === false) {
-        if (executor?.initialize === null) await ctx.initialize();
-        else {
-          histories.push(
-            ...(await (
-              executor?.initialize ?? ChatGptInitializeFunctionAgent.execute
-            )(ctx)),
-          );
-          if (ctx.ready() === false) return histories;
-        }
-      }
-
-      // CANCEL CANDIDATE FUNCTIONS
-      if (ctx.stack.length !== 0)
-        histories.push(
-          ...(await (executor?.cancel ?? ChatGptCancelFunctionAgent.execute)(
-            ctx,
-          )),
-        );
-
-      // SELECT CANDIDATE FUNCTIONS
-      histories.push(
-        ...(await (executor?.select ?? ChatGptSelectFunctionAgent.execute)(
-          ctx,
-        )),
-      );
-      if (ctx.stack.length === 0) return histories;
-
-      // FUNCTION CALLING LOOP
-      while (true) {
-        // EXECUTE FUNCTIONS
-        const prompts: IAgenticaPrompt[] = await (
-          executor?.call ?? ChatGptCallFunctionAgent.execute
-        )(ctx);
-        histories.push(...prompts);
-
-        // EXPLAIN RETURN VALUES
-        const executes: IAgenticaPrompt.IExecute[] = prompts.filter(
-          (prompt) => prompt.type === "execute",
-        );
-        for (const e of executes)
-          await ChatGptCancelFunctionAgent.cancelFunction(ctx, {
-            reason: "completed",
-            name: e.function.name,
-          });
-        histories.push(
-          ...(await (
-            executor?.describe ?? ChatGptDescribeFunctionAgent.execute
-          )(ctx, executes)),
-        );
-        if (executes.length === 0 || ctx.stack.length === 0) break;
-      }
-      return histories;
-    };
-}
+import { ILlmSchema } from "@samchon/openapi";
+
+import { IAgenticaContext } from "../structures/IAgenticaContext";
+import { IAgenticaExecutor } from "../structures/IAgenticaExecutor";
+import { IAgenticaPrompt } from "../structures/IAgenticaPrompt";
+import { ChatGptCallFunctionAgent } from "./ChatGptCallFunctionAgent";
+import { ChatGptCancelFunctionAgent } from "./ChatGptCancelFunctionAgent";
+import { ChatGptDescribeFunctionAgent } from "./ChatGptDescribeFunctionAgent";
+import { ChatGptInitializeFunctionAgent } from "./ChatGptInitializeFunctionAgent";
+import { ChatGptSelectFunctionAgent } from "./ChatGptSelectFunctionAgent";
+
+export namespace ChatGptAgent {
+  export const execute =
+    <Model extends ILlmSchema.Model>(
+      executor: Partial<IAgenticaExecutor<Model>> | null,
+    ) =>
+    async (ctx: IAgenticaContext<Model>): Promise<IAgenticaPrompt<Model>[]> => {
+      const histories: IAgenticaPrompt<Model>[] = [];
+
+      // FUNCTIONS ARE NOT LISTED YET
+      if (ctx.ready() === false) {
+        if (executor?.initialize === null) await ctx.initialize();
+        else {
+          histories.push(
+            ...(await (
+              executor?.initialize ?? ChatGptInitializeFunctionAgent.execute
+            )(ctx)),
+          );
+          if (ctx.ready() === false) return histories;
+        }
+      }
+
+      // CANCEL CANDIDATE FUNCTIONS
+      if (ctx.stack.length !== 0)
+        histories.push(
+          ...(await (executor?.cancel ?? ChatGptCancelFunctionAgent.execute)(
+            ctx,
+          )),
+        );
+
+      // SELECT CANDIDATE FUNCTIONS
+      histories.push(
+        ...(await (executor?.select ?? ChatGptSelectFunctionAgent.execute)(
+          ctx,
+        )),
+      );
+      if (ctx.stack.length === 0) return histories;
+
+      // FUNCTION CALLING LOOP
+      while (true) {
+        // EXECUTE FUNCTIONS
+        const prompts: IAgenticaPrompt<Model>[] = await (
+          executor?.call ?? ChatGptCallFunctionAgent.execute
+        )(ctx);
+        histories.push(...prompts);
+
+        // EXPLAIN RETURN VALUES
+        const executes: IAgenticaPrompt.IExecute<Model>[] = prompts.filter(
+          (prompt) => prompt.type === "execute",
+        );
+        for (const e of executes)
+          await ChatGptCancelFunctionAgent.cancelFunction(ctx, {
+            reason: "completed",
+            name: e.function.name,
+          });
+        histories.push(
+          ...(await (
+            executor?.describe ?? ChatGptDescribeFunctionAgent.execute
+          )(ctx, executes)),
+        );
+        if (executes.length === 0 || ctx.stack.length === 0) break;
+      }
+      return histories;
+    };
+}