@agentica/core 0.34.2 → 0.35.0

package/src/structures/IAgenticaController.ts

@@ -5,7 +5,6 @@ import type {
   IHttpResponse,
   ILlmApplication,
   ILlmFunction,
-  ILlmSchema,
   IMcpLlmApplication,
 } from "@samchon/openapi";
 
@@ -25,10 +24,10 @@ import type {
  *
  * @author Samchon
  */
-export type IAgenticaController<Model extends ILlmSchema.Model> =
-  | IAgenticaController.IHttp<Model>
-  | IAgenticaController.IClass<Model>
-  | IAgenticaController.IMcp<Model>;
+export type IAgenticaController =
+  | IAgenticaController.IHttp
+  | IAgenticaController.IClass
+  | IAgenticaController.IMcp;
 
 export namespace IAgenticaController {
   /**
@@ -37,8 +36,7 @@ export namespace IAgenticaController {
    * You can make it by {@link validateHttpLlmApplication} function with
    * the Swagger or OpenAPI document.
    */
-  export interface IHttp<Model extends ILlmSchema.Model>
-    extends IBase<"http", IHttpLlmApplication<Model>> {
+  export interface IHttp extends IBase<"http", IHttpLlmApplication> {
     /**
      * Connection to the server.
      *
@@ -61,12 +59,12 @@ export namespace IAgenticaController {
       /**
        * Application schema.
        */
-      application: IHttpLlmApplication<Model>;
+      application: IHttpLlmApplication;
 
       /**
        * Function schema.
        */
-      function: IHttpLlmFunction<Model>;
+      function: IHttpLlmFunction;
 
       /**
        * Arguments of the function calling.
@@ -89,8 +87,7 @@ export namespace IAgenticaController {
    *
    * - https://typia.io/docs/llm/application
    */
-  export interface IClass<Model extends ILlmSchema.Model>
-    extends IBase<"class", ILlmApplication<Model>> {
+  export interface IClass extends IBase<"class", ILlmApplication> {
     /**
      * Executor of the class function.
      *
@@ -104,12 +101,12 @@ export namespace IAgenticaController {
         /**
          * Target application schema.
          */
-        application: ILlmApplication<Model>;
+        application: ILlmApplication;
 
         /**
          * Target function schema.
          */
-        function: ILlmFunction<Model>;
+        function: ILlmFunction;
 
         /**
          * Arguments of the function calling.
@@ -121,7 +118,7 @@ export namespace IAgenticaController {
   /**
    * MCP Server controller.
    */
-  export interface IMcp<Model extends ILlmSchema.Model> extends IBase<"mcp", IMcpLlmApplication<Model>> {
+  export interface IMcp extends IBase<"mcp", IMcpLlmApplication> {
     /**
      * MCP client for connection.
      *

package/src/structures/IAgenticaExecutor.ts

@@ -1,5 +1,3 @@
-import type { ILlmSchema } from "@samchon/openapi";
-
 import type { AgenticaContext } from "../context/AgenticaContext";
 import type { AgenticaOperation } from "../context/AgenticaOperation";
 import type { AgenticaExecuteEvent } from "../events/AgenticaExecuteEvent";
@@ -27,7 +25,7 @@ import type { AgenticaExecuteEvent } from "../events/AgenticaExecuteEvent";
  * @reference https://github.com/wrtnlabs/agentica/blob/main/packages/core/src/orchestrate/execute.ts
  * @author Samchon
  */
-export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
+export interface IAgenticaExecutor {
   /**
    * Initializer agent listing up functions.
    *
@@ -60,7 +58,7 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
   initialize:
     | boolean
     | null
-    | ((ctx: AgenticaContext<Model>) => Promise<void>);
+    | ((ctx: AgenticaContext) => Promise<void>);
 
   /**
    * Function selector agent.
@@ -89,7 +87,7 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
    * @param ctx Context of the agent
    * @returns List of prompts generated by the selector
    */
-  select: (ctx: AgenticaContext<Model>) => Promise<void>;
+  select: (ctx: AgenticaContext) => Promise<void>;
 
   /**
    * Function caller agent.
@@ -118,9 +116,9 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
    *          applied to all domain fields.
    */
   call: (
-    ctx: AgenticaContext<Model>,
-    operations: AgenticaOperation<Model>[],
-  ) => Promise<AgenticaExecuteEvent<Model>[]>;
+    ctx: AgenticaContext,
+    operations: AgenticaOperation[],
+  ) => Promise<AgenticaExecuteEvent[]>;
 
   /**
    * Describer agent of the function calling result.
@@ -139,8 +137,8 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
     | boolean
     | null
     | ((
-      ctx: AgenticaContext<Model>,
-      executes: AgenticaExecuteEvent<Model>[],
+      ctx: AgenticaContext,
+      executes: AgenticaExecuteEvent[],
     ) => Promise<void>);
 
   /**
@@ -165,5 +163,5 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
    * @param ctx Context of the agent
    * @returns List of prompts generated by the canceler
    */
-  cancel: (ctx: AgenticaContext<Model>) => Promise<void>;
+  cancel: (ctx: AgenticaContext) => Promise<void>;
 }

package/src/structures/IAgenticaProps.ts

@@ -1,5 +1,3 @@
-import type { ILlmSchema } from "@samchon/openapi";
-
 import type { AgenticaTokenUsage } from "../context/AgenticaTokenUsage";
 import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
 import type { IAgenticaTokenUsageJson } from "../json/IAgenticaTokenUsageJson";
@@ -29,12 +27,7 @@ import type { IAgenticaVendor } from "./IAgenticaVendor";
  *
  * @author Samchon
  */
-export interface IAgenticaProps<Model extends ILlmSchema.Model> {
-  /**
-   * LLM schema model.
-   */
-  model: Model;
-
+export interface IAgenticaProps {
   /**
    * LLM service vendor.
    */
@@ -43,7 +36,7 @@ export interface IAgenticaProps<Model extends ILlmSchema.Model> {
   /**
    * Controllers serving functions to call.
    */
-  controllers: IAgenticaController<Model>[];
+  controllers: IAgenticaController[];
 
   /**
    * Configuration of agent.
@@ -60,7 +53,7 @@ export interface IAgenticaProps<Model extends ILlmSchema.Model> {
    * - `systemPrompt`: default prompts written in markdown
    *   - https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts
    */
-  config?: IAgenticaConfig<Model>;
+  config?: IAgenticaConfig;
 
   /**
    * Prompt histories.

package/src/structures/IAgenticaSystemPrompt.ts

@@ -1,5 +1,3 @@
-import type { ILlmSchema } from "@samchon/openapi";
-
 import type { AgenticaJsonParseErrorEvent } from "../events";
 import type { AgenticaValidateEvent } from "../events/AgenticaValidateEvent";
 import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
@@ -25,7 +23,7 @@ import type { IAgenticaConfig } from "./IAgenticaConfig";
  *
  * @author Samchon
  */
-export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
+export interface IAgenticaSystemPrompt {
   /**
    * Common system prompt that would be used in every situation.
    *
@@ -38,7 +36,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    * @returns The common system prompt
    * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/common.md
    */
-  common?: (config?: IAgenticaConfig<Model> | undefined) => string;
+  common?: (config?: IAgenticaConfig | undefined) => string;
 
   /**
    * Initialize system prompt.
@@ -63,7 +61,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    * @returns initialize system prompt
    * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/initialize.md
    */
-  initialize?: (histories: AgenticaHistory<Model>[]) => string;
+  initialize?: (histories: AgenticaHistory[]) => string;
 
   /**
    * Select system prompt.
@@ -91,7 +89,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    * @returns select system prompt
    * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/select.md
    */
-  select?: (histories: AgenticaHistory<Model>[]) => string;
+  select?: (histories: AgenticaHistory[]) => string;
 
   /**
    * Cancel system prompt.
@@ -113,7 +111,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    * @returns cancel system prompt
    * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/cancel.md
    */
-  cancel?: (histories: AgenticaHistory<Model>[]) => string;
+  cancel?: (histories: AgenticaHistory[]) => string;
 
   /**
    * Execute system prompt.
@@ -140,7 +138,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    * @returns execute system prompt
    * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/execute.md
    */
-  execute?: (histories: AgenticaHistory<Model>[]) => string;
+  execute?: (histories: AgenticaHistory[]) => string;
 
   /**
    * Validation feedback system prompt.
@@ -173,7 +171,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    * @returns validation feedback system prompt
    * @default Built-in validation feedback prompt optimized for typia IValidation.IFailure processing
    */
-  validate?: (events: AgenticaValidateEvent<Model>[]) => string;
+  validate?: (events: AgenticaValidateEvent[]) => string;
 
   /**
    * JSON parsing error system prompt.
@@ -204,7 +202,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    * @returns JSON parse error system prompt
    * @default Built-in JSON parse error prompt optimized for syntax correction
    */
-  jsonParseError?: (event: AgenticaJsonParseErrorEvent<Model>) => string;
+  jsonParseError?: (event: AgenticaJsonParseErrorEvent) => string;
 
   /**
    * Describe system prompt.
@@ -234,5 +232,5 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    * @returns describe system prompt
    * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/describe.md
    */
-  describe?: (histories: AgenticaExecuteHistory<Model>[]) => string;
+  describe?: (histories: AgenticaExecuteHistory[]) => string;
 }

package/src/structures/IMicroAgenticaConfig.ts

@@ -1,5 +1,3 @@
-import type { ILlmSchema } from "@samchon/openapi";
-
 import type { IMicroAgenticaExecutor } from "./IMicroAgenticaExecutor";
 import type { IMicroAgenticaSystemPrompt } from "./IMicroAgenticaSystemPrompt";
 
@@ -13,7 +11,7 @@ import type { IMicroAgenticaSystemPrompt } from "./IMicroAgenticaSystemPrompt";
  *
  * @author Samchon
  */
-export interface IMicroAgenticaConfig<Model extends ILlmSchema.Model> {
+export interface IMicroAgenticaConfig {
   /**
    * Agent executor.
    *
@@ -31,7 +29,7 @@ export interface IMicroAgenticaConfig<Model extends ILlmSchema.Model> {
    */
   executor?:
     | undefined
-    | Partial<IMicroAgenticaExecutor<Model>>;
+    | Partial<IMicroAgenticaExecutor>;
 
   /**
    * System prompt messages.
@@ -39,7 +37,7 @@ export interface IMicroAgenticaConfig<Model extends ILlmSchema.Model> {
    * System prompt messages if you want to customize the system prompt
    * messages for each situation.
    */
-  systemPrompt?: IMicroAgenticaSystemPrompt<Model>;
+  systemPrompt?: IMicroAgenticaSystemPrompt;
 
   /**
    * Locale of the A.I. chatbot.

package/src/structures/IMicroAgenticaExecutor.ts

@@ -1,5 +1,3 @@
-import type { ILlmSchema } from "@samchon/openapi";
-
 import type { MicroAgenticaContext } from "../context/MicroAgenticaContext";
 import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
 
@@ -17,7 +15,7 @@ import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory
  *
  * @author Samchon
  */
-export interface IMicroAgenticaExecutor<Model extends ILlmSchema.Model> {
+export interface IMicroAgenticaExecutor {
   /**
    * Function caller agent.
    *
@@ -43,7 +41,7 @@ export interface IMicroAgenticaExecutor<Model extends ILlmSchema.Model> {
    *          agent is the most general topic which can be universally
    *          applied to all domain fields.
    */
-  call: (ctx: MicroAgenticaContext<Model>) => Promise<AgenticaExecuteHistory<Model>[]>;
+  call: (ctx: MicroAgenticaContext) => Promise<AgenticaExecuteHistory[]>;
 
   /**
    * Describer agent of the function calling result.
@@ -62,7 +60,7 @@ export interface IMicroAgenticaExecutor<Model extends ILlmSchema.Model> {
     | boolean
     | null
     | ((
-      ctx: MicroAgenticaContext<Model>,
-      executes: AgenticaExecuteHistory<Model>[],
+      ctx: MicroAgenticaContext,
+      executes: AgenticaExecuteHistory[],
     ) => Promise<void>);
 }

package/src/structures/IMicroAgenticaProps.ts

@@ -1,5 +1,3 @@
-import type { ILlmSchema } from "@samchon/openapi";
-
 import type { AgenticaTokenUsage } from "../context/AgenticaTokenUsage";
 import type { IAgenticaTokenUsageJson } from "../json/IAgenticaTokenUsageJson";
 import type { IMicroAgenticaHistoryJson } from "../json/IMicroAgenticaHistoryJson";
@@ -29,12 +27,7 @@ import type { IMicroAgenticaConfig } from "./IMicroAgenticaConfig";
  *
  * @author Samchon
  */
-export interface IMicroAgenticaProps<Model extends ILlmSchema.Model> {
-  /**
-   * LLM schema model.
-   */
-  model: Model;
-
+export interface IMicroAgenticaProps {
   /**
    * LLM service vendor.
    */
@@ -43,7 +36,7 @@ export interface IMicroAgenticaProps<Model extends ILlmSchema.Model> {
   /**
    * Controllers serving functions to call.
    */
-  controllers: IAgenticaController<Model>[];
+  controllers: IAgenticaController[];
 
   /**
    * Configuration of agent.
@@ -60,7 +53,7 @@ export interface IMicroAgenticaProps<Model extends ILlmSchema.Model> {
    * - `systemPrompt`: default prompts written in markdown
    *   - https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts
    */
-  config?: IMicroAgenticaConfig<Model>;
+  config?: IMicroAgenticaConfig;
 
   /**
    * Prompt histories.

package/src/structures/IMicroAgenticaSystemPrompt.ts

@@ -1,5 +1,3 @@
-import type { ILlmSchema } from "@samchon/openapi";
-
 import type { AgenticaJsonParseErrorEvent } from "../events/AgenticaJsonParseErrorEvent";
 import type { AgenticaValidateEvent } from "../events/AgenticaValidateEvent";
 import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
@@ -26,7 +24,7 @@ import type { IMicroAgenticaConfig } from "./IMicroAgenticaConfig";
  *
  * @author Samchon
  */
-export interface IMicroAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
+export interface IMicroAgenticaSystemPrompt {
   /**
    * Common system prompt that would be used in every situation.
    *
@@ -41,7 +39,7 @@ export interface IMicroAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    * @returns The common system prompt
    * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/common.md
    */
-  common?: (config?: IMicroAgenticaConfig<Model> | undefined) => string;
+  common?: (config?: IMicroAgenticaConfig | undefined) => string;
 
   /**
    * Execute system prompt.
@@ -72,7 +70,7 @@ export interface IMicroAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    * @returns execute system prompt
    * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/execute.md
    */
-  execute?: null | ((histories: MicroAgenticaHistory<Model>[]) => string);
+  execute?: null | ((histories: MicroAgenticaHistory[]) => string);
 
   /**
    * Validation feedback system prompt.
@@ -106,7 +104,7 @@ export interface IMicroAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    * @returns validation feedback system prompt
    * @default Built-in validation feedback prompt optimized for typia IValidation.IFailure processing
    */
-  validate?: (events: AgenticaValidateEvent<Model>[]) => string;
+  validate?: (events: AgenticaValidateEvent[]) => string;
 
   /**
    * JSON parsing error system prompt.
@@ -137,7 +135,7 @@ export interface IMicroAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    * @returns JSON parse error system prompt
    * @default Built-in JSON parse error prompt optimized for syntax correction
    */
-  jsonParseError?: (event: AgenticaJsonParseErrorEvent<Model>) => string;
+  jsonParseError?: (event: AgenticaJsonParseErrorEvent) => string;
 
   /**
    * Describe system prompt.
@@ -167,5 +165,5 @@ export interface IMicroAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    * @returns describe system prompt
    * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/describe.md
    */
-  describe?: (histories: AgenticaExecuteHistory<Model>[]) => string;
+  describe?: (histories: AgenticaExecuteHistory[]) => string;
 }

package/src/transformers/transformHistory.ts

@@ -1,5 +1,3 @@
-import type { ILlmSchema } from "@samchon/openapi";
-
 import type { AgenticaOperation } from "../context/AgenticaOperation";
 import type { AgenticaUserMessageHistory } from "../histories";
 import type { AgenticaAssistantMessageHistory } from "../histories/AgenticaAssistantMessageHistory";
@@ -17,10 +15,10 @@ import { createOperationSelection } from "../factory/operations";
 /**
  * @internal
  */
-export function transformHistory<Model extends ILlmSchema.Model>(props: {
-  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+export function transformHistory(props: {
+  operations: Map<string, Map<string, AgenticaOperation>>;
   history: IAgenticaHistoryJson;
-}): AgenticaHistory<Model> {
+}): AgenticaHistory {
   // USER
   if (props.history.type === "userMessage") {
     return transformUserMessage({
@@ -83,10 +81,10 @@ function transformUserMessage(props: {
   return createUserMessageHistory(props.history);
 }
 
-function transformSelect<Model extends ILlmSchema.Model>(props: {
-  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+function transformSelect(props: {
+  operations: Map<string, Map<string, AgenticaOperation>>;
   history: IAgenticaHistoryJson.ISelect;
-}): AgenticaSelectHistory<Model> {
+}): AgenticaSelectHistory {
   return createSelectHistory({
     id: props.history.id,
     created_at: props.history.created_at,
@@ -100,10 +98,10 @@ function transformSelect<Model extends ILlmSchema.Model>(props: {
   });
 }
 
-function transformCancel<Model extends ILlmSchema.Model>(props: {
-  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+function transformCancel(props: {
+  operations: Map<string, Map<string, AgenticaOperation>>;
   history: IAgenticaHistoryJson.ICancel;
-}): AgenticaCancelHistory<Model> {
+}): AgenticaCancelHistory {
   return createCancelHistory({
     id: props.history.id,
     created_at: props.history.created_at,
@@ -117,10 +115,10 @@ function transformCancel<Model extends ILlmSchema.Model>(props: {
   });
 }
 
-function transformExecute<Model extends ILlmSchema.Model>(props: {
-  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+function transformExecute(props: {
+  operations: Map<string, Map<string, AgenticaOperation>>;
   history: IAgenticaHistoryJson.IExecute;
-}): AgenticaExecuteHistory<Model> {
+}): AgenticaExecuteHistory {
   return createExecuteHistory({
     id: props.history.id,
     created_at: props.history.created_at,
@@ -138,10 +136,10 @@ function transformExecute<Model extends ILlmSchema.Model>(props: {
   });
 }
 
-function transformDescribe<Model extends ILlmSchema.Model>(props: {
-  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+function transformDescribe(props: {
+  operations: Map<string, Map<string, AgenticaOperation>>;
   history: IAgenticaHistoryJson.IDescribe;
-}): AgenticaDescribeHistory<Model> {
+}): AgenticaDescribeHistory {
   return createDescribeHistory({
     id: props.history.id,
     created_at: props.history.created_at,
@@ -155,14 +153,14 @@ function transformDescribe<Model extends ILlmSchema.Model>(props: {
   });
 }
 
-function findOperation<Model extends ILlmSchema.Model>(props: {
-  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+function findOperation(props: {
+  operations: Map<string, Map<string, AgenticaOperation>>;
   input: {
     controller: string;
     function: string;
   };
-}): AgenticaOperation<Model> {
-  const found: AgenticaOperation<Model> | undefined = props.operations
+}): AgenticaOperation {
+  const found: AgenticaOperation | undefined = props.operations
     .get(props.input.controller)
     ?.get(props.input.function);
   if (found === undefined) {

package/src/utils/ChatGptCompletionStreamingUtil.spec.ts

@@ -301,14 +301,13 @@ describe("reduceStreamingWithDispatch", () => {
       const streamedContent: string[] = [];
       await new Promise(async (resolve) => {
         const eventProcessor = vi.fn(({ stream: contentStream }) => {
-          (async () => {
+          void (async () => {
             for await (const content of contentStream) {
-              streamedContent.push(content);
+              streamedContent.push(content as string);
             }
             resolve(true);
-          })();
+          })().catch(() => {});
         });
-
         await reduceStreamingWithDispatch(stream, eventProcessor);
       });
       expect(streamedContent).toEqual(["Hello", " World"]);
@@ -895,7 +894,7 @@ describe("reduceStreamingWithDispatch", () => {
 
       const stream = new ReadableStream<ChatCompletionChunk>({
         start(controller) {
-          controller.enqueue(malformedChunk);
+          controller.enqueue(malformedChunk as ChatCompletionChunk);
           controller.close();
         },
       });

package/src/utils/request.ts

@@ -1,4 +1,3 @@
-import type { ILlmSchema } from "@samchon/openapi";
 import type OpenAI from "openai";
 
 import { v4 } from "uuid";
@@ -13,9 +12,9 @@ import { createRequestEvent } from "../factory";
 import { ChatGptCompletionMessageUtil } from "./ChatGptCompletionMessageUtil";
 import { streamDefaultReaderToAsyncGenerator, StreamUtil } from "./StreamUtil";
 
-export function getChatCompletionWithStreamingFunction<Model extends ILlmSchema.Model>(props: {
+export function getChatCompletionWithStreamingFunction(props: {
   vendor: IAgenticaVendor;
-  config?: IAgenticaConfig<Model> | IMicroAgenticaConfig<Model>;
+  config?: IAgenticaConfig | IMicroAgenticaConfig;
   dispatch: (event: AgenticaRequestEvent | AgenticaResponseEvent) => Promise<void>;
   abortSignal?: AbortSignal;
   usage: AgenticaTokenUsage;