@agentica/core 0.14.3 → 0.15.0

package/lib/utils/__map_take.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/utils/__map_take.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"__map_take.js","sourceRoot":"","sources":["../../src/utils/__map_take.ts"],"names":[],"mappings":";;AAGA,gCASC;AAZD;;GAEG;AACH,SAAgB,UAAU,CAAS,IAAiB,EAAE,GAAQ,EAAE,SAAkB;IAChF,MAAM,MAAM,GAAkB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,KAAK,GAAM,SAAS,EAAE,CAAC;IAC7B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACrB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./AsyncQueue";
+export * from "./ChatGptCompletionMessageUtil";
+export * from "./MPSC";
+export * from "./StreamUtil";

package/lib/utils/index.js

@@ -0,0 +1,21 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./AsyncQueue"), exports);
+__exportStar(require("./ChatGptCompletionMessageUtil"), exports);
+__exportStar(require("./MPSC"), exports);
+__exportStar(require("./StreamUtil"), exports);
+//# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,iEAA+C;AAC/C,yCAAuB;AACvB,+CAA6B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentica/core",
-  "version": "0.14.3",
+  "version": "0.15.0",
   "description": "Agentic AI Library specialized in LLM Function Calling",
   "author": "Wrtn Technologies",
   "license": "MIT",

package/src/Agentica.ts

@@ -12,16 +12,16 @@ import type { IAgenticaVendor } from "./structures/IAgenticaVendor";
 import type { AgenticaTextPrompt } from "./prompts/AgenticaTextPrompt";
 import type { AgenticaRequestEvent } from "./events/AgenticaRequestEvent";
 
-import { ChatGptAgent } from "./orchestrate/ChatGptAgent";
-import { ChatGptCompletionMessageUtil } from "./orchestrate/ChatGptCompletionMessageUtil";
+import { ChatGptCompletionMessageUtil } from "./utils/ChatGptCompletionMessageUtil";
 import { AgenticaTokenUsage } from "./context/AgenticaTokenUsage";
 import { AgenticaTokenUsageAggregator } from "./context/internal/AgenticaTokenUsageAggregator";
-import { __map_take } from "./internal/__map_take";
-import { AgenticaOperationComposer } from "./internal/AgenticaOperationComposer";
-import { StreamUtil } from "./internal/StreamUtil";
+import { __map_take } from "./utils/__map_take";
+import { AgenticaOperationComposer } from "./context/internal/AgenticaOperationComposer";
+import { StreamUtil } from "./utils/StreamUtil";
 import { AgenticaPromptTransformer } from "./transformers/AgenticaPromptTransformer";
 import { createTextPrompt } from "./factory/prompts";
 import { createInitializeEvent, createRequestEvent, createTextEvent } from "./factory/events";
