@agentica/core 0.24.0 → 0.26.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 (189) hide show
  1. package/README.md +56 -17
  2. package/lib/Agentica.d.ts +2 -2
  3. package/lib/Agentica.js +4 -4
  4. package/lib/Agentica.js.map +1 -1
  5. package/lib/MicroAgentica.d.ts +2 -2
  6. package/lib/MicroAgentica.js +4 -4
  7. package/lib/MicroAgentica.js.map +1 -1
  8. package/lib/context/AgenticaContext.d.ts +2 -2
  9. package/lib/context/MicroAgenticaContext.d.ts +2 -2
  10. package/lib/context/index.d.ts +5 -0
  11. package/lib/{structures/mcp → context}/index.js +5 -1
  12. package/lib/context/index.js.map +1 -0
  13. package/lib/context/internal/AgenticaOperationComposer.spec.js +13 -5
  14. package/lib/context/internal/AgenticaOperationComposer.spec.js.map +1 -1
  15. package/lib/events/AgenticaAssistantMessageEvent.d.ts +9 -0
  16. package/lib/events/AgenticaAssistantMessageEvent.js +3 -0
  17. package/lib/events/AgenticaAssistantMessageEvent.js.map +1 -0
  18. package/lib/events/AgenticaEvent.d.ts +9 -9
  19. package/lib/events/AgenticaEvent.type.d.ts +1 -0
  20. package/lib/events/AgenticaEvent.type.js +8 -0
  21. package/lib/events/AgenticaEvent.type.js.map +1 -0
  22. package/lib/events/AgenticaUserMessageEvent.d.ts +9 -0
  23. package/lib/events/{AgenticaUserInputEvent.js → AgenticaUserMessageEvent.js} +1 -1
  24. package/lib/events/AgenticaUserMessageEvent.js.map +1 -0
  25. package/lib/events/MicroAgenticaEvent.d.ts +6 -6
  26. package/lib/events/index.d.ts +14 -0
  27. package/lib/events/index.js +31 -0
  28. package/lib/events/index.js.map +1 -0
  29. package/lib/factory/events.d.ts +8 -8
  30. package/lib/factory/events.js +23 -38
  31. package/lib/factory/events.js.map +1 -1
  32. package/lib/factory/histories.d.ts +1 -36
  33. package/lib/factory/histories.js +103 -22
  34. package/lib/factory/histories.js.map +1 -1
  35. package/lib/functional/assertHttpController.js +6 -6
  36. package/lib/functional/assertHttpLlmApplication.js +6 -6
  37. package/lib/functional/assertMcpController.d.ts +1 -2
  38. package/lib/functional/assertMcpController.js +6 -6
  39. package/lib/functional/assertMcpController.js.map +1 -1
  40. package/lib/functional/index.d.ts +6 -0
  41. package/lib/functional/index.js +23 -0
  42. package/lib/functional/index.js.map +1 -0
  43. package/lib/functional/validateHttpController.js +5 -5
  44. package/lib/functional/validateHttpLlmApplication.js +5 -5
  45. package/lib/functional/validateMcpController.d.ts +1 -2
  46. package/lib/functional/validateMcpController.js +11 -11
  47. package/lib/functional/validateMcpController.js.map +1 -1
  48. package/lib/histories/AgenticaAssistantMessageHistory.d.ts +5 -0
  49. package/lib/histories/AgenticaAssistantMessageHistory.js +3 -0
  50. package/lib/histories/AgenticaAssistantMessageHistory.js.map +1 -0
  51. package/lib/histories/AgenticaHistory.d.ts +9 -7
  52. package/lib/histories/{AgenticaTextHistory.d.ts → AgenticaSystemMessageHistory.d.ts} +1 -2
  53. package/lib/histories/{AgenticaUserInputHistory.js → AgenticaSystemMessageHistory.js} +1 -1
  54. package/lib/histories/AgenticaSystemMessageHistory.js.map +1 -0
  55. package/lib/histories/AgenticaUserMessageHistory.d.ts +6 -0
  56. package/lib/{events/AgenticaTextEvent.js → histories/AgenticaUserMessageHistory.js} +1 -1
  57. package/lib/histories/AgenticaUserMessageHistory.js.map +1 -0
  58. package/lib/histories/MicroAgenticaHistory.d.ts +5 -4
  59. package/lib/histories/contents/AgenticaUserMessageAudioContent.d.ts +19 -0
  60. package/lib/histories/contents/AgenticaUserMessageAudioContent.js +3 -0
  61. package/lib/histories/contents/AgenticaUserMessageAudioContent.js.map +1 -0
  62. package/lib/histories/contents/AgenticaUserMessageContent.d.ts +14 -0
  63. package/lib/histories/{AgenticaTextHistory.js → contents/AgenticaUserMessageContent.js} +1 -1
  64. package/lib/histories/contents/AgenticaUserMessageContent.js.map +1 -0
  65. package/lib/histories/contents/AgenticaUserMessageContentBase.d.ts +6 -0
  66. package/lib/histories/contents/AgenticaUserMessageContentBase.js +3 -0
  67. package/lib/histories/contents/AgenticaUserMessageContentBase.js.map +1 -0
  68. package/lib/histories/contents/AgenticaUserMessageFileContent.d.ts +26 -0
  69. package/lib/histories/contents/AgenticaUserMessageFileContent.js +3 -0
  70. package/lib/histories/contents/AgenticaUserMessageFileContent.js.map +1 -0
  71. package/lib/histories/contents/AgenticaUserMessageImageContent.d.ts +20 -0
  72. package/lib/histories/contents/AgenticaUserMessageImageContent.js +3 -0
  73. package/lib/histories/contents/AgenticaUserMessageImageContent.js.map +1 -0
  74. package/lib/histories/contents/AgenticaUserMessageTextContent.d.ts +14 -0
  75. package/lib/histories/contents/AgenticaUserMessageTextContent.js +3 -0
  76. package/lib/histories/contents/AgenticaUserMessageTextContent.js.map +1 -0
  77. package/lib/histories/contents/index.d.ts +5 -0
  78. package/lib/histories/contents/index.js +22 -0
  79. package/lib/histories/contents/index.js.map +1 -0
  80. package/lib/histories/index.d.ts +10 -0
  81. package/lib/histories/index.js +27 -0
  82. package/lib/histories/index.js.map +1 -0
  83. package/lib/index.d.ts +6 -45
  84. package/lib/index.js +6 -46
  85. package/lib/index.js.map +1 -1
  86. package/lib/index.mjs +182 -131
  87. package/lib/index.mjs.map +1 -1
  88. package/lib/json/IAgenticaEventJson.d.ts +44 -19
  89. package/lib/json/IAgenticaEventJson.type.d.ts +1 -0
  90. package/lib/json/IAgenticaEventJson.type.js +8 -0
  91. package/lib/json/IAgenticaEventJson.type.js.map +1 -0
  92. package/lib/json/IAgenticaHistoryJson.d.ts +34 -19
  93. package/lib/json/IAgenticaHistoryJson.type.d.ts +1 -0
  94. package/lib/json/IAgenticaHistoryJson.type.js +8 -0
  95. package/lib/json/IAgenticaHistoryJson.type.js.map +1 -0
  96. package/lib/json/IMicroAgenticaEventJson.d.ts +1 -1
  97. package/lib/json/IMicroAgenticaHistoryJson.d.ts +1 -1
  98. package/lib/json/index.d.ts +7 -0
  99. package/lib/json/index.js +24 -0
  100. package/lib/json/index.js.map +1 -0
  101. package/lib/orchestrate/call.js +4 -4
  102. package/lib/orchestrate/call.js.map +1 -1
  103. package/lib/orchestrate/cancel.js +1 -1
  104. package/lib/orchestrate/cancel.js.map +1 -1
  105. package/lib/orchestrate/initialize.js +4 -4
  106. package/lib/orchestrate/initialize.js.map +1 -1
  107. package/lib/orchestrate/select.js +3 -3
  108. package/lib/orchestrate/select.js.map +1 -1
  109. package/lib/structures/IAgenticaController.d.ts +1 -2
  110. package/lib/structures/index.d.ts +10 -0
  111. package/lib/structures/index.js +27 -0
  112. package/lib/structures/index.js.map +1 -0
  113. package/lib/transformers/transformHistory.d.ts +1 -0
  114. package/lib/transformers/{AgenticaHistoryTransformer.js → transformHistory.js} +33 -23
  115. package/lib/transformers/transformHistory.js.map +1 -0
  116. package/lib/utils/ChatGptCompletionMessageUtil.js +2 -2
  117. package/lib/utils/types.d.ts +33 -0
  118. package/lib/utils/types.js +29 -0
  119. package/lib/utils/types.js.map +1 -0
  120. package/package.json +7 -7
  121. package/src/Agentica.ts +10 -9
  122. package/src/MicroAgentica.ts +12 -9
  123. package/src/context/AgenticaContext.ts +2 -2
  124. package/src/context/MicroAgenticaContext.ts +2 -2
  125. package/src/context/index.ts +5 -0
  126. package/src/context/internal/AgenticaOperationComposer.spec.ts +15 -5
  127. package/src/events/AgenticaAssistantMessageEvent.ts +12 -0
  128. package/src/events/AgenticaEvent.ts +15 -15
  129. package/src/events/AgenticaEvent.type.ts +19 -0
  130. package/src/events/AgenticaUserMessageEvent.ts +12 -0
  131. package/src/events/MicroAgenticaEvent.ts +9 -9
  132. package/src/events/index.ts +14 -0
  133. package/src/factory/events.ts +29 -34
  134. package/src/factory/histories.ts +120 -29
  135. package/src/functional/assertMcpController.ts +4 -2
  136. package/src/functional/index.ts +7 -0
  137. package/src/functional/validateMcpController.ts +4 -2
  138. package/src/histories/AgenticaAssistantMessageHistory.ts +10 -0
  139. package/src/histories/AgenticaHistory.ts +11 -8
  140. package/src/histories/{AgenticaTextHistory.ts → AgenticaSystemMessageHistory.ts} +4 -2
  141. package/src/histories/AgenticaUserMessageHistory.ts +11 -0
  142. package/src/histories/MicroAgenticaHistory.ts +6 -5
  143. package/src/histories/contents/AgenticaUserMessageAudioContent.ts +21 -0
  144. package/src/histories/contents/AgenticaUserMessageContent.ts +19 -0
  145. package/src/histories/contents/AgenticaUserMessageContentBase.ts +6 -0
  146. package/src/histories/contents/AgenticaUserMessageFileContent.ts +27 -0
  147. package/src/histories/contents/AgenticaUserMessageImageContent.ts +23 -0
  148. package/src/histories/contents/AgenticaUserMessageTextContent.ts +15 -0
  149. package/src/histories/contents/index.ts +5 -0
  150. package/src/histories/index.ts +10 -0
  151. package/src/index.ts +6 -54
  152. package/src/json/IAgenticaEventJson.ts +53 -21
  153. package/src/json/IAgenticaEventJson.type.ts +19 -0
  154. package/src/json/IAgenticaHistoryJson.ts +41 -23
  155. package/src/json/IAgenticaHistoryJson.type.ts +19 -0
  156. package/src/json/IMicroAgenticaEventJson.ts +2 -1
  157. package/src/json/IMicroAgenticaHistoryJson.ts +2 -1
  158. package/src/json/index.ts +7 -0
  159. package/src/orchestrate/call.ts +8 -8
  160. package/src/orchestrate/cancel.ts +2 -2
  161. package/src/orchestrate/initialize.ts +5 -5
  162. package/src/orchestrate/select.ts +5 -5
  163. package/src/structures/IAgenticaController.ts +4 -2
  164. package/src/structures/index.ts +10 -0
  165. package/src/transformers/{AgenticaHistoryTransformer.ts → transformHistory.ts} +43 -26
  166. package/src/utils/types.ts +50 -0
  167. package/lib/events/AgenticaTextEvent.d.ts +0 -10
  168. package/lib/events/AgenticaTextEvent.js.map +0 -1
  169. package/lib/events/AgenticaUserInputEvent.d.ts +0 -10
  170. package/lib/events/AgenticaUserInputEvent.js.map +0 -1
  171. package/lib/histories/AgenticaTextHistory.js.map +0 -1
  172. package/lib/histories/AgenticaUserInputHistory.d.ts +0 -86
  173. package/lib/histories/AgenticaUserInputHistory.js.map +0 -1
  174. package/lib/structures/mcp/IMcpLlmTransportProps.d.ts +0 -11
  175. package/lib/structures/mcp/IMcpLlmTransportProps.js +0 -3
  176. package/lib/structures/mcp/IMcpLlmTransportProps.js.map +0 -1
  177. package/lib/structures/mcp/index.d.ts +0 -1
  178. package/lib/structures/mcp/index.js.map +0 -1
  179. package/lib/transformers/AgenticaEventTransformer.d.ts +0 -63
  180. package/lib/transformers/AgenticaEventTransformer.js +0 -155
  181. package/lib/transformers/AgenticaEventTransformer.js.map +0 -1
  182. package/lib/transformers/AgenticaHistoryTransformer.d.ts +0 -41
  183. package/lib/transformers/AgenticaHistoryTransformer.js.map +0 -1
  184. package/src/events/AgenticaTextEvent.ts +0 -12
  185. package/src/events/AgenticaUserInputEvent.ts +0 -12
  186. package/src/histories/AgenticaUserInputHistory.ts +0 -94
  187. package/src/structures/mcp/IMcpLlmTransportProps.ts +0 -13
  188. package/src/structures/mcp/index.ts +0 -1
  189. package/src/transformers/AgenticaEventTransformer.ts +0 -196
