@agentica/core 0.23.0 → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/README.md +1 -1
  2. package/lib/Agentica.d.ts +6 -1
  3. package/lib/Agentica.js +8 -3
  4. package/lib/Agentica.js.map +1 -1
  5. package/lib/context/AgenticaContext.d.ts +4 -0
  6. package/lib/histories/AgenticaUserInputHistory.d.ts +13 -7
  7. package/lib/index.mjs +7 -2
  8. package/lib/index.mjs.map +1 -1
  9. package/lib/utils/ChatGptCompletionMessageUtil.spec.d.ts +1 -0
  10. package/lib/utils/ChatGptCompletionMessageUtil.spec.js +288 -0
  11. package/lib/utils/ChatGptCompletionMessageUtil.spec.js.map +1 -0
  12. package/lib/utils/ChatGptTokenUsageAggregator.spec.d.ts +1 -0
  13. package/lib/utils/ChatGptTokenUsageAggregator.spec.js +199 -0
  14. package/lib/utils/ChatGptTokenUsageAggregator.spec.js.map +1 -0
  15. package/lib/utils/Singleton.js +18 -0
  16. package/lib/utils/Singleton.js.map +1 -1
  17. package/lib/utils/Singleton.spec.d.ts +1 -0
  18. package/lib/utils/Singleton.spec.js +106 -0
  19. package/lib/utils/Singleton.spec.js.map +1 -0
  20. package/lib/utils/__map_take.spec.d.ts +1 -0
  21. package/lib/utils/__map_take.spec.js +108 -0
  22. package/lib/utils/__map_take.spec.js.map +1 -0
  23. package/package.json +1 -1
  24. package/src/Agentica.ts +16 -2
  25. package/src/context/AgenticaContext.ts +5 -0
  26. package/src/histories/AgenticaUserInputHistory.ts +14 -8
  27. package/src/utils/ChatGptCompletionMessageUtil.spec.ts +320 -0
  28. package/src/utils/ChatGptTokenUsageAggregator.spec.ts +226 -0
  29. package/src/utils/Singleton.spec.ts +138 -0
  30. package/src/utils/Singleton.ts +18 -0
  31. package/src/utils/__map_take.spec.ts +140 -0
  32. package/lib/utils/MathUtil.d.ts +0 -3
  33. package/lib/utils/MathUtil.js +0 -8
  34. package/lib/utils/MathUtil.js.map +0 -1
  35. package/src/utils/MathUtil.ts +0 -3
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  <!-- https://github.com/user-attachments/assets/5326cc59-5129-470d-abcb-c3f458b5c488 -->
4
4
 
