@agentica/core 0.12.2-dev.20250314 → 0.12.4

package/src/prompts/AgenticaExecutePrompt.ts

@@ -1,52 +1,52 @@
-import { IHttpResponse, ILlmSchema } from "@samchon/openapi";
-
-import { AgenticaOperation } from "../context/AgenticaOperation";
-import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
-import { AgenticaPromptBase } from "./AgenticaPromptBase";
-
-export class AgenticaExecutePrompt<
-  Model extends ILlmSchema.Model,
-  Protocol extends "http" | "class" = any,
-> extends AgenticaPromptBase<"execute", IAgenticaPromptJson.IExecute> {
-  public readonly id: string;
-  public readonly operation: Protocol extends "http"
-    ? AgenticaOperation.Http<Model>
-    : Protocol extends "class"
-      ? AgenticaOperation.Class<Model>
-      : AgenticaOperation<Model>;
-  public readonly arguments: Record<string, any>;
-  public readonly value: Protocol extends "http" ? IHttpResponse : any;
-
-  public constructor(props: AgenticaExecutePrompt.IProps<Model, Protocol>) {
-    super("execute");
-    this.id = props.id;
-    this.operation = props.operation;
-    this.arguments = props.arguments;
-    this.value = props.value;
-  }
-
-  public toJSON(): IAgenticaPromptJson.IExecute {
-    return {
-      type: this.type,
-      id: this.id,
-      operation: this.operation.toJSON(),
-      arguments: this.arguments,
-      value: this.value,
-    };
-  }
-}
-export namespace AgenticaExecutePrompt {
-  export interface IProps<
-    Model extends ILlmSchema.Model,
-    Protocol extends "http" | "class" = any,
-  > {
-    id: string;
-    operation: Protocol extends "http"
-      ? AgenticaOperation.Http<Model>
-      : Protocol extends "class"
-        ? AgenticaOperation.Class<Model>
-        : AgenticaOperation<Model>;
-    arguments: Record<string, any>;
-    value: Protocol extends "http" ? IHttpResponse : any;
-  }
-}
+import { IHttpResponse, ILlmSchema } from "@samchon/openapi";
+
+import { AgenticaOperation } from "../context/AgenticaOperation";
+import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
+import { AgenticaPromptBase } from "./AgenticaPromptBase";
+
+export class AgenticaExecutePrompt<
+  Model extends ILlmSchema.Model,
+  Protocol extends "http" | "class" = any,
+> extends AgenticaPromptBase<"execute", IAgenticaPromptJson.IExecute> {
+  public readonly id: string;
+  public readonly operation: Protocol extends "http"
+    ? AgenticaOperation.Http<Model>
+    : Protocol extends "class"
+      ? AgenticaOperation.Class<Model>
+      : AgenticaOperation<Model>;
+  public readonly arguments: Record<string, any>;
+  public readonly value: Protocol extends "http" ? IHttpResponse : any;
+
+  public constructor(props: AgenticaExecutePrompt.IProps<Model, Protocol>) {
+    super("execute");
+    this.id = props.id;
+    this.operation = props.operation;
+    this.arguments = props.arguments;
+    this.value = props.value;
+  }
+
+  public toJSON(): IAgenticaPromptJson.IExecute {
+    return {
+      type: this.type,
+      id: this.id,
+      operation: this.operation.toJSON(),
+      arguments: this.arguments,
+      value: this.value,
+    };
+  }
+}
+export namespace AgenticaExecutePrompt {
+  export interface IProps<
+    Model extends ILlmSchema.Model,
+    Protocol extends "http" | "class" = any,
+  > {
+    id: string;
+    operation: Protocol extends "http"
+      ? AgenticaOperation.Http<Model>
+      : Protocol extends "class"
+        ? AgenticaOperation.Class<Model>
+        : AgenticaOperation<Model>;
+    arguments: Record<string, any>;
+    value: Protocol extends "http" ? IHttpResponse : any;
+  }
+}

