@agentica/core 0.44.0-dev.20260313-2 → 0.44.1

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 (154) 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 -7
  6. package/lib/index.mjs.map +1 -1
  7. package/lib/orchestrate/call.js +16 -16
  8. package/lib/orchestrate/cancel.js +1 -1
  9. package/lib/orchestrate/cancel.js.map +1 -1
  10. package/lib/orchestrate/initialize.js +44 -2
  11. package/lib/orchestrate/initialize.js.map +1 -1
  12. package/lib/orchestrate/select.js +1 -1
  13. package/lib/orchestrate/select.js.map +1 -1
  14. package/lib/structures/IAgenticaController.d.ts +143 -143
  15. package/lib/utils/ChatGptCompletionMessageUtil.js +6 -6
  16. package/package.json +6 -6
  17. package/prompts/cancel.md +5 -5
  18. package/prompts/common.md +3 -3
  19. package/prompts/describe.md +7 -7
  20. package/prompts/execute.md +122 -122
  21. package/prompts/initialize.md +3 -3
  22. package/prompts/json_parse_error.md +35 -35
  23. package/prompts/select.md +7 -7
  24. package/prompts/validate.md +123 -123
  25. package/prompts/validate_repeated.md +31 -31
  26. package/src/Agentica.ts +367 -367
  27. package/src/MicroAgentica.ts +357 -357
  28. package/src/constants/AgenticaConstant.ts +4 -4
  29. package/src/constants/AgenticaDefaultPrompt.ts +44 -44
  30. package/src/constants/index.ts +2 -2
  31. package/src/context/AgenticaContext.ts +136 -136
  32. package/src/context/AgenticaContextRequestResult.ts +14 -14
  33. package/src/context/AgenticaOperation.ts +73 -73
  34. package/src/context/AgenticaOperationCollection.ts +49 -49
  35. package/src/context/AgenticaOperationSelection.ts +9 -9
  36. package/src/context/AgenticaTokenUsage.ts +186 -186
  37. package/src/context/MicroAgenticaContext.ts +99 -99
  38. package/src/context/index.ts +5 -5
  39. package/src/context/internal/AgenticaOperationComposer.ts +177 -177
  40. package/src/context/internal/AgenticaTokenUsageAggregator.ts +66 -66
  41. package/src/context/internal/__IChatCancelFunctionsApplication.ts +23 -23
  42. package/src/context/internal/__IChatFunctionReference.ts +21 -21
  43. package/src/context/internal/__IChatInitialApplication.ts +13 -15
  44. package/src/context/internal/__IChatSelectFunctionsApplication.ts +24 -24
  45. package/src/context/internal/isAgenticaContext.ts +11 -11
  46. package/src/errors/AgenticaJsonParseError.ts +52 -52
  47. package/src/errors/AgenticaValidationError.ts +49 -49
  48. package/src/errors/index.ts +2 -2
  49. package/src/events/AgenticaAssistantMessageEvent.ts +12 -12
  50. package/src/events/AgenticaCallEvent.ts +27 -27
  51. package/src/events/AgenticaCancelEvent.ts +9 -9
  52. package/src/events/AgenticaDescribeEvent.ts +14 -14
  53. package/src/events/AgenticaEvent.ts +59 -59
  54. package/src/events/AgenticaEvent.type.ts +19 -19
  55. package/src/events/AgenticaEventBase.ts +18 -18
  56. package/src/events/AgenticaEventSource.ts +6 -6
  57. package/src/events/AgenticaExecuteEvent.ts +45 -45
  58. package/src/events/AgenticaInitializeEvent.ts +7 -7
  59. package/src/events/AgenticaJsonParseErrorEvent.ts +16 -16
  60. package/src/events/AgenticaRequestEvent.ts +27 -27
  61. package/src/events/AgenticaResponseEvent.ts +32 -32
  62. package/src/events/AgenticaSelectEvent.ts +11 -11
  63. package/src/events/AgenticaUserMessageEvent.ts +12 -12
  64. package/src/events/AgenticaValidateEvent.ts +32 -32
  65. package/src/events/MicroAgenticaEvent.ts +45 -45
  66. package/src/events/index.ts +15 -15
  67. package/src/factory/events.ts +357 -357
  68. package/src/factory/histories.ts +348 -348
  69. package/src/factory/index.ts +3 -3
  70. package/src/factory/operations.ts +16 -16
  71. package/src/functional/assertHttpController.ts +106 -106
  72. package/src/functional/assertHttpLlmApplication.ts +52 -52
  73. package/src/functional/assertMcpController.ts +47 -47
  74. package/src/functional/createMcpLlmApplication.ts +72 -72
  75. package/src/functional/index.ts +7 -7
  76. package/src/functional/validateHttpController.ts +113 -113
  77. package/src/functional/validateHttpLlmApplication.ts +65 -65
  78. package/src/functional/validateMcpController.ts +53 -53
  79. package/src/histories/AgenticaAssistantMessageHistory.ts +10 -10
  80. package/src/histories/AgenticaCancelHistory.ts +8 -8
  81. package/src/histories/AgenticaDescribeHistory.ts +18 -18
  82. package/src/histories/AgenticaExecuteHistory.ts +64 -64
  83. package/src/histories/AgenticaHistory.ts +28 -28
  84. package/src/histories/AgenticaHistoryBase.ts +35 -35
  85. package/src/histories/AgenticaSelectHistory.ts +8 -8
  86. package/src/histories/AgenticaSystemMessageHistory.ts +10 -10
  87. package/src/histories/AgenticaUserMessageHistory.ts +11 -11
  88. package/src/histories/MicroAgenticaHistory.ts +19 -19
  89. package/src/histories/contents/AgenticaUserMessageAudioContent.ts +21 -21
  90. package/src/histories/contents/AgenticaUserMessageContent.ts +19 -19
  91. package/src/histories/contents/AgenticaUserMessageContentBase.ts +6 -6
  92. package/src/histories/contents/AgenticaUserMessageFileContent.ts +25 -25
  93. package/src/histories/contents/AgenticaUserMessageImageContent.ts +33 -33
  94. package/src/histories/contents/AgenticaUserMessageTextContent.ts +15 -15
  95. package/src/histories/contents/index.ts +5 -5
  96. package/src/histories/index.ts +10 -10
  97. package/src/index.ts +15 -15
  98. package/src/json/IAgenticaEventJson.ts +265 -265
  99. package/src/json/IAgenticaEventJson.type.ts +19 -19
  100. package/src/json/IAgenticaHistoryJson.ts +165 -165
  101. package/src/json/IAgenticaHistoryJson.type.ts +19 -19
  102. package/src/json/IAgenticaOperationJson.ts +36 -36
  103. package/src/json/IAgenticaOperationSelectionJson.ts +26 -26
  104. package/src/json/IAgenticaTokenUsageJson.ts +107 -107
  105. package/src/json/IMicroAgenticaEventJson.ts +22 -22
  106. package/src/json/IMicroAgenticaHistoryJson.ts +25 -25
  107. package/src/json/index.ts +7 -7
  108. package/src/orchestrate/call.ts +542 -542
  109. package/src/orchestrate/cancel.ts +265 -265
  110. package/src/orchestrate/describe.ts +66 -66
  111. package/src/orchestrate/execute.ts +61 -61
  112. package/src/orchestrate/index.ts +6 -6
  113. package/src/orchestrate/initialize.ts +102 -102
  114. package/src/orchestrate/internal/cancelFunctionFromContext.ts +33 -33
  115. package/src/orchestrate/internal/selectFunctionFromContext.ts +34 -34
  116. package/src/orchestrate/select.ts +320 -320
  117. package/src/structures/IAgenticaConfig.ts +83 -83
  118. package/src/structures/IAgenticaConfigBase.ts +87 -87
  119. package/src/structures/IAgenticaController.ts +143 -143
  120. package/src/structures/IAgenticaExecutor.ts +167 -167
  121. package/src/structures/IAgenticaProps.ts +78 -78
  122. package/src/structures/IAgenticaSystemPrompt.ts +236 -236
  123. package/src/structures/IAgenticaVendor.ts +54 -54
  124. package/src/structures/IMcpTool.ts +60 -60
  125. package/src/structures/IMicroAgenticaConfig.ts +56 -56
  126. package/src/structures/IMicroAgenticaExecutor.ts +67 -67
  127. package/src/structures/IMicroAgenticaProps.ts +77 -77
  128. package/src/structures/IMicroAgenticaSystemPrompt.ts +169 -169
  129. package/src/structures/index.ts +10 -10
  130. package/src/transformers/transformHistory.ts +172 -172
  131. package/src/utils/AssistantMessageEmptyError.ts +20 -20
  132. package/src/utils/AsyncQueue.spec.ts +355 -355
  133. package/src/utils/AsyncQueue.ts +95 -95
  134. package/src/utils/ByteArrayUtil.ts +5 -5
  135. package/src/utils/ChatGptCompletionMessageUtil.spec.ts +314 -314
  136. package/src/utils/ChatGptCompletionMessageUtil.ts +210 -210
  137. package/src/utils/ChatGptCompletionStreamingUtil.spec.ts +909 -909
  138. package/src/utils/ChatGptCompletionStreamingUtil.ts +91 -91
  139. package/src/utils/ChatGptTokenUsageAggregator.spec.ts +226 -226
  140. package/src/utils/ChatGptTokenUsageAggregator.ts +57 -57
  141. package/src/utils/MPSC.spec.ts +276 -276
  142. package/src/utils/MPSC.ts +42 -42
  143. package/src/utils/Singleton.spec.ts +138 -138
  144. package/src/utils/Singleton.ts +42 -42
  145. package/src/utils/StreamUtil.spec.ts +512 -512
  146. package/src/utils/StreamUtil.ts +87 -87
  147. package/src/utils/__map_take.spec.ts +140 -140
  148. package/src/utils/__map_take.ts +13 -13
  149. package/src/utils/__retry.spec.ts +198 -198
  150. package/src/utils/__retry.ts +18 -18
  151. package/src/utils/assertExecuteFailure.ts +16 -16
  152. package/src/utils/index.ts +4 -4
  153. package/src/utils/request.ts +140 -140
  154. package/src/utils/types.ts +50 -50
