@agentica/core 0.44.0-dev.20260313 → 0.44.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 (150) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +218 -218
  3. package/lib/context/internal/__IChatInitialApplication.d.ts +1 -2
  4. package/lib/errors/AgenticaJsonParseError.js +6 -6
  5. package/lib/index.mjs +47 -1
  6. package/lib/index.mjs.map +1 -1
  7. package/lib/orchestrate/call.js +16 -16
  8. package/lib/orchestrate/initialize.js +43 -1
  9. package/lib/orchestrate/initialize.js.map +1 -1
  10. package/lib/structures/IAgenticaController.d.ts +143 -143
  11. package/lib/utils/ChatGptCompletionMessageUtil.js +6 -6
  12. package/package.json +6 -6
  13. package/prompts/cancel.md +5 -5
  14. package/prompts/common.md +3 -3
  15. package/prompts/describe.md +7 -7
  16. package/prompts/execute.md +122 -122
  17. package/prompts/initialize.md +3 -3
  18. package/prompts/json_parse_error.md +35 -35
  19. package/prompts/select.md +7 -7
  20. package/prompts/validate.md +123 -123
  21. package/prompts/validate_repeated.md +31 -31
  22. package/src/Agentica.ts +367 -367
  23. package/src/MicroAgentica.ts +357 -357
  24. package/src/constants/AgenticaConstant.ts +4 -4
  25. package/src/constants/AgenticaDefaultPrompt.ts +44 -44
  26. package/src/constants/index.ts +2 -2
  27. package/src/context/AgenticaContext.ts +136 -136
  28. package/src/context/AgenticaContextRequestResult.ts +14 -14
  29. package/src/context/AgenticaOperation.ts +73 -73
  30. package/src/context/AgenticaOperationCollection.ts +49 -49
  31. package/src/context/AgenticaOperationSelection.ts +9 -9
  32. package/src/context/AgenticaTokenUsage.ts +186 -186
  33. package/src/context/MicroAgenticaContext.ts +99 -99
  34. package/src/context/index.ts +5 -5
  35. package/src/context/internal/AgenticaOperationComposer.ts +177 -177
  36. package/src/context/internal/AgenticaTokenUsageAggregator.ts +66 -66
  37. package/src/context/internal/__IChatCancelFunctionsApplication.ts +23 -23
  38. package/src/context/internal/__IChatFunctionReference.ts +21 -21
  39. package/src/context/internal/__IChatInitialApplication.ts +13 -15
  40. package/src/context/internal/__IChatSelectFunctionsApplication.ts +24 -24
  41. package/src/context/internal/isAgenticaContext.ts +11 -11
  42. package/src/errors/AgenticaJsonParseError.ts +52 -52
  43. package/src/errors/AgenticaValidationError.ts +49 -49
  44. package/src/errors/index.ts +2 -2
  45. package/src/events/AgenticaAssistantMessageEvent.ts +12 -12
  46. package/src/events/AgenticaCallEvent.ts +27 -27
  47. package/src/events/AgenticaCancelEvent.ts +9 -9
  48. package/src/events/AgenticaDescribeEvent.ts +14 -14
  49. package/src/events/AgenticaEvent.ts +59 -59
  50. package/src/events/AgenticaEvent.type.ts +19 -19
  51. package/src/events/AgenticaEventBase.ts +18 -18
  52. package/src/events/AgenticaEventSource.ts +6 -6
  53. package/src/events/AgenticaExecuteEvent.ts +45 -45
  54. package/src/events/AgenticaInitializeEvent.ts +7 -7
  55. package/src/events/AgenticaJsonParseErrorEvent.ts +16 -16
  56. package/src/events/AgenticaRequestEvent.ts +27 -27
  57. package/src/events/AgenticaResponseEvent.ts +32 -32
  58. package/src/events/AgenticaSelectEvent.ts +11 -11
  59. package/src/events/AgenticaUserMessageEvent.ts +12 -12
  60. package/src/events/AgenticaValidateEvent.ts +32 -32
  61. package/src/events/MicroAgenticaEvent.ts +45 -45
  62. package/src/events/index.ts +15 -15
  63. package/src/factory/events.ts +357 -357
  64. package/src/factory/histories.ts +348 -348
  65. package/src/factory/index.ts +3 -3
  66. package/src/factory/operations.ts +16 -16
  67. package/src/functional/assertHttpController.ts +106 -106
  68. package/src/functional/assertHttpLlmApplication.ts +52 -52
  69. package/src/functional/assertMcpController.ts +47 -47
  70. package/src/functional/createMcpLlmApplication.ts +72 -72
  71. package/src/functional/index.ts +7 -7
  72. package/src/functional/validateHttpController.ts +113 -113
  73. package/src/functional/validateHttpLlmApplication.ts +65 -65
  74. package/src/functional/validateMcpController.ts +53 -53
  75. package/src/histories/AgenticaAssistantMessageHistory.ts +10 -10
  76. package/src/histories/AgenticaCancelHistory.ts +8 -8
  77. package/src/histories/AgenticaDescribeHistory.ts +18 -18
  78. package/src/histories/AgenticaExecuteHistory.ts +64 -64
  79. package/src/histories/AgenticaHistory.ts +28 -28
  80. package/src/histories/AgenticaHistoryBase.ts +35 -35
  81. package/src/histories/AgenticaSelectHistory.ts +8 -8
  82. package/src/histories/AgenticaSystemMessageHistory.ts +10 -10
  83. package/src/histories/AgenticaUserMessageHistory.ts +11 -11
  84. package/src/histories/MicroAgenticaHistory.ts +19 -19
  85. package/src/histories/contents/AgenticaUserMessageAudioContent.ts +21 -21
  86. package/src/histories/contents/AgenticaUserMessageContent.ts +19 -19
  87. package/src/histories/contents/AgenticaUserMessageContentBase.ts +6 -6
  88. package/src/histories/contents/AgenticaUserMessageFileContent.ts +25 -25
  89. package/src/histories/contents/AgenticaUserMessageImageContent.ts +33 -33
  90. package/src/histories/contents/AgenticaUserMessageTextContent.ts +15 -15
  91. package/src/histories/contents/index.ts +5 -5
  92. package/src/histories/index.ts +10 -10
  93. package/src/index.ts +15 -15
  94. package/src/json/IAgenticaEventJson.ts +265 -265
  95. package/src/json/IAgenticaEventJson.type.ts +19 -19
  96. package/src/json/IAgenticaHistoryJson.ts +165 -165
  97. package/src/json/IAgenticaHistoryJson.type.ts +19 -19
  98. package/src/json/IAgenticaOperationJson.ts +36 -36
  99. package/src/json/IAgenticaOperationSelectionJson.ts +26 -26
  100. package/src/json/IAgenticaTokenUsageJson.ts +107 -107
  101. package/src/json/IMicroAgenticaEventJson.ts +22 -22
  102. package/src/json/IMicroAgenticaHistoryJson.ts +25 -25
  103. package/src/json/index.ts +7 -7
  104. package/src/orchestrate/call.ts +542 -542
  105. package/src/orchestrate/cancel.ts +265 -265
  106. package/src/orchestrate/describe.ts +66 -66
  107. package/src/orchestrate/execute.ts +61 -61
  108. package/src/orchestrate/index.ts +6 -6
  109. package/src/orchestrate/initialize.ts +102 -102
  110. package/src/orchestrate/internal/cancelFunctionFromContext.ts +33 -33
  111. package/src/orchestrate/internal/selectFunctionFromContext.ts +34 -34
  112. package/src/orchestrate/select.ts +320 -320
  113. package/src/structures/IAgenticaConfig.ts +83 -83
  114. package/src/structures/IAgenticaConfigBase.ts +87 -87
  115. package/src/structures/IAgenticaController.ts +143 -143
  116. package/src/structures/IAgenticaExecutor.ts +167 -167
  117. package/src/structures/IAgenticaProps.ts +78 -78
  118. package/src/structures/IAgenticaSystemPrompt.ts +236 -236
  119. package/src/structures/IAgenticaVendor.ts +54 -54
  120. package/src/structures/IMcpTool.ts +60 -60
  121. package/src/structures/IMicroAgenticaConfig.ts +56 -56
  122. package/src/structures/IMicroAgenticaExecutor.ts +67 -67
  123. package/src/structures/IMicroAgenticaProps.ts +77 -77
  124. package/src/structures/IMicroAgenticaSystemPrompt.ts +169 -169
  125. package/src/structures/index.ts +10 -10
  126. package/src/transformers/transformHistory.ts +172 -172
  127. package/src/utils/AssistantMessageEmptyError.ts +20 -20
  128. package/src/utils/AsyncQueue.spec.ts +355 -355
  129. package/src/utils/AsyncQueue.ts +95 -95
  130. package/src/utils/ByteArrayUtil.ts +5 -5
  131. package/src/utils/ChatGptCompletionMessageUtil.spec.ts +314 -314
  132. package/src/utils/ChatGptCompletionMessageUtil.ts +210 -210
  133. package/src/utils/ChatGptCompletionStreamingUtil.spec.ts +909 -909
  134. package/src/utils/ChatGptCompletionStreamingUtil.ts +91 -91
  135. package/src/utils/ChatGptTokenUsageAggregator.spec.ts +226 -226
  136. package/src/utils/ChatGptTokenUsageAggregator.ts +57 -57
  137. package/src/utils/MPSC.spec.ts +276 -276
  138. package/src/utils/MPSC.ts +42 -42
  139. package/src/utils/Singleton.spec.ts +138 -138
  140. package/src/utils/Singleton.ts +42 -42
  141. package/src/utils/StreamUtil.spec.ts +512 -512
  142. package/src/utils/StreamUtil.ts +87 -87
  143. package/src/utils/__map_take.spec.ts +140 -140
  144. package/src/utils/__map_take.ts +13 -13
  145. package/src/utils/__retry.spec.ts +198 -198
  146. package/src/utils/__retry.ts +18 -18
  147. package/src/utils/assertExecuteFailure.ts +16 -16
  148. package/src/utils/index.ts +4 -4
  149. package/src/utils/request.ts +140 -140
  150. package/src/utils/types.ts +50 -50
