@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,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
+ }