+import { execute } from "./orchestrate/execute";
 
 /**
  * Nestia A.I. chatbot agent.
@@ -97,7 +97,7 @@ export class Agentica<Model extends ILlmSchema.Model> {
     this.executor_
       = typeof props.config?.executor === "function"
         ? props.config.executor
-        : ChatGptAgent.execute(props.config?.executor ?? null);
+        : execute(props.config?.executor ?? null);
   }
 
   /**

package/src/{internal → constants}/AgenticaDefaultPrompt.ts

@@ -1,8 +1,8 @@
 import type { ILlmSchema } from "@samchon/openapi";
-
 import type { IAgenticaConfig } from "../structures/IAgenticaConfig";
+
 import { AgenticaSystemPrompt } from "./AgenticaSystemPrompt";
-import { Singleton } from "./Singleton";
+import { Singleton } from "../utils/Singleton";
 
 /**
  * @TODO maybe this code will rewrite

package/src/{internal → context/internal}/AgenticaOperationComposer.ts

@@ -1,10 +1,10 @@
 import type { ILlmSchema } from "@samchon/openapi";
+import type { AgenticaOperation } from "../AgenticaOperation";
+import type { AgenticaOperationCollection } from "../AgenticaOperationCollection";
+import type { IAgenticaConfig } from "../../structures/IAgenticaConfig";
+import type { IAgenticaController } from "../../structures/IAgenticaController";
 
-import type { AgenticaOperation } from "../context/AgenticaOperation";
-import type { AgenticaOperationCollection } from "../context/AgenticaOperationCollection";
-import type { IAgenticaConfig } from "../structures/IAgenticaConfig";
-import type { IAgenticaController } from "../structures/IAgenticaController";
-import { __map_take } from "./__map_take";
+import { __map_take } from "../../utils/__map_take";
 
 export function compose<Model extends ILlmSchema.Model>(props: {
   controllers: IAgenticaController<Model>[];

package/src/factory/events.ts

@@ -21,8 +21,8 @@ import type { AgenticaValidateEvent } from "../events/AgenticaValidateEvent";
 import { createExecutePrompt, createSelectPrompt } from "./prompts";
 
 /* -----------------------------------------------------------
-    FUNCTION SELECTS
-  ----------------------------------------------------------- */
+  FUNCTION SELECTS
+----------------------------------------------------------- */
 export function createInitializeEvent(): AgenticaInitializeEvent {
   const event: IAgenticaEventJson.IInitialize = {
     type: "initialize",
@@ -64,8 +64,8 @@ export function createCancelEvent<Model extends ILlmSchema.Model>(props: {
 }
 
 /* -----------------------------------------------------------
-    FUNCTION CALLS
-  ----------------------------------------------------------- */
+  FUNCTION CALLS
+----------------------------------------------------------- */
 export function createCallEvent<Model extends ILlmSchema.Model>(props: {
   id: string;
   operation: AgenticaOperation<Model>;
@@ -131,8 +131,8 @@ export function createExecuteEvent<Model extends ILlmSchema.Model>(props: {
 }
 
 /* -----------------------------------------------------------
-    TEXT STEAMING
-  ----------------------------------------------------------- */
+  TEXT STEAMING
+----------------------------------------------------------- */
 export function createTextEvent<Role extends "user" | "assistant">(props: {
   role: Role;
   stream: ReadableStream<string>;

package/src/factory/prompts.ts

@@ -1,4 +1,5 @@
-import type { ILlmSchema } from "@samchon/openapi";
+import type OpenAI from "openai";
+import type { IHttpResponse, ILlmSchema } from "@samchon/openapi";
 import type { AgenticaTextPrompt } from "../prompts/AgenticaTextPrompt";
 import type { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
 import type { AgenticaDescribePrompt } from "../prompts/AgenticaDescribePrompt";
@@ -7,10 +8,95 @@ import type { AgenticaOperationSelection } from "../context/AgenticaOperationSel
 import type { AgenticaSelectPrompt } from "../prompts/AgenticaSelectPrompt";
 import type { AgenticaCancelPrompt } from "../context/AgenticaCancelPrompt";
 import type { AgenticaOperation } from "../context/AgenticaOperation";
+import type { AgenticaPrompt } from "../prompts/AgenticaPrompt";
+
+export function decodePrompt<Model extends ILlmSchema.Model>(history: AgenticaPrompt<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.selections.map(s => ({
+                  name: s.operation.function.name,
+                  reason: s.reason,
+                })),
+              }),
+            },
+          },
+        ],
+      },
+      {
+        role: "tool",
+        tool_call_id: history.id,
+        content: "",
+      },
+    ];
+  }
+
+  return [
+    {
+      role: "assistant",
+      tool_calls: [
+        {
+          type: "function",
+          id: history.id,
+          function: {
+            name: history.operation.name,
+            arguments: JSON.stringify(history.arguments),
+          },
+        },
+      ],
+    },
+    {
+      role: "tool",
+      tool_call_id: history.id,
+      content: JSON.stringify({
+        function: {
+          protocol: history.operation.protocol,
+          description: history.operation.function.description,
+          parameters: history.operation.function.parameters,
+          output: history.operation.function.output,
+          ...(history.operation.protocol === "http"
+            ? {
+                method: history.operation.function.method,
+                path: history.operation.function.path,
+              }
+            : {}),
+        },
+        ...(history.operation.protocol === "http"
+          ? {
+              status: (history.value as IHttpResponse).status,
+              data: (history.value as IHttpResponse).body,
+            }
+          : {
+              value: history.value,
+            }),
+      }),
+    },
+  ];
+}
 
 /* -----------------------------------------------------------
-    TEXT PROMPTS
-  ----------------------------------------------------------- */
+  TEXT PROMPTS
+----------------------------------------------------------- */
 export function createTextPrompt<Role extends "assistant" | "user" = "assistant" | "user">(props: {
   role: Role;
   text: string;
@@ -43,8 +129,8 @@ export function createDescribePrompt<Model extends ILlmSchema.Model>(props: {
 }
 
 /* -----------------------------------------------------------
-    FUNCTION CALLING PROMPTS
-  ----------------------------------------------------------- */
+  FUNCTION CALLING PROMPTS
+----------------------------------------------------------- */
 export function createSelectPrompt<Model extends ILlmSchema.Model>(props: {
   id: string;
   selections: AgenticaOperationSelection<Model>[];

package/src/index.ts

@@ -16,6 +16,8 @@ export * from "./events/AgenticaRequestEvent";
 export * from "./events/AgenticaResponseEvent";
 export * from "./events/AgenticaSelectEvent";
 export * from "./events/AgenticaTextEvent";
+export * from "./events/AgenticaValidateEvent";
+
 export * as factory from "./factory";
 
 export * from "./functional/assertHttpLlmApplication";
@@ -26,7 +28,9 @@ export * from "./json/IAgenticaOperationSelectionJson";
 export * from "./json/IAgenticaPromptJson";
 
 export * from "./json/IAgenticaTokenUsageJson";
+
 export * as orchestrate from "./orchestrate";
+
 export * from "./prompts/AgenticaCancelPrompt";
 export * from "./prompts/AgenticaDescribePrompt";
 export * from "./prompts/AgenticaExecutePrompt";
@@ -41,3 +45,8 @@ export * from "./structures/IAgenticaProps";
 export * from "./structures/IAgenticaSystemPrompt";
 
 export * from "./structures/IAgenticaVendor";
+
+/**
+ * @internal
+ */
+export * as utils from "./utils";

package/src/orchestrate/{ChatGptCallFunctionAgent.ts → call.ts}

@@ -19,18 +19,17 @@ import type { AgenticaTextPrompt } from "../prompts/AgenticaTextPrompt";
 import type { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
 import type { AgenticaCallEvent } from "../events/AgenticaCallEvent";
 
-import { AgenticaConstant } from "../internal/AgenticaConstant";
-import { AgenticaDefaultPrompt } from "../internal/AgenticaDefaultPrompt";
-import { AgenticaSystemPrompt } from "../internal/AgenticaSystemPrompt";
-import { StreamUtil } from "../internal/StreamUtil";
-import { ChatGptCancelFunctionAgent } from "./ChatGptCancelFunctionAgent";
-import { ChatGptCompletionMessageUtil } from "./ChatGptCompletionMessageUtil";
-import { ChatGptHistoryDecoder } from "./ChatGptHistoryDecoder";
+import { AgenticaConstant } from "../constants/AgenticaConstant";
+import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
+import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
+import { StreamUtil } from "../utils/StreamUtil";
+import { ChatGptCompletionMessageUtil } from "../utils/ChatGptCompletionMessageUtil";
 import { createCallEvent, createCancelEvent, createExecuteEvent, createTextEvent, createValidateEvent } from "../factory/events";
 import { createOperationSelection } from "../factory/operations";
-import { createCancelPrompt, createExecutePrompt, createTextPrompt } from "../factory/prompts";
+import { createCancelPrompt, createExecutePrompt, createTextPrompt, decodePrompt } from "../factory/prompts";
+import { cancelFunction } from "./internal/cancelFunction";
 
-async function execute<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>): Promise<AgenticaPrompt<Model>[]> {
+export async function call<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>): Promise<AgenticaPrompt<Model>[]> {
   // ----
   // EXECUTE CHATGPT API
   // ----
@@ -42,7 +41,7 @@ async function execute<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Mode
           content: AgenticaDefaultPrompt.write(ctx.config),
         } satisfies OpenAI.ChatCompletionSystemMessageParam,
         // PREVIOUS HISTORIES
-        ...ctx.histories.map(ChatGptHistoryDecoder.decode).flat(),
+        ...ctx.histories.map(decodePrompt).flat(),
         // USER INPUT
         {
           role: "user",
@@ -137,7 +136,7 @@ async function execute<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Mode
               }),
             );
 
-            await ChatGptCancelFunctionAgent.cancelFunction(ctx, {
+            await cancelFunction(ctx, {
               name: call.operation.name,
               reason: "completed",
             });
@@ -369,7 +368,7 @@ async function correct<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Mode
           content: AgenticaDefaultPrompt.write(ctx.config),
         } satisfies OpenAI.ChatCompletionSystemMessageParam,
         // PREVIOUS HISTORIES
-        ...ctx.histories.map(ChatGptHistoryDecoder.decode).flat(),
+        ...ctx.histories.map(decodePrompt).flat(),
         // USER INPUT
         {
           role: "user",
@@ -496,7 +495,3 @@ function isObject($defs: Record<string, IChatGptSchema>, schema: IChatGptSchema)
       && schema.anyOf.every(schema => isObject($defs, schema)))
   );
 }
-
-export const ChatGptCallFunctionAgent = {
-  execute,
-};

package/src/orchestrate/{ChatGptCancelFunctionAgent.ts → cancel.ts}

@@ -12,15 +12,13 @@ import type { AgenticaEvent } from "../events/AgenticaEvent";
 import type { AgenticaCancelPrompt } from "../context/AgenticaCancelPrompt";
 import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
 
-import { AgenticaConstant } from "../internal/AgenticaConstant";
-import { AgenticaDefaultPrompt } from "../internal/AgenticaDefaultPrompt";
-import { AgenticaSystemPrompt } from "../internal/AgenticaSystemPrompt";
-import { StreamUtil } from "../internal/StreamUtil";
-import { ChatGptCompletionMessageUtil } from "./ChatGptCompletionMessageUtil";
-import { ChatGptHistoryDecoder } from "./ChatGptHistoryDecoder";
-import { createCancelPrompt } from "../factory/prompts";
-import { createCancelEvent } from "../factory/events";
-import { createOperationSelection } from "../factory/operations";
+import { AgenticaConstant } from "../constants/AgenticaConstant";
+import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
+import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
+import { StreamUtil } from "../utils/StreamUtil";
+import { ChatGptCompletionMessageUtil } from "../utils/ChatGptCompletionMessageUtil";
+import { createCancelPrompt, decodePrompt } from "../factory/prompts";
+import { cancelFunction } from "./internal/cancelFunction";
 
 const CONTAINER: ILlmApplication<"chatgpt"> = typia.llm.application<
   __IChatCancelFunctionsApplication,
@@ -33,7 +31,7 @@ interface IFailure {
   validation: IValidation.IFailure;
 }
 
-async function execute<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>): Promise<AgenticaCancelPrompt<Model>[]> {
+export async function cancel<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>): Promise<AgenticaCancelPrompt<Model>[]> {
   if (ctx.operations.divided === undefined) {
     return step(ctx, ctx.operations.array, 0);
   }
@@ -94,27 +92,6 @@ async function execute<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Mode
   return [collection];
 }
 
-async function cancelFunction<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>, reference: __IChatFunctionReference): Promise<AgenticaOperationSelection<Model> | null> {
-  const index: number = ctx.stack.findIndex(
-    item => item.operation.name === reference.name,
-  );
-  if (index === -1) {
-    return null;
-  }
-
-  const item: AgenticaOperationSelection<Model> = ctx.stack[index]!;
-  ctx.stack.splice(index, 1);
-  await ctx.dispatch(
-    createCancelEvent({
-      selection: createOperationSelection({
-        operation: item.operation,
-        reason: reference.reason,
-      }),
-    }),
-  );
-  return item;
-}
-
 async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>, operations: AgenticaOperation<Model>[], retry: number, failures?: IFailure[]): Promise<AgenticaCancelPrompt<Model>[]> {
   // ----
   // EXECUTE CHATGPT API
@@ -158,7 +135,7 @@ async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>,
           ),
         },
         // PREVIOUS HISTORIES
