@agentica/core 0.23.0 → 0.25.0

package/lib/utils/ChatGptTokenUsageAggregator.spec.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ChatGptTokenUsageAggregator_1 = require("./ChatGptTokenUsageAggregator");
+describe("chatGptTokenUsageAggregator", () => {
+    describe("sum", () => {
+        it("should sum basic token usage", () => {
+            const usage1 = {
+                prompt_tokens: 10,
+                completion_tokens: 5,
+                total_tokens: 15,
+            };
+            const usage2 = {
+                prompt_tokens: 20,
+                completion_tokens: 10,
+                total_tokens: 30,
+            };
+            const result = ChatGptTokenUsageAggregator_1.ChatGptTokenUsageAggregator.sum(usage1, usage2);
+            expect(result).toEqual({
+                prompt_tokens: 30,
+                completion_tokens: 15,
+                total_tokens: 45,
+                completion_tokens_details: {
+                    accepted_prediction_tokens: 0,
+                    reasoning_tokens: 0,
+                    rejected_prediction_tokens: 0,
+                },
+                prompt_tokens_details: {
+                    audio_tokens: 0,
+                    cached_tokens: 0,
+                },
+            });
+        });
+        it("should handle undefined values", () => {
+            const usage1 = {
+                prompt_tokens: 10,
+                completion_tokens: 5,
+                total_tokens: 15,
+            };
+            const usage2 = {
+                // @ts-expect-error - intended to be undefined
+                prompt_tokens: undefined,
+                // @ts-expect-error - intended to be undefined
+                completion_tokens: undefined,
+                // @ts-expect-error - intended to be undefined
+                total_tokens: undefined,
+            };
+            const result = ChatGptTokenUsageAggregator_1.ChatGptTokenUsageAggregator.sum(usage1, usage2);
+            expect(result).toEqual({
+                prompt_tokens: 10,
+                completion_tokens: 5,
+                total_tokens: 15,
+                completion_tokens_details: {
+                    accepted_prediction_tokens: 0,
+                    reasoning_tokens: 0,
+                    rejected_prediction_tokens: 0,
+                },
+                prompt_tokens_details: {
+                    audio_tokens: 0,
+                    cached_tokens: 0,
+                },
+            });
+        });
+        it("should sum completion token details", () => {
+            const usage1 = {
+                prompt_tokens: 10,
+                completion_tokens: 5,
+                total_tokens: 15,
+                completion_tokens_details: {
+                    accepted_prediction_tokens: 3,
+                    reasoning_tokens: 1,
+                    rejected_prediction_tokens: 1,
+                },
+            };
+            const usage2 = {
+                prompt_tokens: 20,
+                completion_tokens: 10,
+                total_tokens: 30,
+                completion_tokens_details: {
+                    accepted_prediction_tokens: 7,
+                    reasoning_tokens: 2,
+                    rejected_prediction_tokens: 1,
+                },
+            };
+            const result = ChatGptTokenUsageAggregator_1.ChatGptTokenUsageAggregator.sum(usage1, usage2);
+            expect(result.completion_tokens_details).toEqual({
+                accepted_prediction_tokens: 10,
+                reasoning_tokens: 3,
+                rejected_prediction_tokens: 2,
+            });
+        });
+        it("should handle undefined completion token details", () => {
+            const usage1 = {
+                prompt_tokens: 10,
+                completion_tokens: 5,
+                total_tokens: 15,
+                completion_tokens_details: {
+                    accepted_prediction_tokens: 3,
+                    reasoning_tokens: 1,
+                    rejected_prediction_tokens: 1,
+                },
+            };
+            const usage2 = {
+                prompt_tokens: 20,
+                completion_tokens: 10,
+                total_tokens: 30,
+            };
+            const result = ChatGptTokenUsageAggregator_1.ChatGptTokenUsageAggregator.sum(usage1, usage2);
+            expect(result.completion_tokens_details).toEqual({
+                accepted_prediction_tokens: 3,
+                reasoning_tokens: 1,
+                rejected_prediction_tokens: 1,
+            });
+        });
+        it("should sum prompt token details", () => {
+            const usage1 = {
+                prompt_tokens: 10,
+                completion_tokens: 5,
+                total_tokens: 15,
+                prompt_tokens_details: {
+                    audio_tokens: 3,
+                    cached_tokens: 2,
+                },
+            };
+            const usage2 = {
+                prompt_tokens: 20,
+                completion_tokens: 10,
+                total_tokens: 30,
+                prompt_tokens_details: {
+                    audio_tokens: 7,
+                    cached_tokens: 3,
+                },
+            };
+            const result = ChatGptTokenUsageAggregator_1.ChatGptTokenUsageAggregator.sum(usage1, usage2);
+            expect(result.prompt_tokens_details).toEqual({
+                audio_tokens: 10,
+                cached_tokens: 5,
+            });
+        });
+        it("should handle undefined prompt token details", () => {
+            const usage1 = {
+                prompt_tokens: 10,
+                completion_tokens: 5,
+                total_tokens: 15,
+                prompt_tokens_details: {
+                    audio_tokens: 3,
+                    cached_tokens: 2,
+                },
+            };
+            const usage2 = {
+                prompt_tokens: 20,
+                completion_tokens: 10,
+                total_tokens: 30,
+            };
+            const result = ChatGptTokenUsageAggregator_1.ChatGptTokenUsageAggregator.sum(usage1, usage2);
+            expect(result.prompt_tokens_details).toEqual({
+                audio_tokens: 3,
+                cached_tokens: 2,
+            });
+        });
+        it("should handle all undefined values", () => {
+            const usage1 = {
+                // @ts-expect-error - intended to be undefined
+                prompt_tokens: undefined,
+                // @ts-expect-error - intended to be undefined
+                completion_tokens: undefined,
+                // @ts-expect-error - intended to be undefined
+                total_tokens: undefined,
+                completion_tokens_details: undefined,
+                prompt_tokens_details: undefined,
+            };
+            const usage2 = {
+                // @ts-expect-error - intended to be undefined
+                prompt_tokens: undefined,
+                // @ts-expect-error - intended to be undefined
+                completion_tokens: undefined,
+                // @ts-expect-error - intended to be undefined
+                total_tokens: undefined,
+                completion_tokens_details: undefined,
+                prompt_tokens_details: undefined,
+            };
+            const result = ChatGptTokenUsageAggregator_1.ChatGptTokenUsageAggregator.sum(usage1, usage2);
+            expect(result).toEqual({
+                prompt_tokens: 0,
+                completion_tokens: 0,
+                total_tokens: 0,
+                completion_tokens_details: {
+                    accepted_prediction_tokens: 0,
+                    reasoning_tokens: 0,
+                    rejected_prediction_tokens: 0,
+                },
+                prompt_tokens_details: {
+                    audio_tokens: 0,
+                    cached_tokens: 0,
+                },
+            });
+        });
+    });
+});
+//# sourceMappingURL=ChatGptTokenUsageAggregator.spec.js.map

