@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,140 +1,140 @@
1
- import type OpenAI from "openai";
2
-
3
- import { v4 } from "uuid";
4
-
5
- import type { AgenticaContextRequestResult } from "../context/AgenticaContextRequestResult";
6
- import type { AgenticaTokenUsage } from "../context/AgenticaTokenUsage";
7
- import type { AgenticaEventSource, AgenticaRequestEvent, AgenticaResponseEvent } from "../events";
8
- import type { IAgenticaConfig, IAgenticaVendor, IMicroAgenticaConfig } from "../structures";
9
-
10
- import { AgenticaTokenUsageAggregator } from "../context/internal/AgenticaTokenUsageAggregator";
11
- import { createRequestEvent } from "../factory";
12
-
13
- import { ChatGptCompletionMessageUtil } from "./ChatGptCompletionMessageUtil";
14
- import { streamDefaultReaderToAsyncGenerator, StreamUtil } from "./StreamUtil";
15
-
16
- export function getChatCompletionFunction(props: {
17
- vendor: IAgenticaVendor;
18
- config?: IAgenticaConfig | IMicroAgenticaConfig;
19
- dispatch: (event: AgenticaRequestEvent | AgenticaResponseEvent) => Promise<void>;
20
- abortSignal?: AbortSignal;
21
- usage: AgenticaTokenUsage;
22
- }) {
23
- return async (
24
- source: AgenticaEventSource,
25
- body: Omit<OpenAI.ChatCompletionCreateParamsStreaming | OpenAI.ChatCompletionCreateParamsNonStreaming, "model">,
26
- ): Promise<AgenticaContextRequestResult> => {
27
- const streamOptions = props.config?.stream === true || props.config?.stream === undefined
28
- ? { stream: true, stream_options: { include_usage: true } }
29
- : { stream: false };
30
- const event: AgenticaRequestEvent = createRequestEvent({
31
- source,
32
- stream: streamOptions.stream,
33
- body: {
34
- ...body,
35
- model: props.vendor.model,
36
- ...streamOptions,
37
- },
38
- options: {
39
- ...props.vendor.options,
40
- signal: props.abortSignal,
41
- },
42
- });
43
- await props.dispatch(event);
44
-
45
- // completion
46
- const backoffStrategy = props.config?.backoffStrategy ?? ((props) => {
47
- throw props.error;
48
- });
49
- const completion = await (async () => {
50
- let count = 0;
51
- while (true) {
52
- try {
53
- return await props.vendor.api.chat.completions.create(
54
- event.body,
55
- event.options,
56
- );
57
- }
58
- catch (error) {
59
- const waiting = backoffStrategy({ count, error });
60
- await new Promise(resolve => setTimeout(resolve, waiting));
61
- count++;
62
- }
63
- }
64
- })();
65
-
66
- if ("toReadableStream" in completion === false) {
67
- if (completion.usage != null) {
68
- AgenticaTokenUsageAggregator.aggregate({
69
- kind: source,
70
- completionUsage: completion.usage,
71
- usage: props.usage,
72
- });
73
- }
74
- void props.dispatch({
75
- id: v4(),
76
- type: "response",
77
- request_id: event.id,
78
- source,
79
- stream: false,
80
- body: event.body as OpenAI.ChatCompletionCreateParamsNonStreaming,
81
- completion,
82
- options: event.options,
83
- join: async () => completion,
84
- created_at: new Date().toISOString(),
85
- }).catch(() => {});
86
- return {
87
- type: "none-stream",
88
- value: completion,
89
- };
90
- }
91
-
92
- const [streamForEvent, temporaryStream] = StreamUtil.transform(
93
- completion.toReadableStream() as ReadableStream<Uint8Array>,
94
- value =>
95
- ChatGptCompletionMessageUtil.transformCompletionChunk(value),
96
- props.abortSignal,
97
- ).tee();
98
-
99
- const [streamForAggregate, streamForReturn] = temporaryStream.tee();
100
-
101
- (async () => {
102
- const reader = streamForAggregate.getReader();
103
- while (true) {
104
- const chunk = await reader.read();
105
- if (chunk.done || props.abortSignal?.aborted === true) {
106
- break;
107
- }
108
- if (chunk.value.usage != null) {
109
- AgenticaTokenUsageAggregator.aggregate({
110
- kind: source,
111
- completionUsage: chunk.value.usage,
112
- usage: props.usage,
113
- });
114
- }
115
- }
116
- })().catch(() => {});
117
-
118
- const [streamForStream, streamForJoin] = streamForEvent.tee();
119
- void props.dispatch({
120
- id: v4(),
121
- type: "response",
122
- request_id: event.id,
123
- source,
124
- stream: true,
125
- body: event.body as OpenAI.ChatCompletionCreateParamsStreaming,
126
- completion: streamDefaultReaderToAsyncGenerator(streamForStream.getReader(), props.abortSignal),
127
- options: event.options,
128
- join: async () => {
129
- const chunks = await StreamUtil.readAll(streamForJoin, props.abortSignal);
130
- return ChatGptCompletionMessageUtil.merge(chunks);
131
- },
132
- created_at: new Date().toISOString(),
133
- }).catch(() => {});
134
-
135
- return {
136
- type: "stream",
137
- value: streamForReturn,
138
- };
139
- };
140
- }
1
+ import type OpenAI from "openai";
2
+
3
+ import { v4 } from "uuid";
4
+
5
+ import type { AgenticaContextRequestResult } from "../context/AgenticaContextRequestResult";
6
+ import type { AgenticaTokenUsage } from "../context/AgenticaTokenUsage";
7
+ import type { AgenticaEventSource, AgenticaRequestEvent, AgenticaResponseEvent } from "../events";
8
+ import type { IAgenticaConfig, IAgenticaVendor, IMicroAgenticaConfig } from "../structures";
9
+
10
+ import { AgenticaTokenUsageAggregator } from "../context/internal/AgenticaTokenUsageAggregator";
11
+ import { createRequestEvent } from "../factory";
12
+
13
+ import { ChatGptCompletionMessageUtil } from "./ChatGptCompletionMessageUtil";
14
+ import { streamDefaultReaderToAsyncGenerator, StreamUtil } from "./StreamUtil";
15
+
16
+ export function getChatCompletionFunction(props: {
17
+ vendor: IAgenticaVendor;
18
+ config?: IAgenticaConfig | IMicroAgenticaConfig;
19
+ dispatch: (event: AgenticaRequestEvent | AgenticaResponseEvent) => Promise<void>;
20
+ abortSignal?: AbortSignal;
21
+ usage: AgenticaTokenUsage;
22
+ }) {
23
+ return async (
24
+ source: AgenticaEventSource,
25
+ body: Omit<OpenAI.ChatCompletionCreateParamsStreaming | OpenAI.ChatCompletionCreateParamsNonStreaming, "model">,
26
+ ): Promise<AgenticaContextRequestResult> => {
27
+ const streamOptions = props.config?.stream === true || props.config?.stream === undefined
28
+ ? { stream: true, stream_options: { include_usage: true } }
29
+ : { stream: false };
30
+ const event: AgenticaRequestEvent = createRequestEvent({
31
+ source,
32
+ stream: streamOptions.stream,
33
+ body: {
34
+ ...body,
35
+ model: props.vendor.model,
36
+ ...streamOptions,
37
+ },
38
+ options: {
39
+ ...props.vendor.options,
40
+ signal: props.abortSignal,
41
+ },
42
+ });
43
+ await props.dispatch(event);
44
+
45
+ // completion
46
+ const backoffStrategy = props.config?.backoffStrategy ?? ((props) => {
47
+ throw props.error;
48
+ });
49
+ const completion = await (async () => {
50
+ let count = 0;
51
+ while (true) {
52
+ try {
53
+ return await props.vendor.api.chat.completions.create(
54
+ event.body,
55
+ event.options,
56
+ );
57
+ }
58
+ catch (error) {
59
+ const waiting = backoffStrategy({ count, error });
60
+ await new Promise(resolve => setTimeout(resolve, waiting));
61
+ count++;
62
+ }
63
+ }
64
+ })();
65
+
66
+ if ("toReadableStream" in completion === false) {
67
+ if (completion.usage != null) {
68
+ AgenticaTokenUsageAggregator.aggregate({
69
+ kind: source,
70
+ completionUsage: completion.usage,
71
+ usage: props.usage,
72
+ });
73
+ }
74
+ void props.dispatch({
75
+ id: v4(),
76
+ type: "response",
77
+ request_id: event.id,
78
+ source,
79
+ stream: false,
80
+ body: event.body as OpenAI.ChatCompletionCreateParamsNonStreaming,
81
+ completion,
82
+ options: event.options,
83
+ join: async () => completion,
84
+ created_at: new Date().toISOString(),
85
+ }).catch(() => {});
86
+ return {
87
+ type: "none-stream",
88
+ value: completion,
89
+ };
90
+ }
91
+
92
+ const [streamForEvent, temporaryStream] = StreamUtil.transform(
93
+ completion.toReadableStream() as ReadableStream<Uint8Array>,
94
+ value =>
95
+ ChatGptCompletionMessageUtil.transformCompletionChunk(value),
96
+ props.abortSignal,
97
+ ).tee();
98
+
99
+ const [streamForAggregate, streamForReturn] = temporaryStream.tee();
100
+
101
+ (async () => {
102
+ const reader = streamForAggregate.getReader();
103
+ while (true) {
104
+ const chunk = await reader.read();
105
+ if (chunk.done || props.abortSignal?.aborted === true) {
106
+ break;
107
+ }
108
+ if (chunk.value.usage != null) {
109
+ AgenticaTokenUsageAggregator.aggregate({
110
+ kind: source,
111
+ completionUsage: chunk.value.usage,
112
+ usage: props.usage,
113
+ });
114
+ }
115
+ }
116
+ })().catch(() => {});
117
+
118
+ const [streamForStream, streamForJoin] = streamForEvent.tee();
119
+ void props.dispatch({
120
+ id: v4(),
121
+ type: "response",
122
+ request_id: event.id,
123
+ source,
124
+ stream: true,
125
+ body: event.body as OpenAI.ChatCompletionCreateParamsStreaming,
126
+ completion: streamDefaultReaderToAsyncGenerator(streamForStream.getReader(), props.abortSignal),
127
+ options: event.options,
128
+ join: async () => {
129
+ const chunks = await StreamUtil.readAll(streamForJoin, props.abortSignal);
130
+ return ChatGptCompletionMessageUtil.merge(chunks);
131
+ },
132
+ created_at: new Date().toISOString(),
133
+ }).catch(() => {});
134
+
135
+ return {
136
+ type: "stream",
137
+ value: streamForReturn,
138
+ };
139
+ };
140
+ }
@@ -1,50 +1,50 @@
1
- /**
2
- * from ts-toolbelt repository
3
- * https://github.com/millsp/ts-toolbelt/blob/master/sources/Test.ts
4
- */
5
-
6
- type Equals<A1, A2> = (<A>() => A extends A2 ? 1 : 0) extends <
7
- A,
8
- >() => A extends A1 ? 1 : 0
9
- ? 1
10
- : 0;
11
-
12
- type Boolean = 0 | 1;
13
- /**
14
- * Test should pass
15
- */
16
- export type Pass = 1;
17
-
18
- /**
19
- * Test should fail
20
- */
21
- export type Fail = 0;
22
-
23
- /**
24
- * Check or test the validity of a type
25
- * @param debug to debug with parameter hints (`ctrl+p`, `ctrl+shift+space`)
26
- * @example
27
- * ```ts
28
- * // see in `tst` folder
29
- * ```
30
- */
31
- export function check<Type, Expect, Outcome extends Boolean>(
32
- debug?: Type,
33
- ): Equals<Equals<Type, Expect>, Outcome> {
34
- if (debug !== undefined) {
35
- // eslint-disable-next-line no-console
36
- console.log(debug);
37
- }
38
-
39
- return 1 as Equals<Equals<Type, Expect>, Outcome>;
40
- }
41
-
42
- /**
43
- * Validates a batch of [[check]]
44
- * @param _checks a batch of [[check]]
45
- * @example
46
- * ```ts
47
- * // see in `tst` folder
48
- * ```
49
- */
50
- export function checks(_checks: 1[]): void { }
1
+ /**
2
+ * from ts-toolbelt repository
3
+ * https://github.com/millsp/ts-toolbelt/blob/master/sources/Test.ts
4
+ */
5
+
6
+ type Equals<A1, A2> = (<A>() => A extends A2 ? 1 : 0) extends <
7
+ A,
8
+ >() => A extends A1 ? 1 : 0
9
+ ? 1
10
+ : 0;
11
+
12
+ type Boolean = 0 | 1;
13
+ /**
14
+ * Test should pass
15
+ */
16
+ export type Pass = 1;
17
+
18
+ /**
19
+ * Test should fail
20
+ */
21
+ export type Fail = 0;
22
+
23
+ /**
24
+ * Check or test the validity of a type
25
+ * @param debug to debug with parameter hints (`ctrl+p`, `ctrl+shift+space`)
26
+ * @example
27
+ * ```ts
28
+ * // see in `tst` folder
29
+ * ```
30
+ */
31
+ export function check<Type, Expect, Outcome extends Boolean>(
32
+ debug?: Type,
33
+ ): Equals<Equals<Type, Expect>, Outcome> {
34
+ if (debug !== undefined) {
35
+ // eslint-disable-next-line no-console
36
+ console.log(debug);
37
+ }
38
+
39
+ return 1 as Equals<Equals<Type, Expect>, Outcome>;
40
+ }
41
+
42
+ /**
43
+ * Validates a batch of [[check]]
44
+ * @param _checks a batch of [[check]]
45
+ * @example
46
+ * ```ts
47
+ * // see in `tst` folder
48
+ * ```
49
+ */
50
+ export function checks(_checks: 1[]): void { }