@@ -1,107 +1,107 @@
1
- /**
2
- * Token usage information from the A.I. chatbot.
3
- *
4
- * `IAgenticaTokenUsageJson` is a structure representing the token usage
5
- * information from the {@link Agentica} class. And you can get the
6
- * token usage information by calling the {@link Agentica.getTokenUsage}
7
- * method.
8
- *
9
- * For reference, `IAgenticaTokenUsageJson` provides only the token usage
10
- * information, and does not contain any price or cost information. It is
11
- * because the price or cost can be changed by below reasons.
12
- *
13
- * - Type of {@link IAgenticaProps.vendor LLM vendor}
14
- * - {@link IAgenticaVendor.model} in the LLM vendor.
15
- * - Just by a policy change of the LLM vendor company.
16
- *
17
- * @author Samchon
18
- */
19
- export interface IAgenticaTokenUsageJson {
20
- /**
21
- * Aggregated token usage.
22
- */
23
- aggregate: IAgenticaTokenUsageJson.IComponent;
24
-
25
- /**
26
- * Token uasge of initializer agent.
27
- */
28
- initialize: IAgenticaTokenUsageJson.IComponent;
29
-
30
- /**
31
- * Token usage of function selector agent.
32
- */
33
- select: IAgenticaTokenUsageJson.IComponent;
34
-
35
- /**
36
- * Token usage of function canceler agent.
37
- */
38
- cancel: IAgenticaTokenUsageJson.IComponent;
39
-
40
- /**
41
- * Token usage of function caller agent.
42
- */
43
- call: IAgenticaTokenUsageJson.IComponent;
44
-
45
- /**
46
- * Token usage of function calling describer agent.
47
- */
48
- describe: IAgenticaTokenUsageJson.IComponent;
49
- }
50
- export namespace IAgenticaTokenUsageJson {
51
- export interface IComponent {
52
- /**
53
- * Total token usage.
54
- */
55
- total: number;
56
-
57
- /**
58
- * Input token usage of detailed.
59
- */
60
- input: IInput;
61
-
62
- /**
63
- * Output token usage of detailed.
64
- */
65
- output: IOutput;
66
- }
67
-
68
- /**
69
- * Input token usage of detailed.
70
- */
71
- export interface IInput {
72
- /**
73
- * Total amount of input token uasge.
74
- */
75
- total: number;
76
-
77
- /**
78
- * Cached token usage.
79
- */
80
- cached: number;
81
- }
82
-
83
- /**
84
- * Output token usage of detailed.
85
- */
86
- export interface IOutput {
87
- /**
88
- * Total amount of output token usage.
89
- */
90
- total: number;
91
-
92
- /**
93
- * Reasoning token usage.
94
- */
95
- reasoning: number;
96
-
97
- /**
98
- * Prediction token usage.
99
- */
100
- accepted_prediction: number;
101
-
102
- /**
103
- * Rejected prediction token usage.
104
- */
105
- rejected_prediction: number;
106
- }
107
- }
1
+ /**
2
+ * Token usage information from the A.I. chatbot.
3
+ *
4
+ * `IAgenticaTokenUsageJson` is a structure representing the token usage
5
+ * information from the {@link Agentica} class. And you can get the
6
+ * token usage information by calling the {@link Agentica.getTokenUsage}
7
+ * method.
8
+ *
9
+ * For reference, `IAgenticaTokenUsageJson` provides only the token usage
10
+ * information, and does not contain any price or cost information. It is
11
+ * because the price or cost can be changed by below reasons.
12
+ *
13
+ * - Type of {@link IAgenticaProps.vendor LLM vendor}
14
+ * - {@link IAgenticaVendor.model} in the LLM vendor.
15
+ * - Just by a policy change of the LLM vendor company.
16
+ *
17
+ * @author Samchon
18
+ */
19
+ export interface IAgenticaTokenUsageJson {
20
+ /**
21
+ * Aggregated token usage.
22
+ */
23
+ aggregate: IAgenticaTokenUsageJson.IComponent;
24
+
25
+ /**
26
+ * Token uasge of initializer agent.
27
+ */
28
+ initialize: IAgenticaTokenUsageJson.IComponent;
29
+
30
+ /**
31
+ * Token usage of function selector agent.
32
+ */
33
+ select: IAgenticaTokenUsageJson.IComponent;
34
+
35
+ /**
36
+ * Token usage of function canceler agent.
37
+ */
38
+ cancel: IAgenticaTokenUsageJson.IComponent;
39
+
40
+ /**
41
+ * Token usage of function caller agent.
42
+ */
43
+ call: IAgenticaTokenUsageJson.IComponent;
44
+
45
+ /**
46
+ * Token usage of function calling describer agent.
47
+ */
48
+ describe: IAgenticaTokenUsageJson.IComponent;
49
+ }
50
+ export namespace IAgenticaTokenUsageJson {
51
+ export interface IComponent {
52
+ /**
53
+ * Total token usage.
54
+ */
55
+ total: number;
56
+
57
+ /**
58
+ * Input token usage of detailed.
59
+ */
60
+ input: IInput;
61
+
62
+ /**
63
+ * Output token usage of detailed.
64
+ */
65
+ output: IOutput;
66
+ }
67
+
68
+ /**
69
+ * Input token usage of detailed.
70
+ */
71
+ export interface IInput {
72
+ /**
73
+ * Total amount of input token uasge.
74
+ */
75
+ total: number;
76
+
77
+ /**
78
+ * Cached token usage.
79
+ */
80
+ cached: number;
81
+ }
82
+
83
+ /**
84
+ * Output token usage of detailed.
85
+ */
86
+ export interface IOutput {
87
+ /**
88
+ * Total amount of output token usage.
89
+ */
90
+ total: number;
91
+
92
+ /**
93
+ * Reasoning token usage.
94
+ */
95
+ reasoning: number;
96
+
97
+ /**
98
+ * Prediction token usage.
99
+ */
100
+ accepted_prediction: number;
101
+
102
+ /**
103
+ * Rejected prediction token usage.
104
+ */
105
+ rejected_prediction: number;
106
+ }
107
+ }
@@ -1,22 +1,22 @@
1
- import type { IAgenticaEventJson } from "./IAgenticaEventJson";
2
-
3
- /**
4
- * Micro Agentic AI agent event.
5
- *
6
- * `IMicroAgenticaEventJson` is an union type of all possible events
7
- * that can be emitted by the A.I. chatbot of the {@link MicroAgentica}
8
- * class.
9
- *
10
- * You can discriminate the subtype by checking the {@link type} property.
11
- *
12
- * @author Samchon
13
- */
14
- export type IMicroAgenticaEventJson
15
- = | IAgenticaEventJson.IUserMessage
16
- | IAgenticaEventJson.IAssistantMessage
17
- | IAgenticaEventJson.ICall
18
- | IAgenticaEventJson.IDescribe
19
- | IAgenticaEventJson.IExecute
20
- | IAgenticaEventJson.IInitialize
21
- | IAgenticaEventJson.IRequest
22
- | IAgenticaEventJson.IValidate;
1
+ import type { IAgenticaEventJson } from "./IAgenticaEventJson";
2
+
3
+ /**
4
+ * Micro Agentic AI agent event.
5
+ *
6
+ * `IMicroAgenticaEventJson` is an union type of all possible events
7
+ * that can be emitted by the A.I. chatbot of the {@link MicroAgentica}
8
+ * class.
9
+ *
10
+ * You can discriminate the subtype by checking the {@link type} property.
11
+ *
12
+ * @author Samchon
13
+ */
14
+ export type IMicroAgenticaEventJson
15
+ = | IAgenticaEventJson.IUserMessage
16
+ | IAgenticaEventJson.IAssistantMessage
17
+ | IAgenticaEventJson.ICall
18
+ | IAgenticaEventJson.IDescribe
19
+ | IAgenticaEventJson.IExecute
20
+ | IAgenticaEventJson.IInitialize
21
+ | IAgenticaEventJson.IRequest
22
+ | IAgenticaEventJson.IValidate;
@@ -1,25 +1,25 @@
1
- import type { IAgenticaHistoryJson } from "./IAgenticaHistoryJson";
2
-
3
- /**
4
- * Micro Agentic AI agent prompt.
5
- *
6
- * `IMicroAgenticaPromptJson` is an union type of all possible prompts
7
- * that can be generated by the AI chatbot of the {@link MicroAgentica}
8
- * class.
9
- *
10
- * In other words, `IMicroAgenticaPromptJson` is a type of chat history
11
- * that is occurred during the conversation between the user and the
12
- * AI chatbot in the {@link MicroAgentica} class.
13
- *
14
- * If you want to continue the previous A.I. chatbot session, you can
15
- * accomplish it by assigning the {@link IMicroAgenticaProps.histories}
16
- * property when creating a new {@link MicroAgentica} instance.
17
- *
18
- * @author Samchon
19
- */
20
- export type IMicroAgenticaHistoryJson
21
- = | IAgenticaHistoryJson.IExecute
22
- | IAgenticaHistoryJson.IDescribe
23
- | IAgenticaHistoryJson.IAssistantMessage
24
- | IAgenticaHistoryJson.ISystemMessage
25
- | IAgenticaHistoryJson.IUserMessage;
1
+ import type { IAgenticaHistoryJson } from "./IAgenticaHistoryJson";
2
+
3
+ /**
4
+ * Micro Agentic AI agent prompt.
5
+ *
6
+ * `IMicroAgenticaPromptJson` is an union type of all possible prompts
7
+ * that can be generated by the AI chatbot of the {@link MicroAgentica}
8
+ * class.
9
+ *
10
+ * In other words, `IMicroAgenticaPromptJson` is a type of chat history
11
+ * that is occurred during the conversation between the user and the
12
+ * AI chatbot in the {@link MicroAgentica} class.
13
+ *
14
+ * If you want to continue the previous A.I. chatbot session, you can
15
+ * accomplish it by assigning the {@link IMicroAgenticaProps.histories}
16
+ * property when creating a new {@link MicroAgentica} instance.
17
+ *
18
+ * @author Samchon
19
+ */
20
+ export type IMicroAgenticaHistoryJson
21
+ = | IAgenticaHistoryJson.IExecute
22
+ | IAgenticaHistoryJson.IDescribe
23
+ | IAgenticaHistoryJson.IAssistantMessage
24
+ | IAgenticaHistoryJson.ISystemMessage
25
+ | IAgenticaHistoryJson.IUserMessage;
package/src/json/index.ts CHANGED
@@ -1,7 +1,7 @@
1
- export * from "./IAgenticaEventJson";
2
- export * from "./IAgenticaHistoryJson";
3
- export * from "./IAgenticaOperationJson";
4
- export * from "./IAgenticaOperationSelectionJson";
5
- export * from "./IAgenticaTokenUsageJson";
6
- export * from "./IMicroAgenticaEventJson";
7
- export * from "./IMicroAgenticaHistoryJson";
1
+ export * from "./IAgenticaEventJson";
2
+ export * from "./IAgenticaHistoryJson";
3
+ export * from "./IAgenticaOperationJson";
4
+ export * from "./IAgenticaOperationSelectionJson";
5
+ export * from "./IAgenticaTokenUsageJson";
6
+ export * from "./IMicroAgenticaEventJson";
7
+ export * from "./IMicroAgenticaHistoryJson";