@@ -1,95 +1,95 @@
1
- export class AsyncQueueClosedError extends Error {
2
- constructor(message: string) {
3
- super(message);
4
- this.name = "AsyncQueueClosedError";
5
- }
6
- }
7
-
8
- export class AsyncQueue<T> {
9
- private queue: T[] = [];
10
- private resolvers: ((value: IteratorResult<T, undefined>) => void)[] = [];
11
- private closeResolvers: (() => void)[] = [];
12
- private emptyResolvers: (() => void)[] = [];
13
- private closed = false;
14
-
15
- enqueue(item: T) {
16
- if (this.closed) {
17
- console.error(new AsyncQueueClosedError("Cannot enqueue item: queue is closed."));
18
- return;
19
- }
20
-
21
- this.queue.push(item);
22
- if (this.resolvers.length > 0) {
23
- this.resolvers.shift()?.({ value: this.queue.shift()!, done: false });
24
- }
25
- }
26
-
27
- async dequeue(): Promise<IteratorResult<T, undefined>> {
28
- const item = (() => {
29
- if (!this.isEmpty()) {
30
- return { value: this.queue.shift()!, done: false } as const;
31
- }
32
- if (this.isClosed()) {
33
- return { value: undefined, done: true } as const;
34
- }
35
- return null;
36
- })();
37
-
38
- if (this.isEmpty() && this.emptyResolvers.length !== 0) {
39
- this.emptyResolvers.forEach(resolve => resolve());
40
- this.emptyResolvers = [];
41
- }
42
-
43
- if (item !== null) {
44
- return item;
45
- }
46
-
47
- return new Promise(resolve => this.resolvers.push(resolve));
48
- }
49
-
50
- isEmpty() {
51
- return this.queue.length === 0;
52
- }
53
-
54
- isClosed() {
55
- return this.closed;
56
- }
57
-
58
- done() {
59
- return this.isClosed() && this.isEmpty();
60
- }
61
-
62
- close() {
63
- this.closed = true;
64
- while (this.resolvers.length > 0) {
65
- this.resolvers.shift()?.({ value: undefined, done: true });
66
- }
67
- this.closeResolvers.forEach(resolve => resolve());
68
- }
69
-
70
- /**
71
- * Wait until the queue is empty
72
- *
73
- * if the queue is closed, it will not resolve promise
74
- * this function only check the queue is empty
75
- * @returns A promise that resolves when the queue is empty
76
- */
77
- async waitUntilEmpty() {
78
- if (this.isEmpty()) {
79
- return Promise.resolve();
80
- }
81
- return new Promise<void>((resolve) => {
82
- this.emptyResolvers.push(resolve);
83
- });
84
- }
85
-
86
- async waitClosed() {
87
- if (this.isClosed()) {
88
- return Promise.resolve();
89
- }
90
-
91
- return new Promise<void>((resolve) => {
92
- this.closeResolvers.push(resolve);
93
- });
94
- }
95
- }
1
+ export class AsyncQueueClosedError extends Error {
2
+ constructor(message: string) {
3
+ super(message);
4
+ this.name = "AsyncQueueClosedError";
5
+ }
6
+ }
7
+
8
+ export class AsyncQueue<T> {
9
+ private queue: T[] = [];
10
+ private resolvers: ((value: IteratorResult<T, undefined>) => void)[] = [];
11
+ private closeResolvers: (() => void)[] = [];
12
+ private emptyResolvers: (() => void)[] = [];
13
+ private closed = false;
14
+
15
+ enqueue(item: T) {
16
+ if (this.closed) {
17
+ console.error(new AsyncQueueClosedError("Cannot enqueue item: queue is closed."));
18
+ return;
19
+ }
20
+
21
+ this.queue.push(item);
22
+ if (this.resolvers.length > 0) {
23
+ this.resolvers.shift()?.({ value: this.queue.shift()!, done: false });
24
+ }
25
+ }
26
+
27
+ async dequeue(): Promise<IteratorResult<T, undefined>> {
28
+ const item = (() => {
29
+ if (!this.isEmpty()) {
30
+ return { value: this.queue.shift()!, done: false } as const;
31
+ }
32
+ if (this.isClosed()) {
33
+ return { value: undefined, done: true } as const;
34
+ }
35
+ return null;
36
+ })();
37
+
38
+ if (this.isEmpty() && this.emptyResolvers.length !== 0) {
39
+ this.emptyResolvers.forEach(resolve => resolve());
40
+ this.emptyResolvers = [];
41
+ }
42
+
43
+ if (item !== null) {
44
+ return item;
45
+ }
46
+
47
+ return new Promise(resolve => this.resolvers.push(resolve));
48
+ }
49
+
50
+ isEmpty() {
51
+ return this.queue.length === 0;
52
+ }
53
+
54
+ isClosed() {
55
+ return this.closed;
56
+ }
57
+
58
+ done() {
59
+ return this.isClosed() && this.isEmpty();
60
+ }
61
+
62
+ close() {
63
+ this.closed = true;
64
+ while (this.resolvers.length > 0) {
65
+ this.resolvers.shift()?.({ value: undefined, done: true });
66
+ }
67
+ this.closeResolvers.forEach(resolve => resolve());
68
+ }
69
+
70
+ /**
71
+ * Wait until the queue is empty
72
+ *
73
+ * if the queue is closed, it will not resolve promise
74
+ * this function only check the queue is empty
75
+ * @returns A promise that resolves when the queue is empty
76
+ */
77
+ async waitUntilEmpty() {
78
+ if (this.isEmpty()) {
79
+ return Promise.resolve();
80
+ }
81
+ return new Promise<void>((resolve) => {
82
+ this.emptyResolvers.push(resolve);
83
+ });
84
+ }
85
+
86
+ async waitClosed() {
87
+ if (this.isClosed()) {
88
+ return Promise.resolve();
89
+ }
90
+
91
+ return new Promise<void>((resolve) => {
92
+ this.closeResolvers.push(resolve);
93
+ });
94
+ }
95
+ }
@@ -1,5 +1,5 @@
1
- export namespace ByteArrayUtil {
2
- export function toUtf8(byteArray: Uint8Array): string {
3
- return new TextDecoder().decode(byteArray);
4
- }
5
- }
1
+ export namespace ByteArrayUtil {
2
+ export function toUtf8(byteArray: Uint8Array): string {
3
+ return new TextDecoder().decode(byteArray);
4
+ }
5
+ }