@notic/agent-engine 1.0.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/LICENSE +190 -0
- package/README.md +725 -0
- package/dist/adapter/AnthropicAdapter.d.ts +47 -0
- package/dist/adapter/AnthropicAdapter.d.ts.map +1 -0
- package/dist/adapter/AnthropicAdapter.js +341 -0
- package/dist/adapter/AnthropicAdapter.js.map +1 -0
- package/dist/adapter/GeminiAdapter.d.ts +47 -0
- package/dist/adapter/GeminiAdapter.d.ts.map +1 -0
- package/dist/adapter/GeminiAdapter.js +315 -0
- package/dist/adapter/GeminiAdapter.js.map +1 -0
- package/dist/adapter/MessageAdapter.d.ts +66 -0
- package/dist/adapter/MessageAdapter.d.ts.map +1 -0
- package/dist/adapter/MessageAdapter.js +66 -0
- package/dist/adapter/MessageAdapter.js.map +1 -0
- package/dist/adapter/OpenAIAdapter.d.ts +45 -0
- package/dist/adapter/OpenAIAdapter.d.ts.map +1 -0
- package/dist/adapter/OpenAIAdapter.js +305 -0
- package/dist/adapter/OpenAIAdapter.js.map +1 -0
- package/dist/adapter/index.d.ts +5 -0
- package/dist/adapter/index.d.ts.map +1 -0
- package/dist/adapter/index.js +10 -0
- package/dist/adapter/index.js.map +1 -0
- package/dist/agent/Agent.d.ts +319 -0
- package/dist/agent/Agent.d.ts.map +1 -0
- package/dist/agent/Agent.js +876 -0
- package/dist/agent/Agent.js.map +1 -0
- package/dist/agent/index.d.ts +2 -0
- package/dist/agent/index.d.ts.map +1 -0
- package/dist/agent/index.js +8 -0
- package/dist/agent/index.js.map +1 -0
- package/dist/config/RequestConfig.d.ts +119 -0
- package/dist/config/RequestConfig.d.ts.map +1 -0
- package/dist/config/RequestConfig.js +257 -0
- package/dist/config/RequestConfig.js.map +1 -0
- package/dist/config/index.d.ts +2 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +6 -0
- package/dist/config/index.js.map +1 -0
- package/dist/index.d.ts +29 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +69 -0
- package/dist/index.js.map +1 -0
- package/dist/media/DefaultMediaResolver.d.ts +17 -0
- package/dist/media/DefaultMediaResolver.d.ts.map +1 -0
- package/dist/media/DefaultMediaResolver.js +114 -0
- package/dist/media/DefaultMediaResolver.js.map +1 -0
- package/dist/media/MediaResolver.d.ts +20 -0
- package/dist/media/MediaResolver.d.ts.map +1 -0
- package/dist/media/MediaResolver.js +3 -0
- package/dist/media/MediaResolver.js.map +1 -0
- package/dist/media/index.d.ts +3 -0
- package/dist/media/index.d.ts.map +1 -0
- package/dist/media/index.js +6 -0
- package/dist/media/index.js.map +1 -0
- package/dist/message/Message.d.ts +121 -0
- package/dist/message/Message.d.ts.map +1 -0
- package/dist/message/Message.js +345 -0
- package/dist/message/Message.js.map +1 -0
- package/dist/message/MessagePart.d.ts +46 -0
- package/dist/message/MessagePart.d.ts.map +1 -0
- package/dist/message/MessagePart.js +6 -0
- package/dist/message/MessagePart.js.map +1 -0
- package/dist/message/Role.d.ts +10 -0
- package/dist/message/Role.d.ts.map +1 -0
- package/dist/message/Role.js +14 -0
- package/dist/message/Role.js.map +1 -0
- package/dist/message/Usage.d.ts +31 -0
- package/dist/message/Usage.d.ts.map +1 -0
- package/dist/message/Usage.js +58 -0
- package/dist/message/Usage.js.map +1 -0
- package/dist/message/index.d.ts +5 -0
- package/dist/message/index.d.ts.map +1 -0
- package/dist/message/index.js +10 -0
- package/dist/message/index.js.map +1 -0
- package/dist/prompt/Injection.d.ts +72 -0
- package/dist/prompt/Injection.d.ts.map +1 -0
- package/dist/prompt/Injection.js +123 -0
- package/dist/prompt/Injection.js.map +1 -0
- package/dist/prompt/PromptBuilder.d.ts +276 -0
- package/dist/prompt/PromptBuilder.d.ts.map +1 -0
- package/dist/prompt/PromptBuilder.js +465 -0
- package/dist/prompt/PromptBuilder.js.map +1 -0
- package/dist/prompt/Rule.d.ts +98 -0
- package/dist/prompt/Rule.d.ts.map +1 -0
- package/dist/prompt/Rule.js +275 -0
- package/dist/prompt/Rule.js.map +1 -0
- package/dist/prompt/index.d.ts +4 -0
- package/dist/prompt/index.d.ts.map +1 -0
- package/dist/prompt/index.js +10 -0
- package/dist/prompt/index.js.map +1 -0
- package/dist/session/Inserter.d.ts +76 -0
- package/dist/session/Inserter.d.ts.map +1 -0
- package/dist/session/Inserter.js +217 -0
- package/dist/session/Inserter.js.map +1 -0
- package/dist/session/Paginator.d.ts +52 -0
- package/dist/session/Paginator.d.ts.map +1 -0
- package/dist/session/Paginator.js +110 -0
- package/dist/session/Paginator.js.map +1 -0
- package/dist/session/Query.d.ts +54 -0
- package/dist/session/Query.d.ts.map +1 -0
- package/dist/session/Query.js +97 -0
- package/dist/session/Query.js.map +1 -0
- package/dist/session/SearchCriteria.d.ts +39 -0
- package/dist/session/SearchCriteria.d.ts.map +1 -0
- package/dist/session/SearchCriteria.js +28 -0
- package/dist/session/SearchCriteria.js.map +1 -0
- package/dist/session/Session.d.ts +139 -0
- package/dist/session/Session.d.ts.map +1 -0
- package/dist/session/Session.js +344 -0
- package/dist/session/Session.js.map +1 -0
- package/dist/session/index.d.ts +6 -0
- package/dist/session/index.d.ts.map +1 -0
- package/dist/session/index.js +15 -0
- package/dist/session/index.js.map +1 -0
- package/dist/session/matchUtils.d.ts +22 -0
- package/dist/session/matchUtils.d.ts.map +1 -0
- package/dist/session/matchUtils.js +138 -0
- package/dist/session/matchUtils.js.map +1 -0
- package/dist/stream/StreamEvent.d.ts +193 -0
- package/dist/stream/StreamEvent.d.ts.map +1 -0
- package/dist/stream/StreamEvent.js +44 -0
- package/dist/stream/StreamEvent.js.map +1 -0
- package/dist/stream/StreamParser.d.ts +47 -0
- package/dist/stream/StreamParser.d.ts.map +1 -0
- package/dist/stream/StreamParser.js +225 -0
- package/dist/stream/StreamParser.js.map +1 -0
- package/dist/stream/index.d.ts +3 -0
- package/dist/stream/index.d.ts.map +1 -0
- package/dist/stream/index.js +8 -0
- package/dist/stream/index.js.map +1 -0
- package/dist/tool/Context.d.ts +30 -0
- package/dist/tool/Context.d.ts.map +1 -0
- package/dist/tool/Context.js +50 -0
- package/dist/tool/Context.js.map +1 -0
- package/dist/tool/Hook.d.ts +23 -0
- package/dist/tool/Hook.d.ts.map +1 -0
- package/dist/tool/Hook.js +27 -0
- package/dist/tool/Hook.js.map +1 -0
- package/dist/tool/McpToolAdapter.d.ts +47 -0
- package/dist/tool/McpToolAdapter.d.ts.map +1 -0
- package/dist/tool/McpToolAdapter.js +88 -0
- package/dist/tool/McpToolAdapter.js.map +1 -0
- package/dist/tool/Param.d.ts +68 -0
- package/dist/tool/Param.d.ts.map +1 -0
- package/dist/tool/Param.js +161 -0
- package/dist/tool/Param.js.map +1 -0
- package/dist/tool/Tool.d.ts +92 -0
- package/dist/tool/Tool.d.ts.map +1 -0
- package/dist/tool/Tool.js +198 -0
- package/dist/tool/Tool.js.map +1 -0
- package/dist/tool/ToolCall.d.ts +37 -0
- package/dist/tool/ToolCall.d.ts.map +1 -0
- package/dist/tool/ToolCall.js +118 -0
- package/dist/tool/ToolCall.js.map +1 -0
- package/dist/tool/ToolKit.d.ts +87 -0
- package/dist/tool/ToolKit.d.ts.map +1 -0
- package/dist/tool/ToolKit.js +173 -0
- package/dist/tool/ToolKit.js.map +1 -0
- package/dist/tool/ValueType.d.ts +12 -0
- package/dist/tool/ValueType.d.ts.map +1 -0
- package/dist/tool/ValueType.js +16 -0
- package/dist/tool/ValueType.js.map +1 -0
- package/dist/tool/index.d.ts +9 -0
- package/dist/tool/index.d.ts.map +1 -0
- package/dist/tool/index.js +21 -0
- package/dist/tool/index.js.map +1 -0
- package/dist/utils/generateId.d.ts +10 -0
- package/dist/utils/generateId.d.ts.map +1 -0
- package/dist/utils/generateId.js +18 -0
- package/dist/utils/generateId.js.map +1 -0
- package/dist/utils/index.d.ts +2 -0
- package/dist/utils/index.d.ts.map +1 -0
- package/dist/utils/index.js +6 -0
- package/dist/utils/index.js.map +1 -0
- package/package.json +72 -0
|
@@ -0,0 +1,198 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.Tool = void 0;
|
|
4
|
+
const Hook_1 = require("./Hook");
|
|
5
|
+
const Context_1 = require("./Context");
|
|
6
|
+
const ToolCall_1 = require("./ToolCall");
|
|
7
|
+
/**
|
|
8
|
+
* 工具定义 — Builder 模式
|
|
9
|
+
*
|
|
10
|
+
* build() 前: 构建阶段,链式配置
|
|
11
|
+
* build() 后: 冻结状态,只能create() 调用实例
|
|
12
|
+
*
|
|
13
|
+
* 用法:
|
|
14
|
+
* const weather = Tool.create(getWeatherFn)
|
|
15
|
+
* .name("get_weather")
|
|
16
|
+
* .description("获取天气")
|
|
17
|
+
* .params(
|
|
18
|
+
* Param.string("city").desc("城市名").required(),
|
|
19
|
+
* Param.string("unit").desc("单位").enum(["celsius", "fahrenheit"]),
|
|
20
|
+
* )
|
|
21
|
+
* .on(Hook.ON_ERROR, (ctx) => { ctx.result = "暂不可用"; })
|
|
22
|
+
* .build();
|
|
23
|
+
*/
|
|
24
|
+
class Tool {
|
|
25
|
+
_func;
|
|
26
|
+
_name;
|
|
27
|
+
_description = "";
|
|
28
|
+
_params = [];
|
|
29
|
+
_hooks = new Map();
|
|
30
|
+
_built = false;
|
|
31
|
+
_schema;
|
|
32
|
+
constructor(func, name) {
|
|
33
|
+
this._func = func;
|
|
34
|
+
this._name = name || func.name || "unnamed";
|
|
35
|
+
// 初始化所有 Hook的handler 列表
|
|
36
|
+
for (const hook of Object.values(Hook_1.Hook)) {
|
|
37
|
+
this._hooks.set(hook, []);
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
// ========================
|
|
41
|
+
// 静态工厂
|
|
42
|
+
// ========================
|
|
43
|
+
/**
|
|
44
|
+
* 创建工具 Builder
|
|
45
|
+
* @param fn 工具执行函数,签名 (args: Record<string, unknown>) => unknown
|
|
46
|
+
*/
|
|
47
|
+
static create(fn) {
|
|
48
|
+
return new Tool(fn);
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* 从已有的schema + 执行函数直接创建(用于 MCP 等外部工具)
|
|
52
|
+
*跳过 Builder 阶段,直接进入 built 状态
|
|
53
|
+
*/
|
|
54
|
+
static fromRaw(name, description, schema, fn) {
|
|
55
|
+
const tool = new Tool(fn, name);
|
|
56
|
+
tool._description = description;
|
|
57
|
+
tool._schema = schema;
|
|
58
|
+
tool._built = true;
|
|
59
|
+
return tool;
|
|
60
|
+
}
|
|
61
|
+
// ========================
|
|
62
|
+
// 链式配置(build前)
|
|
63
|
+
// ========================
|
|
64
|
+
name(n) {
|
|
65
|
+
this.guardNotBuilt();
|
|
66
|
+
this._name = n;
|
|
67
|
+
return this;
|
|
68
|
+
}
|
|
69
|
+
description(desc) {
|
|
70
|
+
this.guardNotBuilt();
|
|
71
|
+
this._description = desc;
|
|
72
|
+
return this;
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* 批量添加参数
|
|
76
|
+
*/
|
|
77
|
+
params(...params) {
|
|
78
|
+
this.guardNotBuilt();
|
|
79
|
+
this._params.push(...params);
|
|
80
|
+
return this;
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* 注册钩子,同一Hook 可注册多个handler,按注册顺序执行
|
|
84
|
+
*/
|
|
85
|
+
on(hook, handler) {
|
|
86
|
+
this.guardNotBuilt();
|
|
87
|
+
this._hooks.get(hook).push(handler);
|
|
88
|
+
return this;
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* 冻结配置,生成 JSON Schema
|
|
92
|
+
*/
|
|
93
|
+
build() {
|
|
94
|
+
this.guardNotBuilt();
|
|
95
|
+
// 组装 properties和 required
|
|
96
|
+
const properties = {};
|
|
97
|
+
const required = [];
|
|
98
|
+
for (const param of this._params) {
|
|
99
|
+
properties[param.name] = param.toSchema();
|
|
100
|
+
if (param.isRequired) {
|
|
101
|
+
required.push(param.name);
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
this._schema = {
|
|
105
|
+
type: "function",
|
|
106
|
+
function: {
|
|
107
|
+
name: this._name,
|
|
108
|
+
description: this._description,
|
|
109
|
+
parameters: {
|
|
110
|
+
type: "object",
|
|
111
|
+
properties,
|
|
112
|
+
required,
|
|
113
|
+
},
|
|
114
|
+
},
|
|
115
|
+
};
|
|
116
|
+
this._built = true;
|
|
117
|
+
return this;
|
|
118
|
+
}
|
|
119
|
+
// ========================
|
|
120
|
+
// 运行时(build 后)
|
|
121
|
+
// ========================
|
|
122
|
+
/** 获取 OpenAI tools 格式的 JSON Schema */
|
|
123
|
+
get schema() {
|
|
124
|
+
this.guardBuilt();
|
|
125
|
+
return this._schema;
|
|
126
|
+
}
|
|
127
|
+
/** 工具名*/
|
|
128
|
+
get toolName() {
|
|
129
|
+
return this._name;
|
|
130
|
+
}
|
|
131
|
+
/** 执行函数 */
|
|
132
|
+
get func() {
|
|
133
|
+
return this._func;
|
|
134
|
+
}
|
|
135
|
+
/**
|
|
136
|
+
* 从模版创建一次具体的函数调用
|
|
137
|
+
*
|
|
138
|
+
* @param toolCallId LLM 返回的 tool_call id
|
|
139
|
+
* @param args 调用参数
|
|
140
|
+
*/
|
|
141
|
+
create(toolCallId, args, signal) {
|
|
142
|
+
this.guardBuilt();
|
|
143
|
+
const ctx = new Context_1.Context(toolCallId, this._name, { ...args }, signal);
|
|
144
|
+
try {
|
|
145
|
+
// ---- ON_CREATE ----
|
|
146
|
+
this.fire(Hook_1.Hook.ON_CREATE, ctx);
|
|
147
|
+
// ---- ON_VALIDATE ----
|
|
148
|
+
this.fire(Hook_1.Hook.ON_VALIDATE, ctx);
|
|
149
|
+
//内置校验:必填参数
|
|
150
|
+
const requiredParams = this._params.filter((p) => p.isRequired);
|
|
151
|
+
const missing = requiredParams
|
|
152
|
+
.filter((p) => !(p.name in ctx.arguments))
|
|
153
|
+
.map((p) => p.name);
|
|
154
|
+
if (missing.length > 0) {
|
|
155
|
+
throw new Error(`缺少必填参数: ${missing.join(", ")}`);
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
catch (e) {
|
|
159
|
+
const error = e instanceof Error ? e : new Error(String(e));
|
|
160
|
+
ctx.error = error;
|
|
161
|
+
// ---- ON_ERROR ----
|
|
162
|
+
this.fire(Hook_1.Hook.ON_ERROR, ctx);
|
|
163
|
+
// ON_ERROR 未提供降级结果则继续抛出
|
|
164
|
+
if (ctx.result === undefined) {
|
|
165
|
+
throw error;
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
return new ToolCall_1.ToolCall(this, toolCallId, this._name, ctx.arguments, signal);
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* 触发钩子链
|
|
172
|
+
*/
|
|
173
|
+
fire(hook, ctx) {
|
|
174
|
+
const handlers = this._hooks.get(hook) || [];
|
|
175
|
+
for (const handler of handlers) {
|
|
176
|
+
const result = handler(ctx);
|
|
177
|
+
if (result instanceof Context_1.Context) {
|
|
178
|
+
ctx = result;
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
return ctx;
|
|
182
|
+
}
|
|
183
|
+
// ========================
|
|
184
|
+
// 防护
|
|
185
|
+
// ========================
|
|
186
|
+
guardBuilt() {
|
|
187
|
+
if (!this._built) {
|
|
188
|
+
throw new Error("工具尚未构建,请先调用 build()");
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
guardNotBuilt() {
|
|
192
|
+
if (this._built) {
|
|
193
|
+
throw new Error("工具已构建,无法修改");
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
exports.Tool = Tool;
|
|
198
|
+
//# sourceMappingURL=Tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Tool.js","sourceRoot":"","sources":["../../src/tool/Tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { Message } from "../message";
|
|
2
|
+
import type { Tool } from "./Tool";
|
|
3
|
+
/**
|
|
4
|
+
* 一次具体的函数调用实例
|
|
5
|
+
*
|
|
6
|
+
* 由Tool 模版的 create() 方法产生,
|
|
7
|
+
* 走完整生命周期: BEFORE_EXECUTE → execute → AFTER_EXECUTE
|
|
8
|
+
*/
|
|
9
|
+
export declare class ToolCall {
|
|
10
|
+
readonly id: string;
|
|
11
|
+
readonly name: string;
|
|
12
|
+
readonly arguments: Record<string, unknown>;
|
|
13
|
+
private _template;
|
|
14
|
+
private _signal?;
|
|
15
|
+
private _result?;
|
|
16
|
+
private _executed;
|
|
17
|
+
private _error?;
|
|
18
|
+
private _ctx?;
|
|
19
|
+
constructor(template: Tool, id: string, name: string, args: Record<string, unknown>, signal?: AbortSignal);
|
|
20
|
+
execute(): Promise<unknown>;
|
|
21
|
+
/**
|
|
22
|
+
* 将执行结果序列化为 Message.tool(),回传给 LLM
|
|
23
|
+
*/
|
|
24
|
+
toMessage(): Message;
|
|
25
|
+
get result(): unknown;
|
|
26
|
+
get isExecuted(): boolean;
|
|
27
|
+
get error(): Error | undefined;
|
|
28
|
+
/**
|
|
29
|
+
* 获取或创建 Context
|
|
30
|
+
*
|
|
31
|
+
* 首次调用创建新的 Context 并缓存,后续调用复用同一实例,
|
|
32
|
+
* 确保 BEFORE_EXECUTE → execute → AFTER_EXECUTE → ON_SERIALIZE
|
|
33
|
+
* 整个生命周期共享同一个 Context。
|
|
34
|
+
*/
|
|
35
|
+
private getOrCreateContext;
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=ToolCall.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ToolCall.d.ts","sourceRoot":"","sources":["../../src/tool/ToolCall.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC;;;;;GAKG;AACH,qBAAa,QAAQ;IACnB,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnD,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,IAAI,CAAC,CAAU;gBAGrB,QAAQ,EAAE,IAAI,EACd,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,CAAC,EAAE,WAAW;IAahB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IA6CjC;;OAEG;IACH,SAAS,IAAI,OAAO;IAmBpB,IAAI,MAAM,IAAI,OAAO,CAKpB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,KAAK,IAAI,KAAK,GAAG,SAAS,CAE7B;IAMD;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;CAM3B"}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.ToolCall = void 0;
|
|
4
|
+
const Context_1 = require("./Context");
|
|
5
|
+
const Hook_1 = require("./Hook");
|
|
6
|
+
const message_1 = require("../message");
|
|
7
|
+
/**
|
|
8
|
+
* 一次具体的函数调用实例
|
|
9
|
+
*
|
|
10
|
+
* 由Tool 模版的 create() 方法产生,
|
|
11
|
+
* 走完整生命周期: BEFORE_EXECUTE → execute → AFTER_EXECUTE
|
|
12
|
+
*/
|
|
13
|
+
class ToolCall {
|
|
14
|
+
id;
|
|
15
|
+
name;
|
|
16
|
+
arguments;
|
|
17
|
+
_template;
|
|
18
|
+
_signal;
|
|
19
|
+
_result;
|
|
20
|
+
_executed = false;
|
|
21
|
+
_error;
|
|
22
|
+
_ctx;
|
|
23
|
+
constructor(template, id, name, args, signal) {
|
|
24
|
+
this._template = template;
|
|
25
|
+
this._signal = signal;
|
|
26
|
+
this.id = id;
|
|
27
|
+
this.name = name;
|
|
28
|
+
this.arguments = args;
|
|
29
|
+
}
|
|
30
|
+
// ========================
|
|
31
|
+
// 执行(完整生命周期)
|
|
32
|
+
// ========================
|
|
33
|
+
async execute() {
|
|
34
|
+
const ctx = this.getOrCreateContext();
|
|
35
|
+
ctx.throwIfAborted();
|
|
36
|
+
//---- BEFORE_EXECUTE ----
|
|
37
|
+
this._template.fire(Hook_1.Hook.BEFORE_EXECUTE, ctx);
|
|
38
|
+
ctx.throwIfAborted();
|
|
39
|
+
if (ctx.cancelled) {
|
|
40
|
+
throw new Error(`执行被取消: ${ctx.cancelReason}`);
|
|
41
|
+
}
|
|
42
|
+
// ---- execute ----
|
|
43
|
+
try {
|
|
44
|
+
this._result = await this._template.func(ctx.arguments, ctx);
|
|
45
|
+
ctx.throwIfAborted();
|
|
46
|
+
ctx.result = this._result;
|
|
47
|
+
this._executed = true;
|
|
48
|
+
// ---- AFTER_EXECUTE ----
|
|
49
|
+
this._template.fire(Hook_1.Hook.AFTER_EXECUTE, ctx);
|
|
50
|
+
this._result = ctx.result;
|
|
51
|
+
}
|
|
52
|
+
catch (e) {
|
|
53
|
+
const error = e instanceof Error ? e : new Error(String(e));
|
|
54
|
+
this._error = error;
|
|
55
|
+
ctx.error = error;
|
|
56
|
+
// ---- ON_ERROR ----
|
|
57
|
+
this._template.fire(Hook_1.Hook.ON_ERROR, ctx);
|
|
58
|
+
if (ctx.result !== undefined) {
|
|
59
|
+
//钩子提供了降级结果
|
|
60
|
+
this._result = ctx.result;
|
|
61
|
+
this._executed = true;
|
|
62
|
+
}
|
|
63
|
+
else {
|
|
64
|
+
throw error;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
return this._result;
|
|
68
|
+
}
|
|
69
|
+
// ========================
|
|
70
|
+
// 序列化为 Message
|
|
71
|
+
// ========================
|
|
72
|
+
/**
|
|
73
|
+
* 将执行结果序列化为 Message.tool(),回传给 LLM
|
|
74
|
+
*/
|
|
75
|
+
toMessage() {
|
|
76
|
+
const ctx = this.getOrCreateContext();
|
|
77
|
+
ctx.result = this._result;
|
|
78
|
+
// ---- ON_SERIALIZE ----
|
|
79
|
+
this._template.fire(Hook_1.Hook.ON_SERIALIZE, ctx);
|
|
80
|
+
const content = typeof ctx.result === "string"
|
|
81
|
+
? ctx.result
|
|
82
|
+
: JSON.stringify(ctx.result ?? null);
|
|
83
|
+
return message_1.Message.tool(this.id, content);
|
|
84
|
+
}
|
|
85
|
+
// ========================
|
|
86
|
+
// 状态 Getter
|
|
87
|
+
// ========================
|
|
88
|
+
get result() {
|
|
89
|
+
if (!this._executed) {
|
|
90
|
+
throw new Error("尚未执行,请先调用 execute()");
|
|
91
|
+
}
|
|
92
|
+
return this._result;
|
|
93
|
+
}
|
|
94
|
+
get isExecuted() {
|
|
95
|
+
return this._executed;
|
|
96
|
+
}
|
|
97
|
+
get error() {
|
|
98
|
+
return this._error;
|
|
99
|
+
}
|
|
100
|
+
// ========================
|
|
101
|
+
// 内部辅助
|
|
102
|
+
// ========================
|
|
103
|
+
/**
|
|
104
|
+
* 获取或创建 Context
|
|
105
|
+
*
|
|
106
|
+
* 首次调用创建新的 Context 并缓存,后续调用复用同一实例,
|
|
107
|
+
* 确保 BEFORE_EXECUTE → execute → AFTER_EXECUTE → ON_SERIALIZE
|
|
108
|
+
* 整个生命周期共享同一个 Context。
|
|
109
|
+
*/
|
|
110
|
+
getOrCreateContext() {
|
|
111
|
+
if (!this._ctx) {
|
|
112
|
+
this._ctx = new Context_1.Context(this.id, this.name, { ...this.arguments }, this._signal);
|
|
113
|
+
}
|
|
114
|
+
return this._ctx;
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
exports.ToolCall = ToolCall;
|
|
118
|
+
//# sourceMappingURL=ToolCall.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ToolCall.js","sourceRoot":"","sources":["../../src/tool/ToolCall.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
import { Tool, ToolSchema } from "./Tool";
|
|
2
|
+
import { ToolCallPart } from "../message/MessagePart";
|
|
3
|
+
import { Message } from "../message/Message";
|
|
4
|
+
export type ToolErrorPolicy = "return_to_model" | "throw";
|
|
5
|
+
export declare class ToolExecutionError extends Error {
|
|
6
|
+
readonly toolCallId: string;
|
|
7
|
+
readonly toolName: string;
|
|
8
|
+
readonly cause?: unknown;
|
|
9
|
+
constructor(toolCallId: string, toolName: string, cause: unknown);
|
|
10
|
+
}
|
|
11
|
+
export interface ToolExecutionOptions {
|
|
12
|
+
/** 中断信号:传入 Tool Context,供工具内部响应取消 */
|
|
13
|
+
signal?: AbortSignal;
|
|
14
|
+
/** 工具错误策略:默认 return_to_model */
|
|
15
|
+
errorPolicy?: ToolErrorPolicy;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* 工具包管理器
|
|
19
|
+
*
|
|
20
|
+
* 统一管理所有工具,作为 Message 系统与 Tool 系统之间的桥梁。
|
|
21
|
+
*
|
|
22
|
+
* 用法:
|
|
23
|
+
*const toolkit = new ToolKit()
|
|
24
|
+
* .add(weatherTool, timeTool);
|
|
25
|
+
*
|
|
26
|
+
* await toolkit.addMCP(mcpClient);// 自动发现 MCP 工具
|
|
27
|
+
*
|
|
28
|
+
* const tools = toolkit.schemas;// 丢给LLM
|
|
29
|
+
* const results = await toolkit.executeAll(msg.toolCalls); // 批量执行
|
|
30
|
+
*/
|
|
31
|
+
export declare class ToolKit {
|
|
32
|
+
private _tools;
|
|
33
|
+
/**
|
|
34
|
+
* 添加一个或多个工具
|
|
35
|
+
*/
|
|
36
|
+
add(...tools: Tool[]): this;
|
|
37
|
+
/**
|
|
38
|
+
* 从 MCP Client 自动发现并注册工具
|
|
39
|
+
*
|
|
40
|
+
* @param client @modelcontextprotocol/sdk的 Client 实例
|
|
41
|
+
*/
|
|
42
|
+
addMCP(client: McpClientLike): Promise<this>;
|
|
43
|
+
/** 按名称获取工具 */
|
|
44
|
+
get(name: string): Tool | undefined;
|
|
45
|
+
/** 检查工具是否存在 */
|
|
46
|
+
has(name: string): boolean;
|
|
47
|
+
/** 所有工具的schema,直接传给LLM 的 tools参数 */
|
|
48
|
+
get schemas(): ToolSchema[];
|
|
49
|
+
/** 所有工具名*/
|
|
50
|
+
get names(): string[];
|
|
51
|
+
/** 工具数量 */
|
|
52
|
+
get size(): number;
|
|
53
|
+
/**
|
|
54
|
+
* 执行单个 ToolCallPart
|
|
55
|
+
*
|
|
56
|
+
* ToolCallPart(数据) → ToolCall(行为) → execute → Message(数据)
|
|
57
|
+
*/
|
|
58
|
+
execute(toolCallPart: ToolCallPart, options?: ToolExecutionOptions): Promise<Message>;
|
|
59
|
+
/**
|
|
60
|
+
* 并行执行多个 ToolCallPart
|
|
61
|
+
*/
|
|
62
|
+
executeAll(toolCallParts: ToolCallPart[], options?: ToolExecutionOptions): Promise<Message[]>;
|
|
63
|
+
private parseArguments;
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* MCP Client最小接口
|
|
67
|
+
*避免直接依赖 @modelcontextprotocol/sdk 的具体类型
|
|
68
|
+
*/
|
|
69
|
+
export interface McpClientLike {
|
|
70
|
+
listTools(): Promise<{
|
|
71
|
+
tools: Array<{
|
|
72
|
+
name: string;
|
|
73
|
+
description?: string;
|
|
74
|
+
inputSchema: Record<string, unknown>;
|
|
75
|
+
}>;
|
|
76
|
+
}>;
|
|
77
|
+
callTool(params: {
|
|
78
|
+
name: string;
|
|
79
|
+
arguments?: Record<string, unknown>;
|
|
80
|
+
}): Promise<{
|
|
81
|
+
content: Array<{
|
|
82
|
+
type: string;
|
|
83
|
+
text?: string;
|
|
84
|
+
}>;
|
|
85
|
+
}>;
|
|
86
|
+
}
|
|
87
|
+
//# sourceMappingURL=ToolKit.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ToolKit.d.ts","sourceRoot":"","sources":["../../src/tool/ToolKit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,OAAO,CAAC;AAE1D,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAQjE;AAED,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gCAAgC;IAChC,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAgC;IAM9C;;OAEG;IACH,GAAG,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAU3B;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAelD,cAAc;IACd,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,eAAe;IACf,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,oCAAoC;IACpC,IAAI,OAAO,IAAI,UAAU,EAAE,CAE1B;IAED,WAAW;IACX,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAED,WAAW;IACX,IAAI,IAAI,IAAI,MAAM,CAEjB;IAMD;;;;OAIG;IACG,OAAO,CACX,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,OAAO,CAAC;IA+BnB;;OAEG;IACG,UAAU,CACd,aAAa,EAAE,YAAY,EAAE,EAC7B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,OAAO,EAAE,CAAC;IAQrB,OAAO,CAAC,cAAc;CAWvB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,IAAI,OAAO,CAAC;QACnB,KAAK,EAAE,KAAK,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACtC,CAAC,CAAC;KACJ,CAAC,CAAC;IACH,QAAQ,CAAC,MAAM,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,GAAG,OAAO,CAAC;QACV,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACjD,CAAC,CAAC;CACJ"}
|
|
@@ -0,0 +1,173 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
3
|
+
if (k2 === undefined) k2 = k;
|
|
4
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
5
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
6
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
7
|
+
}
|
|
8
|
+
Object.defineProperty(o, k2, desc);
|
|
9
|
+
}) : (function(o, m, k, k2) {
|
|
10
|
+
if (k2 === undefined) k2 = k;
|
|
11
|
+
o[k2] = m[k];
|
|
12
|
+
}));
|
|
13
|
+
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
14
|
+
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
15
|
+
}) : function(o, v) {
|
|
16
|
+
o["default"] = v;
|
|
17
|
+
});
|
|
18
|
+
var __importStar = (this && this.__importStar) || (function () {
|
|
19
|
+
var ownKeys = function(o) {
|
|
20
|
+
ownKeys = Object.getOwnPropertyNames || function (o) {
|
|
21
|
+
var ar = [];
|
|
22
|
+
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
|
|
23
|
+
return ar;
|
|
24
|
+
};
|
|
25
|
+
return ownKeys(o);
|
|
26
|
+
};
|
|
27
|
+
return function (mod) {
|
|
28
|
+
if (mod && mod.__esModule) return mod;
|
|
29
|
+
var result = {};
|
|
30
|
+
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
|
|
31
|
+
__setModuleDefault(result, mod);
|
|
32
|
+
return result;
|
|
33
|
+
};
|
|
34
|
+
})();
|
|
35
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
36
|
+
exports.ToolKit = exports.ToolExecutionError = void 0;
|
|
37
|
+
const Message_1 = require("../message/Message");
|
|
38
|
+
class ToolExecutionError extends Error {
|
|
39
|
+
toolCallId;
|
|
40
|
+
toolName;
|
|
41
|
+
cause;
|
|
42
|
+
constructor(toolCallId, toolName, cause) {
|
|
43
|
+
const message = cause instanceof Error ? cause.message : String(cause);
|
|
44
|
+
super(`工具执行失败 [${toolName}]: ${message}`);
|
|
45
|
+
this.name = "ToolExecutionError";
|
|
46
|
+
this.toolCallId = toolCallId;
|
|
47
|
+
this.toolName = toolName;
|
|
48
|
+
this.cause = cause;
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
exports.ToolExecutionError = ToolExecutionError;
|
|
52
|
+
/**
|
|
53
|
+
* 工具包管理器
|
|
54
|
+
*
|
|
55
|
+
* 统一管理所有工具,作为 Message 系统与 Tool 系统之间的桥梁。
|
|
56
|
+
*
|
|
57
|
+
* 用法:
|
|
58
|
+
*const toolkit = new ToolKit()
|
|
59
|
+
* .add(weatherTool, timeTool);
|
|
60
|
+
*
|
|
61
|
+
* await toolkit.addMCP(mcpClient);// 自动发现 MCP 工具
|
|
62
|
+
*
|
|
63
|
+
* const tools = toolkit.schemas;// 丢给LLM
|
|
64
|
+
* const results = await toolkit.executeAll(msg.toolCalls); // 批量执行
|
|
65
|
+
*/
|
|
66
|
+
class ToolKit {
|
|
67
|
+
_tools = new Map();
|
|
68
|
+
// ========================
|
|
69
|
+
// 注册工具
|
|
70
|
+
// ========================
|
|
71
|
+
/**
|
|
72
|
+
* 添加一个或多个工具
|
|
73
|
+
*/
|
|
74
|
+
add(...tools) {
|
|
75
|
+
for (const tool of tools) {
|
|
76
|
+
if (this._tools.has(tool.toolName)) {
|
|
77
|
+
throw new Error(`工具名重复: ${tool.toolName}`);
|
|
78
|
+
}
|
|
79
|
+
this._tools.set(tool.toolName, tool);
|
|
80
|
+
}
|
|
81
|
+
return this;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* 从 MCP Client 自动发现并注册工具
|
|
85
|
+
*
|
|
86
|
+
* @param client @modelcontextprotocol/sdk的 Client 实例
|
|
87
|
+
*/
|
|
88
|
+
async addMCP(client) {
|
|
89
|
+
const { McpToolAdapter } = await Promise.resolve().then(() => __importStar(require("./McpToolAdapter")));
|
|
90
|
+
const tools = await McpToolAdapter.fromClient(client);
|
|
91
|
+
for (const tool of tools) {
|
|
92
|
+
if (!this._tools.has(tool.toolName)) {
|
|
93
|
+
this._tools.set(tool.toolName, tool);
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
return this;
|
|
97
|
+
}
|
|
98
|
+
// ========================
|
|
99
|
+
// 查询
|
|
100
|
+
// ========================
|
|
101
|
+
/** 按名称获取工具 */
|
|
102
|
+
get(name) {
|
|
103
|
+
return this._tools.get(name);
|
|
104
|
+
}
|
|
105
|
+
/** 检查工具是否存在 */
|
|
106
|
+
has(name) {
|
|
107
|
+
return this._tools.has(name);
|
|
108
|
+
}
|
|
109
|
+
/** 所有工具的schema,直接传给LLM 的 tools参数 */
|
|
110
|
+
get schemas() {
|
|
111
|
+
return Array.from(this._tools.values()).map((t) => t.schema);
|
|
112
|
+
}
|
|
113
|
+
/** 所有工具名*/
|
|
114
|
+
get names() {
|
|
115
|
+
return Array.from(this._tools.keys());
|
|
116
|
+
}
|
|
117
|
+
/** 工具数量 */
|
|
118
|
+
get size() {
|
|
119
|
+
return this._tools.size;
|
|
120
|
+
}
|
|
121
|
+
// ========================
|
|
122
|
+
// 执行 —桥接Message↔ Tool
|
|
123
|
+
// ========================
|
|
124
|
+
/**
|
|
125
|
+
* 执行单个 ToolCallPart
|
|
126
|
+
*
|
|
127
|
+
* ToolCallPart(数据) → ToolCall(行为) → execute → Message(数据)
|
|
128
|
+
*/
|
|
129
|
+
async execute(toolCallPart, options) {
|
|
130
|
+
const tool = this._tools.get(toolCallPart.name);
|
|
131
|
+
if (!tool) {
|
|
132
|
+
//工具不存在,返回错误消息
|
|
133
|
+
return Message_1.Message.tool(toolCallPart.toolCallId, JSON.stringify({ error: `未知工具: ${toolCallPart.name}` }));
|
|
134
|
+
}
|
|
135
|
+
const args = this.parseArguments(toolCallPart.arguments);
|
|
136
|
+
const call = tool.create(toolCallPart.toolCallId, args, options?.signal);
|
|
137
|
+
try {
|
|
138
|
+
await call.execute();
|
|
139
|
+
}
|
|
140
|
+
catch (e) {
|
|
141
|
+
if (options?.errorPolicy === "throw") {
|
|
142
|
+
throw new ToolExecutionError(toolCallPart.toolCallId, toolCallPart.name, e);
|
|
143
|
+
}
|
|
144
|
+
// 执行失败,返回错误消息
|
|
145
|
+
const errorMsg = e instanceof Error ? e.message : String(e);
|
|
146
|
+
return Message_1.Message.tool(toolCallPart.toolCallId, JSON.stringify({ error: errorMsg }));
|
|
147
|
+
}
|
|
148
|
+
return call.toMessage();
|
|
149
|
+
}
|
|
150
|
+
/**
|
|
151
|
+
* 并行执行多个 ToolCallPart
|
|
152
|
+
*/
|
|
153
|
+
async executeAll(toolCallParts, options) {
|
|
154
|
+
return Promise.all(toolCallParts.map((part) => this.execute(part, options)));
|
|
155
|
+
}
|
|
156
|
+
// ========================
|
|
157
|
+
// 内部辅助
|
|
158
|
+
// ========================
|
|
159
|
+
parseArguments(args) {
|
|
160
|
+
try {
|
|
161
|
+
const parsed = JSON.parse(args);
|
|
162
|
+
if (typeof parsed === "object" && parsed !== null) {
|
|
163
|
+
return parsed;
|
|
164
|
+
}
|
|
165
|
+
return {};
|
|
166
|
+
}
|
|
167
|
+
catch {
|
|
168
|
+
return {};
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
exports.ToolKit = ToolKit;
|
|
173
|
+
//# sourceMappingURL=ToolKit.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ToolKit.js","sourceRoot":"","sources":["../../src/tool/ToolKit.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,gDAA6C;AAI7C,MAAa,kBAAmB,SAAQ,KAAK;IAClC,UAAU,CAAS;IACnB,QAAQ,CAAS;IACjB,KAAK,CAAW;IAEzB,YAAY,UAAkB,EAAE,QAAgB,EAAE,KAAc;QAC9D,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,KAAK,CAAC,WAAW,QAAQ,MAAM,OAAO,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAbD,gDAaC;AASD;;;;;;;;;;;;;GAaG;AACH,MAAa,OAAO;IACV,MAAM,GAAsB,IAAI,GAAG,EAAE,CAAC;IAE9C,2BAA2B;IAC3B,QAAQ;IACR,2BAA2B;IAE3B;;OAEG;IACH,GAAG,CAAC,GAAG,KAAa;QAClB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7C,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,MAAqB;QAChC,MAAM,EAAE,cAAc,EAAE,GAAG,wDAAa,kBAAkB,GAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACtD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2BAA2B;IAC3B,MAAM;IACN,2BAA2B;IAE3B,cAAc;IACd,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,eAAe;IACf,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,oCAAoC;IACpC,IAAI,OAAO;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IAED,WAAW;IACX,IAAI,KAAK;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,WAAW;IACX,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,2BAA2B;IAC3B,uBAAuB;IACvB,2BAA2B;IAE3B;;;;OAIG;IACH,KAAK,CAAC,OAAO,CACX,YAA0B,EAC1B,OAA8B;QAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,cAAc;YACd,OAAO,iBAAO,CAAC,IAAI,CACjB,YAAY,CAAC,UAAU,EACvB,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CACxD,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAEzE,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,OAAO,EAAE,WAAW,KAAK,OAAO,EAAE,CAAC;gBACrC,MAAM,IAAI,kBAAkB,CAAC,YAAY,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC9E,CAAC;YAED,cAAc;YACd,MAAM,QAAQ,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC5D,OAAO,iBAAO,CAAC,IAAI,CACjB,YAAY,CAAC,UAAU,EACvB,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CACpC,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,aAA6B,EAC7B,OAA8B;QAE9B,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC;IAED,2BAA2B;IAC3B,QAAQ;IACR,2BAA2B;IAEnB,cAAc,CAAC,IAAY;QACjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBAClD,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AArID,0BAqIC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ValueType.d.ts","sourceRoot":"","sources":["../../src/tool/ValueType.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,SAAS;IACnB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,MAAM,WAAW;CAClB"}
|