@agentica/core 0.10.4 → 0.11.0

package/lib/{structures/IAgenticaContext.d.ts → context/AgenticaContext.d.ts}

@@ -1,11 +1,12 @@
 import { ILlmSchema } from "@samchon/openapi";
 import OpenAI from "openai";
-import { AgenticaSource } from "../typings/AgenticaSource";
-import { IAgenticaConfig } from "./IAgenticaConfig";
-import { IAgenticaEvent } from "./IAgenticaEvent";
-import { IAgenticaOperationCollection } from "./IAgenticaOperationCollection";
-import { IAgenticaOperationSelection } from "./IAgenticaOperationSelection";
-import { IAgenticaPrompt } from "./IAgenticaPrompt";
+import { AgenticaEvent } from "../events/AgenticaEvent";
+import { AgenticaEventSource } from "../events/AgenticaEventSource";
+import { AgenticaPrompt } from "../prompts/AgenticaPrompt";
+import { AgenticaTextPrompt } from "../prompts/AgenticaTextPrompt";
+import { IAgenticaConfig } from "../structures/IAgenticaConfig";
+import { AgenticaOperationCollection } from "./AgenticaOperationCollection";
+import { AgenticaOperationSelection } from "./AgenticaOperationSelection";
 /**
  * Context of the Nestia A.I. agent.
  *
@@ -37,7 +38,7 @@ import { IAgenticaPrompt } from "./IAgenticaPrompt";
  *
  * @author Samchon
  */