-        ...ctx.histories.map(ChatGptHistoryDecoder.decode).flat(),
+        ...ctx.histories.map(decodePrompt).flat(),
         // USER INPUT
         {
           role: "user",
@@ -299,8 +276,3 @@ function emendMessages(failures: IFailure[]): OpenAI.ChatCompletionMessageParam[
     ])
     .flat();
 }
-
-export const ChatGptCancelFunctionAgent = {
-  execute,
-  cancelFunction,
-};

package/src/orchestrate/{ChatGptDescribeFunctionAgent.ts → describe.ts}

@@ -4,16 +4,15 @@ import type { AgenticaContext } from "../context/AgenticaContext";
 import type { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
 import type { AgenticaDescribePrompt } from "../prompts/AgenticaDescribePrompt";
 
-import { AgenticaDefaultPrompt } from "../internal/AgenticaDefaultPrompt";
-import { AgenticaSystemPrompt } from "../internal/AgenticaSystemPrompt";
-import { MPSC } from "../internal/MPSC";
-import { StreamUtil } from "../internal/StreamUtil";
-import { ChatGptCompletionMessageUtil } from "./ChatGptCompletionMessageUtil";
-import { ChatGptHistoryDecoder } from "./ChatGptHistoryDecoder";
+import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
+import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
+import { MPSC } from "../utils/MPSC";
+import { StreamUtil } from "../utils/StreamUtil";
+import { ChatGptCompletionMessageUtil } from "../utils/ChatGptCompletionMessageUtil";
 import { createDescribeEvent } from "../factory/events";
-import { createDescribePrompt } from "../factory/prompts";
+import { createDescribePrompt, decodePrompt } from "../factory/prompts";
 
-async function execute<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>, histories: AgenticaExecutePrompt<Model>[]): Promise<AgenticaDescribePrompt<Model>[]> {
+export async function describe<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>, histories: AgenticaExecutePrompt<Model>[]): Promise<AgenticaDescribePrompt<Model>[]> {
   if (histories.length === 0) {
     return [];
   }
@@ -26,7 +25,7 @@ async function execute<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Mode
         content: AgenticaDefaultPrompt.write(ctx.config),
       } satisfies OpenAI.ChatCompletionSystemMessageParam,
       // FUNCTION CALLING HISTORIES
