@agentica/core 0.8.3-dev.20250227 → 0.9.0-dev.20250302

package/src/structures/IAgenticaProps.ts

@@ -1,3 +1,4 @@
+import { ILlmSchema } from "@samchon/openapi";
 import { Primitive } from "typia";
 
 import { IAgenticaConfig } from "./IAgenticaConfig";
@@ -26,7 +27,12 @@ import { IAgenticaProvider } from "./IAgenticaProvider";
  *
  * @author Samchon
  */
-export interface IAgenticaProps {
+export interface IAgenticaProps<Model extends ILlmSchema.Model> {
+  /**
+   * LLM schema model.
+   */
+  model: Model;
+
   /**
    * LLM service provider.
    */
@@ -35,7 +41,7 @@ export interface IAgenticaProps {
   /**
    * Controllers serving functions to call.
    */
-  controllers: IAgenticaController[];
+  controllers: IAgenticaController<Model>[];
 
   /**
    * Configuration of agent.
@@ -52,7 +58,7 @@ 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.
@@ -60,5 +66,5 @@ export interface IAgenticaProps {
    * 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/src/structures/IAgenticaProvider.ts

@@ -6,40 +6,34 @@ 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 namespace IAgenticaProvider {
+export interface IAgenticaProvider {
   /**
-   * OpenAI provider.
+   * OpenAI API instance.
    */
-  export interface IChatGpt {
-    /**
-     * Discriminator type.
-     */
-    type: "chatgpt";
+  api: OpenAI;
 
-    /**
-     * OpenAI API instance.
-     */
-    api: OpenAI;
-
-    /**
-     * Chat model to be used.
-     */
-    model: OpenAI.ChatModel;
+  /**
+   * 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;
-  }
+  /**
+   * Options for the request.
+   */
+  options?: OpenAI.RequestOptions | undefined;
 }

package/src/structures/IAgenticaSystemPrompt.ts

@@ -1,3 +1,5 @@
+import { ILlmSchema } from "@samchon/openapi";
+
 import { IAgenticaConfig } from "./IAgenticaConfig";
 import { IAgenticaPrompt } from "./IAgenticaPrompt";
 
@@ -19,7 +21,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.
    *
@@ -27,7 +29,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.
@@ -45,7 +47,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.
@@ -66,7 +68,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.
@@ -83,7 +85,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.
@@ -101,7 +103,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.
@@ -118,5 +120,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;
 }