@agentica/core 0.7.0 → 0.8.0

package/src/internal/AgenticaTokenUsageAggregator.ts

@@ -0,0 +1,123 @@
+import OpenAI from "openai";
+
+import { IAgenticaTokenUsage } from "../structures/IAgenticaTokenUsage";
+
+export namespace AgenticaTokenUsageAggregator {
+  export const aggregate = (props: {
+    kind: Exclude<keyof IAgenticaTokenUsage, "aggregate">;
+    completion: OpenAI.ChatCompletion;
+    usage: IAgenticaTokenUsage;
+  }): void => {
+    if (!props.completion.usage) return;
+
+    //----
+    // COMPONENT
+    //----
+    const component: IAgenticaTokenUsage.IComponent<any> =
+      props.usage[props.kind];
+
+    // TOTAL
+    component.total += props.completion.usage.total_tokens;
+
+    // PROMPT
+    component.input.total += props.completion.usage.prompt_tokens;
+    props.completion.usage.prompt_tokens_details?.audio_tokens ?? 0;
+    component.input.cached +=
+      props.completion.usage.prompt_tokens_details?.cached_tokens ?? 0;
+
+    // COMPLETION
+    component.output.total += props.completion.usage.total_tokens;
+    component.output.accepted_prediction +=
+      props.completion.usage.completion_tokens_details
+        ?.accepted_prediction_tokens ?? 0;
+    component.output.reasoning +=
+      props.completion.usage.completion_tokens_details?.reasoning_tokens ?? 0;
+    component.output.rejected_prediction +=
+      props.completion.usage.completion_tokens_details
+        ?.rejected_prediction_tokens ?? 0;
+
+    //----
+    // RE-AGGREGATE
+    //----
+    const sum = (
+      getter: (comp: IAgenticaTokenUsage.IComponent<any>) => number,
+    ) =>
+      Object.entries(props.usage)
+        .filter(([key]) => key !== "aggregate")
+        .map(([_, comp]) => getter(comp))
+        .reduce((a, b) => a + b, 0);
+    const aggregate: IAgenticaTokenUsage.IComponent<"aggregate"> =
+      props.usage.aggregate;
+    aggregate.total = sum((comp) => comp.total);
+    aggregate.input.total = sum((comp) => comp.input.total);
+    aggregate.input.cached = sum((comp) => comp.input.cached);
+    aggregate.output.total = sum((comp) => comp.output.total);
+    aggregate.output.reasoning = sum((comp) => comp.output.reasoning);
+    aggregate.output.accepted_prediction = sum(
+      (comp) => comp.output.accepted_prediction,
+    );
+    aggregate.output.rejected_prediction = sum(
+      (comp) => comp.output.rejected_prediction,
+    );
+  };
+
+  export const plus = (
+    x: IAgenticaTokenUsage,
+    y: IAgenticaTokenUsage,
+  ): IAgenticaTokenUsage => {
+    const component = <Kind extends string>(
+      a: IAgenticaTokenUsage.IComponent<Kind>,
+      b: IAgenticaTokenUsage.IComponent<Kind>,
+    ): IAgenticaTokenUsage.IComponent<Kind> => ({
+      kind: a.kind,
+      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),
+    };
+  };
+
+  export const zero = (): IAgenticaTokenUsage => {
+    const component = <Kind extends string>(
+      kind: Kind,
+    ): IAgenticaTokenUsage.IComponent<Kind> => ({
+      kind,
+      total: 0,
+      input: {
+        total: 0,
+        cached: 0,
+      },
+      output: {
+        total: 0,
+        reasoning: 0,
+        accepted_prediction: 0,
+        rejected_prediction: 0,
+      },
+    });
+    return {
+      aggregate: component("aggregate"),
+      initialize: component("initialize"),
+      select: component("select"),
+      cancel: component("cancel"),
+      call: component("call"),
+      describe: component("describe"),
+    };
+  };
+}

package/src/structures/IAgenticaTokenUsage.ts

