@agentica/core 0.10.3 → 0.11.0

package/lib/structures/IAgenticaEvent.d.ts

@@ -1,192 +0,0 @@
-import { ILlmSchema } from "@samchon/openapi";
-import OpenAI from "openai";
-import { AgenticaSource } from "../typings/AgenticaSource";
-import { IAgenticaOperation } from "./IAgenticaOperation";
-import { IAgenticaPrompt } from "./IAgenticaPrompt";
-/**
- * Nestia A.I. chatbot event.
- *
- * `IAgenticaEvent` is an union type of all possible events that can
- * be emitted by the A.I. chatbot of the {@link Agentica} class. You
- * can discriminate the subtype by checking the {@link type} property.
- *
- * @author Samchon
- */
-export type IAgenticaEvent<Model extends ILlmSchema.Model> = IAgenticaEvent.IInitialize | IAgenticaEvent.ISelect<Model> | IAgenticaEvent.ICancel<Model> | IAgenticaEvent.ICall<Model> | IAgenticaEvent.IExecute<Model> | IAgenticaEvent.IDescribe<Model> | IAgenticaEvent.IText | IAgenticaEvent.IRequest | IAgenticaEvent.IResponse;
-export declare namespace IAgenticaEvent {
-    export type Type = IAgenticaEvent<any>["type"];
-    export type Mapper<Model extends ILlmSchema.Model> = {
-        initialize: IInitialize;
-        select: ISelect<Model>;
-        cancel: ICancel<Model>;
-        call: ICall<Model>;
-        execute: IExecute<Model>;
-        describe: IDescribe<Model>;
-        text: IText;
-        request: IRequest;
-        response: IResponse;
-    };
-    /**
-     * Event of initializing the chatbot.
-     */
-    export interface IInitialize extends IBase<"initialize"> {
-    }
-    /**
-     * Event of selecting a function to call.
-     */
-    export interface ISelect<Model extends ILlmSchema.Model> extends IBase<"select"> {
-        /**
-         * Selected operation.
-         *
-         * Operation that has been selected to prepare LLM function calling.
-         */
-        operation: IAgenticaOperation<Model>;
-        /**
-         * Reason of selecting the function.
-         *
-         * The A.I. chatbot will fill this property describing why the function
-         * has been selected.
-         */
-        reason: string;
-    }
-    /**
-     * Event of canceling a function calling.
-     */
-    export interface ICancel<Model extends ILlmSchema.Model> extends IBase<"cancel"> {
-        /**
-         * Selected operation to cancel.
-         *
-         * Operation that has been selected to prepare LLM function calling,
-         * but canceled due to no more required.
-         */
-        operation: IAgenticaOperation<Model>;
-        /**
-         * Reason of selecting the function.
-         *
-         * The A.I. chatbot will fill this property describing why the function
-         * has been cancelled.
-         *
-         * For reference, if the A.I. chatbot successfully completes the LLM
-         * function calling, the reason of the function cancellation will be
-         * "complete".
-         */
-        reason: string;
-    }
-    /**
-     * Event of calling a function.
-     */
-    export interface ICall<Model extends ILlmSchema.Model> extends IBase<"call"> {
-        /**
-         * ID of the tool calling.
-         */
-        id: string;
-        /**
-         * Target operation to call.
-         */
-        operation: IAgenticaOperation<Model>;
-        /**
-         * Arguments of the function calling.
-         *
-         * If you modify this {@link arguments} property, it actually modifies
-         * the backend server's request. Therefore, be careful when you're
-         * trying to modify this property.
-         */
-        arguments: object;
-    }
-    /**
-     * Event of function calling execution.
-     */
-    export interface IExecute<Model extends ILlmSchema.Model> extends IBase<"execute"> {
-        /**
-         * ID of the tool calling.
-         */
-        id: string;
-        /**
-         * Target operation had called.
-         */
-        operation: IAgenticaOperation<Model>;
-        /**
-         * Arguments of the function calling.
-         */
-        arguments: object;
-        /**
-         * Return value.
-         */
-        value: any;
-    }
-    /**
-     * Event of description.
-     *
-     * Event describing return values of LLM function callings.
-     */
-    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: IAgenticaPrompt.IExecute<Model>[];
-        /**
-         * Description text.
-         */
-        text: string;
-    }
-    /**
-     * Event of text message.
-     */
-    export interface IText extends IBase<"text"> {
-        /**
-         * Role of the orator.
-         */
-        role: "assistant" | "user";
-        /**
-         * The text content.
-         */
-        text: string;
-    }
-    /**
-     * Request event of LLM vendor API.
-     */
-    export interface IRequest extends IBase<"request"> {
-        /**
-         * The source agent of the request.
-         */
-        source: AgenticaSource;
-        /**
-         * Request body.
-         */
-        body: OpenAI.ChatCompletionCreateParamsNonStreaming;
-        /**
-         * Options for the request.
-         */
-        options?: OpenAI.RequestOptions | undefined;
-    }
-    /**
-     * Response event of LLM vendor API.
-     */
-    export interface IResponse extends IBase<"response"> {
-        /**
-         * The source agent of the response.
-         */
-        source: AgenticaSource;
-        /**
-         * Request body.
-         */
-        body: OpenAI.ChatCompletionCreateParamsNonStreaming;
-        /**
-         * Options for the request.
-         */
-        options?: OpenAI.RequestOptions | undefined;
-        /**
-         * Return value from the LLM vendor API.
-         */
-        value: OpenAI.ChatCompletion;
-    }
-    interface IBase<Type extends string> {
-        /**
-         * Discriminator type.
-         */
-        type: Type;
-    }
-    export {};
-}

