@agentica/core 0.8.3 → 0.9.0-dev.20250302

package/src/chatgpt/ChatGptDescribeFunctionAgent.ts

@@ -1,51 +1,52 @@
-import OpenAI from "openai";
-
-import { AgenticaDefaultPrompt } from "../internal/AgenticaDefaultPrompt";
-import { AgenticaSystemPrompt } from "../internal/AgenticaSystemPrompt";
-import { IAgenticaContext } from "../structures/IAgenticaContext";
-import { IAgenticaPrompt } from "../structures/IAgenticaPrompt";
-import { ChatGptHistoryDecoder } from "./ChatGptHistoryDecoder";
-
-export namespace ChatGptDescribeFunctionAgent {
-  export const execute = async (
-    ctx: IAgenticaContext,
-    histories: IAgenticaPrompt.IExecute[],
-  ): Promise<IAgenticaPrompt.IDescribe[]> => {
-    if (histories.length === 0) return [];
-    const completion: OpenAI.ChatCompletion = await ctx.request("describe", {
-      messages: [
-        // COMMON SYSTEM PROMPT
-        {
-          role: "system",
-          content: AgenticaDefaultPrompt.write(ctx.config),
-        } satisfies OpenAI.ChatCompletionSystemMessageParam,
-        // FUNCTION CALLING HISTORIES
-        ...histories.map(ChatGptHistoryDecoder.decode).flat(),
-        // SYSTEM PROMPT
-        {
-          role: "system",
-          content:
-            ctx.config?.systemPrompt?.describe?.(histories) ??
-            AgenticaSystemPrompt.DESCRIBE,
-        },
-      ],
-    });
-    const descriptions: IAgenticaPrompt.IDescribe[] = completion.choices
-      .map((choice) =>
-        choice.message.role === "assistant" && !!choice.message.content?.length
-          ? choice.message.content
-          : null,
-      )
-      .filter((str) => str !== null)
-      .map(
-        (content) =>
-          ({
-            type: "describe",
-            executions: histories,
-            text: content,
-          }) satisfies IAgenticaPrompt.IDescribe,
-      );
-    for (const describe of descriptions) await ctx.dispatch(describe);
-    return descriptions;
-  };
-}
+import { ILlmSchema } from "@samchon/openapi";
+import OpenAI from "openai";
+
+import { AgenticaDefaultPrompt } from "../internal/AgenticaDefaultPrompt";
+import { AgenticaSystemPrompt } from "../internal/AgenticaSystemPrompt";
+import { IAgenticaContext } from "../structures/IAgenticaContext";
+import { IAgenticaPrompt } from "../structures/IAgenticaPrompt";
+import { ChatGptHistoryDecoder } from "./ChatGptHistoryDecoder";
+
+export namespace ChatGptDescribeFunctionAgent {
+  export const execute = async <Model extends ILlmSchema.Model>(
+    ctx: IAgenticaContext<Model>,
+    histories: IAgenticaPrompt.IExecute<Model>[],
+  ): Promise<IAgenticaPrompt.IDescribe<Model>[]> => {
+    if (histories.length === 0) return [];
+    const completion: OpenAI.ChatCompletion = await ctx.request("describe", {
+      messages: [
+        // COMMON SYSTEM PROMPT
+        {
+          role: "system",
+          content: AgenticaDefaultPrompt.write(ctx.config),
+        } satisfies OpenAI.ChatCompletionSystemMessageParam,
+        // FUNCTION CALLING HISTORIES
+        ...histories.map(ChatGptHistoryDecoder.decode).flat(),
+        // SYSTEM PROMPT
+        {
+          role: "system",
+          content:
+            ctx.config?.systemPrompt?.describe?.(histories) ??
+            AgenticaSystemPrompt.DESCRIBE,
+        },
+      ],
+    });
+    const descriptions: IAgenticaPrompt.IDescribe<Model>[] = completion.choices
+      .map((choice) =>
+        choice.message.role === "assistant" && !!choice.message.content?.length
+          ? choice.message.content
+          : null,
+      )
+      .filter((str) => str !== null)
+      .map(
+        (content) =>
+          ({
+            type: "describe",
+            executions: histories,
+            text: content,
+          }) satisfies IAgenticaPrompt.IDescribe<Model>,
+      );
+    for (const describe of descriptions) await ctx.dispatch(describe);
+    return descriptions;
+  };
+}

package/src/chatgpt/ChatGptHistoryDecoder.ts

