@agentica/core 0.15.7 → 0.16.1

package/lib/Agentica.d.ts

@@ -1,19 +1,19 @@
 import type { ILlmSchema } from "@samchon/openapi";
 import type { AgenticaOperation } from "./context/AgenticaOperation";
 import type { AgenticaEvent } from "./events/AgenticaEvent";
-import type { AgenticaPrompt } from "./prompts/AgenticaPrompt";
+import type { AgenticaHistory } from "./histories/AgenticaHistory";
 import type { IAgenticaConfig } from "./structures/IAgenticaConfig";
 import type { IAgenticaController } from "./structures/IAgenticaController";
 import type { IAgenticaProps } from "./structures/IAgenticaProps";
 import type { IAgenticaVendor } from "./structures/IAgenticaVendor";
 import { AgenticaTokenUsage } from "./context/AgenticaTokenUsage";
 /**
- * Nestia A.I. chatbot agent.
+ * Agentica AI chatbot agent.
  *
- * `Agentica` is a facade class for the super A.I. chatbot agent
- * which performs the {@link conversate user's conversation function}
- * with LLM (Large Language Model) function calling and manages the
- * {@link getPromptHistories prompt histories}.
+ * `Agentica` is a facade class for the super AI chatbot agent
+ * which performs LLM (Large Language Model) function calling from the
+ * {@link conversate user's conversation}, and manages the
+ * {@link getHistories prompt histories}.
  *
  * To understand and compose the `Agentica` class exactly, reference
  * below types concentrating on the documentation comments please.
@@ -28,7 +28,7 @@ import { AgenticaTokenUsage } from "./context/AgenticaTokenUsage";
  *   - {@link IAgenticaSystemPrompt}
  * - Accessors
  *   - {@link IAgenticaOperation}
- *   - {@link IAgenticaPromptJson}
+ *   - {@link IAgenticaHistoryJson}
  *   - {@link IAgenticaEventJson}
  *   - {@link IAgenticaTokenUsageJson}
  *
@@ -38,7 +38,7 @@ export declare class Agentica<Model extends ILlmSchema.Model> {
     private readonly props;
     private readonly operations_;
     private readonly stack_;
-    private readonly prompt_histories_;
+    private readonly histories_;
     private readonly listeners_;
     private readonly token_usage_;
     private ready_;
@@ -50,18 +50,18 @@ export declare class Agentica<Model extends ILlmSchema.Model> {
      */
     constructor(props: IAgenticaProps<Model>);
     /**
-     * Conversate with the A.I. chatbot.
+     * Conversate with the AI chatbot.
      *
-     * User talks to the A.I. chatbot with the content.
+     * User talks to the AI chatbot with the given content.
      *
-     * When the user's conversation implies the A.I. chatbot to execute a
+     * When the user's conversation implies the AI chatbot to execute a
      * function calling, the returned chat prompts will contain the
-     * function calling information like {@link IAgenticaPromptJson.IExecute}.
+     * function calling information like {@link AgenticaExecuteHistory}.
      *
      * @param content The content to talk
      * @returns List of newly created chat prompts
      */
-    conversate(content: string): Promise<AgenticaPrompt<Model>[]>;
+    conversate(content: string): Promise<AgenticaHistory<Model>[]>;
     /**
      * Get configuration.
      */
