@agentica/core 0.44.0-dev.20260313-2 → 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,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";