package/src/prompts/AgenticaPrompt.ts

@@ -1,14 +1,14 @@
-import { ILlmSchema } from "@samchon/openapi";
-
-import { AgenticaCancelPrompt } from "../context/AgenticaCancelPrompt";
-import { AgenticaDescribePrompt } from "./AgenticaDescribePrompt";
-import { AgenticaExecutePrompt } from "./AgenticaExecutePrompt";
-import { AgenticaSelectPrompt } from "./AgenticaSelectPrompt";
-import { AgenticaTextPrompt } from "./AgenticaTextPrompt";
-
-export type AgenticaPrompt<Model extends ILlmSchema.Model> =
-  | AgenticaCancelPrompt<Model>
-  | AgenticaDescribePrompt<Model>
-  | AgenticaExecutePrompt<Model>
-  | AgenticaSelectPrompt<Model>
-  | AgenticaTextPrompt;
+import { ILlmSchema } from "@samchon/openapi";
+
+import { AgenticaCancelPrompt } from "../context/AgenticaCancelPrompt";
+import { AgenticaDescribePrompt } from "./AgenticaDescribePrompt";
+import { AgenticaExecutePrompt } from "./AgenticaExecutePrompt";
+import { AgenticaSelectPrompt } from "./AgenticaSelectPrompt";
+import { AgenticaTextPrompt } from "./AgenticaTextPrompt";
+
+export type AgenticaPrompt<Model extends ILlmSchema.Model> =
+  | AgenticaCancelPrompt<Model>
+  | AgenticaDescribePrompt<Model>
+  | AgenticaExecutePrompt<Model>
+  | AgenticaSelectPrompt<Model>
+  | AgenticaTextPrompt;

package/src/prompts/AgenticaPromptBase.ts

@@ -1,27 +1,27 @@
-/**
- * Base class for all prompts in Agentica.
- *
- * `AgenticaPromptBase` is a base class for every prompt classes
- * in Agentica. It is generated by {@link Agentica.conversate} function,
- * and used for restoring the previous conversation history when
- * constructing the {@link Agentica} instance.
- *
- * @template Type Discriminator type
- * @template Json Primitive type of the prompt
- * @author Samchon
- */
-export abstract class AgenticaPromptBase<
-  Type extends string,
-  Json extends { type: Type },
-> {
-  /**
-   * Discriminator type.
-   */
-  public readonly type: Type;
-
-  protected constructor(type: Type) {
-    this.type = type;
-  }
-
-  public abstract toJSON(): Json;
-}
+/**
+ * Base class for all prompts in Agentica.
+ *
+ * `AgenticaPromptBase` is a base class for every prompt classes
+ * in Agentica. It is generated by {@link Agentica.conversate} function,
+ * and used for restoring the previous conversation history when
+ * constructing the {@link Agentica} instance.
+ *
+ * @template Type Discriminator type
+ * @template Json Primitive type of the prompt
+ * @author Samchon
+ */
+export abstract class AgenticaPromptBase<
+  Type extends string,
+  Json extends { type: Type },
+> {
+  /**
+   * Discriminator type.
+   */
+  public readonly type: Type;
+
+  protected constructor(type: Type) {
+    this.type = type;
+  }
+
+  public abstract toJSON(): Json;
+}

package/src/prompts/AgenticaSelectPrompt.ts

