@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,172 +1,172 @@
1
- import type { AgenticaOperation } from "../context/AgenticaOperation";
2
- import type { AgenticaUserMessageHistory } from "../histories";
3
- import type { AgenticaAssistantMessageHistory } from "../histories/AgenticaAssistantMessageHistory";
4
- import type { AgenticaCancelHistory } from "../histories/AgenticaCancelHistory";
5
- import type { AgenticaDescribeHistory } from "../histories/AgenticaDescribeHistory";
6
- import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
7
- import type { AgenticaHistory } from "../histories/AgenticaHistory";
8
- import type { AgenticaSelectHistory } from "../histories/AgenticaSelectHistory";
9
- import type { AgenticaSystemMessageHistory } from "../histories/AgenticaSystemMessageHistory";
10
- import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
11
-
12
- import { createAssistantMessageHistory, createCancelHistory, createDescribeHistory, createExecuteHistory, createSelectHistory, createSystemMessageHistory, createUserMessageHistory } from "../factory/histories";
13
- import { createOperationSelection } from "../factory/operations";
14
-
15
- /**
16
- * @internal
17
- */
18
- export function transformHistory(props: {
19
- operations: Map<string, Map<string, AgenticaOperation>>;
20
- history: IAgenticaHistoryJson;
21
- }): AgenticaHistory {
22
- // USER
23
- if (props.history.type === "userMessage") {
24
- return transformUserMessage({
25
- history: props.history,
26
- });
27
- }
28
- // ASSISTANT
29
- else if (props.history.type === "assistantMessage") {
30
- return transformAssistantMessage({
31
- history: props.history,
32
- });
33
- }
34
- // SYSTEM
35
- else if (props.history.type === "systemMessage") {
36
- return transformSystemMessage({
37
- history: props.history,
38
- });
39
- }
40
- // SELECT & CANCEL
41
- else if (props.history.type === "select") {
42
- return transformSelect({
43
- operations: props.operations,
44
- history: props.history,
45
- });
46
- }
47
- else if (props.history.type === "cancel") {
48
- return transformCancel({
49
- operations: props.operations,
50
- history: props.history,
51
- });
52
- }
53
- // EXECUTE
54
- else if (props.history.type === "execute") {
55
- return transformExecute({
56
- operations: props.operations,
57
- history: props.history,
58
- });
59
- }
60
- return transformDescribe({
61
- operations: props.operations,
62
- history: props.history,
63
- });
64
- }
65
-
66
- function transformAssistantMessage(props: {
67
- history: IAgenticaHistoryJson.IAssistantMessage;
68
- }): AgenticaAssistantMessageHistory {
69
- return createAssistantMessageHistory(props.history);
70
- }
71
-
72
- function transformSystemMessage(props: {
73
- history: IAgenticaHistoryJson.ISystemMessage;
74
- }): AgenticaSystemMessageHistory {
75
- return createSystemMessageHistory(props.history);
76
- }
77
-
78
- function transformUserMessage(props: {
79
- history: IAgenticaHistoryJson.IUserMessage;
80
- }): AgenticaUserMessageHistory {
81
- return createUserMessageHistory(props.history);
82
- }
83
-
84
- function transformSelect(props: {
85
- operations: Map<string, Map<string, AgenticaOperation>>;
86
- history: IAgenticaHistoryJson.ISelect;
87
- }): AgenticaSelectHistory {
88
- return createSelectHistory({
89
- id: props.history.id,
90
- created_at: props.history.created_at,
91
- selection: createOperationSelection({
92
- operation: findOperation({
93
- operations: props.operations,
94
- input: props.history.selection.operation,
95
- }),
96
- reason: props.history.selection.reason,
97
- }),
98
- });
99
- }
100
-
101
- function transformCancel(props: {
102
- operations: Map<string, Map<string, AgenticaOperation>>;
103
- history: IAgenticaHistoryJson.ICancel;
104
- }): AgenticaCancelHistory {
105
- return createCancelHistory({
106
- id: props.history.id,
107
- created_at: props.history.created_at,
108
- selection: createOperationSelection({
109
- operation: findOperation({
110
- operations: props.operations,
111
- input: props.history.selection.operation,
112
- }),
113
- reason: props.history.selection.reason,
114
- }),
115
- });
116
- }
117
-
118
- function transformExecute(props: {
119
- operations: Map<string, Map<string, AgenticaOperation>>;
120
- history: IAgenticaHistoryJson.IExecute;
121
- }): AgenticaExecuteHistory {
122
- return createExecuteHistory({
123
- id: props.history.id,
124
- created_at: props.history.created_at,
125
- operation: findOperation({
126
- operations: props.operations,
127
- input: props.history.operation,
128
- }),
129
- arguments: props.history.arguments,
130
- /**
131
- * @TODO fix it
132
- * The property and value have a type mismatch, but it works.
133
- */
134
- value: props.history.value as Record<string, unknown>,
135
- success: props.history.success,
136
- });
137
- }
138
-
139
- function transformDescribe(props: {
140
- operations: Map<string, Map<string, AgenticaOperation>>;
141
- history: IAgenticaHistoryJson.IDescribe;
142
- }): AgenticaDescribeHistory {
143
- return createDescribeHistory({
144
- id: props.history.id,
145
- created_at: props.history.created_at,
146
- text: props.history.text,
147
- executes: props.history.executes.map(next =>
148
- transformExecute({
149
- operations: props.operations,
150
- history: next,
151
- }),
152
- ),
153
- });
154
- }
155
-
156
- function findOperation(props: {
157
- operations: Map<string, Map<string, AgenticaOperation>>;
158
- input: {
159
- controller: string;
160
- function: string;
161
- };
162
- }): AgenticaOperation {
163
- const found: AgenticaOperation | undefined = props.operations
164
- .get(props.input.controller)
165
- ?.get(props.input.function);
166
- if (found === undefined) {
167
- throw new Error(
168
- `No operation found: (controller: ${props.input.controller}, function: ${props.input.function})`,
169
- );
170
- }
171
- return found;
172
- }
1
+ import type { AgenticaOperation } from "../context/AgenticaOperation";
2
+ import type { AgenticaUserMessageHistory } from "../histories";
3
+ import type { AgenticaAssistantMessageHistory } from "../histories/AgenticaAssistantMessageHistory";
4
+ import type { AgenticaCancelHistory } from "../histories/AgenticaCancelHistory";
5
+ import type { AgenticaDescribeHistory } from "../histories/AgenticaDescribeHistory";
6
+ import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
7
+ import type { AgenticaHistory } from "../histories/AgenticaHistory";
8
+ import type { AgenticaSelectHistory } from "../histories/AgenticaSelectHistory";
9
+ import type { AgenticaSystemMessageHistory } from "../histories/AgenticaSystemMessageHistory";
10
+ import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
11
+
12
+ import { createAssistantMessageHistory, createCancelHistory, createDescribeHistory, createExecuteHistory, createSelectHistory, createSystemMessageHistory, createUserMessageHistory } from "../factory/histories";
13
+ import { createOperationSelection } from "../factory/operations";
14
+
15
+ /**
16
+ * @internal
17
+ */
18
+ export function transformHistory(props: {
19
+ operations: Map<string, Map<string, AgenticaOperation>>;
20
+ history: IAgenticaHistoryJson;
21
+ }): AgenticaHistory {
22
+ // USER
23
+ if (props.history.type === "userMessage") {
24
+ return transformUserMessage({
25
+ history: props.history,
26
+ });
27
+ }
28
+ // ASSISTANT
29
+ else if (props.history.type === "assistantMessage") {
30
+ return transformAssistantMessage({
31
+ history: props.history,
32
+ });
33
+ }
34
+ // SYSTEM
35
+ else if (props.history.type === "systemMessage") {
36
+ return transformSystemMessage({
37
+ history: props.history,
38
+ });
39
+ }
40
+ // SELECT & CANCEL
41
+ else if (props.history.type === "select") {
42
+ return transformSelect({
43
+ operations: props.operations,
44
+ history: props.history,
45
+ });
46
+ }
47
+ else if (props.history.type === "cancel") {
48
+ return transformCancel({
49
+ operations: props.operations,
50
+ history: props.history,
51
+ });
52
+ }
53
+ // EXECUTE
54
+ else if (props.history.type === "execute") {
55
+ return transformExecute({
56
+ operations: props.operations,
57
+ history: props.history,
58
+ });
59
+ }
60
+ return transformDescribe({
61
+ operations: props.operations,
62
+ history: props.history,
63
+ });
64
+ }
65
+
66
+ function transformAssistantMessage(props: {
67
+ history: IAgenticaHistoryJson.IAssistantMessage;
68
+ }): AgenticaAssistantMessageHistory {
69
+ return createAssistantMessageHistory(props.history);
70
+ }
71
+
72
+ function transformSystemMessage(props: {
73
+ history: IAgenticaHistoryJson.ISystemMessage;
74
+ }): AgenticaSystemMessageHistory {
75
+ return createSystemMessageHistory(props.history);
76
+ }
77
+
78
+ function transformUserMessage(props: {
79
+ history: IAgenticaHistoryJson.IUserMessage;
80
+ }): AgenticaUserMessageHistory {
81
+ return createUserMessageHistory(props.history);
82
+ }
83
+
84
+ function transformSelect(props: {
85
+ operations: Map<string, Map<string, AgenticaOperation>>;
86
+ history: IAgenticaHistoryJson.ISelect;
87
+ }): AgenticaSelectHistory {
88
+ return createSelectHistory({
89
+ id: props.history.id,
90
+ created_at: props.history.created_at,
91
+ selection: createOperationSelection({
92
+ operation: findOperation({
93
+ operations: props.operations,
94
+ input: props.history.selection.operation,
95
+ }),
96
+ reason: props.history.selection.reason,
97
+ }),
98
+ });
99
+ }
100
+
101
+ function transformCancel(props: {
102
+ operations: Map<string, Map<string, AgenticaOperation>>;
103
+ history: IAgenticaHistoryJson.ICancel;
104
+ }): AgenticaCancelHistory {
105
+ return createCancelHistory({
106
+ id: props.history.id,
107
+ created_at: props.history.created_at,
108
+ selection: createOperationSelection({
109
+ operation: findOperation({
110
+ operations: props.operations,
111
+ input: props.history.selection.operation,
112
+ }),
113
+ reason: props.history.selection.reason,
114
+ }),
115
+ });
116
+ }
117
+
118
+ function transformExecute(props: {
119
+ operations: Map<string, Map<string, AgenticaOperation>>;
120
+ history: IAgenticaHistoryJson.IExecute;
121
+ }): AgenticaExecuteHistory {
122
+ return createExecuteHistory({
123
+ id: props.history.id,
124
+ created_at: props.history.created_at,
125
+ operation: findOperation({
126
+ operations: props.operations,
127
+ input: props.history.operation,
128
+ }),
129
+ arguments: props.history.arguments,
130
+ /**
131
+ * @TODO fix it
132
+ * The property and value have a type mismatch, but it works.
133
+ */
134
+ value: props.history.value as Record<string, unknown>,
135
+ success: props.history.success,
136
+ });
137
+ }
138
+
139
+ function transformDescribe(props: {
140
+ operations: Map<string, Map<string, AgenticaOperation>>;
141
+ history: IAgenticaHistoryJson.IDescribe;
142
+ }): AgenticaDescribeHistory {
143
+ return createDescribeHistory({
144
+ id: props.history.id,
145
+ created_at: props.history.created_at,
146
+ text: props.history.text,
147
+ executes: props.history.executes.map(next =>
148
+ transformExecute({
149
+ operations: props.operations,
150
+ history: next,
151
+ }),
152
+ ),
153
+ });
154
+ }
155
+
156
+ function findOperation(props: {
157
+ operations: Map<string, Map<string, AgenticaOperation>>;
158
+ input: {
159
+ controller: string;
160
+ function: string;
161
+ };
162
+ }): AgenticaOperation {
163
+ const found: AgenticaOperation | undefined = props.operations
164
+ .get(props.input.controller)
165
+ ?.get(props.input.function);
166
+ if (found === undefined) {
167
+ throw new Error(
168
+ `No operation found: (controller: ${props.input.controller}, function: ${props.input.function})`,
169
+ );
170
+ }
171
+ return found;
172
+ }
@@ -1,20 +1,20 @@
1
- export class AssistantMessageEmptyError extends Error {
2
- constructor() {
3
- super();
4
- const proto = new.target.prototype;
5
- // eslint-disable-next-line
6
- if (Object.setPrototypeOf) { Object.setPrototypeOf(this, proto); }
7
- else {
8
- // eslint-disable-next-line
9
- (this as any).__proto__ = proto;
10
- }
11
- }
12
- }
13
-
14
- export class AssistantMessageEmptyWithReasoningError extends AssistantMessageEmptyError {
15
- public readonly reasoning: string;
16
- constructor(reasoning: string) {
17
- super();
18
- this.reasoning = reasoning;
19
- }
20
- }
1
+ export class AssistantMessageEmptyError extends Error {
2
+ constructor() {
3
+ super();
4
+ const proto = new.target.prototype;
5
+ // eslint-disable-next-line
6
+ if (Object.setPrototypeOf) { Object.setPrototypeOf(this, proto); }
7
+ else {
8
+ // eslint-disable-next-line
9
+ (this as any).__proto__ = proto;
10
+ }
11
+ }
12
+ }
13
+
14
+ export class AssistantMessageEmptyWithReasoningError extends AssistantMessageEmptyError {
15
+ public readonly reasoning: string;
16
+ constructor(reasoning: string) {
17
+ super();
18
+ this.reasoning = reasoning;
19
+ }
20
+ }