@agentica/core 0.22.0 → 0.24.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.
- package/README.md +11 -12
- package/lib/Agentica.d.ts +6 -1
- package/lib/Agentica.js +8 -3
- package/lib/Agentica.js.map +1 -1
- package/lib/MicroAgentica.d.ts +10 -0
- package/lib/MicroAgentica.js +11 -0
- package/lib/MicroAgentica.js.map +1 -1
- package/lib/context/AgenticaContext.d.ts +4 -0
- package/lib/functional/assertHttpController.d.ts +75 -0
- package/lib/functional/assertHttpController.js +9622 -0
- package/lib/functional/assertHttpController.js.map +1 -0
- package/lib/functional/assertHttpLlmApplication.d.ts +1 -0
- package/lib/functional/assertHttpLlmApplication.js +1 -0
- package/lib/functional/assertHttpLlmApplication.js.map +1 -1
- package/lib/functional/assertMcpController.d.ts +1 -1
- package/lib/functional/assertMcpController.js +1 -1
- package/lib/functional/assertMcpController.js.map +1 -1
- package/lib/functional/validateHttpController.d.ts +75 -0
- package/lib/functional/validateHttpController.js +7952 -0
- package/lib/functional/validateHttpController.js.map +1 -0
- package/lib/functional/validateHttpLlmApplication.d.ts +1 -0
- package/lib/functional/validateHttpLlmApplication.js +1 -0
- package/lib/functional/validateHttpLlmApplication.js.map +1 -1
- package/lib/functional/validateMcpController.d.ts +24 -0
- package/lib/functional/validateMcpController.js +3034 -0
- package/lib/functional/validateMcpController.js.map +1 -0
- package/lib/histories/AgenticaUserInputHistory.d.ts +13 -7
- package/lib/index.d.ts +3 -0
- package/lib/index.js +3 -0
- package/lib/index.js.map +1 -1
- package/lib/index.mjs +25981 -5985
- package/lib/index.mjs.map +1 -1
- package/lib/utils/ChatGptCompletionMessageUtil.spec.d.ts +1 -0
- package/lib/utils/ChatGptCompletionMessageUtil.spec.js +288 -0
- package/lib/utils/ChatGptCompletionMessageUtil.spec.js.map +1 -0
- package/lib/utils/ChatGptTokenUsageAggregator.spec.d.ts +1 -0
- package/lib/utils/ChatGptTokenUsageAggregator.spec.js +199 -0
- package/lib/utils/ChatGptTokenUsageAggregator.spec.js.map +1 -0
- package/lib/utils/Singleton.js +18 -0
- package/lib/utils/Singleton.js.map +1 -1
- package/lib/utils/Singleton.spec.d.ts +1 -0
- package/lib/utils/Singleton.spec.js +106 -0
- package/lib/utils/Singleton.spec.js.map +1 -0
- package/lib/utils/__map_take.spec.d.ts +1 -0
- package/lib/utils/__map_take.spec.js +108 -0
- package/lib/utils/__map_take.spec.js.map +1 -0
- package/package.json +1 -1
- package/src/Agentica.ts +16 -2
- package/src/MicroAgentica.ts +13 -0
- package/src/context/AgenticaContext.ts +5 -0
- package/src/functional/assertHttpController.ts +112 -0
- package/src/functional/assertHttpLlmApplication.ts +1 -0
- package/src/functional/assertMcpController.ts +1 -2
- package/src/functional/validateHttpController.ts +118 -0
- package/src/functional/validateHttpLlmApplication.ts +1 -1
- package/src/functional/validateMcpController.ts +56 -0
- package/src/histories/AgenticaUserInputHistory.ts +14 -8
- package/src/index.ts +3 -0
- package/src/utils/ChatGptCompletionMessageUtil.spec.ts +320 -0
- package/src/utils/ChatGptTokenUsageAggregator.spec.ts +226 -0
- package/src/utils/Singleton.spec.ts +138 -0
- package/src/utils/Singleton.ts +18 -0
- package/src/utils/__map_take.spec.ts +140 -0
- package/lib/utils/MathUtil.d.ts +0 -3
- package/lib/utils/MathUtil.js +0 -8
- package/lib/utils/MathUtil.js.map +0 -1
- package/src/utils/MathUtil.ts +0 -3
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
<!-- https://github.com/user-attachments/assets/5326cc59-5129-470d-abcb-c3f458b5c488 -->
|
|
4
4
|
|
|
5
|
-
|
|
6
6
|
|
|
7
7
|
[](https://github.com/wrtnlabs/agentica/blob/master/LICENSE)
|
|
8
8
|
[](https://www.npmjs.com/package/@agentica/core)
|
|
@@ -26,7 +26,7 @@ Are you a TypeScript developer? Then you're already an AI developer. Familiar wi
|
|
|
26
26
|
<!-- eslint-skip -->
|
|
27
27
|
|
|
28
28
|
```typescript
|
|
29
|
-
import { Agentica,
|
|
29
|
+
import { Agentica, assertHttpController } from "@agentica/core";
|
|
30
30
|
import OpenAI from "openai";
|
|
31
31
|
import typia from "typia";
|
|
32
32
|
|
|
@@ -40,24 +40,23 @@ const agent = new Agentica({
|
|
|
40
40
|
controllers: [
|
|
41
41
|
// functions from TypeScript class
|
|
42
42
|
{
|
|
43
|
-
protocol: "
|
|
43
|
+
protocol: "class",
|
|
44
|
+
name: "filesystem",
|
|
44
45
|
application: typia.llm.application<MobileFileSystem, "chatgpt">(),
|
|
45
46
|
execute: new MobileFileSystem(),
|
|
46
47
|
},
|
|
47
48
|
// functions from Swagger/OpenAPI
|
|
48
|
-
{
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
).then(r => r.json()),
|
|
55
|
-
}),
|
|
49
|
+
assertHttpController({
|
|
50
|
+
name: "shopping",
|
|
51
|
+
model: "chatgpt",
|
|
52
|
+
document: await fetch(
|
|
53
|
+
"https://shopping-be.wrtn.ai/editor/swagger.json",
|
|
54
|
+
).then(r => r.json()),
|
|
56
55
|
connection: {
|
|
57
56
|
host: "https://shopping-be.wrtn.ai",
|
|
58
57
|
headers: { Authorization: "Bearer ********" },
|
|
59
58
|
},
|
|
60
|
-
},
|
|
59
|
+
}),
|
|
61
60
|
],
|
|
62
61
|
});
|
|
63
62
|
await agent.conversate("I wanna buy MacBook Pro");
|
package/lib/Agentica.d.ts
CHANGED
|
@@ -60,9 +60,14 @@ export declare class Agentica<Model extends ILlmSchema.Model> {
|
|
|
60
60
|
* function calling information like {@link AgenticaExecuteHistory}.
|
|
61
61
|
*
|
|
62
62
|
* @param content The content to talk
|
|
63
|
+
* @param options Options
|
|
64
|
+
* @param options.abortSignal Abort signal
|
|
65
|
+
* @throws AbortError
|
|
63
66
|
* @returns List of newly created chat prompts
|
|
64
67
|
*/
|
|
65
|
-
conversate(content: string | AgenticaUserInputHistory.Contents | Array<AgenticaUserInputHistory.Contents
|
|
68
|
+
conversate(content: string | AgenticaUserInputHistory.Contents | Array<AgenticaUserInputHistory.Contents>, options?: {
|
|
69
|
+
abortSignal?: AbortSignal;
|
|
70
|
+
}): Promise<AgenticaHistory<Model>[]>;
|
|
66
71
|
/**
|
|
67
72
|
* Get configuration.
|
|
68
73
|
*/
|
package/lib/Agentica.js
CHANGED
|
@@ -99,10 +99,13 @@ class Agentica {
|
|
|
99
99
|
* function calling information like {@link AgenticaExecuteHistory}.
|
|
100
100
|
*
|
|
101
101
|
* @param content The content to talk
|
|
102
|
+
* @param options Options
|
|
103
|
+
* @param options.abortSignal Abort signal
|
|
104
|
+
* @throws AbortError
|
|
102
105
|
* @returns List of newly created chat prompts
|
|
103
106
|
*/
|
|
104
|
-
conversate(
|
|
105
|
-
return __awaiter(this,
|
|
107
|
+
conversate(content_1) {
|
|
108
|
+
return __awaiter(this, arguments, void 0, function* (content, options = {}) {
|
|
106
109
|
const prompt = (0, factory_1.createUserInputHistory)({
|
|
107
110
|
contents: Array.isArray(content)
|
|
108
111
|
? content
|
|
@@ -118,6 +121,7 @@ class Agentica {
|
|
|
118
121
|
})).catch(() => { });
|
|
119
122
|
const newbie = yield this.executor_(this.getContext({
|
|
120
123
|
prompt,
|
|
124
|
+
abortSignal: options.abortSignal,
|
|
121
125
|
usage: this.token_usage_,
|
|
122
126
|
}));
|
|
123
127
|
this.histories_.push(prompt, ...newbie);
|
|
@@ -191,6 +195,7 @@ class Agentica {
|
|
|
191
195
|
stack: this.stack_,
|
|
192
196
|
ready: () => this.ready_,
|
|
193
197
|
prompt: props.prompt,
|
|
198
|
+
abortSignal: props.abortSignal,
|
|
194
199
|
// HANDLERS
|
|
195
200
|
dispatch: (event) => __awaiter(this, void 0, void 0, function* () { return this.dispatch(event); }),
|
|
196
201
|
request: (source, body) => __awaiter(this, void 0, void 0, function* () {
|
|
@@ -200,7 +205,7 @@ class Agentica {
|
|
|
200
205
|
body: Object.assign(Object.assign({}, body), { model: this.props.vendor.model, stream: true, stream_options: {
|
|
201
206
|
include_usage: true,
|
|
202
207
|
} }),
|
|
203
|
-
options: this.props.vendor.options,
|
|
208
|
+
options: Object.assign(Object.assign({}, this.props.vendor.options), { signal: props.abortSignal }),
|
|
204
209
|
});
|
|
205
210
|
yield dispatch(event);
|
|
206
211
|
// completion
|
package/lib/Agentica.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Agentica.js","sourceRoot":"","sources":["../src/Agentica.ts"],"names":[],"mappings":";;;;;;;;;;;;AAeA,qEAAkE;AAClE,4FAAyF;AACzF,kGAA+F;AAC/F,uCAAmD;AACnD,6CAAmG;AACnG,mDAAgD;AAChD,0FAAuF;AACvF,mDAAgD;AAChD,uFAAoF;AACpF,mDAAqF;AAErF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAa,QAAQ;IAgBnB;;kEAE8D;IAC9D;;;;OAIG;IACH,YAAoC,KAA4B;;QAA5B,UAAK,GAAL,KAAK,CAAuB;QAC9D,aAAa;QACb,IAAI,CAAC,WAAW,GAAG,qDAAyB,CAAC,OAAO,CAAC;YACnD,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC;QAEH,SAAS;QACT,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,CAAC,MAAA,KAAK,CAAC,SAAS,mCAAI,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CACpD,uDAA0B,CAAC,SAAS,CAAC;YACnC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK;YAClC,OAAO,EAAE,KAAK;SACf,CAAC,CACH,CAAC;QAEF,SAAS;QACT,IAAI,CAAC,YAAY,GAAG,uCAAkB,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,SAAS;cACV,OAAO,CAAA,MAAA,KAAK,CAAC,MAAM,0CAAE,QAAQ,CAAA,KAAK,UAAU;gBAC5C,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ;gBACvB,CAAC,CAAC,IAAA,iBAAO,EAAC,MAAA,MAAA,KAAK,CAAC,MAAM,0CAAE,QAAQ,mCAAI,IAAI,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACI,KAAK;;QACV,OAAO,IAAI,QAAQ,iCACd,IAAI,CAAC,KAAK,KACb,SAAS,EAAE,MAAA,IAAI,CAAC,KAAK,CAAC,SAAS,0CAAE,KAAK,EAAE,IACxC,CAAC;IACL,CAAC;IAED;;kEAE8D;IAC9D
|
|
1
|
+
{"version":3,"file":"Agentica.js","sourceRoot":"","sources":["../src/Agentica.ts"],"names":[],"mappings":"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"}
|
package/lib/MicroAgentica.d.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { ILlmSchema } from "@samchon/openapi";
|
|
2
|
+
import type { AgenticaOperation } from "./context/AgenticaOperation";
|
|
2
3
|
import type { MicroAgenticaEvent } from "./events/MicroAgenticaEvent";
|
|
3
4
|
import type { AgenticaUserInputHistory } from "./histories/AgenticaUserInputHistory";
|
|
4
5
|
import type { MicroAgenticaHistory } from "./histories/MicroAgenticaHistory";
|
|
@@ -70,6 +71,15 @@ export declare class MicroAgentica<Model extends ILlmSchema.Model> {
|
|
|
70
71
|
* Get LLM vendor.
|
|
71
72
|
*/
|
|
72
73
|
getVendor(): IAgenticaVendor;
|
|
74
|
+
/**
|
|
75
|
+
* Get operations.
|
|
76
|
+
*
|
|
77
|
+
* Get list of operations, which has capsuled the pair of controller
|
|
78
|
+
* and function from the {@link getControllers controllers}.
|
|
79
|
+
*
|
|
80
|
+
* @returns List of operations
|
|
81
|
+
*/
|
|
82
|
+
getOperations(): ReadonlyArray<AgenticaOperation<Model>>;
|
|
73
83
|
/**
|
|
74
84
|
* Get controllers.
|
|
75
85
|
*
|
package/lib/MicroAgentica.js
CHANGED
|
@@ -138,6 +138,17 @@ class MicroAgentica {
|
|
|
138
138
|
getVendor() {
|
|
139
139
|
return this.props.vendor;
|
|
140
140
|
}
|
|
141
|
+
/**
|
|
142
|
+
* Get operations.
|
|
143
|
+
*
|
|
144
|
+
* Get list of operations, which has capsuled the pair of controller
|
|
145
|
+
* and function from the {@link getControllers controllers}.
|
|
146
|
+
*
|
|
147
|
+
* @returns List of operations
|
|
148
|
+
*/
|
|
149
|
+
getOperations() {
|
|
150
|
+
return this.operations_.array;
|
|
151
|
+
}
|
|
141
152
|
/**
|
|
142
153
|
* Get controllers.
|
|
143
154
|
*
|
package/lib/MicroAgentica.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"MicroAgentica.js","sourceRoot":"","sources":["../src/MicroAgentica.ts"],"names":[],"mappings":";;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"MicroAgentica.js","sourceRoot":"","sources":["../src/MicroAgentica.ts"],"names":[],"mappings":"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"}
|
|
@@ -73,6 +73,10 @@ export interface AgenticaContext<Model extends ILlmSchema.Model> {
|
|
|
73
73
|
* {@link Agentica.conversate} function.
|
|
74
74
|
*/
|
|
75
75
|
prompt: AgenticaUserInputHistory;
|
|
76
|
+
/**
|
|
77
|
+
* Abort signal.
|
|
78
|
+
*/
|
|
79
|
+
abortSignal?: AbortSignal;
|
|
76
80
|
/**
|
|
77
81
|
* Whether the agent is ready.
|
|
78
82
|
*
|
|
@@ -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>;
|