@agentica/core 0.10.0-dev.20250302 → 0.10.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 (46) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +419 -419
  3. package/package.json +1 -1
  4. package/prompts/cancel.md +4 -4
  5. package/prompts/common.md +2 -2
  6. package/prompts/describe.md +6 -6
  7. package/prompts/execute.md +6 -6
  8. package/prompts/initialize.md +2 -2
  9. package/prompts/select.md +6 -6
  10. package/src/Agentica.ts +323 -323
  11. package/src/chatgpt/ChatGptAgent.ts +75 -75
  12. package/src/chatgpt/ChatGptCallFunctionAgent.ts +464 -464
  13. package/src/chatgpt/ChatGptCancelFunctionAgent.ts +287 -287
  14. package/src/chatgpt/ChatGptDescribeFunctionAgent.ts +52 -52
  15. package/src/chatgpt/ChatGptHistoryDecoder.ts +88 -88
  16. package/src/chatgpt/ChatGptInitializeFunctionAgent.ts +88 -88
  17. package/src/chatgpt/ChatGptSelectFunctionAgent.ts +319 -319
  18. package/src/functional/createHttpLlmApplication.ts +63 -63
  19. package/src/index.ts +19 -19
  20. package/src/internal/AgenticaConstant.ts +4 -4
  21. package/src/internal/AgenticaDefaultPrompt.ts +43 -43
  22. package/src/internal/AgenticaOperationComposer.ts +87 -87
  23. package/src/internal/AgenticaPromptFactory.ts +32 -32
  24. package/src/internal/AgenticaPromptTransformer.ts +86 -86
  25. package/src/internal/AgenticaTokenUsageAggregator.ts +115 -115
  26. package/src/internal/MathUtil.ts +3 -3
  27. package/src/internal/Singleton.ts +22 -22
  28. package/src/internal/__map_take.ts +15 -15
  29. package/src/structures/IAgenticaConfig.ts +123 -123
  30. package/src/structures/IAgenticaContext.ts +129 -129
  31. package/src/structures/IAgenticaController.ts +133 -133
  32. package/src/structures/IAgenticaEvent.ts +229 -229
  33. package/src/structures/IAgenticaExecutor.ts +156 -156
  34. package/src/structures/IAgenticaOperation.ts +63 -63
  35. package/src/structures/IAgenticaOperationCollection.ts +52 -52
  36. package/src/structures/IAgenticaOperationSelection.ts +68 -68
  37. package/src/structures/IAgenticaPrompt.ts +182 -182
  38. package/src/structures/IAgenticaProps.ts +70 -70
  39. package/src/structures/IAgenticaSystemPrompt.ts +124 -124
  40. package/src/structures/IAgenticaTokenUsage.ts +107 -107
  41. package/src/structures/IAgenticaVendor.ts +39 -39
  42. package/src/structures/internal/__IChatCancelFunctionsApplication.ts +23 -23
  43. package/src/structures/internal/__IChatFunctionReference.ts +21 -21
  44. package/src/structures/internal/__IChatInitialApplication.ts +15 -15
  45. package/src/structures/internal/__IChatSelectFunctionsApplication.ts +24 -24
  46. package/src/typings/AgenticaSource.ts +6 -6