@@ -74,7 +74,7 @@ export declare class Agentica<Model extends ILlmSchema.Model> {
      * Get controllers.
      *
      * Get list of controllers, which are the collection of functions that
-     * the "Super A.I. Chatbot" can execute.
+     * the "Super AI Chatbot" can execute.
      */
     getControllers(): ReadonlyArray<IAgenticaController<Model>>;
     /**
@@ -87,20 +87,20 @@ export declare class Agentica<Model extends ILlmSchema.Model> {
      */
     getOperations(): ReadonlyArray<AgenticaOperation<Model>>;
     /**
-     * Get the chatbot's prompt histories.
+     * Get the chatbot's histories.
      *
-     * Get list of chat prompts that the chatbot has been conversated.
+     * Get list of chat histories that the chatbot has been conversated.
      *
-     * @returns List of chat prompts
+     * @returns List of chat histories
      */
-    getPromptHistories(): AgenticaPrompt<Model>[];
+    getHistories(): AgenticaHistory<Model>[];
     /**
-     * Get token usage of the A.I. chatbot.
+     * Get token usage of the AI chatbot.
      *
-     * Entire token usage of the A.I. chatbot during the conversating
+     * Entire token usage of the AI chatbot during the conversating
      * with the user by {@link conversate} method callings.
      *
-     * @returns Cost of the A.I. chatbot
+     * @returns Cost of the AI chatbot
      */
     getTokenUsage(): AgenticaTokenUsage;
     /**

package/lib/Agentica.js

@@ -14,19 +14,19 @@ const AgenticaTokenUsage_1 = require("./context/AgenticaTokenUsage");
 const AgenticaOperationComposer_1 = require("./context/internal/AgenticaOperationComposer");
 const AgenticaTokenUsageAggregator_1 = require("./context/internal/AgenticaTokenUsageAggregator");
 const events_1 = require("./factory/events");
-const prompts_1 = require("./factory/prompts");
+const histories_1 = require("./factory/histories");
 const execute_1 = require("./orchestrate/execute");
 const AgenticaPromptTransformer_1 = require("./transformers/AgenticaPromptTransformer");
 const __map_take_1 = require("./utils/__map_take");
 const ChatGptCompletionMessageUtil_1 = require("./utils/ChatGptCompletionMessageUtil");
 const StreamUtil_1 = require("./utils/StreamUtil");
 /**
- * Nestia A.I. chatbot agent.
+ * Agentica AI chatbot agent.
  *
- * `Agentica` is a facade class for the super A.I. chatbot agent
- * which performs the {@link conversate user's conversation function}
- * with LLM (Large Language Model) function calling and manages the
- * {@link getPromptHistories prompt histories}.
+ * `Agentica` is a facade class for the super AI chatbot agent
+ * which performs LLM (Large Language Model) function calling from the
+ * {@link conversate user's conversation}, and manages the
+ * {@link getHistories prompt histories}.
  *
  * To understand and compose the `Agentica` class exactly, reference
  * below types concentrating on the documentation comments please.
@@ -41,7 +41,7 @@ const StreamUtil_1 = require("./utils/StreamUtil");
  *   - {@link IAgenticaSystemPrompt}
  * - Accessors
  *   - {@link IAgenticaOperation}
- *   - {@link IAgenticaPromptJson}
+ *   - {@link IAgenticaHistoryJson}
  *   - {@link IAgenticaEventJson}
  *   - {@link IAgenticaTokenUsageJson}
  *
@@ -67,9 +67,9 @@ class Agentica {
         // STATUS
         this.stack_ = [];
         this.listeners_ = new Map();
-        this.prompt_histories_ = ((_a = props.histories) !== null && _a !== void 0 ? _a : []).map(input => AgenticaPromptTransformer_1.AgenticaPromptTransformer.transform({
+        this.histories_ = ((_a = props.histories) !== null && _a !== void 0 ? _a : []).map(input => AgenticaPromptTransformer_1.AgenticaPromptTransformer.transform({
             operations: this.operations_.group,
-            prompt: input,
+            history: input,
         }));
         // STATUS
         this.token_usage_ = AgenticaTokenUsage_1.AgenticaTokenUsage.zero();
@@ -90,20 +90,20 @@ class Agentica {
       ACCESSORS
     ----------------------------------------------------------- */
     /**
-     * Conversate with the A.I. chatbot.
+     * Conversate with the AI chatbot.
      *
-     * User talks to the A.I. chatbot with the content.
+     * User talks to the AI chatbot with the given content.
      *
-     * When the user's conversation implies the A.I. chatbot to execute a
+     * When the user's conversation implies the AI chatbot to execute a
      * function calling, the returned chat prompts will contain the
-     * function calling information like {@link IAgenticaPromptJson.IExecute}.
+     * function calling information like {@link AgenticaExecuteHistory}.
      *
      * @param content The content to talk
      * @returns List of newly created chat prompts
      */
     conversate(content) {
         return __awaiter(this, void 0, void 0, function* () {
-            const prompt = (0, prompts_1.createTextPrompt)({
+            const text = (0, histories_1.createTextHistory)({
                 role: "user",
                 text: content,
             });
@@ -115,11 +115,11 @@ class Agentica {
                 join: () => __awaiter(this, void 0, void 0, function* () { return Promise.resolve(content); }),
             }));
             const newbie = yield this.executor_(this.getContext({
-                prompt,
+                prompt: text,
                 usage: this.token_usage_,
             }));
-            this.prompt_histories_.push(prompt, ...newbie);
-            return [prompt, ...newbie];
+            this.histories_.push(text, ...newbie);
+            return [text, ...newbie];
         });
     }
     /**
@@ -138,7 +138,7 @@ class Agentica {
      * Get controllers.
      *
      * Get list of controllers, which are the collection of functions that
-     * the "Super A.I. Chatbot" can execute.
+     * the "Super AI Chatbot" can execute.
      */
     getControllers() {
         return this.props.controllers;
@@ -155,22 +155,22 @@ class Agentica {
         return this.operations_.array;
     }
     /**
-     * Get the chatbot's prompt histories.
+     * Get the chatbot's histories.
      *
-     * Get list of chat prompts that the chatbot has been conversated.
+     * Get list of chat histories that the chatbot has been conversated.
      *
-     * @returns List of chat prompts
+     * @returns List of chat histories
      */
-    getPromptHistories() {
-        return this.prompt_histories_;
+    getHistories() {
+        return this.histories_;
     }
     /**
-     * Get token usage of the A.I. chatbot.
+     * Get token usage of the AI chatbot.
      *
-     * Entire token usage of the A.I. chatbot during the conversating
+     * Entire token usage of the AI chatbot during the conversating
      * with the user by {@link conversate} method callings.
      *
-     * @returns Cost of the A.I. chatbot
+     * @returns Cost of the AI chatbot
      */
     getTokenUsage() {
         return this.token_usage_;
@@ -185,7 +185,7 @@ class Agentica {
             operations: this.operations_,
             config: this.props.config,
             // STATES
-            histories: this.prompt_histories_,
+            histories: this.histories_,
             stack: this.stack_,
             ready: () => this.ready_,
             prompt: props.prompt,
@@ -205,7 +205,7 @@ class Agentica {
                 const completion = yield this.props.vendor.api.chat.completions.create(event.body, event.options);
                 const [streamForEvent, temporaryStream] = StreamUtil_1.StreamUtil.transform(completion.toReadableStream(), value => ChatGptCompletionMessageUtil_1.ChatGptCompletionMessageUtil.transformCompletionChunk(value)).tee();
                 const [streamForAggregate, streamForReturn] = temporaryStream.tee();
-                void (() => __awaiter(this, void 0, void 0, function* () {
+                (() => __awaiter(this, void 0, void 0, function* () {
                     const reader = streamForAggregate.getReader();
                     while (true) {
                         const chunk = yield reader.read();
@@ -220,7 +220,7 @@ class Agentica {
                             });
                         }
                     }
-                }))();
+                }))().catch(() => { });
                 const [streamForStream, streamForJoin] = streamForEvent.tee();
                 yield dispatch({
                     type: "response",

package/lib/Agentica.js.map

@@ -1 +1 @@
-{"version":3,"file":"Agentica.js","sourceRoot":"","sources":["../src/Agentica.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Agentica.js","sourceRoot":"","sources":["../src/Agentica.ts"],"names":[],"mappings":"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"}

package/lib/MicroAgentica.d.ts

@@ -0,0 +1,115 @@
+import type { ILlmSchema } from "@samchon/openapi";
+import type { MicroAgenticaEvent } from "./events/MicroAgenticaEvent";
+import type { MicroAgenticaHistory } from "./histories/MicroAgenticaHistory";
+import type { IAgenticaController } from "./structures/IAgenticaController";
+import type { IAgenticaVendor } from "./structures/IAgenticaVendor";
+import type { IMicroAgenticaConfig } from "./structures/IMicroAgenticaConfig";
+import type { IMicroAgenticaProps } from "./structures/IMicroAgenticaProps";
+import { AgenticaTokenUsage } from "./context/AgenticaTokenUsage";
+/**
+ * Micro AI chatbot.
+ *
+ * `MicroAgentica` is a facade class for the micro AI chatbot agent
+ * which performs LLM (Large Language Model) function calling from the
+ * {@link conversate user's conversation} and manages the
+ * {@link getHistories prompt histories}.
+ *
+ * Different between `MicroAgentica` and {@link Agentica} is that
+ * `MicroAgentica` does not have function selecting filter. It directly
+ * list up every functions to the agent. Besides, {@link Agentica} has
+ * a function selecting mechanism to reduce the number of functions to
+ * be listed up to the agent.
+ *
+ * Therefore, if you have a lot of functions to call, you must not
+ * use this `MicroAgentica` class. Use this `MicroAgentica` class only
+ * when you have a few functions to call.
+ *
+ * - [Multi-agent orchestration of `@agentica`](https://wrtnlabs.io/agentica/docs/concepts/function-calling/#orchestration-strategy)
+ * - Internal agents of `MicroAgentica`
+ *   - executor
+ *   - describier
+ * - Internal agents of {@link Agentica}
+ *   - initializer
+ *   - **selector**
+ *   - executor
+ *   - describer
+ *
+ * @author Samchon
+ */
+export declare class MicroAgentica<Model extends ILlmSchema.Model> {
+    private readonly props;
+    private readonly operations_;
+    private readonly histories_;
+    private readonly listeners_;
+    private readonly token_usage_;
+    /**
+     * Initializer Constructor.
+     *
+     * @param props Properties to construct the micro agent
+     */
+    constructor(props: IMicroAgenticaProps<Model>);
+    /**
+     * Conversate with the micro agent.
+     *
+     * User talks to the AI chatbot with the given content.
+     *
+     * When the user's conversation implies the AI chatbot to execute a
+     * function calling, the returned chat prompts will contain the
+     * function callinng information like {@link AgenticaExecuteHistory}
+     *
+     * @param content The content to talk
+     * @returns List of newly created histories
+     */
+    conversate(content: string): Promise<MicroAgenticaHistory<Model>[]>;
+    /**
+     * Get configuration.
+     */
+    getConfig(): IMicroAgenticaConfig<Model> | undefined;
+    /**
+     * Get LLM vendor.
+     */
+    getVendor(): IAgenticaVendor;
+    /**
+     * Get controllers.
+     *
+     * Get list of controllers, which are the collection of functions that
+     * the agent can execute.
+     */
+    getControllers(): ReadonlyArray<IAgenticaController<Model>>;
+    /**
+     * Get the chatbot's histories.
+     *
+     * Get list of chat histories that the chatbot has been conversated.
+     *
+     * @returns List of chat histories
+     */
+    getHistories(): MicroAgenticaHistory<Model>[];
+    /**
+     * Get token usage of the AI chatbot.
+     *
+     * Entire token usage of the AI chatbot during the conversating
+     * with the user by {@link conversate} method callings.
+     *
+     * @returns Cost of the AI chatbot
+     */
+    getTokenUsage(): AgenticaTokenUsage;
+    /**
+     * Add an event listener.
+     *
+     * Add an event listener to be called whenever the event is emitted.
+     *
+     * @param type Type of event
+     * @param listener Callback function to be called whenever the event is emitted
+     */
+    on<Type extends MicroAgenticaEvent.Type>(type: Type, listener: (event: MicroAgenticaEvent.Mapper<Model>[Type]) => void | Promise<void>): this;
+    /**
+     * Erase an event listener.
+     *
+     * Erase an event listener to stop calling the callback function.
+     *
+     * @param type Type of event
+     * @param listener Callback function to erase
+     */
+    off<Type extends MicroAgenticaEvent.Type>(type: Type, listener: (event: MicroAgenticaEvent.Mapper<Model>[Type]) => void | Promise<void>): this;
+    private dispatch;
+}