@agentica/core 0.21.0 → 0.23.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 (91) hide show
  1. package/README.md +10 -11
  2. package/lib/Agentica.d.ts +2 -1
  3. package/lib/Agentica.js +15 -13
  4. package/lib/Agentica.js.map +1 -1
  5. package/lib/MicroAgentica.d.ts +12 -1
  6. package/lib/MicroAgentica.js +23 -10
  7. package/lib/MicroAgentica.js.map +1 -1
  8. package/lib/context/AgenticaContext.d.ts +4 -4
  9. package/lib/context/MicroAgenticaContext.d.ts +2 -2
  10. package/lib/events/AgenticaEvent.d.ts +3 -1
  11. package/lib/events/AgenticaTextEvent.d.ts +2 -2
  12. package/lib/events/AgenticaUserInputEvent.d.ts +10 -0
  13. package/lib/events/AgenticaUserInputEvent.js +3 -0
  14. package/lib/events/AgenticaUserInputEvent.js.map +1 -0
  15. package/lib/events/MicroAgenticaEvent.d.ts +3 -1
  16. package/lib/factory/events.d.ts +7 -3
  17. package/lib/factory/events.js +29 -4
  18. package/lib/factory/events.js.map +1 -1
  19. package/lib/factory/histories.d.ts +6 -3
  20. package/lib/factory/histories.js +59 -32
  21. package/lib/factory/histories.js.map +1 -1
  22. package/lib/functional/assertHttpController.d.ts +75 -0
  23. package/lib/functional/assertHttpController.js +9622 -0
  24. package/lib/functional/assertHttpController.js.map +1 -0
  25. package/lib/functional/assertHttpLlmApplication.d.ts +1 -0
  26. package/lib/functional/assertHttpLlmApplication.js +1 -0
  27. package/lib/functional/assertHttpLlmApplication.js.map +1 -1
  28. package/lib/functional/assertMcpController.d.ts +1 -1
  29. package/lib/functional/assertMcpController.js +1 -1
  30. package/lib/functional/assertMcpController.js.map +1 -1
  31. package/lib/functional/validateHttpController.d.ts +75 -0
  32. package/lib/functional/validateHttpController.js +7952 -0
  33. package/lib/functional/validateHttpController.js.map +1 -0
  34. package/lib/functional/validateHttpLlmApplication.d.ts +1 -0
  35. package/lib/functional/validateHttpLlmApplication.js +1 -0
  36. package/lib/functional/validateHttpLlmApplication.js.map +1 -1
  37. package/lib/functional/validateMcpController.d.ts +24 -0
  38. package/lib/functional/validateMcpController.js +3034 -0
  39. package/lib/functional/validateMcpController.js.map +1 -0
  40. package/lib/histories/AgenticaHistory.d.ts +3 -1
  41. package/lib/histories/AgenticaTextHistory.d.ts +2 -2
  42. package/lib/histories/AgenticaUserInputHistory.d.ts +80 -0
  43. package/lib/histories/AgenticaUserInputHistory.js +3 -0
  44. package/lib/histories/AgenticaUserInputHistory.js.map +1 -0
  45. package/lib/histories/MicroAgenticaHistory.d.ts +2 -1
  46. package/lib/index.d.ts +3 -0
  47. package/lib/index.js +3 -0
  48. package/lib/index.js.map +1 -1
  49. package/lib/index.mjs +25984 -5962
  50. package/lib/index.mjs.map +1 -1
  51. package/lib/json/IAgenticaEventJson.d.ts +8 -1
  52. package/lib/json/IAgenticaHistoryJson.d.ts +15 -3
  53. package/lib/orchestrate/call.js +3 -7
  54. package/lib/orchestrate/call.js.map +1 -1
  55. package/lib/orchestrate/cancel.js +1 -1
  56. package/lib/orchestrate/cancel.js.map +1 -1
  57. package/lib/orchestrate/initialize.js +2 -6
  58. package/lib/orchestrate/initialize.js.map +1 -1
  59. package/lib/orchestrate/select.js +2 -6
  60. package/lib/orchestrate/select.js.map +1 -1
  61. package/lib/transformers/AgenticaEventTransformer.js +0 -1
  62. package/lib/transformers/AgenticaEventTransformer.js.map +1 -1
  63. package/package.json +2 -2
  64. package/src/Agentica.ts +21 -18
  65. package/src/MicroAgentica.ts +30 -15
  66. package/src/context/AgenticaContext.ts +4 -4
  67. package/src/context/MicroAgenticaContext.ts +2 -2
  68. package/src/events/AgenticaEvent.ts +4 -1
  69. package/src/events/AgenticaTextEvent.ts +2 -4
  70. package/src/events/AgenticaUserInputEvent.ts +12 -0
  71. package/src/events/MicroAgenticaEvent.ts +4 -1
  72. package/src/factory/events.ts +26 -8
  73. package/src/factory/histories.ts +76 -43
  74. package/src/functional/assertHttpController.ts +112 -0
  75. package/src/functional/assertHttpLlmApplication.ts +1 -0
  76. package/src/functional/assertMcpController.ts +1 -2
  77. package/src/functional/validateHttpController.ts +118 -0
  78. package/src/functional/validateHttpLlmApplication.ts +1 -1
  79. package/src/functional/validateMcpController.ts +56 -0
  80. package/src/histories/AgenticaHistory.ts +4 -1
  81. package/src/histories/AgenticaTextHistory.ts +2 -4
  82. package/src/histories/AgenticaUserInputHistory.ts +88 -0
  83. package/src/histories/MicroAgenticaHistory.ts +3 -1
  84. package/src/index.ts +3 -0
  85. package/src/json/IAgenticaEventJson.ts +9 -1
  86. package/src/json/IAgenticaHistoryJson.ts +16 -4
  87. package/src/orchestrate/call.ts +5 -7
  88. package/src/orchestrate/cancel.ts +1 -1
  89. package/src/orchestrate/initialize.ts +2 -6
  90. package/src/orchestrate/select.ts +2 -7
  91. package/src/transformers/AgenticaEventTransformer.ts +0 -1