-export interface IAgenticaContext<Model extends ILlmSchema.Model> {
+export interface AgenticaContext<Model extends ILlmSchema.Model> {
     /**
      * Collection of operations.
      *
@@ -45,7 +46,7 @@ export interface IAgenticaContext<Model extends ILlmSchema.Model> {
      * groups composed by the divide and conquer rule for the
      * efficient operation selection if configured.
      */
-    operations: IAgenticaOperationCollection<Model>;
+    operations: AgenticaOperationCollection<Model>;
     /**
      * Configuration of the agent.
      *
@@ -58,27 +59,27 @@ export interface IAgenticaContext<Model extends ILlmSchema.Model> {
     /**
      * Prompt histories.
      */
-    histories: IAgenticaPrompt<Model>[];
+    histories: AgenticaPrompt<Model>[];
     /**
      * Stacked operations.
      *
      * In other words, list of candidate operations for the LLM function calling.
      */
-    stack: IAgenticaOperationSelection<Model>[];
+    stack: AgenticaOperationSelection<Model>[];
     /**
      * Text prompt of the user.
      *
      * Text conversation written the by user through the
      * {@link Agentica.conversate} function.
      */
-    prompt: IAgenticaPrompt.IText<"user">;
+    prompt: AgenticaTextPrompt<"user">;
     /**
      * Whether the agent is ready.
      *
      * Returns a boolean value indicates whether the agent is ready to
      * perform the function calling.
      *
-     * If the agent has called the {@link IAgenticaContext.initialize},
+     * If the agent has called the {@link AgenticaContext.initialize},
      * it returns `true`. Otherwise the {@link initialize} has never been
      * called, returns `false`.
      */
@@ -91,7 +92,7 @@ export interface IAgenticaContext<Model extends ILlmSchema.Model> {
      *
      * @param event Event to deliver
      */
-    dispatch: (event: IAgenticaEvent<Model>) => Promise<void>;
+    dispatch: (event: AgenticaEvent<Model>) => Promise<void>;
     /**
      * Request to the OpenAI server.
      *
@@ -99,7 +100,7 @@ export interface IAgenticaContext<Model extends ILlmSchema.Model> {
      * @param body The request body to the OpenAI server
      * @returns Response from the OpenAI server
      */
-    request: (source: AgenticaSource, body: Omit<OpenAI.ChatCompletionCreateParamsNonStreaming, "model">) => Promise<OpenAI.ChatCompletion>;
+    request: (source: AgenticaEventSource, body: Omit<OpenAI.ChatCompletionCreateParamsStreaming, "model" | "stream">) => Promise<ReadableStream<OpenAI.Chat.Completions.ChatCompletionChunk>>;
     /**
      * Initialize the agent.
      */

package/lib/{structures/IAgenticaPrompt.js → context/AgenticaContext.js}

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

package/lib/context/AgenticaContext.js.map

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

package/lib/context/AgenticaHttpOperation.d.ts

@@ -0,0 +1,8 @@
+import { IHttpLlmApplication, IHttpLlmFunction, ILlmSchema } from "@samchon/openapi";
+import { AgenticaOperationBase } from "./AgenticaOperationBase";
+export declare class AgenticaHttpOperation<Model extends ILlmSchema.Model> extends AgenticaOperationBase<"http", IHttpLlmApplication<Model>, IHttpLlmFunction<Model>> {
+    constructor(props: AgenticaHttpOperation.IProps<Model>);
+}
+export declare namespace AgenticaHttpOperation {
+    type IProps<Model extends ILlmSchema.Model> = AgenticaOperationBase.IProps<"http", IHttpLlmApplication<Model>, IHttpLlmFunction<Model>>;
+}

package/lib/context/AgenticaHttpOperation.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgenticaHttpOperation = void 0;
+const AgenticaOperationBase_1 = require("./AgenticaOperationBase");
+class AgenticaHttpOperation extends AgenticaOperationBase_1.AgenticaOperationBase {
+    constructor(props) {
+        super(props);
+    }
+}
+exports.AgenticaHttpOperation = AgenticaHttpOperation;
+//# sourceMappingURL=AgenticaHttpOperation.js.map

package/lib/context/AgenticaHttpOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgenticaHttpOperation.js","sourceRoot":"","sources":["../../src/context/AgenticaHttpOperation.ts"],"names":[],"mappings":";;;AAMA,mEAAgE;AAEhE,MAAa,qBAEX,SAAQ,6CAIT;IACC,YAAmB,KAA0C;QAC3D,KAAK,CAAC,KAAK,CAAC,CAAC;IACf,CAAC;CACF;AAVD,sDAUC"}

package/lib/context/AgenticaOperation.d.ts

@@ -0,0 +1,46 @@
+import { IHttpLlmFunction, ILlmFunction, ILlmSchema } from "@samchon/openapi";
+import { IAgenticaOperationJson } from "../json/IAgenticaOperationJson";
+import { IAgenticaController } from "../structures/IAgenticaController";
+/**
+ * Operation information in the Agentica Agent.
+ *
+ * `AgenticaOperation` 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 AgenticaOperation<Model extends ILlmSchema.Model> = AgenticaOperation.Class<Model> | AgenticaOperation.Http<Model>;
+export declare namespace AgenticaOperation {
+    export type Class<Model extends ILlmSchema.Model> = Base<"class", IAgenticaController.IClass<Model>, ILlmFunction<Model>>;
+    export type Http<Model extends ILlmSchema.Model> = Base<"http", IAgenticaController.IHttp<Model>, IHttpLlmFunction<Model>>;
+    interface Base<Protocol extends "http" | "class", Controller extends object, Function extends object> {
+        /**
+         * Protocol discriminator.
+         */
+        protocol: Protocol;
+        /**
+         * Belonged controller of the target function.
+         */
+        controller: Controller;
+        /**
+         * Target function to call.
+         */
+        function: Function;
+        /**
+         * Identifier name.
+         */
+        name: string;
+        /**
+         * Convert to primitive JSON object.
+         */
+        toJSON(): IAgenticaOperationJson;
+    }
+    export {};
+}

package/lib/{structures/IAgenticaContext.js → context/AgenticaOperation.js}

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

package/lib/context/AgenticaOperation.js.map

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

package/lib/context/AgenticaOperationBase.d.ts

@@ -0,0 +1,29 @@
+import { IAgenticaOperationJson } from "../json/IAgenticaOperationJson";
+export declare abstract class AgenticaOperationBase<Protocol extends "http" | "class", Controller extends object, Function extends object> {
+    /**
+     * Protocol discriminator.
+     */
+    readonly protocol: Protocol;
+    /**
+     * Belonged controller of the target function.
+     */
+    readonly controller: Controller;
+    /**
+     * Target function to call.
+     */
+    readonly function: Function;
+    /**
+     * Identifier name.
+     */
+    readonly name: string;
+    protected constructor(props: AgenticaOperationBase.IProps<Protocol, Controller, Function>);
+    toJSON(): IAgenticaOperationJson;
+}
+export declare namespace AgenticaOperationBase {
+    interface IProps<Protocol extends "http" | "class", Controller extends object, Function extends object> {
+        protocol: Protocol;
+        controller: Controller;
+        function: Function;
+        name: string;
+    }
+}

package/lib/context/AgenticaOperationBase.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgenticaOperationBase = void 0;
+class AgenticaOperationBase {
+    constructor(props) {
+        this.protocol = props.protocol;
+        this.controller = props.controller;
+        this.function = props.function;
+        this.name = props.name;
+    }
+    toJSON() {
+        return {
+            protocol: this.protocol,
+            controller: this.controller.constructor.name,
+            function: this.function.constructor.name,
+            name: this.name,
+        };
+    }
+}
+exports.AgenticaOperationBase = AgenticaOperationBase;
+//# sourceMappingURL=AgenticaOperationBase.js.map

package/lib/context/AgenticaOperationBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgenticaOperationBase.js","sourceRoot":"","sources":["../../src/context/AgenticaOperationBase.ts"],"names":[],"mappings":";;;AAEA,MAAsB,qBAAqB;IAyBzC,YACE,KAAmE;QAEnE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAEM,MAAM;QACX,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI;YAC5C,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI;YACxC,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;IACJ,CAAC;CACF;AA1CD,sDA0CC"}

package/lib/{structures/IAgenticaOperationCollection.d.ts → context/AgenticaOperationCollection.d.ts}

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

package/lib/{structures/IAgenticaOperationSelection.js → context/AgenticaOperationCollection.js}

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

package/lib/context/AgenticaOperationCollection.js.map

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

package/lib/context/AgenticaOperationSelection.d.ts

@@ -0,0 +1,15 @@
+import { ILlmSchema } from "@samchon/openapi";
+import { IAgenticaOperationSelectionJson } from "../json/IAgenticaOperationSelectionJson";
+import { AgenticaOperation } from "./AgenticaOperation";
+export declare class AgenticaOperationSelection<Model extends ILlmSchema.Model> {
+    readonly operation: AgenticaOperation<Model>;
+    readonly reason: string;
+    constructor(props: AgenticaOperationSelection.IProps<Model>);
+    toJSON(): IAgenticaOperationSelectionJson;
+}
+export declare namespace AgenticaOperationSelection {
+    interface IProps<Model extends ILlmSchema.Model> {
+        operation: AgenticaOperation<Model>;
+        reason: string;
+    }
+}

package/lib/context/AgenticaOperationSelection.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgenticaOperationSelection = void 0;
+class AgenticaOperationSelection {
+    constructor(props) {
+        this.operation = props.operation;
+        this.reason = props.reason;
+    }
+    toJSON() {
+        return {
+            operation: this.operation.toJSON(),
+            reason: this.reason,
+        };
+    }
+}
+exports.AgenticaOperationSelection = AgenticaOperationSelection;
+//# sourceMappingURL=AgenticaOperationSelection.js.map

package/lib/context/AgenticaOperationSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgenticaOperationSelection.js","sourceRoot":"","sources":["../../src/context/AgenticaOperationSelection.ts"],"names":[],"mappings":";;;AAKA,MAAa,0BAA0B;IAIrC,YAAmB,KAA+C;QAChE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;IAEM,MAAM;QACX,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;YAClC,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF;AAfD,gEAeC"}

package/lib/context/AgenticaTokenUsage.d.ts

@@ -0,0 +1,82 @@
+import { IAgenticaTokenUsageJson } from "../json/IAgenticaTokenUsageJson";
+export declare class AgenticaTokenUsage implements IAgenticaTokenUsageJson {
+    /**
+     * Aggregated token usage.
+     */
+    readonly aggregate: IAgenticaTokenUsageJson.IComponent;
+    /**
+     * Token uasge of initializer agent.
+     */
+    readonly initialize: IAgenticaTokenUsageJson.IComponent;
+    /**
+     * Token usage of function selector agent.
+     */
+    readonly select: IAgenticaTokenUsageJson.IComponent;
+    /**
+     * Token usage of function canceler agent.
+     */
+    readonly cancel: IAgenticaTokenUsageJson.IComponent;
+    /**
+     * Token usage of function caller agent.
+     */
+    readonly call: IAgenticaTokenUsageJson.IComponent;
+    /**
+     * Token usage of function calling describer agent.
+     */
+    readonly describe: IAgenticaTokenUsageJson.IComponent;
+    constructor(props?: IAgenticaTokenUsageJson);
+    increment(y: IAgenticaTokenUsageJson): void;
+    toJSON(): IAgenticaTokenUsageJson;
+    static zero(): AgenticaTokenUsage;
+    static plus(x: AgenticaTokenUsage, y: AgenticaTokenUsage): AgenticaTokenUsage;
+}
+export declare namespace AgenticaTokenUsage {
+    interface IComponent {
+        /**
+         * Total token usage.
+         */
+        total: number;
+        /**
+         * Input token usage of detailed.
+         */
+        input: IInput;
+        /**
+         * Output token usage of detailed.
+         */
+        output: IOutput;
+    }
+    /**
+     * Input token usage of detailed.
+     */
+    interface IInput {
+        /**
+         * Total amount of input token uasge.
+         */
+        total: number;
+        /**
+         * Cached token usage.
+         */
+        cached: number;
+    }
+    /**
+     * Output token usage of detailed.
+     */
+    interface IOutput {
+        /**
+         * Total amount of output token usage.
+         */
+        total: number;
+        /**
+         * Reasoning token usage.
+         */
+        reasoning: number;
+        /**
+         * Prediction token usage.
+         */
+        accepted_prediction: number;
+        /**
+         * Rejected prediction token usage.
+         */
+        rejected_prediction: number;
+    }
+}

package/lib/context/AgenticaTokenUsage.js

@@ -0,0 +1,97 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgenticaTokenUsage = void 0;
+const typia_1 = __importDefault(require("typia"));
+class AgenticaTokenUsage {
+    constructor(props) {
+        if (props === undefined) {
+            const zero = AgenticaTokenUsage.zero();
+            this.aggregate = zero.aggregate;
+            this.initialize = zero.initialize;
+            this.select = zero.select;
+            this.cancel = zero.cancel;
+            this.call = zero.call;
+            this.describe = zero.describe;
+        }
+        else {
+            this.aggregate = props.aggregate;
+            this.initialize = props.initialize;
+            this.select = props.select;
+            this.cancel = props.cancel;
+            this.call = props.call;
+            this.describe = props.describe;
+        }
+    }
+    increment(y) {
+        const increment = (x, y) => {
+            x.total += y.total;
+            x.input.total += y.input.total;
+            x.input.cached += y.input.cached;
+            x.output.total += y.output.total;
+            x.output.reasoning += y.output.reasoning;
+            x.output.accepted_prediction += y.output.accepted_prediction;
+            x.output.rejected_prediction += y.output.rejected_prediction;
+        };
+        increment(this.aggregate, y.aggregate);
+        increment(this.initialize, y.initialize);
+        increment(this.select, y.select);
+        increment(this.cancel, y.cancel);
+        increment(this.call, y.call);
+        increment(this.describe, y.describe);
+    }
+    toJSON() {
+        return (() => { const _co0 = input => ({
+            aggregate: _co1(input.aggregate),
+            initialize: _co1(input.initialize),
+            select: _co1(input.select),
+            cancel: _co1(input.cancel),
+            call: _co1(input.call),
+            describe: _co1(input.describe)
+        }); const _co1 = input => ({
+            total: input.total,
+            input: _co2(input.input),
+            output: _co3(input.output)
+        }); const _co2 = input => ({
+            total: input.total,
+            cached: input.cached
+        }); const _co3 = input => ({
+            total: input.total,
+            reasoning: input.reasoning,
+            accepted_prediction: input.accepted_prediction,
+            rejected_prediction: input.rejected_prediction
+        }); const _io1 = input => "number" === typeof input.total && ("object" === typeof input.input && null !== input.input && _io2(input.input)) && ("object" === typeof input.output && null !== input.output && _io3(input.output)); const _io2 = input => "number" === typeof input.total && "number" === typeof input.cached; const _io3 = input => "number" === typeof input.total && "number" === typeof input.reasoning && "number" === typeof input.accepted_prediction && "number" === typeof input.rejected_prediction; return input => _co0(input); })()(this);
+    }
+    static zero() {
+        const component = () => ({
+            total: 0,
+            input: {
+                total: 0,
+                cached: 0,
+            },
+            output: {
+                total: 0,
+                reasoning: 0,
+                accepted_prediction: 0,
+                rejected_prediction: 0,
+            },
+        });
+        return new AgenticaTokenUsage({
+            aggregate: component(),
+            initialize: component(),
+            select: component(),
+            cancel: component(),
+            call: component(),
+            describe: component(),
+        });
+    }
+    static plus(x, y) {
+        const z = new AgenticaTokenUsage(x);
+        z.increment(y.toJSON());
+        return z;
+    }
+}
+exports.AgenticaTokenUsage = AgenticaTokenUsage;
+//# sourceMappingURL=AgenticaTokenUsage.js.map

package/lib/context/AgenticaTokenUsage.js.map

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

package/lib/context/internal/AgenticaTokenUsageAggregator.d.ts

@@ -0,0 +1,10 @@
+import { CompletionUsage } from "openai/resources";
+import { Primitive } from "typia";
+import { AgenticaTokenUsage } from "../AgenticaTokenUsage";
+export declare namespace AgenticaTokenUsageAggregator {
+    const aggregate: (props: {
+        kind: Exclude<keyof Primitive<AgenticaTokenUsage>, "aggregate">;
+        completionUsage: CompletionUsage;
+        usage: AgenticaTokenUsage;
+    }) => void;
+}

package/lib/{internal → context/internal}/AgenticaTokenUsageAggregator.js

@@ -43,51 +43,5 @@ var AgenticaTokenUsageAggregator;
         aggregate.output.accepted_prediction = sum((comp) => comp.output.accepted_prediction);
         aggregate.output.rejected_prediction = sum((comp) => comp.output.rejected_prediction);
     };
