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