@@ -1,75 +1,75 @@
1
- import { ILlmSchema } from "@samchon/openapi";
2
-
3
- import { IAgenticaContext } from "../structures/IAgenticaContext";
4
- import { IAgenticaExecutor } from "../structures/IAgenticaExecutor";
5
- import { IAgenticaPrompt } from "../structures/IAgenticaPrompt";
6
- import { ChatGptCallFunctionAgent } from "./ChatGptCallFunctionAgent";
7
- import { ChatGptCancelFunctionAgent } from "./ChatGptCancelFunctionAgent";
8
- import { ChatGptDescribeFunctionAgent } from "./ChatGptDescribeFunctionAgent";
9
- import { ChatGptInitializeFunctionAgent } from "./ChatGptInitializeFunctionAgent";
10
- import { ChatGptSelectFunctionAgent } from "./ChatGptSelectFunctionAgent";
11
-
12
- export namespace ChatGptAgent {
13
- export const execute =
14
- <Model extends ILlmSchema.Model>(
15
- executor: Partial<IAgenticaExecutor<Model>> | null,
16
- ) =>
17
- async (ctx: IAgenticaContext<Model>): Promise<IAgenticaPrompt<Model>[]> => {
18
- const histories: IAgenticaPrompt<Model>[] = [];
19
-
20
- // FUNCTIONS ARE NOT LISTED YET
21
- if (ctx.ready() === false) {
22
- if (executor?.initialize === null) await ctx.initialize();
23
- else {
24
- histories.push(
25
- ...(await (
26
- executor?.initialize ?? ChatGptInitializeFunctionAgent.execute
27
- )(ctx)),
28
- );
29
- if (ctx.ready() === false) return histories;
30
- }
31
- }
32
-
33
- // CANCEL CANDIDATE FUNCTIONS
34
- if (ctx.stack.length !== 0)
35
- histories.push(
36
- ...(await (executor?.cancel ?? ChatGptCancelFunctionAgent.execute)(
37
- ctx,
38
- )),
39
- );
40
-
41
- // SELECT CANDIDATE FUNCTIONS
42
- histories.push(
43
- ...(await (executor?.select ?? ChatGptSelectFunctionAgent.execute)(
44
- ctx,
45
- )),
46
- );
47
- if (ctx.stack.length === 0) return histories;
48
-
49
- // FUNCTION CALLING LOOP
50
- while (true) {
51
- // EXECUTE FUNCTIONS
52
- const prompts: IAgenticaPrompt<Model>[] = await (
53
- executor?.call ?? ChatGptCallFunctionAgent.execute
54
- )(ctx);
55
- histories.push(...prompts);
56
-
57
- // EXPLAIN RETURN VALUES
58
- const executes: IAgenticaPrompt.IExecute<Model>[] = prompts.filter(
59
- (prompt) => prompt.type === "execute",
60
- );
61
- for (const e of executes)
62
- await ChatGptCancelFunctionAgent.cancelFunction(ctx, {
63
- reason: "completed",
64
- name: e.function.name,
65
- });
66
- histories.push(
67
- ...(await (
68
- executor?.describe ?? ChatGptDescribeFunctionAgent.execute
69
- )(ctx, executes)),
70
- );
71
- if (executes.length === 0 || ctx.stack.length === 0) break;
72
- }
73
- return histories;
74
- };
75
- }
1
+ import { ILlmSchema } from "@samchon/openapi";
2
+
3
+ import { IAgenticaContext } from "../structures/IAgenticaContext";
4
+ import { IAgenticaExecutor } from "../structures/IAgenticaExecutor";
5
+ import { IAgenticaPrompt } from "../structures/IAgenticaPrompt";
6
+ import { ChatGptCallFunctionAgent } from "./ChatGptCallFunctionAgent";
7
+ import { ChatGptCancelFunctionAgent } from "./ChatGptCancelFunctionAgent";
8
+ import { ChatGptDescribeFunctionAgent } from "./ChatGptDescribeFunctionAgent";
9
+ import { ChatGptInitializeFunctionAgent } from "./ChatGptInitializeFunctionAgent";
10
+ import { ChatGptSelectFunctionAgent } from "./ChatGptSelectFunctionAgent";
11
+
12
+ export namespace ChatGptAgent {
13
+ export const execute =
14
+ <Model extends ILlmSchema.Model>(
15
+ executor: Partial<IAgenticaExecutor<Model>> | null,
16
+ ) =>
17
+ async (ctx: IAgenticaContext<Model>): Promise<IAgenticaPrompt<Model>[]> => {
18
+ const histories: IAgenticaPrompt<Model>[] = [];
19
+
20
+ // FUNCTIONS ARE NOT LISTED YET
21
+ if (ctx.ready() === false) {
22
+ if (executor?.initialize === null) await ctx.initialize();
23
+ else {
24
+ histories.push(
25
+ ...(await (
26
+ executor?.initialize ?? ChatGptInitializeFunctionAgent.execute
27
+ )(ctx)),
28
+ );
29
+ if (ctx.ready() === false) return histories;
30
+ }
31
+ }
32
+
33
+ // CANCEL CANDIDATE FUNCTIONS
34
+ if (ctx.stack.length !== 0)
35
+ histories.push(
36
+ ...(await (executor?.cancel ?? ChatGptCancelFunctionAgent.execute)(
37
+ ctx,
38
+ )),
39
+ );
40
+
41
+ // SELECT CANDIDATE FUNCTIONS
42
+ histories.push(
43
+ ...(await (executor?.select ?? ChatGptSelectFunctionAgent.execute)(
44
+ ctx,
45
+ )),
46
+ );
47
+ if (ctx.stack.length === 0) return histories;
48
+
49
+ // FUNCTION CALLING LOOP
50
+ while (true) {
51
+ // EXECUTE FUNCTIONS
52
+ const prompts: IAgenticaPrompt<Model>[] = await (
53
+ executor?.call ?? ChatGptCallFunctionAgent.execute
54
+ )(ctx);
55
+ histories.push(...prompts);
56
+
57
+ // EXPLAIN RETURN VALUES
58
+ const executes: IAgenticaPrompt.IExecute<Model>[] = prompts.filter(
59
+ (prompt) => prompt.type === "execute",
60
+ );
61
+ for (const e of executes)
62
+ await ChatGptCancelFunctionAgent.cancelFunction(ctx, {
63
+ reason: "completed",
64
+ name: e.function.name,
65
+ });
66
+ histories.push(
67
+ ...(await (
68
+ executor?.describe ?? ChatGptDescribeFunctionAgent.execute
69
+ )(ctx, executes)),
70
+ );
71
+ if (executes.length === 0 || ctx.stack.length === 0) break;
72
+ }
73
+ return histories;
74
+ };
75
+ }