package/lib/structures/IAgenticaEvent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IAgenticaEvent.js","sourceRoot":"","sources":["../../src/structures/IAgenticaEvent.ts"],"names":[],"mappings":""}

package/lib/structures/IAgenticaOperation.d.ts

@@ -1,47 +0,0 @@
-import { IHttpLlmFunction, ILlmFunction, ILlmSchema } from "@samchon/openapi";
-import { IAgenticaController } from "./IAgenticaController";
-/**
- * Operation information in the Nestia Agent.
- *
- * `IAgenticaOperation` is a type represents an operation that would
- * be selected by the A.I. chatbot of {@link Agentica} class to
- * perform the LLM (Large Language Model) function calling.
- *
- * Also, it is an union type that is discriminated by the {@link protocol}
- * property. If the protocol value is `http`, it means that the HTTP API
- * operation would be called by the A.I. chatbot. Otherwise, if the protocol
- * value is `class`, it means that the operation has come from a
- * TypeScript class.
- *
- * @author Samchon
- */
-export type IAgenticaOperation<Model extends ILlmSchema.Model> = IAgenticaOperation.IHttp<Model> | IAgenticaOperation.IClass<Model>;
-export declare namespace IAgenticaOperation {
-    /**
-     * HTTP API operation.
-     */
-    export type IHttp<Model extends ILlmSchema.Model> = IBase<"http", IAgenticaController.IHttp<Model>, IHttpLlmFunction<Model>>;
-    /**
-     * TypeScript class operation.
-     */
-    export type IClass<Model extends ILlmSchema.Model> = IBase<"class", IAgenticaController.IClass<Model>, ILlmFunction<Model>>;
-    interface IBase<Protocol, Application, Function> {
-        /**
-         * Protocol discriminator.
-         */
-        protocol: Protocol;
-        /**
-         * Belonged controller of the target function.
-         */
-        controller: Application;
-        /**
-         * Target function to call.
-         */
-        function: Function;
-        /**
-         * Identifier name.
-         */
-        name: string;
-    }
-    export {};
-}

package/lib/structures/IAgenticaOperation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IAgenticaOperation.js","sourceRoot":"","sources":["../../src/structures/IAgenticaOperation.ts"],"names":[],"mappings":""}

package/lib/structures/IAgenticaOperationCollection.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IAgenticaOperationCollection.js","sourceRoot":"","sources":["../../src/structures/IAgenticaOperationCollection.ts"],"names":[],"mappings":""}