@@ -18,35 +18,95 @@
  */
 export interface IAgenticaTokenUsage {
   /**
-   * Total token usage.
+   * Aggregated token usage.
    */
-  total: number;
+  aggregate: IAgenticaTokenUsage.IComponent<"aggregate">;
 
   /**
-   * Token usage in the prompt.
-   *
-   * In other words, it is called as the input token.
+   * Token uasge of initializer agent.
    */
-  prompt: IAgenticaTokenUsage.IPrompt;
+  initialize: IAgenticaTokenUsage.IComponent<"initialize">;
 
   /**
-   * Token usage in the completion.
-   *
-   * In other words, it is called as the output token.
+   * Token usage of function selector agent.
    */
-  completion: IAgenticaTokenUsage.ICompletion;
+  select: IAgenticaTokenUsage.IComponent<"select">;
+
+  /**
+   * Token usage of function canceler agent.
+   */
+  cancel: IAgenticaTokenUsage.IComponent<"cancel">;
+
+  /**
+   * Token usage of function caller agent.
+   */
+  call: IAgenticaTokenUsage.IComponent<"call">;
+
+  /**
+   * Token usage of function calling describer agent.
+   */
+  describe: IAgenticaTokenUsage.IComponent<"describe">;
 }
 export namespace IAgenticaTokenUsage {
-  export interface IPrompt {
+  export interface IComponent<Kind extends string> {
+    /**
+     * Kind of the token usage.
+     */
+    kind: Kind;
+
+    /**
+     * Total token usage.
+     */
+    total: number;
+
+    /**
+     * Input token usage of detailed.
+     */
+    input: IInput;
+
+    /**
+     * Output token usage of detailed.
+     */
+    output: IOutput;
+  }
+
+  /**
+   * Input token usage of detailed.
+   */
+  export interface IInput {
+    /**
+     * Total amount of input token uasge.
+     */
     total: number;
-    audio: number;
+
+    /**
+     * Cached token usage.
+     */
     cached: number;
   }
-  export interface ICompletion {
+
+  /**
+   * Output token usage of detailed.
+   */
+  export interface IOutput {
+    /**
+     * Total amount of output token usage.
+     */
     total: number;
-    accepted_prediction: number;
-    audio: number;
+
+    /**
+     * Reasoning token usage.
+     */
     reasoning: number;
+
+    /**
+     * Prediction token usage.
+     */
+    accepted_prediction: number;
+
+    /**
+     * Rejected prediction token usage.
+     */
     rejected_prediction: number;
   }
 }

package/src/typings/AgenticaSource.ts

@@ -2,5 +2,5 @@ export type AgenticaSource =
   | "initialize"
   | "select"
   | "cancel"
-  | "execute"
+  | "call"
   | "describe";

package/lib/internal/AgenticaCostAggregator.d.ts

@@ -1,5 +0,0 @@
-import OpenAI from "openai";
-import { IAgenticaTokenUsage } from "../structures/IAgenticaTokenUsage";
-export declare namespace AgenticaCostAggregator {
-    const aggregate: (cost: IAgenticaTokenUsage, completion: OpenAI.ChatCompletion) => void;
-}

package/lib/internal/AgenticaCostAggregator.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgenticaCostAggregator = void 0;
-var AgenticaCostAggregator;
-(function (AgenticaCostAggregator) {
-    AgenticaCostAggregator.aggregate = (cost, completion) => {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
-        if (!completion.usage)
-            return;
-        // TOTAL
-        cost.total += completion.usage.total_tokens;
-        // PROMPT
-        cost.prompt.total += completion.usage.prompt_tokens;
-        cost.prompt.audio +=
-            (_b = (_a = completion.usage.prompt_tokens_details) === null || _a === void 0 ? void 0 : _a.audio_tokens) !== null && _b !== void 0 ? _b : 0;
-        cost.prompt.cached +=
-            (_d = (_c = completion.usage.prompt_tokens_details) === null || _c === void 0 ? void 0 : _c.cached_tokens) !== null && _d !== void 0 ? _d : 0;
-        // COMPLETION
-        cost.completion.total += completion.usage.total_tokens;
-        cost.completion.accepted_prediction +=
-            (_f = (_e = completion.usage.completion_tokens_details) === null || _e === void 0 ? void 0 : _e.accepted_prediction_tokens) !== null && _f !== void 0 ? _f : 0;
-        cost.completion.audio +=
-            (_h = (_g = completion.usage.completion_tokens_details) === null || _g === void 0 ? void 0 : _g.audio_tokens) !== null && _h !== void 0 ? _h : 0;
-        cost.completion.reasoning +=
-            (_k = (_j = completion.usage.completion_tokens_details) === null || _j === void 0 ? void 0 : _j.reasoning_tokens) !== null && _k !== void 0 ? _k : 0;
-        cost.completion.rejected_prediction +=
-            (_m = (_l = completion.usage.completion_tokens_details) === null || _l === void 0 ? void 0 : _l.rejected_prediction_tokens) !== null && _m !== void 0 ? _m : 0;
-    };
-})(AgenticaCostAggregator || (exports.AgenticaCostAggregator = AgenticaCostAggregator = {}));
-//# sourceMappingURL=AgenticaCostAggregator.js.map

package/lib/internal/AgenticaCostAggregator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgenticaCostAggregator.js","sourceRoot":"","sources":["../../src/internal/AgenticaCostAggregator.ts"],"names":[],"mappings":";;;AAIA,IAAiB,sBAAsB,CA8BtC;AA9BD,WAAiB,sBAAsB;IACxB,gCAAS,GAAG,CACvB,IAAyB,EACzB,UAAiC,EAC3B,EAAE;;QACR,IAAI,CAAC,UAAU,CAAC,KAAK;YAAE,OAAO;QAE9B,QAAQ;QACR,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC;QAE5C,SAAS;QACT,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAA,MAAA,UAAU,CAAC,KAAK,CAAC,qBAAqB,0CAAE,YAAY,mCAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,CAAC,MAAM;YAChB,MAAA,MAAA,UAAU,CAAC,KAAK,CAAC,qBAAqB,0CAAE,aAAa,mCAAI,CAAC,CAAC;QAE7D,aAAa;QACb,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC;QACvD,IAAI,CAAC,UAAU,CAAC,mBAAmB;YACjC,MAAA,MAAA,UAAU,CAAC,KAAK,CAAC,yBAAyB,0CAAE,0BAA0B,mCACtE,CAAC,CAAC;QACJ,IAAI,CAAC,UAAU,CAAC,KAAK;YACnB,MAAA,MAAA,UAAU,CAAC,KAAK,CAAC,yBAAyB,0CAAE,YAAY,mCAAI,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,CAAC,SAAS;YACvB,MAAA,MAAA,UAAU,CAAC,KAAK,CAAC,yBAAyB,0CAAE,gBAAgB,mCAAI,CAAC,CAAC;QACpE,IAAI,CAAC,UAAU,CAAC,mBAAmB;YACjC,MAAA,MAAA,UAAU,CAAC,KAAK,CAAC,yBAAyB,0CAAE,0BAA0B,mCACtE,CAAC,CAAC;IACN,CAAC,CAAC;AACJ,CAAC,EA9BgB,sBAAsB,sCAAtB,sBAAsB,QA8BtC"}

package/src/internal/AgenticaCostAggregator.ts

@@ -1,35 +0,0 @@
-import OpenAI from "openai";
-
-import { IAgenticaTokenUsage } from "../structures/IAgenticaTokenUsage";
-
-export namespace AgenticaCostAggregator {
-  export const aggregate = (
-    cost: IAgenticaTokenUsage,
-    completion: OpenAI.ChatCompletion,
-  ): void => {
-    if (!completion.usage) return;
-
-    // TOTAL
-    cost.total += completion.usage.total_tokens;
-
-    // PROMPT
-    cost.prompt.total += completion.usage.prompt_tokens;
-    cost.prompt.audio +=
-      completion.usage.prompt_tokens_details?.audio_tokens ?? 0;
-    cost.prompt.cached +=
-      completion.usage.prompt_tokens_details?.cached_tokens ?? 0;
-
-    // COMPLETION
-    cost.completion.total += completion.usage.total_tokens;
-    cost.completion.accepted_prediction +=
-      completion.usage.completion_tokens_details?.accepted_prediction_tokens ??
-      0;
-    cost.completion.audio +=
-      completion.usage.completion_tokens_details?.audio_tokens ?? 0;
-    cost.completion.reasoning +=
-      completion.usage.completion_tokens_details?.reasoning_tokens ?? 0;
-    cost.completion.rejected_prediction +=
-      completion.usage.completion_tokens_details?.rejected_prediction_tokens ??
-      0;
-  };
-}