@@ -1,87 +1,88 @@
-import OpenAI from "openai";
-
-import { IAgenticaPrompt } from "../structures/IAgenticaPrompt";
-
-export namespace ChatGptHistoryDecoder {
-  export const decode = (
-    history: IAgenticaPrompt,
-  ): OpenAI.ChatCompletionMessageParam[] => {
-    // NO NEED TO DECODE DESCRIBE
-    if (history.type === "describe") return [];
-    else if (history.type === "text")
-      return [
-        {
-          role: history.role,
-          content: history.text,
-        },
-      ];
-    else if (history.type === "select" || history.type === "cancel")
-      return [
-        {
-          role: "assistant",
-          tool_calls: [
-            {
-              type: "function",
-              id: history.id,
-              function: {
-                name: `${history.type}Functions`,
-                arguments: JSON.stringify({
-                  functions: history.operations.map((t) => ({
-                    name: t.function.name,
-                    reason: t.reason,
-                  })),
-                }),
-              },
-            },
-          ],
-        },
-        {
-          role: "tool",
-          tool_call_id: history.id,
-          content: "",
-        },
-      ];
-
-    return [
-      {
-        role: "assistant",
-        tool_calls: [
-          {
-            type: "function",
-            id: history.id,
-            function: {
-              name: history.function.name,
-              arguments: JSON.stringify(history.arguments),
-            },
-          },
-        ],
-      },
-      {
-        role: "tool",
-        tool_call_id: history.id,
-        content: JSON.stringify({
-          function: {
-            protocol: history.protocol,
-            description: history.function.description,
-            parameters: history.function.parameters,
-            output: history.function.output,
-            ...(history.protocol === "http"
-              ? {
-                  method: history.function.method,
-                  path: history.function.path,
-                }
-              : {}),
-          },
-          ...(history.protocol === "http"
-            ? {
-                status: history.value.status,
-                data: history.value.body,
-              }
-            : {
-                value: history.value,
-              }),
-        }),
-      },
-    ];
-  };
-}
+import { ILlmSchema } from "@samchon/openapi";
+import OpenAI from "openai";
+
+import { IAgenticaPrompt } from "../structures/IAgenticaPrompt";
+
+export namespace ChatGptHistoryDecoder {
+  export const decode = <Model extends ILlmSchema.Model>(
+    history: IAgenticaPrompt<Model>,
+  ): OpenAI.ChatCompletionMessageParam[] => {
+    // NO NEED TO DECODE DESCRIBE
+    if (history.type === "describe") return [];
+    else if (history.type === "text")
+      return [
+        {
+          role: history.role,
+          content: history.text,
+        },
+      ];
+    else if (history.type === "select" || history.type === "cancel")
+      return [
+        {
+          role: "assistant",
+          tool_calls: [
+            {
+              type: "function",
+              id: history.id,
+              function: {
+                name: `${history.type}Functions`,
+                arguments: JSON.stringify({
+                  functions: history.operations.map((t) => ({
+                    name: t.function.name,
+                    reason: t.reason,
+                  })),
+                }),
+              },
+            },
+          ],
+        },
+        {
+          role: "tool",
+          tool_call_id: history.id,
+          content: "",
+        },
+      ];
+
+    return [
+      {
+        role: "assistant",
+        tool_calls: [
+          {
+            type: "function",
+            id: history.id,
+            function: {
+              name: history.function.name,
+              arguments: JSON.stringify(history.arguments),
+            },
+          },
+        ],
+      },
+      {
+        role: "tool",
+        tool_call_id: history.id,
+        content: JSON.stringify({
+          function: {
+            protocol: history.protocol,
+            description: history.function.description,
+            parameters: history.function.parameters,
+            output: history.function.output,
+            ...(history.protocol === "http"
+              ? {
+                  method: history.function.method,
+                  path: history.function.path,
+                }
+              : {}),
+          },
+          ...(history.protocol === "http"
+            ? {
+                status: history.value.status,
+                data: history.value.body,
+              }
+            : {
+                value: history.value,
+              }),
+        }),
+      },
+    ];
+  };
+}

package/src/chatgpt/ChatGptInitializeFunctionAgent.ts