package/lib/structures/IAgenticaOperationSelection.d.ts

@@ -1,50 +0,0 @@
-import { IHttpLlmFunction, ILlmFunction, ILlmSchema } from "@samchon/openapi";
-import { IAgenticaController } from "./IAgenticaController";
-/**
- * Nestia agent operation selection.
- *
- * `IAgenticaOperationSelection` is a type represents an operation
- * which has been selected by the A.I. chatbot of {@link Agentica}
- * class for the LLM (Large Language Model) function calling with
- * detailed {@link reason} of the selection (or cancellation).
- *
- * Also, `IAgenticaOperationSelection` is an union type that can
- * specify a subtype by checking the {@link protocol} property.
- *
- * @author Samchon
- */
-export type IAgenticaOperationSelection<Model extends ILlmSchema.Model> = IAgenticaOperationSelection.IHttp<Model> | IAgenticaOperationSelection.IClass<Model>;
-export declare namespace IAgenticaOperationSelection {
-    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>, ILlmFunction<Model>>;
-    interface IBase<Protocol, Controller, Function> {
-        /**
-         * Discriminator protocol.
-         */
-        protocol: Protocol;
-        /**
-         * Belonged controller of the target function.
-         */
-        controller: Controller;
-        /**
-         * Target function.
-         *
-         * Function that has been selected to prepare LLM function calling,
-         * or canceled due to no more required.
-         */
-        function: Function;
-        /**
-         * Identifier name of the target function.
-         *
-         * If {@link Agentica} has multiple {@link IAgenticaController}s,
-         * the `name` can be different from target function's name.
-         */
-        name: string;
-        /**
-         * The reason of the function selection or cancellation.
-         */
-        reason: string;
-        toJSON(): Omit<IBase<Protocol, string, string>, "toJSON">;
-    }
-    export {};
-}

package/lib/structures/IAgenticaOperationSelection.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IAgenticaOperationSelection.js","sourceRoot":"","sources":["../../src/structures/IAgenticaOperationSelection.ts"],"names":[],"mappings":""}

package/lib/structures/IAgenticaPrompt.d.ts

@@ -1,138 +0,0 @@
-import { IHttpLlmFunction, IHttpResponse, ILlmFunction, ILlmSchema } from "@samchon/openapi";
-import { IAgenticaController } from "./IAgenticaController";
-import { IAgenticaOperationSelection } from "./IAgenticaOperationSelection";
-/**
- * Nestia A.I. chatbot prompt.
- *
- * `IWrtnChatPrompt` is an union type of all possible prompts that can
- * be generated by the A.I. chatbot of the {@link Agentica} class.
- *
- * In other words, `IWrtnChatPrompt` is a type of chat history that
- * is occurred during the conversation between the user and the A.I. chatbot
- * in the {@link Agentica} class.
- *
- * If you want to continue the previous A.I. chatbot session, you can
- * accomplish it by assigning the {@link IAgenticaProps.histories}
- * property when creating a new {@link Agentica} instance.
- *
- * @author Samchon
- */
-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<Model extends ILlmSchema.Model> extends IBase<"select"> {
-        /**
-         * ID of the LLM tool call result.
-         */
-        id: string;
-        /**
-         * Operations that have been selected.
-         */
-        operations: IAgenticaOperationSelection<Model>[];
-    }
-    /**
-     * Cancel prompt.
-     *
-     * Cancellation prompt about the candidate functions to be discarded.
-     */
-    export interface ICancel<Model extends ILlmSchema.Model> extends IBase<"cancel"> {
-        /**
-         * ID of the LLM tool call result.
-         */
-        id: string;
-        /**
-         * Operations that have been cancelled.
-         */
-        operations: IAgenticaOperationSelection<Model>[];
-    }
-    /**
-     * Execute prompt.
-     *
-     * Execution prompt about the LLM function calling.
-     */
-    export type IExecute<Model extends ILlmSchema.Model> = IExecute.IHttp<Model> | IExecute.IClass<Model>;
-    export namespace IExecute {
-        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>, ILlmFunction<Model>, any>;
-        interface IBase<Protocol, Controller, Function, Value> {
-            /**
-             * Discriminator type.
-             */
-            type: "execute";
-            /**
-             * Protocol discriminator.
-             */
-            protocol: Protocol;
-            /**
-             * Belonged controller of the target function.
-             */
-            controller: Controller;
-            /**
-             * Target function to call.
-             */
-            function: Function;
-            /**
-             * ID of the LLM tool call result.
-             */
-            id: string;
-            /**
-             * Identifier name of the function.
-             *
-             * If {@link Agentica} has multiple {@link IAgenticaController}s,
-             * the `name` can be different from target function's name.
-             */
-            name: string;
-            /**
-             * Arguments of the LLM function calling.
-             */
-            arguments: object;
-            /**
-             * Return value.
-             */
-            value: Value;
-            toJSON(): Omit<IBase<Protocol, string, string, Value>, "toJSON">;
-        }
-        export {};
-    }
-    /**
-     * Description prompt.
-     *
-     * Description prompt about the return value of the LLM function calling.
-     */
-    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<Model>[];
-        /**
-         * Description text.
-         */
-        text: string;
-    }
-    /**
-     * Text prompt.
-     */
-    export interface IText<Role extends "assistant" | "user" = "assistant" | "user"> extends IBase<"text"> {
-        /**
-         * Role of the orator.
-         */
-        role: Role;
-        /**
-         * The text content.
-         */
-        text: string;
-    }
-    interface IBase<Type extends string> {
-        /**
-         * Discriminator type.
-         */
-        type: Type;
-    }
-    export {};
-}