-      ...histories.map(ChatGptHistoryDecoder.decode).flat(),
+      ...histories.map(decodePrompt).flat(),
       // SYSTEM PROMPT
       {
         role: "system",
@@ -123,5 +122,5 @@ async function execute<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Mode
 }
 
 export const ChatGptDescribeFunctionAgent = {
-  execute,
+  execute: describe,
 };

package/src/orchestrate/{ChatGptAgent.ts → execute.ts}

@@ -4,14 +4,15 @@ import type { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
 import type { AgenticaPrompt } from "../prompts/AgenticaPrompt";
 import type { IAgenticaExecutor } from "../structures/IAgenticaExecutor";
 
-import { ChatGptCallFunctionAgent } from "./ChatGptCallFunctionAgent";
-import { ChatGptCancelFunctionAgent } from "./ChatGptCancelFunctionAgent";
-import { ChatGptDescribeFunctionAgent } from "./ChatGptDescribeFunctionAgent";
-import { ChatGptInitializeFunctionAgent } from "./ChatGptInitializeFunctionAgent";
-import { ChatGptSelectFunctionAgent } from "./ChatGptSelectFunctionAgent";
+import { describe } from "./describe";
+import { cancel } from "./cancel";
+import { call } from "./call";
+import { cancelFunction } from "./internal/cancelFunction";
+import { initialize } from "./initialize";
+import { select } from "./select";
 
-export const ChatGptAgent = {
-  execute: <Model extends ILlmSchema.Model>(executor: Partial<IAgenticaExecutor<Model>> | null) => async (ctx: AgenticaContext<Model>): Promise<AgenticaPrompt<Model>[]> => {
+export function execute<Model extends ILlmSchema.Model>(executor: Partial<IAgenticaExecutor<Model>> | null) {
+  return async (ctx: AgenticaContext<Model>): Promise<AgenticaPrompt<Model>[]> => {
     const histories: AgenticaPrompt<Model>[] = [];
 
     // FUNCTIONS ARE NOT LISTED YET
@@ -22,7 +23,7 @@ export const ChatGptAgent = {
       else {
         histories.push(
           ...(await (
-            executor?.initialize ?? ChatGptInitializeFunctionAgent.execute
+            executor?.initialize ?? initialize
           )(ctx)),
         );
         if (ctx.ready() === false) {
@@ -34,7 +35,7 @@ export const ChatGptAgent = {
     // CANCEL CANDIDATE FUNCTIONS
     if (ctx.stack.length !== 0) {
       histories.push(
-        ...(await (executor?.cancel ?? ChatGptCancelFunctionAgent.execute)(
+        ...(await (executor?.cancel ?? cancel)(
           ctx,
         )),
       );
@@ -42,7 +43,7 @@ export const ChatGptAgent = {
 
     // SELECT CANDIDATE FUNCTIONS
     histories.push(
-      ...(await (executor?.select ?? ChatGptSelectFunctionAgent.execute)(
+      ...(await (executor?.select ?? select)(
         ctx,
       )),
     );
@@ -54,7 +55,7 @@ export const ChatGptAgent = {
     while (true) {
       // EXECUTE FUNCTIONS
       const prompts: AgenticaPrompt<Model>[] = await (
-        executor?.call ?? ChatGptCallFunctionAgent.execute
+        executor?.call ?? call
       )(ctx);
       histories.push(...prompts);
 
@@ -63,14 +64,14 @@ export const ChatGptAgent = {
         prompt => prompt.type === "execute",
       );
       for (const e of executes) {
-        await ChatGptCancelFunctionAgent.cancelFunction(ctx, {
+        await cancelFunction(ctx, {
           reason: "completed",
           name: e.operation.name,
         });
       }
       histories.push(
         ...(await (
-          executor?.describe ?? ChatGptDescribeFunctionAgent.execute
+          executor?.describe ?? describe
         )(ctx, executes)),
       );
       if (executes.length === 0 || ctx.stack.length === 0) {
@@ -78,5 +79,5 @@ export const ChatGptAgent = {
       }
     }
     return histories;
-  },
-};
+  };
+}

package/src/orchestrate/index.ts

@@ -1,8 +1,6 @@
-export * from "./ChatGptAgent";
-export * from "./ChatGptCallFunctionAgent";
-export * from "./ChatGptCancelFunctionAgent";
-export * from "./ChatGptCompletionMessageUtil";
-export * from "./ChatGptDescribeFunctionAgent";
-export * from "./ChatGptHistoryDecoder";
-export * from "./ChatGptInitializeFunctionAgent";
-export * from "./ChatGptSelectFunctionAgent";
+export * from "./call";
+export * from "./cancel";
+export * from "./describe";
+export * from "./execute";
+export * from "./initialize";
+export * from "./select";

package/src/orchestrate/{ChatGptInitializeFunctionAgent.ts → initialize.ts}

@@ -6,21 +6,20 @@ import type { AgenticaContext } from "../context/AgenticaContext";
 import type { __IChatInitialApplication } from "../context/internal/__IChatInitialApplication";
 import type { AgenticaPrompt } from "../prompts/AgenticaPrompt";
 
-import { AgenticaDefaultPrompt } from "../internal/AgenticaDefaultPrompt";
-import { AgenticaSystemPrompt } from "../internal/AgenticaSystemPrompt";
-import { MPSC } from "../internal/MPSC";
-import { StreamUtil } from "../internal/StreamUtil";
-import { ChatGptCompletionMessageUtil } from "./ChatGptCompletionMessageUtil";
-import { ChatGptHistoryDecoder } from "./ChatGptHistoryDecoder";
+import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
+import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
+import { MPSC } from "../utils/MPSC";
+import { StreamUtil } from "../utils/StreamUtil";
+import { ChatGptCompletionMessageUtil } from "../utils/ChatGptCompletionMessageUtil";
 import { createTextEvent } from "../factory/events";
-import { createTextPrompt } from "../factory/prompts";
+import { createTextPrompt, decodePrompt } from "../factory/prompts";
 
 const FUNCTION: ILlmFunction<"chatgpt"> = typia.llm.application<
   __IChatInitialApplication,
   "chatgpt"
 >().functions[0]!;
 
-async function execute<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>): Promise<AgenticaPrompt<Model>[]> {
+export async function initialize<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>): Promise<AgenticaPrompt<Model>[]> {
   // ----
   // EXECUTE CHATGPT API
   // ----
@@ -32,7 +31,7 @@ async function execute<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Mode
           content: AgenticaDefaultPrompt.write(ctx.config),
         } satisfies OpenAI.ChatCompletionSystemMessageParam,
         // PREVIOUS HISTORIES
-        ...ctx.histories.map(ChatGptHistoryDecoder.decode).flat(),
+        ...ctx.histories.map(decodePrompt).flat(),
         // USER INPUT
         {
           role: "user",
@@ -164,7 +163,3 @@ async function execute<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Mode
 
   return prompts;
 }
-
-export const ChatGptInitializeFunctionAgent = {
-  execute,
-};

package/src/orchestrate/internal/cancelFunction.ts

@@ -0,0 +1,34 @@
+import type { ILlmSchema } from "@samchon/openapi";
+import type { AgenticaOperationSelection } from "../../context/AgenticaOperationSelection";
+import type { AgenticaContext } from "../../context/AgenticaContext";
+import type { __IChatFunctionReference } from "../../context/internal/__IChatFunctionReference";
+
+import { createCancelEvent } from "../../factory/events";
+import { createOperationSelection } from "../../factory/operations";
+
+/**
+ * @internal
+ */
+export async function cancelFunction<Model extends ILlmSchema.Model>(
+  ctx: AgenticaContext<Model>,
+  reference: __IChatFunctionReference,
+): Promise<AgenticaOperationSelection<Model> | null> {
+  const index: number = ctx.stack.findIndex(
+    item => item.operation.name === reference.name,
+  );
+  if (index === -1) {
+    return null;
+  }
+
+  const item: AgenticaOperationSelection<Model> = ctx.stack[index]!;
+  ctx.stack.splice(index, 1);
+  await ctx.dispatch(
+    createCancelEvent({
+      selection: createOperationSelection({
+        operation: item.operation,
+        reason: reference.reason,
+      }),
+    }),
+  );
+  return item;
+}