@@ -1,88 +1,88 @@
-import { ILlmFunction } from "@samchon/openapi";
-import OpenAI from "openai";
-import typia from "typia";
-
-import { AgenticaDefaultPrompt } from "../internal/AgenticaDefaultPrompt";
-import { AgenticaSystemPrompt } from "../internal/AgenticaSystemPrompt";
-import { IAgenticaContext } from "../structures/IAgenticaContext";
-import { IAgenticaPrompt } from "../structures/IAgenticaPrompt";
-import { __IChatInitialApplication } from "../structures/internal/__IChatInitialApplication";
-import { ChatGptHistoryDecoder } from "./ChatGptHistoryDecoder";
-
-export namespace ChatGptInitializeFunctionAgent {
-  export const execute = async (
-    ctx: IAgenticaContext,
-  ): Promise<IAgenticaPrompt[]> => {
-    //----
-    // EXECUTE CHATGPT API
-    //----
-    const completion: OpenAI.ChatCompletion = await ctx.request("initialize", {
-      messages: [
-        // COMMON SYSTEM PROMPT
-        {
-          role: "system",
-          content: AgenticaDefaultPrompt.write(ctx.config),
-        } satisfies OpenAI.ChatCompletionSystemMessageParam,
-        // PREVIOUS HISTORIES
-        ...ctx.histories.map(ChatGptHistoryDecoder.decode).flat(),
-        // USER INPUT
-        {
-          role: "user",
-          content: ctx.prompt.text,
-        },
-        {
-          // SYSTEM PROMPT
-          role: "system",
-          content:
-            ctx.config?.systemPrompt?.initialize?.(ctx.histories) ??
-            AgenticaSystemPrompt.INITIALIZE,
-        },
-      ],
-      // GETTER FUNCTION
-      tools: [
-        {
-          type: "function",
-          function: {
-            name: FUNCTION.name,
-            description: FUNCTION.description,
-            parameters: FUNCTION.parameters as any,
-          },
-        },
-      ],
-      tool_choice: "auto",
-      parallel_tool_calls: false,
-    });
-
-    //----
-    // PROCESS COMPLETION
-    //----
-    const prompts: IAgenticaPrompt[] = [];
-    for (const choice of completion.choices) {
-      if (
-        choice.message.role === "assistant" &&
-        !!choice.message.content?.length
-      )
-        prompts.push({
-          type: "text",
-          role: "assistant",
-          text: choice.message.content,
-        });
-    }
-    if (
-      completion.choices.some(
-        (c) =>
-          !!c.message.tool_calls?.some(
-            (tc) =>
-              tc.type === "function" && tc.function.name === FUNCTION.name,
-          ),
-      )
-    )
-      await ctx.initialize();
-    return prompts;
-  };
-}
-
-const FUNCTION: ILlmFunction<"chatgpt"> = typia.llm.application<
-  __IChatInitialApplication,
-  "chatgpt"
->().functions[0]!;
+import { ILlmFunction, ILlmSchema } from "@samchon/openapi";
+import OpenAI from "openai";
+import typia from "typia";
+
+import { AgenticaDefaultPrompt } from "../internal/AgenticaDefaultPrompt";
+import { AgenticaSystemPrompt } from "../internal/AgenticaSystemPrompt";
+import { IAgenticaContext } from "../structures/IAgenticaContext";
+import { IAgenticaPrompt } from "../structures/IAgenticaPrompt";
+import { __IChatInitialApplication } from "../structures/internal/__IChatInitialApplication";
+import { ChatGptHistoryDecoder } from "./ChatGptHistoryDecoder";
+
+export namespace ChatGptInitializeFunctionAgent {
+  export const execute = async <Model extends ILlmSchema.Model>(
+    ctx: IAgenticaContext<Model>,
+  ): Promise<IAgenticaPrompt<Model>[]> => {
+    //----
+    // EXECUTE CHATGPT API
+    //----
+    const completion: OpenAI.ChatCompletion = await ctx.request("initialize", {
+      messages: [
+        // COMMON SYSTEM PROMPT
+        {
+          role: "system",
+          content: AgenticaDefaultPrompt.write(ctx.config),
+        } satisfies OpenAI.ChatCompletionSystemMessageParam,
+        // PREVIOUS HISTORIES
+        ...ctx.histories.map(ChatGptHistoryDecoder.decode).flat(),
+        // USER INPUT
+        {
+          role: "user",
+          content: ctx.prompt.text,
+        },
+        {
+          // SYSTEM PROMPT
+          role: "system",
+          content:
+            ctx.config?.systemPrompt?.initialize?.(ctx.histories) ??
+            AgenticaSystemPrompt.INITIALIZE,
+        },
+      ],
+      // GETTER FUNCTION
+      tools: [
+        {
+          type: "function",
+          function: {
+            name: FUNCTION.name,
+            description: FUNCTION.description,
+            parameters: FUNCTION.parameters as any,
+          },
+        },
+      ],
+      tool_choice: "auto",
+      parallel_tool_calls: false,
+    });
+
+    //----
+    // PROCESS COMPLETION
+    //----
+    const prompts: IAgenticaPrompt<Model>[] = [];
+    for (const choice of completion.choices) {
+      if (
+        choice.message.role === "assistant" &&
+        !!choice.message.content?.length
+      )
+        prompts.push({
+          type: "text",
+          role: "assistant",
+          text: choice.message.content,
+        });
+    }
+    if (
+      completion.choices.some(
+        (c) =>
+          !!c.message.tool_calls?.some(
+            (tc) =>
+              tc.type === "function" && tc.function.name === FUNCTION.name,
+          ),
+      )
+    )
+      await ctx.initialize();
+    return prompts;
+  };
+}
+
+const FUNCTION: ILlmFunction<"chatgpt"> = typia.llm.application<
+  __IChatInitialApplication,
+  "chatgpt"
+>().functions[0]!;