package/lib/structures/IAgenticaPrompt.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IAgenticaPrompt.js","sourceRoot":"","sources":["../../src/structures/IAgenticaPrompt.ts"],"names":[],"mappings":""}

package/lib/structures/IAgenticaTokenUsage.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=IAgenticaTokenUsage.js.map

package/lib/structures/IAgenticaTokenUsage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IAgenticaTokenUsage.js","sourceRoot":"","sources":["../../src/structures/IAgenticaTokenUsage.ts"],"names":[],"mappings":""}

package/lib/structures/internal/__IChatCancelFunctionsApplication.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"__IChatCancelFunctionsApplication.js","sourceRoot":"","sources":["../../../src/structures/internal/__IChatCancelFunctionsApplication.ts"],"names":[],"mappings":""}

package/lib/structures/internal/__IChatFunctionReference.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"__IChatFunctionReference.js","sourceRoot":"","sources":["../../../src/structures/internal/__IChatFunctionReference.ts"],"names":[],"mappings":""}

package/lib/structures/internal/__IChatInitialApplication.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"__IChatInitialApplication.js","sourceRoot":"","sources":["../../../src/structures/internal/__IChatInitialApplication.ts"],"names":[],"mappings":""}

package/lib/structures/internal/__IChatSelectFunctionsApplication.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"__IChatSelectFunctionsApplication.js","sourceRoot":"","sources":["../../../src/structures/internal/__IChatSelectFunctionsApplication.ts"],"names":[],"mappings":""}

package/lib/typings/AgenticaSource.d.ts

@@ -1 +0,0 @@
-export type AgenticaSource = "initialize" | "select" | "cancel" | "call" | "describe";

package/lib/typings/AgenticaSource.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgenticaSource.js","sourceRoot":"","sources":["../../src/typings/AgenticaSource.ts"],"names":[],"mappings":""}

package/src/internal/AgenticaPromptFactory.ts