@@ -1,196 +0,0 @@
1
- import type { ILlmSchema } from "@samchon/openapi";
2
-
3
- import type { AgenticaOperation } from "../context/AgenticaOperation";
4
- import type { AgenticaCallEvent } from "../events/AgenticaCallEvent";
5
- import type { AgenticaCancelEvent } from "../events/AgenticaCancelEvent";
6
- import type { AgenticaDescribeEvent } from "../events/AgenticaDescribeEvent";
7
- import type { AgenticaEvent } from "../events/AgenticaEvent";
8
- import type { AgenticaExecuteEvent } from "../events/AgenticaExecuteEvent";
9
- import type { AgenticaInitializeEvent } from "../events/AgenticaInitializeEvent";
10
- import type { AgenticaRequestEvent } from "../events/AgenticaRequestEvent";
11
- import type { AgenticaSelectEvent } from "../events/AgenticaSelectEvent";
12
- import type { AgenticaTextEvent } from "../events/AgenticaTextEvent";
13
- import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
14
-
15
- import { createCallEvent, createCancelEvent, createDescribeEvent, createExecuteEvent, createInitializeEvent, createRequestEvent, createSelectEvent, createTextEvent } from "../factory/events";
16
- import { createOperationSelection } from "../factory/operations";
17
- import { toAsyncGenerator } from "../utils/StreamUtil";
18
-
19
- function findOperation<Model extends ILlmSchema.Model>(props: {
20
- operations: Map<string, Map<string, AgenticaOperation<Model>>>;
21
- input: {
22
- controller: string;
23
- function: string;
24
- };
25
- }): AgenticaOperation<Model> {
26
- const found: AgenticaOperation<Model> | undefined = props.operations
27
- .get(props.input.controller)
28
- ?.get(props.input.function);
29
- if (found === undefined) {
30
- throw new Error(
31
- `No operation found: (controller: ${props.input.controller}, function: ${props.input.function})`,
32
- );
33
- }
34
- return found;
35
- }
36
-
37
- function transform<Model extends ILlmSchema.Model>(props: {
38
- operations: Map<string, Map<string, AgenticaOperation<Model>>>;
39
- event: IAgenticaEventJson;
40
- }): AgenticaEvent<Model> {
41
- if (props.event.type === "call") {
42
- return transformCall({
43
- operations: props.operations,
44
- event: props.event,
45
- });
46
- }
47
- else if (props.event.type === "cancel") {
48
- return transformCancel({
49
- operations: props.operations,
50
- event: props.event,
51
- });
52
- }
53
- else if (props.event.type === "describe") {
54
- return transformDescribe({
55
- operations: props.operations,
56
- event: props.event,
57
- });
58
- }
59
- else if (props.event.type === "execute") {
60
- return transformExecute({
61
- operations: props.operations,
62
- event: props.event,
63
- });
64
- }
65
- else if (props.event.type === "initialize") {
66
- return transformInitialize();
67
- }
68
- else if (props.event.type === "request") {
69
- return transformRequest({
70
- event: props.event,
71
- });
72
- }
73
- else if (props.event.type === "select") {
74
- return transformSelect({
75
- operations: props.operations,
76
- event: props.event,
77
- });
78
- }
79
- else if (props.event.type === "text") {
80
- return transformText({
81
- event: props.event,
82
- });
83
- }
84
- else { throw new Error("Unknown event type"); }
85
- }
86
-
87
- function transformCall<Model extends ILlmSchema.Model>(props: {
88
- operations: Map<string, Map<string, AgenticaOperation<Model>>>;
89
- event: IAgenticaEventJson.ICall;
90
- }): AgenticaCallEvent<Model> {
91
- return createCallEvent({
92
- id: props.event.id,
93
- operation: findOperation({
94
- operations: props.operations,
95
- input: props.event.operation,
96
- }),
97
- arguments: props.event.arguments,
98
- });
99
- }
100
-
101
- export function transformCancel<Model extends ILlmSchema.Model>(props: {
102
- operations: Map<string, Map<string, AgenticaOperation<Model>>>;
103
- event: IAgenticaEventJson.ICancel;
104
- }): AgenticaCancelEvent<Model> {
105
- return createCancelEvent({
106
- selection: createOperationSelection({
107
- operation: findOperation({
108
- operations: props.operations,
109
- input: props.event.selection.operation,
110
- }),
111
- reason: props.event.selection.reason,
112
- }),
113
- });
114
- }
115
-
116
- function transformDescribe<Model extends ILlmSchema.Model>(props: {
117
- operations: Map<string, Map<string, AgenticaOperation<Model>>>;
118
- event: IAgenticaEventJson.IDescribe;
119
- }): AgenticaDescribeEvent<Model> {
120
- return createDescribeEvent({
121
- executes: props.event.executes.map(next =>
122
- transformExecute({
123
- operations: props.operations,
124
- event: next,
125
- }),
126
- ),
127
- stream: toAsyncGenerator(props.event.text),
128
- done: () => true,
129
- get: () => props.event.text,
130
- join: async () => props.event.text,
131
- });
132
- }
133
-
134
- function transformExecute<Model extends ILlmSchema.Model>(props: {
135
- operations: Map<string, Map<string, AgenticaOperation<Model>>>;
136
- event: IAgenticaEventJson.IExecute;
137
- }): AgenticaExecuteEvent<Model> {
138
- return createExecuteEvent({
139
- id: props.event.id,
140
- operation: findOperation({
141
- operations: props.operations,
142
- input: props.event.operation,
143
- }),
144
- arguments: props.event.arguments,
145
- value: props.event.value,
146
- });
147
- }
148
-
149
- function transformInitialize(): AgenticaInitializeEvent {
150
- return createInitializeEvent();
151
- }
152
-
153
- function transformRequest(props: {
154
- event: IAgenticaEventJson.IRequest;
155
- }): AgenticaRequestEvent {
156
- return createRequestEvent(props.event);
157
- }
158
-
159
- function transformSelect<Model extends ILlmSchema.Model>(props: {
160
- operations: Map<string, Map<string, AgenticaOperation<Model>>>;
161
- event: IAgenticaEventJson.ISelect;
162
- }): AgenticaSelectEvent<Model> {
163
- return createSelectEvent({
164
- selection: createOperationSelection({
165
- operation: findOperation({
166
- operations: props.operations,
167
- input: props.event.selection.operation,
168
- }),
169
- reason: props.event.selection.reason,
170
- }),
171
- });
172
- }
173
-
174
- function transformText(props: {
175
- event: IAgenticaEventJson.IText;
176
- }): AgenticaTextEvent {
177
- return createTextEvent({
178
- stream: toAsyncGenerator(props.event.text),
179
- done: () => true,
180
- get: () => props.event.text,
181
- join: async () => props.event.text,
182
- });
183
- }
184
-
185
- export const AgenticaEventTransformer = {
186
- transform,
187
- transformCall,
188
- transformCancel,
189
- transformDescribe,
190
- transformExecute,
191
- transformInitialize,
192
- transformRequest,
193
- transformSelect,
194
- transformText,
195
- findOperation,
196
- };