5
- ![Logo](https://wrtnlabs.io/agentica/og.jpg?refresh)
5
+ ![Logo](https://wrtnlabs.io/agentica/og.jpg)
6
6
 
7
7
  [![GitHub License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/wrtnlabs/agentica/blob/master/LICENSE)
8
8
  [![NPM Version](https://img.shields.io/npm/v/@agentica/core.svg)](https://www.npmjs.com/package/@agentica/core)
package/lib/Agentica.d.ts CHANGED
@@ -60,9 +60,14 @@ export declare class Agentica<Model extends ILlmSchema.Model> {
60
60
  * function calling information like {@link AgenticaExecuteHistory}.
61
61
  *
62
62
  * @param content The content to talk
63
+ * @param options Options
64
+ * @param options.abortSignal Abort signal
65
+ * @throws AbortError
63
66
  * @returns List of newly created chat prompts
64
67
  */
65
- conversate(content: string | AgenticaUserInputHistory.Contents | Array<AgenticaUserInputHistory.Contents>): Promise<AgenticaHistory<Model>[]>;
68
+ conversate(content: string | AgenticaUserInputHistory.Contents | Array<AgenticaUserInputHistory.Contents>, options?: {
69
+ abortSignal?: AbortSignal;
70
+ }): Promise<AgenticaHistory<Model>[]>;
66
71
  /**
67
72
  * Get configuration.
68
73
  */
package/lib/Agentica.js CHANGED
@@ -99,10 +99,13 @@ class Agentica {
99
99
  * function calling information like {@link AgenticaExecuteHistory}.
100
100
  *
101
101
  * @param content The content to talk
102
+ * @param options Options
103
+ * @param options.abortSignal Abort signal
104
+ * @throws AbortError
102
105
  * @returns List of newly created chat prompts
103
106
  */
104
- conversate(content) {
105
- return __awaiter(this, void 0, void 0, function* () {
107
+ conversate(content_1) {
108
+ return __awaiter(this, arguments, void 0, function* (content, options = {}) {
106
109
  const prompt = (0, factory_1.createUserInputHistory)({
107
110
  contents: Array.isArray(content)
108
111
  ? content
@@ -118,6 +121,7 @@ class Agentica {
118
121
  })).catch(() => { });
119
122
  const newbie = yield this.executor_(this.getContext({
120
123
  prompt,
124
+ abortSignal: options.abortSignal,
121
125
  usage: this.token_usage_,
122
126
  }));
123
127
  this.histories_.push(prompt, ...newbie);
@@ -191,6 +195,7 @@ class Agentica {
191
195
  stack: this.stack_,
192
196
  ready: () => this.ready_,
193
197
  prompt: props.prompt,
198
+ abortSignal: props.abortSignal,
194
199
  // HANDLERS
195
200
  dispatch: (event) => __awaiter(this, void 0, void 0, function* () { return this.dispatch(event); }),
196
201
  request: (source, body) => __awaiter(this, void 0, void 0, function* () {
@@ -200,7 +205,7 @@ class Agentica {
200
205
  body: Object.assign(Object.assign({}, body), { model: this.props.vendor.model, stream: true, stream_options: {
201
206
  include_usage: true,
202
207
  } }),
203
- options: this.props.vendor.options,
208
+ options: Object.assign(Object.assign({}, this.props.vendor.options), { signal: props.abortSignal }),
204
209
  });
205
210
  yield dispatch(event);
206
211
  // completion
@@ -1 +1 @@
1
- {"version":3,"file":"Agentica.js","sourceRoot":"","sources":["../src/Agentica.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"Agentica.js","sourceRoot":"","sources":["../src/Agentica.ts"],"names":[],"mappings":"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"}
@@ -73,6 +73,10 @@ export interface AgenticaContext<Model extends ILlmSchema.Model> {
73
73
  * {@link Agentica.conversate} function.
74
74
  */
75
75
  prompt: AgenticaUserInputHistory;
76
+ /**
77
+ * Abort signal.
78
+ */
79
+ abortSignal?: AbortSignal;
76
80
  /**
77
81
  * Whether the agent is ready.
78
82
  *
@@ -1,3 +1,4 @@
1
+ import type typia from "typia";
1
2
  import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
2
3
  import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
3
4
  export interface AgenticaUserInputHistory extends AgenticaHistoryBase<"user_input", IAgenticaHistoryJson.IUserInput> {
@@ -31,7 +32,7 @@ export declare namespace AgenticaUserInputHistory {
31
32
  /**
32
33
  * Either a URL of the image or the base64 encoded image data.
33
34
  */
34
- url: string;
35
+ url: string & typia.tags.Format<"url">;
35
36
  /**
36
37
  * Specifies the detail level of the image. Learn more in the
37
38
  * [Vision guide](https://platform.openai.com/docs/guides/vision#low-or-high-fidelity-image-understanding).
@@ -41,6 +42,8 @@ export declare namespace AgenticaUserInputHistory {
41
42
  }
42
43
  /**
43
44
  * Learn about [audio inputs](https://platform.openai.com/docs/guides/audio).
45
+ *
46
+ * Note: we not recommend it because audio input data only support base64 so it's too big data.
44
47
  */
45
48
  export interface InputAudio extends ContentsBase<"input_audio"> {
46
49
  input_audio: {
@@ -57,22 +60,25 @@ export declare namespace AgenticaUserInputHistory {
57
60
  /**
58
61
  * Learn about [file inputs](https://platform.openai.com/docs/guides/text) for text
59
62
  * generation.
63
+ *
64
+ * Note: we recommend use `file_id` instead of `file_data` because it's too big data.
60
65
  */
61
66
  export interface File extends ContentsBase<"file"> {
62
67
  file: {
63
68
  /**
64
- * The base64 encoded file data, used when passing the file to the model as a
65
- * string.
69
+ * The ID of an uploaded file to use as input.
66
70
  */
67
- file_data?: string;
71
+ file_id: string;
72
+ } | {
68
73
  /**
69
- * The ID of an uploaded file to use as input.
74
+ * The base64 encoded file data, used when passing the file to the model as a
75
+ * string.
70
76
  */
71
- file_id?: string;
77
+ file_data: string;
72
78
  /**
73
79
  * The name of the file, used when passing the file to the model as a string.
74
80
  */
75
- filename?: string;
81
+ filename: string;
76
82
  };
77
83
  }
78
84
  export {};
package/lib/index.mjs CHANGED
@@ -4402,7 +4402,7 @@ class Agentica {
4402
4402
  histories: this.props.histories?.slice()
4403
4403
  });
4404
4404
  }
4405
- async conversate(content) {
4405
+ async conversate(content, options = {}) {
4406
4406
  const prompt = createUserInputHistory({
4407
4407
  contents: Array.isArray(content) ? content : typeof content === "string" ? [ {
4408
4408
  type: "text",
@@ -4414,6 +4414,7 @@ class Agentica {
4414
4414
  })).catch((() => {}));
4415
4415
  const newbie = await this.executor_(this.getContext({
4416
4416
  prompt,
4417
+ abortSignal: options.abortSignal,
4417
4418
  usage: this.token_usage_
4418
4419
  }));
4419
4420
  this.histories_.push(prompt, ...newbie);
@@ -4446,6 +4447,7 @@ class Agentica {
4446
4447
  stack: this.stack_,
4447
4448
  ready: () => this.ready_,
4448
4449
  prompt: props.prompt,
4450
+ abortSignal: props.abortSignal,
4449
4451
  dispatch: async event => this.dispatch(event),
4450
4452
  request: async (source, body) => {
4451
4453
  const event = createRequestEvent({
@@ -4458,7 +4460,10 @@ class Agentica {
4458
4460
  include_usage: true
4459
4461
  }
4460
4462
  },
4461
- options: this.props.vendor.options
4463
+ options: {
4464
+ ...this.props.vendor.options,
4465
+ signal: props.abortSignal
4466
+ }
4462
4467
  });
4463
4468
  await dispatch(event);
4464
4469
  const completion = await this.props.vendor.api.chat.completions.create(event.body, event.options);