-    AgenticaTokenUsageAggregator.plus = (x, y) => {
-        const component = (a, b) => ({
-            total: a.total + b.total,
-            input: {
-                total: a.input.total + b.input.total,
-                cached: a.input.cached + b.input.cached,
-            },
-            output: {
-                total: a.output.total + b.output.total,
-                reasoning: a.output.reasoning + b.output.reasoning,
-                accepted_prediction: a.output.accepted_prediction + b.output.accepted_prediction,
-                rejected_prediction: a.output.rejected_prediction + b.output.rejected_prediction,
-            },
-        });
-        return {
-            aggregate: component(x.aggregate, y.aggregate),
-            initialize: component(x.initialize, y.initialize),
-            select: component(x.select, y.select),
-            cancel: component(x.cancel, y.cancel),
-            call: component(x.call, y.call),
-            describe: component(x.describe, y.describe),
-        };
-    };
-    AgenticaTokenUsageAggregator.zero = () => {
-        const component = () => ({
-            total: 0,
-            input: {
-                total: 0,
-                cached: 0,
-            },
-            output: {
-                total: 0,
-                reasoning: 0,
-                accepted_prediction: 0,
-                rejected_prediction: 0,
-            },
-        });
-        return {
-            aggregate: component(),
-            initialize: component(),
-            select: component(),
-            cancel: component(),
-            call: component(),
-            describe: component(),
-        };
-    };
 })(AgenticaTokenUsageAggregator || (exports.AgenticaTokenUsageAggregator = AgenticaTokenUsageAggregator = {}));
 //# sourceMappingURL=AgenticaTokenUsageAggregator.js.map