@@ -1,32 +0,0 @@
-import { ILlmSchema } from "@samchon/openapi";
-
-import { IAgenticaOperationSelection } from "../structures/IAgenticaOperationSelection";
-import { IAgenticaPrompt } from "../structures/IAgenticaPrompt";
-
-export namespace AgenticaPromptFactory {
-  export const execute = <Model extends ILlmSchema.Model>(
-    props: Omit<IAgenticaPrompt.IExecute<Model>, "toJSON">,
-  ): IAgenticaPrompt.IExecute<Model> =>
-    ({
-      ...props,
-      toJSON: () =>
-        ({
-          ...props,
-          controller: props.controller.name,
-          function: props.function.name,
-        }) as any,
-    }) as IAgenticaPrompt.IExecute<Model>;
-
-  export const selection = <Model extends ILlmSchema.Model>(
-    props: Omit<IAgenticaOperationSelection<Model>, "toJSON">,
-  ): IAgenticaOperationSelection<Model> =>
-    ({
-      ...props,
-      toJSON: () =>
-        ({
-          ...props,
-          controller: props.controller.name,
-          function: props.function.name,
-        }) as any,
-    }) as IAgenticaOperationSelection<Model>;
-}

package/src/internal/AgenticaPromptTransformer.ts

@@ -1,86 +0,0 @@
-import { ILlmSchema } from "@samchon/openapi";
-import { Primitive } from "typia";
-
-import { IAgenticaOperation } from "../structures/IAgenticaOperation";
-import { IAgenticaPrompt } from "../structures/IAgenticaPrompt";
-import { AgenticaPromptFactory } from "./AgenticaPromptFactory";
-
-export namespace AgenticaPromptTransformer {
-  export const transform = <Model extends ILlmSchema.Model>(props: {
-    operations: Map<string, Map<string, IAgenticaOperation<Model>>>;
-    input: Primitive<IAgenticaPrompt<Model>>;
-  }): IAgenticaPrompt<Model> => {
-    // TEXT
-    if (props.input.type === "text") return props.input;
-    // SELECT & CANCEL
-    else if (props.input.type === "select" || props.input.type === "cancel")
-      return {
-        ...props.input,
-        operations: props.input.operations.map((func) =>
-          AgenticaPromptFactory.selection({
-            ...findOperation({
-              operations: props.operations,
-              input: func,
-            }),
-            reason: func.reason,
-          }),
-        ),
-      } satisfies
-        | IAgenticaPrompt.ISelect<Model>
-        | IAgenticaPrompt.ICancel<Model>;
-    // EXECUTE
-    else if (props.input.type === "execute")
-      return transformExecute({
-        operations: props.operations,
-        input: props.input,
-      }) satisfies IAgenticaPrompt.IExecute<Model>;
-    // DESCRIBE
-    return {
-      type: "describe",
-      text: props.input.text,
-      executions: props.input.executions.map((next) =>
-        transformExecute({
-          operations: props.operations,
-          input: next,
-        }),
-      ),
-    } satisfies IAgenticaPrompt.IDescribe<Model>;
-  };
-
-  const transformExecute = <Model extends ILlmSchema.Model>(props: {
-    operations: Map<string, Map<string, IAgenticaOperation<Model>>>;
-    input: Primitive<IAgenticaPrompt.IExecute<Model>>;
-  }): IAgenticaPrompt.IExecute<Model> => {
-    const operation = findOperation({
-      operations: props.operations,
-      input: props.input,
-    });
-    return AgenticaPromptFactory.execute({
-      type: "execute",
-      protocol: operation.protocol as "http",
-      controller: operation.controller,
-      function: operation.function,
-      id: props.input.id,
-      name: props.input.name,
-      arguments: props.input.arguments,
-      value: props.input.value,
-    });
-  };
-
-  const findOperation = <Model extends ILlmSchema.Model>(props: {
-    operations: Map<string, Map<string, IAgenticaOperation<Model>>>;
-    input: {
-      controller: string;
-      function: string;
-    };
-  }): IAgenticaOperation.IHttp<Model> => {
-    const found: IAgenticaOperation<Model> | undefined = props.operations
-      .get(props.input.controller)
-      ?.get(props.input.function);
-    if (found === undefined)
-      throw new Error(
-        `No operation found: (controller: ${props.input.controller}, function: ${props.input.function})`,
-      );
-    return found as IAgenticaOperation.IHttp<Model>;
-  };
-}