@@ -1,32 +1,32 @@
-import { ILlmSchema } from "@samchon/openapi";
-
-import { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
-import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
-import { AgenticaPromptBase } from "./AgenticaPromptBase";
-
-export class AgenticaSelectPrompt<
-  Model extends ILlmSchema.Model,
-> extends AgenticaPromptBase<"select", IAgenticaPromptJson.ISelect> {
-  public readonly id: string;
-  public readonly selections: AgenticaOperationSelection<Model>[];
-
-  public constructor(props: AgenticaSelectPrompt.IProps<Model>) {
-    super("select");
-    this.id = props.id;
-    this.selections = props.selections;
-  }
-
-  public toJSON(): IAgenticaPromptJson.ISelect {
-    return {
-      type: this.type,
-      id: this.id,
-      selections: this.selections.map((s) => s.toJSON()),
-    };
-  }
-}
-export namespace AgenticaSelectPrompt {
-  export interface IProps<Model extends ILlmSchema.Model> {
-    id: string;
-    selections: AgenticaOperationSelection<Model>[];
-  }
-}
+import { ILlmSchema } from "@samchon/openapi";
+
+import { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
+import { AgenticaPromptBase } from "./AgenticaPromptBase";
+
+export class AgenticaSelectPrompt<
+  Model extends ILlmSchema.Model,
+> extends AgenticaPromptBase<"select", IAgenticaPromptJson.ISelect> {
+  public readonly id: string;
+  public readonly selections: AgenticaOperationSelection<Model>[];
+
+  public constructor(props: AgenticaSelectPrompt.IProps<Model>) {
+    super("select");
+    this.id = props.id;
+    this.selections = props.selections;
+  }
+
+  public toJSON(): IAgenticaPromptJson.ISelect {
+    return {
+      type: this.type,
+      id: this.id,
+      selections: this.selections.map((s) => s.toJSON()),
+    };
+  }
+}
+export namespace AgenticaSelectPrompt {
+  export interface IProps<Model extends ILlmSchema.Model> {
+    id: string;
+    selections: AgenticaOperationSelection<Model>[];
+  }
+}

package/src/prompts/AgenticaTextPrompt.ts

@@ -1,31 +1,31 @@
-import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
-import { AgenticaPromptBase } from "./AgenticaPromptBase";
-
-export class AgenticaTextPrompt<
-  Role extends "assistant" | "user" = "assistant" | "user",
-> extends AgenticaPromptBase<"text", IAgenticaPromptJson.IText> {
-  public readonly role: Role;
-  public readonly text: string;
-
-  public constructor(props: AgenticaTextPrompt.IProps<Role>) {
-    super("text");
-    this.role = props.role;
-    this.text = props.text;
-  }
-
-  public toJSON(): IAgenticaPromptJson.IText<Role> {
-    return {
-      type: this.type,
-      role: this.role,
-      text: this.text,
-    };
-  }
-}
-export namespace AgenticaTextPrompt {
-  export interface IProps<
-    Role extends "assistant" | "user" = "assistant" | "user",
-  > {
-    role: Role;
-    text: string;
-  }
-}
+import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
+import { AgenticaPromptBase } from "./AgenticaPromptBase";
+
+export class AgenticaTextPrompt<
+  Role extends "assistant" | "user" = "assistant" | "user",
+> extends AgenticaPromptBase<"text", IAgenticaPromptJson.IText> {
+  public readonly role: Role;
+  public readonly text: string;
+
+  public constructor(props: AgenticaTextPrompt.IProps<Role>) {
+    super("text");
+    this.role = props.role;
+    this.text = props.text;
+  }
+
+  public toJSON(): IAgenticaPromptJson.IText<Role> {
+    return {
+      type: this.type,
+      role: this.role,
+      text: this.text,
+    };
+  }
+}
+export namespace AgenticaTextPrompt {
+  export interface IProps<
+    Role extends "assistant" | "user" = "assistant" | "user",
+  > {
+    role: Role;
+    text: string;
+  }
+}

package/src/structures/IAgenticaConfig.ts

@@ -1,123 +1,123 @@
-import { ILlmSchema } from "@samchon/openapi";
-
-import { AgenticaContext } from "../context/AgenticaContext";
-import { AgenticaPrompt } from "../prompts/AgenticaPrompt";
-import { IAgenticaExecutor } from "./IAgenticaExecutor";
-import { IAgenticaSystemPrompt } from "./IAgenticaSystemPrompt";
-
-/**
- * Configuration for Nestia Agent.
- *
- * `IAgenticaConfig` is an interface that defines the configuration
- * properties of the {@link Agentica}. With this configuration, you
- * can set the user's locale, timezone, and some of system prompts.
- *
- * Also, you can affect to the LLM function selecing/calling logic by
- * configuring additional properties. For an example, if you configure the
- * {@link capacity} property, the A.I. chatbot will divide the functions
- * into the several groups with the configured capacity and select proper
- * functions to call by operating the multiple LLM function selecting
- * agents parallelly.
- *
- * @author Samchon
- */
-export interface IAgenticaConfig<Model extends ILlmSchema.Model> {
-  /**
-   * Agent executor.
-   *
-   * Executor function of Agentic AI's iteration plan to internal agents
-   * running by the {@link Agentica.conversate} function.
-   *
-   * If you want to customize the agent execution plan, you can do it
-   * by assigning you logic function of entire or partial to this property.
-   * When customizing it, it would better to reference the
-   * {@link ChatGptAgent.execute} function.
-   *
-   * @param ctx Context of the agent
-   * @returns Lit of prompts generated by the executor
-   * @default ChatGptAgent.execute
-   */
-  executor?:
-    | Partial<IAgenticaExecutor<Model>>
-    | ((ctx: AgenticaContext<Model>) => Promise<AgenticaPrompt<Model>[]>);
-
-  /**
-   * System prompt messages.
-   *
-   * System prompt messages if you want to customize the system prompt
-   * messages for each situation.
-   */
-  systemPrompt?: IAgenticaSystemPrompt<Model>;
-
-  /**
-   * Locale of the A.I. chatbot.
-   *
-   * If you configure this property, the A.I. chatbot will conversate with
-   * the given locale. You can get the locale value by
-   *
-   * - Browser: `navigator.language`
-   * - NodeJS: `process.env.LANG.split(".")[0]`
-   *
-   * @default your_locale
-   */
-  locale?: string;
-
-  /**
-   * Timezone of the A.I. chatbot.
-   *
-   * If you configure this property, the A.I. chatbot will consider the
-   * given timezone. You can get the timezone value by
-   * `Intl.DateTimeFormat().resolvedOptions().timeZone`.
-   *
-   * @default your_timezone
-   */
-  timezone?: string;
-
-  /**
-   * Retry count.
-   *
-   * If LLM function calling composed arguments are invalid,
-   * the A.I. chatbot will retry to call the function with
-   * the modified arguments.
-   *
-   * By the way, if you configure it to 0 or 1, the A.I. chatbot
-   * will not retry the LLM function calling for correcting the
-   * arguments.
-   *
-   * @default 3
-   */
-  retry?: number;
-
-  /**
-   * Capacity of the LLM function selecting.
-   *
-   * When the A.I. chatbot selects a proper function to call, if the
-   * number of functions registered in the
-   * {@link IAgenticaProps.applications} is too much greater,
-   * the A.I. chatbot often fallen into the hallucination.
-   *
-   * In that case, if you configure this property value, `Agentica`
-   * will divide the functions into the several groups with the configured
-   * capacity and select proper functions to call by operating the multiple
-   * LLM function selecting agents parallelly.
-   *
-   * @default 100
-   */
-  capacity?: number;
-
-  /**
-   * Eliticism for the LLM function selecting.
-   *
-   * If you configure {@link capacity}, the A.I. chatbot will complete
-   * the candidate functions to call which are selected by the multiple
-   * LLM function selecting agents.
-   *
-   * Otherwise you configure this property as `false`, the A.I. chatbot
-   * will not complete the candidate functions to call and just accept
-   * every candidate functions to call which are selected by the multiple
-   * LLM function selecting agents.
-   *
-   * @default true
-   */
-  eliticism?: boolean;
-}
+import { ILlmSchema } from "@samchon/openapi";
+
+import { AgenticaContext } from "../context/AgenticaContext";
+import { AgenticaPrompt } from "../prompts/AgenticaPrompt";
+import { IAgenticaExecutor } from "./IAgenticaExecutor";
+import { IAgenticaSystemPrompt } from "./IAgenticaSystemPrompt";
+
+/**
+ * Configuration for Nestia Agent.
+ *
+ * `IAgenticaConfig` is an interface that defines the configuration
+ * properties of the {@link Agentica}. With this configuration, you
+ * can set the user's locale, timezone, and some of system prompts.
+ *
+ * Also, you can affect to the LLM function selecing/calling logic by
+ * configuring additional properties. For an example, if you configure the
+ * {@link capacity} property, the A.I. chatbot will divide the functions
+ * into the several groups with the configured capacity and select proper
+ * functions to call by operating the multiple LLM function selecting
+ * agents parallelly.
+ *
+ * @author Samchon
+ */
+export interface IAgenticaConfig<Model extends ILlmSchema.Model> {
+  /**
+   * Agent executor.
+   *
+   * Executor function of Agentic AI's iteration plan to internal agents
+   * running by the {@link Agentica.conversate} function.
+   *
+   * If you want to customize the agent execution plan, you can do it
+   * by assigning you logic function of entire or partial to this property.
+   * When customizing it, it would better to reference the
+   * {@link ChatGptAgent.execute} function.
+   *
+   * @param ctx Context of the agent
+   * @returns Lit of prompts generated by the executor
+   * @default ChatGptAgent.execute
+   */
+  executor?:
+    | Partial<IAgenticaExecutor<Model>>
+    | ((ctx: AgenticaContext<Model>) => Promise<AgenticaPrompt<Model>[]>);
+
+  /**
+   * System prompt messages.
+   *
+   * System prompt messages if you want to customize the system prompt
+   * messages for each situation.
+   */
+  systemPrompt?: IAgenticaSystemPrompt<Model>;
+
+  /**
+   * Locale of the A.I. chatbot.
+   *
+   * If you configure this property, the A.I. chatbot will conversate with
+   * the given locale. You can get the locale value by
+   *
+   * - Browser: `navigator.language`
+   * - NodeJS: `process.env.LANG.split(".")[0]`
+   *
+   * @default your_locale
+   */
+  locale?: string;
+
+  /**
+   * Timezone of the A.I. chatbot.
+   *
+   * If you configure this property, the A.I. chatbot will consider the
+   * given timezone. You can get the timezone value by
+   * `Intl.DateTimeFormat().resolvedOptions().timeZone`.
+   *
+   * @default your_timezone
+   */
+  timezone?: string;
+
+  /**
+   * Retry count.
+   *
+   * If LLM function calling composed arguments are invalid,
+   * the A.I. chatbot will retry to call the function with
+   * the modified arguments.
+   *
+   * By the way, if you configure it to 0 or 1, the A.I. chatbot
+   * will not retry the LLM function calling for correcting the
+   * arguments.
+   *
+   * @default 3
+   */
+  retry?: number;
+
+  /**
+   * Capacity of the LLM function selecting.
+   *
+   * When the A.I. chatbot selects a proper function to call, if the
+   * number of functions registered in the
+   * {@link IAgenticaProps.applications} is too much greater,
+   * the A.I. chatbot often fallen into the hallucination.
+   *
+   * In that case, if you configure this property value, `Agentica`
+   * will divide the functions into the several groups with the configured
+   * capacity and select proper functions to call by operating the multiple
+   * LLM function selecting agents parallelly.
+   *
+   * @default 100
+   */
+  capacity?: number;
+
+  /**
+   * Eliticism for the LLM function selecting.
+   *
+   * If you configure {@link capacity}, the A.I. chatbot will complete
+   * the candidate functions to call which are selected by the multiple
+   * LLM function selecting agents.
+   *
+   * Otherwise you configure this property as `false`, the A.I. chatbot
+   * will not complete the candidate functions to call and just accept
+   * every candidate functions to call which are selected by the multiple
+   * LLM function selecting agents.
+   *
+   * @default true
+   */
+  eliticism?: boolean;
+}