@agentica/core 0.8.3 → 0.9.0-dev.20250302

package/lib/structures/IAgenticaExecutor.d.ts

@@ -1,3 +1,4 @@
+import { ILlmSchema } from "@samchon/openapi";
 import { IAgenticaContext } from "./IAgenticaContext";
 import { IAgenticaPrompt } from "./IAgenticaPrompt";
 /**
@@ -23,7 +24,7 @@ import { IAgenticaPrompt } from "./IAgenticaPrompt";
  * @reference https://github.com/wrtnlabs/agentica/blob/main/packages/agent/src/chatgpt/ChatGptAgent.ts
  * @author Samchon
  */
-export interface IAgenticaExecutor {
+export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
     /**
      * Initializer agent listing up functions.
      *
@@ -52,7 +53,7 @@ export interface IAgenticaExecutor {
      * @param ctx Context of the agent
      * @returns List of prompts generated by the initializer
      */
-    initialize: null | ((ctx: IAgenticaContext) => Promise<IAgenticaPrompt[]>);
+    initialize: null | ((ctx: IAgenticaContext<Model>) => Promise<IAgenticaPrompt<Model>[]>);
     /**
      * Function selector agent.
      *
@@ -80,7 +81,7 @@ export interface IAgenticaExecutor {
      * @param ctx Context of the agent
      * @returns List of prompts generated by the selector
      */
-    select: (ctx: IAgenticaContext) => Promise<IAgenticaPrompt[]>;
+    select: (ctx: IAgenticaContext<Model>) => Promise<IAgenticaPrompt<Model>[]>;
     /**
      * Function caller agent.
      *
@@ -106,7 +107,7 @@ export interface IAgenticaExecutor {
      *          agent is the most general topic which can be universally
      *          applied to all domain fields.
      */
-    call: (ctx: IAgenticaContext) => Promise<IAgenticaPrompt[]>;
+    call: (ctx: IAgenticaContext<Model>) => Promise<IAgenticaPrompt<Model>[]>;
     /**
      * Describer agent of the function calling result.
      *
@@ -117,7 +118,7 @@ export interface IAgenticaExecutor {
      * @param executes List of function calling results
      * @returns List of prompts generated by the describer
      */
-    describe: (ctx: IAgenticaContext, executes: IAgenticaPrompt.IExecute[]) => Promise<IAgenticaPrompt[]>;
+    describe: (ctx: IAgenticaContext<Model>, executes: IAgenticaPrompt.IExecute<Model>[]) => Promise<IAgenticaPrompt<Model>[]>;
     /**
      * Function canceler agent.
      *
@@ -140,5 +141,5 @@ export interface IAgenticaExecutor {
      * @param ctx Context of the agent
      * @returns List of prompts generated by the canceler
      */
-    cancel: (ctx: IAgenticaContext) => Promise<IAgenticaPrompt[]>;
+    cancel: (ctx: IAgenticaContext<Model>) => Promise<IAgenticaPrompt<Model>[]>;
 }

package/lib/structures/IAgenticaOperation.d.ts

@@ -1,4 +1,4 @@
-import { IHttpLlmFunction } from "@samchon/openapi";
+import { IHttpLlmFunction, ILlmSchema } from "@samchon/openapi";
 import { ILlmFunctionOfValidate } from "typia";
 import { IAgenticaController } from "./IAgenticaController";
 /**
@@ -16,16 +16,16 @@ import { IAgenticaController } from "./IAgenticaController";
  *
  * @author Samchon
  */