package/lib/utils/ChatGptTokenUsageAggregator.spec.js.map

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

package/lib/utils/Singleton.js

@@ -7,6 +7,24 @@ exports.Singleton = void 0;
 const NOT_MOUNTED_YET = {};
 /**
  * @internal
+ *
+ * @description
+ * A singleton class that creates a single instance of a class.
+ *
+ * @example
+ * ```ts
+ * const singleton = new Singleton((name: string) => new SomeClass(name));
+ * const instance = singleton.get("test");
+ * ```
+ *
+ * but next case is not work
+ * ```ts
+ * const singleton = new Singleton((name: string) => new SomeClass(name));
+ * const instance = singleton.get("test");
+ * const instance2 = singleton.get("test2");
+ *
+ * expect(instance).toBe(instance2); // true
+ * ```
  */
 class Singleton {
     constructor(closure) {

package/lib/utils/Singleton.js.map

@@ -1 +1 @@
-{"version":3,"file":"Singleton.js","sourceRoot":"","sources":["../../src/utils/Singleton.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B;;GAEG;AACH,MAAa,SAAS;IAIpB,YAAmB,OAA6B;QAC9C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC;IAChC,CAAC;IAEM,GAAG,CAAC,GAAG,IAAU;QACtB,IAAI,IAAI,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC,MAAW,CAAC;IAC1B,CAAC;CACF;AAfD,8BAeC"}
+{"version":3,"file":"Singleton.js","sourceRoot":"","sources":["../../src/utils/Singleton.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAa,SAAS;IAIpB,YAAmB,OAA6B;QAC9C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC;IAChC,CAAC;IAEM,GAAG,CAAC,GAAG,IAAU;QACtB,IAAI,IAAI,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC,MAAW,CAAC;IAC1B,CAAC;CACF;AAfD,8BAeC"}

package/lib/utils/Singleton.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/utils/Singleton.spec.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const Singleton_1 = require("./Singleton");
+describe("singleton", () => {
+    describe("basic functionality", () => {
+        it("should create instance only once", () => {
+            const factory = () => ({ value: 42 });
+            const singleton = new Singleton_1.Singleton(factory);
+            const instance1 = singleton.get();
+            const instance2 = singleton.get();
+            expect(instance1).toBe(instance2);
+            expect(instance1.value).toBe(42);
+        });
+        it("should create different instances for different singletons", () => {
+            const factory1 = () => ({ value: 42 });
+            const factory2 = () => ({ value: 24 });
+            const singleton1 = new Singleton_1.Singleton(factory1);
+            const singleton2 = new Singleton_1.Singleton(factory2);
+            const instance1 = singleton1.get();
+            const instance2 = singleton2.get();
+            expect(instance1).not.toBe(instance2);
+            expect(instance1.value).toBe(42);
+            expect(instance2.value).toBe(24);
+        });
+    });
+    describe("constructor arguments", () => {
+        it("should pass constructor arguments to factory", () => {
+            const factory = (value) => ({ value });
+            const singleton = new Singleton_1.Singleton(factory);
+            const instance = singleton.get(42);
+            expect(instance.value).toBe(42);
+        });
+        it("should use same instance with same constructor arguments", () => {
+            const factory = (value) => ({ value });
+            const singleton = new Singleton_1.Singleton(factory);
+            const instance1 = singleton.get(42);
+            const instance2 = singleton.get(42);
+            expect(instance1).toBe(instance2);
+            expect(instance1.value).toBe(42);
+        });
+        it("should return same instance even with different constructor arguments", () => {
+            const factory = (value) => ({ value });
+            const singleton = new Singleton_1.Singleton(factory);
+            const instance1 = singleton.get(42);
+            const instance2 = singleton.get(24);
+            expect(instance1).toBe(instance2);
+            expect(instance1.value).toBe(42);
+            expect(instance2.value).toBe(42);
+        });
+    });
+    describe("complex object types", () => {
+        it("should handle complex objects", () => {
+            const factory = (id, name, value) => ({
+                id,
+                data: { name, value },
+                timestamp: new Date(),
+            });
+            const singleton = new Singleton_1.Singleton(factory);
+            const instance = singleton.get(1, "test", 42);
+            expect(instance.id).toBe(1);
+            expect(instance.data.name).toBe("test");
+            expect(instance.data.value).toBe(42);
+            expect(instance.timestamp).toBeInstanceOf(Date);
+        });
+        it("should maintain same complex object instance", () => {
+            const factory = () => ({
+                data: new Map([["key", 42]]),
+                array: [1, 2, 3],
+            });
+            const singleton = new Singleton_1.Singleton(factory);
+            const instance1 = singleton.get();
+            const instance2 = singleton.get();
+            expect(instance1).toBe(instance2);
+            expect(instance1.data).toBe(instance2.data);
+            expect(instance1.array).toBe(instance2.array);
+        });
+    });
+    describe("edge cases", () => {
+        it("should handle null factory return", () => {
+            const factory = () => null;
+            const singleton = new Singleton_1.Singleton(factory);
+            const instance = singleton.get();
+            expect(instance).toBeNull();
+        });
+        it("should handle undefined factory return", () => {
+            const factory = () => undefined;
+            const singleton = new Singleton_1.Singleton(factory);
+            const instance = singleton.get();
+            expect(instance).toBeUndefined();
+        });
+        it("should handle primitive values", () => {
+            const factory = () => 42;
+            const singleton = new Singleton_1.Singleton(factory);
+            const instance = singleton.get();
+            expect(instance).toBe(42);
+        });
+        it("should handle factory throwing error", () => {
+            const factory = () => {
+                throw new Error("Factory error");
+            };
+            const singleton = new Singleton_1.Singleton(factory);
+            expect(() => singleton.get()).toThrow("Factory error");
+        });
+    });
+});
+//# sourceMappingURL=Singleton.spec.js.map

package/lib/utils/Singleton.spec.js.map

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

package/lib/utils/__map_take.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/utils/__map_take.spec.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const __map_take_1 = require("./__map_take");
+describe("__map_take", () => {
+    describe("basic functionality", () => {
+        it("should generate value for new key", () => {
+            const map = new Map();
+            const generator = () => 42;
+            const result = (0, __map_take_1.__map_take)(map, "test", generator);
+            expect(result).toBe(42);
+            expect(map.get("test")).toBe(42);
+        });
+        it("should return existing value for existing key", () => {
+            const map = new Map();
+            map.set("test", 100);
+            const generator = () => 42;
+            const result = (0, __map_take_1.__map_take)(map, "test", generator);
+            expect(result).toBe(100);
+            expect(map.get("test")).toBe(100);
+        });
+    });
+    describe("various type tests", () => {
+        it("should handle object type", () => {
+            const map = new Map();
+            const generator = () => ({ value: 42 });
+            const result = (0, __map_take_1.__map_take)(map, "test", generator);
+            expect(result).toEqual({ value: 42 });
+            expect(map.get("test")).toEqual({ value: 42 });
+        });
+        it("should handle array type", () => {
+            const map = new Map();
+            const generator = () => [1, 2, 3];
+            const result = (0, __map_take_1.__map_take)(map, "test", generator);
+            expect(result).toEqual([1, 2, 3]);
+            expect(map.get("test")).toEqual([1, 2, 3]);
+        });
+        it("should handle function type", () => {
+            var _a;
+            const map = new Map();
+            const generator = () => () => 42;
+            const result = (0, __map_take_1.__map_take)(map, "test", generator);
+            expect(result()).toBe(42);
+            expect((_a = map.get("test")) === null || _a === void 0 ? void 0 : _a()).toBe(42);
+        });
+    });
+    describe("edge cases", () => {
+        it("should handle null key", () => {
+            const map = new Map();
+            const generator = () => "test";
+            const result = (0, __map_take_1.__map_take)(map, null, generator);
+            expect(result).toBe("test");
+            expect(map.get(null)).toBe("test");
+        });
+        it("should handle undefined key", () => {
+            const map = new Map();
+            const generator = () => "test";
+            const result = (0, __map_take_1.__map_take)(map, undefined, generator);
+            expect(result).toBe("test");
+            expect(map.get(undefined)).toBe("test");
+        });
+        it("should handle empty string key", () => {
+            const map = new Map();
+            const generator = () => "test";
+            const result = (0, __map_take_1.__map_take)(map, "", generator);
+            expect(result).toBe("test");
+            expect(map.get("")).toBe("test");
+        });
+    });
+    describe("generator function tests", () => {
+        it("should not call generator multiple times", () => {
+            const map = new Map();
+            let callCount = 0;
+            const generator = () => {
+                callCount++;
+                return 42;
+            };
+            (0, __map_take_1.__map_take)(map, "test", generator);
+            (0, __map_take_1.__map_take)(map, "test", generator);
+            expect(callCount).toBe(1);
+        });
+        it("should handle generator throwing error", () => {
+            const map = new Map();
+            const generator = () => {
+                throw new Error("Generator error");
+            };
+            expect(() => (0, __map_take_1.__map_take)(map, "test", generator)).toThrow("Generator error");
+        });
+        it("should handle generator returning undefined", () => {
+            const map = new Map();
+            const generator = () => undefined;
+            const result = (0, __map_take_1.__map_take)(map, "test", generator);
+            expect(result).toBeUndefined();
+            expect(map.get("test")).toBeUndefined();
+        });
+    });
+    describe("concurrency tests", () => {
+        it("should handle concurrent access to same key", () => {
+            const map = new Map();
+            const generator = () => 42;
+            const result1 = (0, __map_take_1.__map_take)(map, "test", generator);
+            const result2 = (0, __map_take_1.__map_take)(map, "test", generator);
+            expect(result1).toBe(42);
+            expect(result2).toBe(42);
+            expect(map.get("test")).toBe(42);
+        });
+    });
+});
+//# sourceMappingURL=__map_take.spec.js.map

package/lib/utils/__map_take.spec.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentica/core",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "Agentic AI Library specialized in LLM Function Calling",
   "author": "Wrtn Technologies",
   "license": "MIT",
@@ -36,14 +36,13 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@modelcontextprotocol/sdk": "^1.9.0",
-    "@samchon/openapi": "^4.2.0",
+    "@samchon/openapi": "^4.3.0",
     "openai": "^4.80.0",
-    "typia": "^9.0.1"
+    "typia": "^9.3.0"
   },
   "dependencies": {
-    "@samchon/openapi": "^4.2.0",
-    "typia": "^9.0.1",
+    "@samchon/openapi": "^4.3.0",
+    "typia": "^9.3.0",
     "uuid": "^11.0.4"
   },
   "devDependencies": {

package/src/Agentica.ts

@@ -6,8 +6,9 @@ import type { AgenticaOperationCollection } from "./context/AgenticaOperationCol
 import type { AgenticaOperationSelection } from "./context/AgenticaOperationSelection";
 import type { AgenticaEvent } from "./events/AgenticaEvent";
 import type { AgenticaRequestEvent } from "./events/AgenticaRequestEvent";
+import type { AgenticaUserMessageContent } from "./histories";
 import type { AgenticaHistory } from "./histories/AgenticaHistory";
-import type { AgenticaUserInputHistory } from "./histories/AgenticaUserInputHistory";
+import type { AgenticaUserMessageHistory } from "./histories/AgenticaUserMessageHistory";
 import type { IAgenticaConfig } from "./structures/IAgenticaConfig";
 import type { IAgenticaController } from "./structures/IAgenticaController";
 import type { IAgenticaProps } from "./structures/IAgenticaProps";
@@ -16,10 +17,10 @@ import type { IAgenticaVendor } from "./structures/IAgenticaVendor";
 import { AgenticaTokenUsage } from "./context/AgenticaTokenUsage";
 import { AgenticaOperationComposer } from "./context/internal/AgenticaOperationComposer";
 import { AgenticaTokenUsageAggregator } from "./context/internal/AgenticaTokenUsageAggregator";
-import { createUserInputHistory } from "./factory";
-import { createInitializeEvent, createRequestEvent, createUserInputEvent } from "./factory/events";
+import { createUserMessageHistory } from "./factory";
+import { createInitializeEvent, createRequestEvent, createUserMessageEvent } from "./factory/events";
 import { execute } from "./orchestrate/execute";
-import { AgenticaHistoryTransformer } from "./transformers/AgenticaHistoryTransformer";
+import { transformHistory } from "./transformers/transformHistory";
 import { __map_take } from "./utils/__map_take";
 import { ChatGptCompletionMessageUtil } from "./utils/ChatGptCompletionMessageUtil";
 import { streamDefaultReaderToAsyncGenerator, StreamUtil } from "./utils/StreamUtil";
@@ -86,7 +87,7 @@ export class Agentica<Model extends ILlmSchema.Model> {
     this.stack_ = [];
     this.listeners_ = new Map();
     this.histories_ = (props.histories ?? []).map(input =>
-      AgenticaHistoryTransformer.transform({
+      transformHistory({
         operations: this.operations_.group,
         history: input,
       }),
@@ -124,10 +125,18 @@ export class Agentica<Model extends ILlmSchema.Model> {
    * function calling information like {@link AgenticaExecuteHistory}.
    *
    * @param content The content to talk
+   * @param options Options
+   * @param options.abortSignal Abort signal
+   * @throws AbortError
    * @returns List of newly created chat prompts
    */
-  public async conversate(content: string | AgenticaUserInputHistory.Contents | Array<AgenticaUserInputHistory.Contents>): Promise<AgenticaHistory<Model>[]> {
-    const prompt: AgenticaUserInputHistory = createUserInputHistory({
+  public async conversate(
+    content: string | AgenticaUserMessageContent | Array<AgenticaUserMessageContent>,
+    options: {
+      abortSignal?: AbortSignal;
+    } = {},
+  ): Promise<AgenticaHistory<Model>[]> {
+    const prompt: AgenticaUserMessageHistory = createUserMessageHistory({
       contents: Array.isArray(content)
         ? content
         : typeof content === "string"
@@ -139,7 +148,7 @@ export class Agentica<Model extends ILlmSchema.Model> {
     });
 
     this.dispatch(
-      createUserInputEvent({
+      createUserMessageEvent({
         contents: prompt.contents,
       }),
     ).catch(() => {});
@@ -147,6 +156,7 @@ export class Agentica<Model extends ILlmSchema.Model> {
     const newbie: AgenticaHistory<Model>[] = await this.executor_(
       this.getContext({
         prompt,
+        abortSignal: options.abortSignal,
         usage: this.token_usage_,
       }),
     );
@@ -217,8 +227,9 @@ export class Agentica<Model extends ILlmSchema.Model> {
    * @internal
    */
   public getContext(props: {
-    prompt: AgenticaUserInputHistory;
+    prompt: AgenticaUserMessageHistory;
     usage: AgenticaTokenUsage;
+    abortSignal?: AbortSignal;
   }): AgenticaContext<Model> {
     const dispatch = async (event: AgenticaEvent<Model>) => this.dispatch(event);
     return {
@@ -231,6 +242,7 @@ export class Agentica<Model extends ILlmSchema.Model> {
       stack: this.stack_,
       ready: () => this.ready_,
       prompt: props.prompt,
+      abortSignal: props.abortSignal,
 
       // HANDLERS
       dispatch: async event => this.dispatch(event),
@@ -246,7 +258,10 @@ export class Agentica<Model extends ILlmSchema.Model> {
               include_usage: true,
             },
           },
-          options: this.props.vendor.options,
+          options: {
+            ...this.props.vendor.options,
+            signal: props.abortSignal,
+          },
         });
         await dispatch(event);