package/lib/context/internal/AgenticaTokenUsageAggregator.js.map

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

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

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

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

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

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

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

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

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

package/lib/events/AgenticaCallEvent.d.ts

@@ -0,0 +1,18 @@
+import { ILlmSchema } from "@samchon/openapi";
+import { AgenticaOperation } from "../context/AgenticaOperation";
+import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+import { AgenticaEventBase } from "./AgenticaEventBase";
+export declare class AgenticaCallEvent<Model extends ILlmSchema.Model> extends AgenticaEventBase<"call"> {
+    readonly id: string;
+    readonly operation: AgenticaOperation<Model>;
+    arguments: Record<string, any>;
+    constructor(props: AgenticaCallEvent.IProps<Model>);
+    toJSON(): IAgenticaEventJson.ICall;
+}
+export declare namespace AgenticaCallEvent {
+    interface IProps<Model extends ILlmSchema.Model> {
+        id: string;
+        operation: AgenticaOperation<Model>;
+        arguments: Record<string, any>;
+    }
+}

package/lib/events/AgenticaCallEvent.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgenticaCallEvent = void 0;
+const AgenticaEventBase_1 = require("./AgenticaEventBase");
+class AgenticaCallEvent extends AgenticaEventBase_1.AgenticaEventBase {
+    constructor(props) {
+        super("call");
+        this.id = props.id;
+        this.operation = props.operation;
+        this.arguments = props.arguments;
+    }
+    toJSON() {
+        return {
+            type: "call",
+            id: this.id,
+            operation: this.operation.toJSON(),
+            arguments: this.arguments,
+        };
+    }
+}
+exports.AgenticaCallEvent = AgenticaCallEvent;
+//# sourceMappingURL=AgenticaCallEvent.js.map

package/lib/events/AgenticaCallEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgenticaCallEvent.js","sourceRoot":"","sources":["../../src/events/AgenticaCallEvent.ts"],"names":[],"mappings":";;;AAIA,2DAAwD;AAExD,MAAa,iBAEX,SAAQ,qCAAyB;IAKjC,YAAmB,KAAsC;QACvD,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IACnC,CAAC;IAEM,MAAM;QACX,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;YAClC,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;CACF;AAtBD,8CAsBC"}