@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,16 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ValueType = void 0;
4
+ /**
5
+ * JSON Schema 值类型枚举
6
+ */
7
+ var ValueType;
8
+ (function (ValueType) {
9
+ ValueType["String"] = "string";
10
+ ValueType["Integer"] = "integer";
11
+ ValueType["Number"] = "number";
12
+ ValueType["Boolean"] = "boolean";
13
+ ValueType["Array"] = "array";
14
+ ValueType["Object"] = "object";
15
+ })(ValueType || (exports.ValueType = ValueType = {}));
16
+ //# sourceMappingURL=ValueType.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ValueType.js","sourceRoot":"","sources":["../../src/tool/ValueType.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,8BAAiB,CAAA;IACjB,gCAAmB,CAAA;IACnB,8BAAiB,CAAA;IACjB,gCAAmB,CAAA;IACnB,4BAAe,CAAA;IACf,8BAAiB,CAAA;AACnB,CAAC,EAPW,SAAS,yBAAT,SAAS,QAOpB"}
@@ -0,0 +1,9 @@
1
+ export { ValueType } from "./ValueType";
2
+ export { Param } from "./Param";
3
+ export { Hook } from "./Hook";
4
+ export { Context } from "./Context";
5
+ export { Tool, ToolFunction, HookHandler, ToolSchema } from "./Tool";
6
+ export { ToolCall } from "./ToolCall";
7
+ export { ToolKit, McpClientLike, ToolExecutionOptions, ToolErrorPolicy, ToolExecutionError, } from "./ToolKit";
8
+ export { McpToolAdapter } from "./McpToolAdapter";
9
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tool/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EACH,OAAO,EACP,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,kBAAkB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}
@@ -0,0 +1,21 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.McpToolAdapter = exports.ToolExecutionError = exports.ToolKit = exports.ToolCall = exports.Tool = exports.Context = exports.Hook = exports.Param = exports.ValueType = void 0;
4
+ var ValueType_1 = require("./ValueType");
5
+ Object.defineProperty(exports, "ValueType", { enumerable: true, get: function () { return ValueType_1.ValueType; } });
6
+ var Param_1 = require("./Param");
7
+ Object.defineProperty(exports, "Param", { enumerable: true, get: function () { return Param_1.Param; } });
8
+ var Hook_1 = require("./Hook");
9
+ Object.defineProperty(exports, "Hook", { enumerable: true, get: function () { return Hook_1.Hook; } });
10
+ var Context_1 = require("./Context");
11
+ Object.defineProperty(exports, "Context", { enumerable: true, get: function () { return Context_1.Context; } });
12
+ var Tool_1 = require("./Tool");
13
+ Object.defineProperty(exports, "Tool", { enumerable: true, get: function () { return Tool_1.Tool; } });
14
+ var ToolCall_1 = require("./ToolCall");
15
+ Object.defineProperty(exports, "ToolCall", { enumerable: true, get: function () { return ToolCall_1.ToolCall; } });
16
+ var ToolKit_1 = require("./ToolKit");
17
+ Object.defineProperty(exports, "ToolKit", { enumerable: true, get: function () { return ToolKit_1.ToolKit; } });
18
+ Object.defineProperty(exports, "ToolExecutionError", { enumerable: true, get: function () { return ToolKit_1.ToolExecutionError; } });
19
+ var McpToolAdapter_1 = require("./McpToolAdapter");
20
+ Object.defineProperty(exports, "McpToolAdapter", { enumerable: true, get: function () { return McpToolAdapter_1.McpToolAdapter; } });
21
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tool/index.ts"],"names":[],"mappings":";;;AAAA,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AACd,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AACb,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,+BAAqE;AAA5D,4FAAA,IAAI,OAAA;AACb,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,qCAMmB;AALf,kGAAA,OAAO,OAAA;AAIP,6GAAA,kBAAkB,OAAA;AAEtB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * 通用 ID 生成器
3
+ *
4
+ * 生成格式为 `[prefix-]<timestamp>-<random>` 的唯一标识符。
5
+ *
6
+ * @param prefix 可选前缀,如 "inj"、"run"、"approval"
7
+ * @returns 唯一 ID 字符串
8
+ */
9
+ export declare function generateId(prefix?: string): string;
10
+ //# sourceMappingURL=generateId.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generateId.d.ts","sourceRoot":"","sources":["../../src/utils/generateId.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAMlD"}
@@ -0,0 +1,18 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.generateId = generateId;
4
+ /**
5
+ * 通用 ID 生成器
6
+ *
7
+ * 生成格式为 `[prefix-]<timestamp>-<random>` 的唯一标识符。
8
+ *
9
+ * @param prefix 可选前缀,如 "inj"、"run"、"approval"
10
+ * @returns 唯一 ID 字符串
11
+ */
12
+ function generateId(prefix) {
13
+ const id = Date.now().toString(36) +
14
+ "-" +
15
+ Math.random().toString(36).slice(2, 10);
16
+ return prefix ? `${prefix}-${id}` : id;
17
+ }
18
+ //# sourceMappingURL=generateId.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generateId.js","sourceRoot":"","sources":["../../src/utils/generateId.ts"],"names":[],"mappings":";;AAQA,gCAMC;AAdD;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAC,MAAe;IACxC,MAAM,EAAE,GACN,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvB,GAAG;QACH,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACzC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { generateId } from "./generateId";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}
@@ -0,0 +1,6 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.generateId = void 0;
4
+ var generateId_1 = require("./generateId");
5
+ Object.defineProperty(exports, "generateId", { enumerable: true, get: function () { return generateId_1.generateId; } });
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;AAAA,2CAA0C;AAAjC,wGAAA,UAAU,OAAA"}
package/package.json ADDED
@@ -0,0 +1,72 @@
1
+ {
2
+ "name": "@notic/agent-engine",
3
+ "version": "1.0.0",
4
+ "description": "A lightweight, elegant, and feature-complete TypeScript AI Agent framework",
5
+ "main": "dist/index.js",
6
+ "types": "dist/index.d.ts",
7
+ "exports": {
8
+ ".": {
9
+ "types": "./dist/index.d.ts",
10
+ "default": "./dist/index.js"
11
+ }
12
+ },
13
+ "sideEffects": false,
14
+ "files": [
15
+ "dist",
16
+ "README.md",
17
+ "LICENSE"
18
+ ],
19
+ "scripts": {
20
+ "build": "tsc",
21
+ "clean": "rimraf dist",
22
+ "prepublishOnly": "npm run clean && npm run build"
23
+ },
24
+ "keywords": [
25
+ "ai",
26
+ "agent",
27
+ "llm",
28
+ "openai",
29
+ "chatgpt",
30
+ "gpt",
31
+ "claude",
32
+ "gemini",
33
+ "deepseek",
34
+ "mcp",
35
+ "tool-calling",
36
+ "streaming",
37
+ "typescript",
38
+ "framework"
39
+ ],
40
+ "author": "notic",
41
+ "license": "Apache-2.0",
42
+ "repository": {
43
+ "type": "git",
44
+ "url": "https://github.com/torinaViolet/AgentEngine.git"
45
+ },
46
+ "homepage": "https://github.com/torinaViolet/AgentEngine#readme",
47
+ "engines": {
48
+ "node": ">=18.0.0"
49
+ },
50
+ "dependencies": {},
51
+ "peerDependencies": {
52
+ "@modelcontextprotocol/sdk": ">=1.0.0",
53
+ "openai": ">=4.0.0"
54
+ },
55
+ "peerDependenciesMeta": {
56
+ "@modelcontextprotocol/sdk": {
57
+ "optional": true
58
+ },
59
+ "openai": {
60
+ "optional": true
61
+ }
62
+ },
63
+ "devDependencies": {
64
+ "@modelcontextprotocol/sdk": "^1.29.0",
65
+ "@modelcontextprotocol/server-filesystem": "^2026.1.14",
66
+ "@types/node": "^25.6.0",
67
+ "openai": "^6.34.0",
68
+ "rimraf": "^6.0.0",
69
+ "typescript": "^5.5.3",
70
+ "zod": "^4.3.6"
71
+ }
72
+ }