@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.
Files changed (175) hide show
  1. package/LICENSE +190 -0
  2. package/README.md +725 -0
  3. package/dist/adapter/AnthropicAdapter.d.ts +47 -0
  4. package/dist/adapter/AnthropicAdapter.d.ts.map +1 -0
  5. package/dist/adapter/AnthropicAdapter.js +341 -0
  6. package/dist/adapter/AnthropicAdapter.js.map +1 -0
  7. package/dist/adapter/GeminiAdapter.d.ts +47 -0
  8. package/dist/adapter/GeminiAdapter.d.ts.map +1 -0
  9. package/dist/adapter/GeminiAdapter.js +315 -0
  10. package/dist/adapter/GeminiAdapter.js.map +1 -0
  11. package/dist/adapter/MessageAdapter.d.ts +66 -0
  12. package/dist/adapter/MessageAdapter.d.ts.map +1 -0
  13. package/dist/adapter/MessageAdapter.js +66 -0
  14. package/dist/adapter/MessageAdapter.js.map +1 -0
  15. package/dist/adapter/OpenAIAdapter.d.ts +45 -0
  16. package/dist/adapter/OpenAIAdapter.d.ts.map +1 -0
  17. package/dist/adapter/OpenAIAdapter.js +305 -0
  18. package/dist/adapter/OpenAIAdapter.js.map +1 -0
  19. package/dist/adapter/index.d.ts +5 -0
  20. package/dist/adapter/index.d.ts.map +1 -0
  21. package/dist/adapter/index.js +10 -0
  22. package/dist/adapter/index.js.map +1 -0
  23. package/dist/agent/Agent.d.ts +319 -0
  24. package/dist/agent/Agent.d.ts.map +1 -0
  25. package/dist/agent/Agent.js +876 -0
  26. package/dist/agent/Agent.js.map +1 -0
  27. package/dist/agent/index.d.ts +2 -0
  28. package/dist/agent/index.d.ts.map +1 -0
  29. package/dist/agent/index.js +8 -0
  30. package/dist/agent/index.js.map +1 -0
  31. package/dist/config/RequestConfig.d.ts +119 -0
  32. package/dist/config/RequestConfig.d.ts.map +1 -0
  33. package/dist/config/RequestConfig.js +257 -0
  34. package/dist/config/RequestConfig.js.map +1 -0
  35. package/dist/config/index.d.ts +2 -0
  36. package/dist/config/index.d.ts.map +1 -0
  37. package/dist/config/index.js +6 -0
  38. package/dist/config/index.js.map +1 -0
  39. package/dist/index.d.ts +29 -0
  40. package/dist/index.d.ts.map +1 -0
  41. package/dist/index.js +69 -0
  42. package/dist/index.js.map +1 -0
  43. package/dist/media/DefaultMediaResolver.d.ts +17 -0
  44. package/dist/media/DefaultMediaResolver.d.ts.map +1 -0
  45. package/dist/media/DefaultMediaResolver.js +114 -0
  46. package/dist/media/DefaultMediaResolver.js.map +1 -0
  47. package/dist/media/MediaResolver.d.ts +20 -0
  48. package/dist/media/MediaResolver.d.ts.map +1 -0
  49. package/dist/media/MediaResolver.js +3 -0
  50. package/dist/media/MediaResolver.js.map +1 -0
  51. package/dist/media/index.d.ts +3 -0
  52. package/dist/media/index.d.ts.map +1 -0
  53. package/dist/media/index.js +6 -0
  54. package/dist/media/index.js.map +1 -0
  55. package/dist/message/Message.d.ts +121 -0
  56. package/dist/message/Message.d.ts.map +1 -0
  57. package/dist/message/Message.js +345 -0
  58. package/dist/message/Message.js.map +1 -0
  59. package/dist/message/MessagePart.d.ts +46 -0
  60. package/dist/message/MessagePart.d.ts.map +1 -0
  61. package/dist/message/MessagePart.js +6 -0
  62. package/dist/message/MessagePart.js.map +1 -0
  63. package/dist/message/Role.d.ts +10 -0
  64. package/dist/message/Role.d.ts.map +1 -0
  65. package/dist/message/Role.js +14 -0
  66. package/dist/message/Role.js.map +1 -0
  67. package/dist/message/Usage.d.ts +31 -0
  68. package/dist/message/Usage.d.ts.map +1 -0
  69. package/dist/message/Usage.js +58 -0
  70. package/dist/message/Usage.js.map +1 -0
  71. package/dist/message/index.d.ts +5 -0
  72. package/dist/message/index.d.ts.map +1 -0
  73. package/dist/message/index.js +10 -0
  74. package/dist/message/index.js.map +1 -0
  75. package/dist/prompt/Injection.d.ts +72 -0
  76. package/dist/prompt/Injection.d.ts.map +1 -0
  77. package/dist/prompt/Injection.js +123 -0
  78. package/dist/prompt/Injection.js.map +1 -0
  79. package/dist/prompt/PromptBuilder.d.ts +276 -0
  80. package/dist/prompt/PromptBuilder.d.ts.map +1 -0
  81. package/dist/prompt/PromptBuilder.js +465 -0
  82. package/dist/prompt/PromptBuilder.js.map +1 -0
  83. package/dist/prompt/Rule.d.ts +98 -0
  84. package/dist/prompt/Rule.d.ts.map +1 -0
  85. package/dist/prompt/Rule.js +275 -0
  86. package/dist/prompt/Rule.js.map +1 -0
  87. package/dist/prompt/index.d.ts +4 -0
  88. package/dist/prompt/index.d.ts.map +1 -0
  89. package/dist/prompt/index.js +10 -0
  90. package/dist/prompt/index.js.map +1 -0
  91. package/dist/session/Inserter.d.ts +76 -0
  92. package/dist/session/Inserter.d.ts.map +1 -0
  93. package/dist/session/Inserter.js +217 -0
  94. package/dist/session/Inserter.js.map +1 -0
  95. package/dist/session/Paginator.d.ts +52 -0
  96. package/dist/session/Paginator.d.ts.map +1 -0
  97. package/dist/session/Paginator.js +110 -0
  98. package/dist/session/Paginator.js.map +1 -0
  99. package/dist/session/Query.d.ts +54 -0
  100. package/dist/session/Query.d.ts.map +1 -0
  101. package/dist/session/Query.js +97 -0
  102. package/dist/session/Query.js.map +1 -0
  103. package/dist/session/SearchCriteria.d.ts +39 -0
  104. package/dist/session/SearchCriteria.d.ts.map +1 -0
  105. package/dist/session/SearchCriteria.js +28 -0
  106. package/dist/session/SearchCriteria.js.map +1 -0
  107. package/dist/session/Session.d.ts +139 -0
  108. package/dist/session/Session.d.ts.map +1 -0
  109. package/dist/session/Session.js +344 -0
  110. package/dist/session/Session.js.map +1 -0
  111. package/dist/session/index.d.ts +6 -0
  112. package/dist/session/index.d.ts.map +1 -0
  113. package/dist/session/index.js +15 -0
  114. package/dist/session/index.js.map +1 -0
  115. package/dist/session/matchUtils.d.ts +22 -0
  116. package/dist/session/matchUtils.d.ts.map +1 -0
  117. package/dist/session/matchUtils.js +138 -0
  118. package/dist/session/matchUtils.js.map +1 -0
  119. package/dist/stream/StreamEvent.d.ts +193 -0
  120. package/dist/stream/StreamEvent.d.ts.map +1 -0
  121. package/dist/stream/StreamEvent.js +44 -0
  122. package/dist/stream/StreamEvent.js.map +1 -0
  123. package/dist/stream/StreamParser.d.ts +47 -0
  124. package/dist/stream/StreamParser.d.ts.map +1 -0
  125. package/dist/stream/StreamParser.js +225 -0
  126. package/dist/stream/StreamParser.js.map +1 -0
  127. package/dist/stream/index.d.ts +3 -0
  128. package/dist/stream/index.d.ts.map +1 -0
  129. package/dist/stream/index.js +8 -0
  130. package/dist/stream/index.js.map +1 -0
  131. package/dist/tool/Context.d.ts +30 -0
  132. package/dist/tool/Context.d.ts.map +1 -0
  133. package/dist/tool/Context.js +50 -0
  134. package/dist/tool/Context.js.map +1 -0
  135. package/dist/tool/Hook.d.ts +23 -0
  136. package/dist/tool/Hook.d.ts.map +1 -0
  137. package/dist/tool/Hook.js +27 -0
  138. package/dist/tool/Hook.js.map +1 -0
  139. package/dist/tool/McpToolAdapter.d.ts +47 -0
  140. package/dist/tool/McpToolAdapter.d.ts.map +1 -0
  141. package/dist/tool/McpToolAdapter.js +88 -0
  142. package/dist/tool/McpToolAdapter.js.map +1 -0
  143. package/dist/tool/Param.d.ts +68 -0
  144. package/dist/tool/Param.d.ts.map +1 -0
  145. package/dist/tool/Param.js +161 -0
  146. package/dist/tool/Param.js.map +1 -0
  147. package/dist/tool/Tool.d.ts +92 -0
  148. package/dist/tool/Tool.d.ts.map +1 -0
  149. package/dist/tool/Tool.js +198 -0
  150. package/dist/tool/Tool.js.map +1 -0
  151. package/dist/tool/ToolCall.d.ts +37 -0
  152. package/dist/tool/ToolCall.d.ts.map +1 -0
  153. package/dist/tool/ToolCall.js +118 -0
  154. package/dist/tool/ToolCall.js.map +1 -0
  155. package/dist/tool/ToolKit.d.ts +87 -0
  156. package/dist/tool/ToolKit.d.ts.map +1 -0
  157. package/dist/tool/ToolKit.js +173 -0
  158. package/dist/tool/ToolKit.js.map +1 -0
  159. package/dist/tool/ValueType.d.ts +12 -0
  160. package/dist/tool/ValueType.d.ts.map +1 -0
  161. package/dist/tool/ValueType.js +16 -0
  162. package/dist/tool/ValueType.js.map +1 -0
  163. package/dist/tool/index.d.ts +9 -0
  164. package/dist/tool/index.d.ts.map +1 -0
  165. package/dist/tool/index.js +21 -0
  166. package/dist/tool/index.js.map +1 -0
  167. package/dist/utils/generateId.d.ts +10 -0
  168. package/dist/utils/generateId.d.ts.map +1 -0
  169. package/dist/utils/generateId.js +18 -0
  170. package/dist/utils/generateId.js.map +1 -0
  171. package/dist/utils/index.d.ts +2 -0
  172. package/dist/utils/index.d.ts.map +1 -0
  173. package/dist/utils/index.js +6 -0
  174. package/dist/utils/index.js.map +1 -0
  175. 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":";;;AACA,iCAA8B;AAC9B,uCAAoC;AACpC,yCAAsC;AAyBtC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,IAAI;IACP,KAAK,CAAe;IACpB,KAAK,CAAS;IACd,YAAY,GAAW,EAAE,CAAC;IAC1B,OAAO,GAAY,EAAE,CAAC;IACtB,MAAM,GAA6B,IAAI,GAAG,EAAE,CAAC;IAC7C,MAAM,GAAY,KAAK,CAAC;IACxB,OAAO,CAAc;IAE7B,YAAoB,IAAkB,EAAE,IAAa;QACnD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC;QAE5C,wBAAwB;QACxB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,WAAI,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,QAAQ;IACR,2BAA2B;IAE3B;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,EAAgB;QAC5B,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,OAAO,CACZ,IAAY,EACZ,WAAmB,EACnB,MAAkB,EAClB,EAAgB;QAEhB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2BAA2B;IAC3B,gBAAgB;IAChB,2BAA2B;IAE3B,IAAI,CAAC,CAAS;QACZ,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,MAAe;QACvB,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,EAAE,CAAC,IAAU,EAAE,OAAoB;QACjC,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,0BAA0B;QAC1B,MAAM,UAAU,GAA4B,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC1C,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,OAAO,GAAG;YACb,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,IAAI,CAAC,KAAK;gBAChB,WAAW,EAAE,IAAI,CAAC,YAAY;gBAC9B,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU;oBACV,QAAQ;iBACT;aACF;SACF,CAAC;QAEF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2BAA2B;IAC3B,gBAAgB;IAChB,2BAA2B;IAE3B,sCAAsC;IACtC,IAAI,MAAM;QACR,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,OAAQ,CAAC;IACvB,CAAC;IAED,SAAS;IACT,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,WAAW;IACX,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CACJ,UAAkB,EAClB,IAA6B,EAC7B,MAAoB;QAEpB,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,MAAM,GAAG,GAAG,IAAI,iBAAO,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,sBAAsB;YACtB,IAAI,CAAC,IAAI,CAAC,WAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAE/B,wBAAwB;YACxB,IAAI,CAAC,IAAI,CAAC,WAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;YAEjC,WAAW;YACX,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YAChE,MAAM,OAAO,GAAG,cAAc;iBAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;iBACzC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAEtB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5D,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;YAElB,qBAAqB;YACrB,IAAI,CAAC,IAAI,CAAC,WAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAE9B,wBAAwB;YACxB,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,IAAI,mBAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC3E,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAU,EAAE,GAAY;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,MAAM,YAAY,iBAAO,EAAE,CAAC;gBAC9B,GAAG,GAAG,MAAM,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,2BAA2B;IAC3B,MAAM;IACN,2BAA2B;IAEnB,UAAU;QAChB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;CACF;AApND,oBAoNC"}
@@ -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":"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"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * JSON Schema 值类型枚举
3
+ */
4
+ export declare enum ValueType {
5
+ String = "string",
6
+ Integer = "integer",
7
+ Number = "number",
8
+ Boolean = "boolean",
9
+ Array = "array",
10
+ Object = "object"
11
+ }
12
+ //# sourceMappingURL=ValueType.d.ts.map
@@ -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"}