-export type IAgenticaOperation = IAgenticaOperation.IHttp | IAgenticaOperation.IClass;
+export type IAgenticaOperation<Model extends ILlmSchema.Model> = IAgenticaOperation.IHttp<Model> | IAgenticaOperation.IClass<Model>;
 export declare namespace IAgenticaOperation {
     /**
      * HTTP API operation.
      */
-    export type IHttp = IBase<"http", IAgenticaController.IHttp, IHttpLlmFunction<"chatgpt">>;
+    export type IHttp<Model extends ILlmSchema.Model> = IBase<"http", IAgenticaController.IHttp<Model>, IHttpLlmFunction<Model>>;
     /**
      * TypeScript class operation.
      */
-    export type IClass = IBase<"class", IAgenticaController.IClass, ILlmFunctionOfValidate<"chatgpt">>;
+    export type IClass<Model extends ILlmSchema.Model> = IBase<"class", IAgenticaController.IClass<Model>, ILlmFunctionOfValidate<Model>>;
     interface IBase<Protocol, Application, Function> {
         /**
          * Protocol discriminator.

package/lib/structures/IAgenticaOperationCollection.d.ts

@@ -1,3 +1,4 @@
+import { ILlmSchema } from "@samchon/openapi";
 import { IAgenticaOperation } from "./IAgenticaOperation";
 /**
  * Collection of operations used in the Nestia Agent.
@@ -8,11 +9,11 @@ import { IAgenticaOperation } from "./IAgenticaOperation";
  *
  * @author Samchon
  */
-export interface IAgenticaOperationCollection {
+export interface IAgenticaOperationCollection<Model extends ILlmSchema.Model> {
     /**
      * List of every operations.
      */
-    array: IAgenticaOperation[];
+    array: IAgenticaOperation<Model>[];
     /**
      * Divided operations.
      *
@@ -28,13 +29,13 @@ export interface IAgenticaOperationCollection {
      * Otherwise, if the {@link IAgenticaConfig.capacity} has not been
      * configured, this `divided` property would be the `undefined` value.
      */
-    divided?: IAgenticaOperation[][] | undefined;
+    divided?: IAgenticaOperation<Model>[][] | undefined;
     /**
      * Flat dictionary of operations.
      *
      * Dictionary of operations with their {@link IAgenticaOperation.name}.
      */
-    flat: Map<string, IAgenticaOperation>;
+    flat: Map<string, IAgenticaOperation<Model>>;
     /**
      * Group dictionary of operations.
      *
@@ -42,5 +43,5 @@ export interface IAgenticaOperationCollection {
      * {@link IAgenticaOperation.controller.name} and
      * {@link IAgenticaOperation.function.name}.
      */
-    group: Map<string, Map<string, IAgenticaOperation>>;
+    group: Map<string, Map<string, IAgenticaOperation<Model>>>;
 }

package/lib/structures/IAgenticaOperationSelection.d.ts

@@ -1,4 +1,4 @@
-import { IHttpLlmFunction } from "@samchon/openapi";
+import { IHttpLlmFunction, ILlmSchema } from "@samchon/openapi";
 import { ILlmFunctionOfValidate } from "typia";
 import { IAgenticaController } from "./IAgenticaController";
 /**
@@ -14,10 +14,10 @@ import { IAgenticaController } from "./IAgenticaController";
  *
  * @author Samchon
  */
-export type IAgenticaOperationSelection = IAgenticaOperationSelection.IHttp | IAgenticaOperationSelection.IClass;
+export type IAgenticaOperationSelection<Model extends ILlmSchema.Model> = IAgenticaOperationSelection.IHttp<Model> | IAgenticaOperationSelection.IClass<Model>;
 export declare namespace IAgenticaOperationSelection {
-    export type IHttp = IBase<"http", IAgenticaController.IHttp, IHttpLlmFunction<"chatgpt">>;
-    export type IClass = IBase<"class", IAgenticaController.IClass, ILlmFunctionOfValidate<"chatgpt">>;
+    export type IHttp<Model extends ILlmSchema.Model> = IBase<"http", IAgenticaController.IHttp<Model>, IHttpLlmFunction<Model>>;
+    export type IClass<Model extends ILlmSchema.Model> = IBase<"class", IAgenticaController.IClass<Model>, ILlmFunctionOfValidate<Model>>;
     interface IBase<Protocol, Controller, Function> {
         /**
          * Discriminator protocol.

package/lib/structures/IAgenticaPrompt.d.ts

@@ -1,4 +1,4 @@
-import { IHttpLlmFunction, IHttpResponse } from "@samchon/openapi";
+import { IHttpLlmFunction, IHttpResponse, ILlmSchema } from "@samchon/openapi";
 import { ILlmFunctionOfValidate } from "typia";
 import { IAgenticaController } from "./IAgenticaController";
 import { IAgenticaOperationSelection } from "./IAgenticaOperationSelection";
@@ -18,14 +18,14 @@ import { IAgenticaOperationSelection } from "./IAgenticaOperationSelection";
  *
  * @author Samchon
  */
-export type IAgenticaPrompt = IAgenticaPrompt.IText | IAgenticaPrompt.ISelect | IAgenticaPrompt.ICancel | IAgenticaPrompt.IExecute | IAgenticaPrompt.IDescribe;
+export type IAgenticaPrompt<Model extends ILlmSchema.Model> = IAgenticaPrompt.IText | IAgenticaPrompt.ISelect<Model> | IAgenticaPrompt.ICancel<Model> | IAgenticaPrompt.IExecute<Model> | IAgenticaPrompt.IDescribe<Model>;
 export declare namespace IAgenticaPrompt {
     /**
      * Select prompt.
      *
      * Selection prompt about candidate functions to call.
      */
-    export interface ISelect extends IBase<"select"> {
+    export interface ISelect<Model extends ILlmSchema.Model> extends IBase<"select"> {
         /**
          * ID of the LLM tool call result.
          */
@@ -33,14 +33,14 @@ export declare namespace IAgenticaPrompt {
         /**
          * Operations that have been selected.
          */
-        operations: IAgenticaOperationSelection[];
+        operations: IAgenticaOperationSelection<Model>[];
     }
     /**
      * Cancel prompt.
      *
      * Cancellation prompt about the candidate functions to be discarded.
      */
-    export interface ICancel extends IBase<"cancel"> {
+    export interface ICancel<Model extends ILlmSchema.Model> extends IBase<"cancel"> {
         /**
          * ID of the LLM tool call result.
          */
@@ -48,17 +48,17 @@ export declare namespace IAgenticaPrompt {
         /**
          * Operations that have been cancelled.
          */
-        operations: IAgenticaOperationSelection[];
+        operations: IAgenticaOperationSelection<Model>[];
     }
     /**
      * Execute prompt.
      *
      * Execution prompt about the LLM function calling.
      */
-    export type IExecute = IExecute.IHttp | IExecute.IClass;
+    export type IExecute<Model extends ILlmSchema.Model> = IExecute.IHttp<Model> | IExecute.IClass<Model>;
     export namespace IExecute {
-        export type IHttp = IBase<"http", IAgenticaController.IHttp, IHttpLlmFunction<"chatgpt">, IHttpResponse>;
-        export type IClass = IBase<"class", IAgenticaController.IClass, ILlmFunctionOfValidate<"chatgpt">, any>;
+        export type IHttp<Model extends ILlmSchema.Model> = IBase<"http", IAgenticaController.IHttp<Model>, IHttpLlmFunction<Model>, IHttpResponse>;
+        export type IClass<Model extends ILlmSchema.Model> = IBase<"class", IAgenticaController.IClass<Model>, ILlmFunctionOfValidate<Model>, any>;
         interface IBase<Protocol, Controller, Function, Value> {
             /**
              * Discriminator type.
@@ -104,13 +104,13 @@ export declare namespace IAgenticaPrompt {
      *
      * Description prompt about the return value of the LLM function calling.
      */
-    export interface IDescribe extends IBase<"describe"> {
+    export interface IDescribe<Model extends ILlmSchema.Model> extends IBase<"describe"> {
         /**
          * Executions of the LLM function calling.
          *
          * This prompt describes the return value of them.
          */
-        executions: IExecute[];
+        executions: IExecute<Model>[];
         /**
          * Description text.
          */

package/lib/structures/IAgenticaProps.d.ts

@@ -1,3 +1,4 @@
+import { ILlmSchema } from "@samchon/openapi";
 import { Primitive } from "typia";
 import { IAgenticaConfig } from "./IAgenticaConfig";
 import { IAgenticaController } from "./IAgenticaController";
@@ -24,7 +25,11 @@ import { IAgenticaProvider } from "./IAgenticaProvider";
  *
  * @author Samchon
  */
-export interface IAgenticaProps {
+export interface IAgenticaProps<Model extends ILlmSchema.Model> {
+    /**
+     * LLM schema model.
+     */
+    model: Model;
     /**
      * LLM service provider.
      */
@@ -32,7 +37,7 @@ export interface IAgenticaProps {
     /**
      * Controllers serving functions to call.
      */
-    controllers: IAgenticaController[];
+    controllers: IAgenticaController<Model>[];
     /**
      * Configuration of agent.
      *
@@ -48,12 +53,12 @@ export interface IAgenticaProps {
      * - `systemPrompt`: default prompts written in markdown
      *   - https://github.com/samchon/nestia/tree/master/packages/agent/prompts
      */
-    config?: IAgenticaConfig;
+    config?: IAgenticaConfig<Model>;
     /**
      * Prompt histories.
      *
      * If you're starting the conversation from an existing session,
      * assign the previouis prompt histories to this property.
      */
-    histories?: Primitive<IAgenticaPrompt>[];
+    histories?: Primitive<IAgenticaPrompt<Model>>[];
 }

package/lib/structures/IAgenticaProvider.d.ts

@@ -5,37 +5,32 @@ import OpenAI from "openai";
  * `IAgenticaProvider` is a type represents an LLM
  * (Large Language Model) provider of the {@link Agentica}.
  *
- * Currently, {@link Agentica} is supporting only one provider OpenAI.
- * You can specify the provider by configuring the `type` property as
- * `"chatgpt"`. Also, you have to assign the OpenAI API client instance
- * to the `api` property, and specify the `model` to use.
+ * Currently, {@link Agentica} supports OpenAI SDK. However, it does
+ * not mean that you can use only OpenAI's GPT model in the
+ * {@link Agentica}. The OpenAI SDK is just a connection tool to the
+ * LLM provider's API, and you can use other LLM providers by configuring
+ * its `baseURL` and API key.
  *
- * If you want to use another LLM provider like Claude or Gemini,
- * please write an issue or contribute to `nestia` please.
+ * Therefore, if you want to use another LLM provider like Claude or
+ * Gemini, please configure the `baseURL` to the {@link api}, and
+ * set {@link IAgenticaController}'s schema model as "cluade" or
+ * "gemini".
  *
  * @author Samchon
  */
-export type IAgenticaProvider = IAgenticaProvider.IChatGpt;
-export declare namespace IAgenticaProvider {
+export interface IAgenticaProvider {
     /**
-     * OpenAI provider.
+     * OpenAI API instance.
      */
-    interface IChatGpt {
-        /**
-         * Discriminator type.
-         */
-        type: "chatgpt";
-        /**
-         * OpenAI API instance.
-         */
-        api: OpenAI;
-        /**
-         * Chat model to be used.
-         */
-        model: OpenAI.ChatModel;
-        /**
-         * Options for the request.
-         */
-        options?: OpenAI.RequestOptions | undefined;
-    }
+    api: OpenAI;
+    /**
+     * Chat model to be used.
+     *
+     * `({}) & string` means to support third party hosting cloud(eg. openRouter, aws)
+     */
+    model: OpenAI.ChatModel | ({} & string);
+    /**
+     * Options for the request.
+     */
+    options?: OpenAI.RequestOptions | undefined;
 }

package/lib/structures/IAgenticaSystemPrompt.d.ts

@@ -1,3 +1,4 @@
+import { ILlmSchema } from "@samchon/openapi";
 import { IAgenticaConfig } from "./IAgenticaConfig";
 import { IAgenticaPrompt } from "./IAgenticaPrompt";
 /**
@@ -18,7 +19,7 @@ import { IAgenticaPrompt } from "./IAgenticaPrompt";
  *
  * @author Samchon
  */
-export interface IAgenticaSystemPrompt {
+export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
     /**
      * Common system prompt that would be used in every situation.
      *
@@ -26,7 +27,7 @@ export interface IAgenticaSystemPrompt {
      * @returns The common system prompt
      * @default https://github.com/samchon/nestia/blob/master/packages/agent/prompts/common.md
      */
-    common?: (config?: IAgenticaConfig | undefined) => string;
+    common?: (config?: IAgenticaConfig<Model> | undefined) => string;
     /**
      * Initialize system prompt.
      *
@@ -43,7 +44,7 @@ export interface IAgenticaSystemPrompt {
      * @returns initialize system prompt
      * @default https://github.com/samchon/nestia/blob/master/packages/agent/prompts/initialize.md
      */
-    initialize?: (histories: IAgenticaPrompt[]) => string;
+    initialize?: (histories: IAgenticaPrompt<Model>[]) => string;
     /**
      * Select system prompt.
      *
@@ -63,7 +64,7 @@ export interface IAgenticaSystemPrompt {
      * @returns select system promopt
      * @default https://github.com/samchon/nestia/blob/master/packages/agent/prompts/select.md
      */
-    select?: (histories: IAgenticaPrompt[]) => string;
+    select?: (histories: IAgenticaPrompt<Model>[]) => string;
     /**
      * Cancel system prompt.
      *
@@ -79,7 +80,7 @@ export interface IAgenticaSystemPrompt {
      * @returns cancel system prompt
      * @default https://github.com/samchon/nestia/blob/master/packages/agent/prompts/cancel.md
      */
-    cancel?: (histories: IAgenticaPrompt[]) => string;
+    cancel?: (histories: IAgenticaPrompt<Model>[]) => string;
     /**
      * Execute system prompt.
      *
@@ -96,7 +97,7 @@ export interface IAgenticaSystemPrompt {
      * @returns execute system prompt
      * https://github.com/samchon/nestia/blob/master/packages/agent/prompts/execute.md
      */
-    execute?: (histories: IAgenticaPrompt[]) => string;
+    execute?: (histories: IAgenticaPrompt<Model>[]) => string;
     /**
      * Describe system prompt.
      *
@@ -112,5 +113,5 @@ export interface IAgenticaSystemPrompt {
      * @returns describe system prompt
      * @default https://github.com/samchon/nestia/blob/master/packages/agent/prompts/describe.md
      */
-    describe?: (histories: IAgenticaPrompt.IExecute[]) => string;
+    describe?: (histories: IAgenticaPrompt.IExecute<Model>[]) => string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentica/core",
-  "version": "0.8.3",
+  "version": "0.9.0-dev.20250302",
   "main": "lib/index.js",
   "description": "Agentic AI Library specialized in LLM Function Calling",
   "scripts": {
@@ -45,7 +45,6 @@
     "@nestia/e2e": "^0.8.2",
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^12.1.2",
-    "@samchon/openapi": "^2.4.2",
     "@trivago/prettier-plugin-sort-imports": "^5.2.2",
     "@types/node": "^22.13.4",
     "@types/uuid": "^10.0.0",
@@ -57,18 +56,16 @@
     "ts-node": "^10.9.2",
     "ts-patch": "^3.3.0",
     "typedoc": "^0.27.7",
-    "typescript": "~5.7.3",
-    "typia": "^7.6.4"
+    "typescript": "~5.8.2"
   },
   "dependencies": {
-    "@samchon/openapi": "^2.4.3",
-    "typia": "^7.6.4",
+    "@samchon/openapi": "^3.0.0",
+    "typia": "^8.0.0",
     "uuid": "^11.0.4"
   },
   "peerDependencies": {
-    "@samchon/openapi": ">= 2.4.3",
-    "openai": ">= 4.80.0",
-    "typia": ">= 7.6.4"
+    "@samchon/openapi": ">=3.0.0 <4.0.0",
+    "openai": ">=4.80.0"
   },
   "module": "lib/index.mjs",
   "typings": "lib/index.d.ts"

package/prompts/cancel.md

@@ -1,5 +1,5 @@
-You are a helpful assistant for cancelling functions which are prepared to call.
-
-Use the supplied tools to select some functions to cancel of `getApiFunctions()` returned.
-
+You are a helpful assistant for cancelling functions which are prepared to call.
+
+Use the supplied tools to select some functions to cancel of `getApiFunctions()` returned.
+
 If you can't find any proper function to select, don't talk, don't do anything.

package/prompts/common.md

@@ -1,3 +1,3 @@
-At first, the user's language locale code is "${locale}". When you are conversating with the user or describing the function calling result, consider it and always translate to the target locale language. Never conversate with different locale language text with the user.
-
+At first, the user's language locale code is "${locale}". When you are conversating with the user or describing the function calling result, consider it and always translate to the target locale language. Never conversate with different locale language text with the user.
+
 At second, the user's timezone is "${timezone}", and ISO datetime is ${datetime}. When you are conversating with the user, consider current time and user belonged timezone.

package/prompts/describe.md

@@ -1,7 +1,7 @@
-You are a helpful assistant describing return values of function calls.
-
-Above messages are the list of function call histories. When describing the return values, please do not too much shortly summarize them. Instead, provide detailed descriptions as much as.
-
-Also, its content format must be markdown. If required, utilize the mermaid syntax for drawing some diagrams. When image contents are, just put them through the markdown image syntax.
-
+You are a helpful assistant describing return values of function calls.
+
+Above messages are the list of function call histories. When describing the return values, please do not too much shortly summarize them. Instead, provide detailed descriptions as much as.
+
+Also, its content format must be markdown. If required, utilize the mermaid syntax for drawing some diagrams. When image contents are, just put them through the markdown image syntax.
+
 At last, if user's language locale code is different with your description, please translate it to the user's language.

package/prompts/execute.md

@@ -1,7 +1,7 @@
-You are a helpful assistant for tool calling.
-
-Use the supplied tools to assist the user.
-
-If previous messages are not enough to compose the arguments, you can ask the user to write more information. By the way, when asking the user to write more information, make the text concise and clear.
-
+You are a helpful assistant for tool calling.
+
+Use the supplied tools to assist the user.
+
+If previous messages are not enough to compose the arguments, you can ask the user to write more information. By the way, when asking the user to write more information, make the text concise and clear.
+
 For reference, in the "tool" role message content, the `function` property means metadata of the API operation. In other words, it is the function schema describing its purpose, parameters and return value types. And then the `data` property is the return value from the target function calling.

package/prompts/initialize.md

@@ -1,3 +1,3 @@
-You are a helpful assistant.
-
+You are a helpful assistant.
+
 Use the supplied tools to assist the user.

package/prompts/select.md

@@ -1,7 +1,7 @@
-You are a helpful assistant for selecting functions to call.
-
-Use the supplied tools to select some functions of `getApiFunctions()` returned.
-
-When selecting functions to call, pay attention to the relationship between functions. In particular, check the prerequisites between each function.
-
+You are a helpful assistant for selecting functions to call.
+
+Use the supplied tools to select some functions of `getApiFunctions()` returned.
+
+When selecting functions to call, pay attention to the relationship between functions. In particular, check the prerequisites between each function.
+
 If you can't find any proper function to select, just type your own message. By the way, when typing your own message, please consider the user's language locale code. If your message is different with the user's language, please translate it to the user's.