@@ -1,6 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.decodeHistory = decodeHistory;
4
+ exports.createUserInputHistory = createUserInputHistory;
4
5
  exports.createTextHistory = createTextHistory;
5
6
  exports.createDescribeHistory = createDescribeHistory;
6
7
  exports.createSelectHistory = createSelectHistory;
@@ -11,7 +12,7 @@ function decodeHistory(history) {
11
12
  if (history.type === "describe") {
12
13
  return [];
13
14
  }
14
- else if (history.type === "text") {
15
+ if (history.type === "text") {
15
16
  return [
16
17
  {
17
18
  role: history.role,
@@ -19,7 +20,7 @@ function decodeHistory(history) {
19
20
  },
20
21
  ];
21
22
  }
22
- else if (history.type === "select" || history.type === "cancel") {
23
+ if (history.type === "select" || history.type === "cancel") {
23
24
  return [
24
25
  {
25
26
  role: "assistant",
@@ -46,38 +47,64 @@ function decodeHistory(history) {
46
47
  },
47
48
  ];
48
49
  }
49
- return [
50
- {
51
- role: "assistant",
52
- tool_calls: [
53
- {
54
- type: "function",
55
- id: history.id,
56
- function: {
57
- name: history.operation.name,
58
- arguments: JSON.stringify(history.arguments),
50
+ if (history.type === "execute") {
51
+ return [
52
+ {
53
+ role: "assistant",
54
+ tool_calls: [
55
+ {
56
+ type: "function",
57
+ id: history.id,
58
+ function: {
59
+ name: history.operation.name,
60
+ arguments: JSON.stringify(history.arguments),
61
+ },
59
62
  },
60
- },
61
- ],
62
- },
63
- {
64
- role: "tool",
65
- tool_call_id: history.id,
66
- content: JSON.stringify(Object.assign({ function: Object.assign({ protocol: history.operation.protocol, description: history.operation.function.description, parameters: history.operation.function.parameters, output: history.operation.function.output }, (history.operation.protocol === "http"
63
+ ],
64
+ },
65
+ {
66
+ role: "tool",
67
+ tool_call_id: history.id,
68
+ content: JSON.stringify(Object.assign({ function: Object.assign({ protocol: history.operation.protocol, description: history.operation.function.description, parameters: history.operation.function.parameters, output: history.operation.function.output }, (history.operation.protocol === "http"
69
+ ? {
70
+ method: history.operation.function.method,
71
+ path: history.operation.function.path,
72
+ }
73
+ : {})) }, (history.operation.protocol === "http"
67
74
  ? {
68
- method: history.operation.function.method,
69
- path: history.operation.function.path,
75
+ status: history.value.status,
76
+ data: history.value.body,
70
77
  }
71
- : {})) }, (history.operation.protocol === "http"
72
- ? {
73
- status: history.value.status,
74
- data: history.value.body,
75
- }
76
- : {
77
- value: history.value,
78
- }))),
79
- },
80
- ];
78
+ : {
79
+ value: history.value,
80
+ }))),
81
+ },
82
+ ];
83
+ }
84
+ if (history.type === "user_input") {
85
+ return [
86
+ {
87
+ role: "user",
88
+ content: history.contents,
89
+ },
90
+ ];
91
+ }
92
+ history;
93
+ throw new Error("Invalid history type");
94
+ }
95
+ /* -----------------------------------------------------------
96
+ USER INPUT PROMPTS
97
+ ----------------------------------------------------------- */
98
+ function createUserInputHistory(props) {
99
+ return {
100
+ type: "user_input",
101
+ role: "user",
102
+ contents: props.contents,
103
+ toJSON: () => ({
104
+ type: "user_input",
105
+ contents: props.contents,
106
+ }),
107
+ };
81
108
  }
82
109
  /* -----------------------------------------------------------
83
110
  TEXT PROMPTS
@@ -85,7 +112,7 @@ function decodeHistory(history) {
85
112
  function createTextHistory(props) {
86
113
  const prompt = {
87
114
  type: "text",
88
- role: props.role,
115
+ role: "assistant",
89
116
  text: props.text,
90
117
  };
91
118
  return Object.assign(Object.assign({}, prompt), { toJSON: () => prompt });
@@ -1 +1 @@
1
- {"version":3,"file":"histories.js","sourceRoot":"","sources":["../../src/factory/histories.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"histories.js","sourceRoot":"","sources":["../../src/factory/histories.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,75 @@
1
+ import type { IHttpConnection, IHttpLlmApplication, IHttpLlmFunction, IHttpResponse, ILlmSchema, OpenApiV3, OpenApiV3_1, SwaggerV2 } from "@samchon/openapi";
2
+ import { OpenApi } from "@samchon/openapi";
3
+ import type { IAgenticaController } from "../structures/IAgenticaController";
4
+ /**
5
+ * Create an HTTP controller with type assertion.
6
+ *
7
+ * Create an {@link IAgenticaController.IHttp} instance which represents
8
+ * the HTTP controller from the given Swagger/OpenAPI document and the
9
+ * target LLM model with connection information.
10
+ *
11
+ * By the way, even though this `assertHttpController` function
12
+ * supports every version of Swagger/OpenAPI specification, there can
13
+ * be a type error in the given document. In that case, the function
14
+ * will throw an error with detailed type error tracing information.
15
+ *
16
+ * @param props Properties to create the HTTP controller instance
17
+ * @returns HTTP controller instance
18
+ * @throws {@link TypeGuardError} when the given document is invalid
19
+ * @author Samchon
20
+ */
21
+ export declare function assertHttpController<Model extends ILlmSchema.Model>(props: {
22
+ /**
23
+ * Name of the controller.
24
+ */
25
+ name: string;
26
+ /**
27
+ * Target LLM model.
28
+ */
29
+ model: Model;
30
+ /**
31
+ * Swagger/OpenAPI document.
32
+ */
33
+ document: SwaggerV2.IDocument | OpenApiV3.IDocument | OpenApiV3_1.IDocument | OpenApi.IDocument | unknown;
34
+ /**
35
+ * Connection to the server.
36
+ *
37
+ * Connection to the API server including the URL and headers.
38
+ */
39
+ connection: IHttpConnection;
40
+ /**
41
+ * Options for the LLM function calling schema composition.
42
+ */
43
+ options?: Partial<IHttpLlmApplication.IOptions<Model>>;
44
+ /**
45
+ * Executor of the API function.
46
+ *
47
+ * @param props Properties of the API function call
48
+ * @returns HTTP response of the API function call
49
+ */
50
+ execute?: (props: {
51
+ /**
52
+ * Connection to the server.
53
+ */
54
+ connection: IHttpConnection;
55
+ /**
56
+ * Application schema.
57
+ */
58
+ application: IHttpLlmApplication<Model>;
59
+ /**
60
+ * Function schema.
61
+ */
62
+ function: IHttpLlmFunction<Model>;
63
+ /**
64
+ * Arguments of the function calling.
65
+ *
66
+ * It is an object of key-value pairs of the API function's parameters.
67
+ * The property keys are composed by below rules:
68
+ *
69
+ * - parameter names
70
+ * - query parameter as an object type if exists
71
+ * - body parameter if exists
72
+ */
73
+ arguments: object;
74
+ }) => Promise<IHttpResponse>;
75
+ }): IAgenticaController.IHttp<Model>;