@airmcp-dev/core 0.1.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 (290) hide show
  1. package/LICENSE +17 -0
  2. package/dist/config/defaults.d.ts +3 -0
  3. package/dist/config/defaults.d.ts.map +1 -0
  4. package/dist/config/defaults.js +11 -0
  5. package/dist/config/defaults.js.map +1 -0
  6. package/dist/config/index.d.ts +3 -0
  7. package/dist/config/index.d.ts.map +1 -0
  8. package/dist/config/index.js +5 -0
  9. package/dist/config/index.js.map +1 -0
  10. package/dist/config/loader.d.ts +4 -0
  11. package/dist/config/loader.d.ts.map +1 -0
  12. package/dist/config/loader.js +59 -0
  13. package/dist/config/loader.js.map +1 -0
  14. package/dist/context/index.d.ts +3 -0
  15. package/dist/context/index.d.ts.map +1 -0
  16. package/dist/context/index.js +5 -0
  17. package/dist/context/index.js.map +1 -0
  18. package/dist/context/request-context.d.ts +4 -0
  19. package/dist/context/request-context.d.ts.map +1 -0
  20. package/dist/context/request-context.js +14 -0
  21. package/dist/context/request-context.js.map +1 -0
  22. package/dist/context/server-context.d.ts +12 -0
  23. package/dist/context/server-context.d.ts.map +1 -0
  24. package/dist/context/server-context.js +25 -0
  25. package/dist/context/server-context.js.map +1 -0
  26. package/dist/index.d.ts +47 -0
  27. package/dist/index.d.ts.map +1 -0
  28. package/dist/index.js +62 -0
  29. package/dist/index.js.map +1 -0
  30. package/dist/middleware/after-hook.d.ts +4 -0
  31. package/dist/middleware/after-hook.d.ts.map +1 -0
  32. package/dist/middleware/after-hook.js +18 -0
  33. package/dist/middleware/after-hook.js.map +1 -0
  34. package/dist/middleware/before-hook.d.ts +4 -0
  35. package/dist/middleware/before-hook.d.ts.map +1 -0
  36. package/dist/middleware/before-hook.js +40 -0
  37. package/dist/middleware/before-hook.js.map +1 -0
  38. package/dist/middleware/chain.d.ts +11 -0
  39. package/dist/middleware/chain.d.ts.map +1 -0
  40. package/dist/middleware/chain.js +84 -0
  41. package/dist/middleware/chain.js.map +1 -0
  42. package/dist/middleware/error-handler.d.ts +27 -0
  43. package/dist/middleware/error-handler.d.ts.map +1 -0
  44. package/dist/middleware/error-handler.js +63 -0
  45. package/dist/middleware/error-handler.js.map +1 -0
  46. package/dist/middleware/index.d.ts +7 -0
  47. package/dist/middleware/index.d.ts.map +1 -0
  48. package/dist/middleware/index.js +9 -0
  49. package/dist/middleware/index.js.map +1 -0
  50. package/dist/middleware/meter-middleware.d.ts +19 -0
  51. package/dist/middleware/meter-middleware.d.ts.map +1 -0
  52. package/dist/middleware/meter-middleware.js +139 -0
  53. package/dist/middleware/meter-middleware.js.map +1 -0
  54. package/dist/middleware/shield-middleware.d.ts +16 -0
  55. package/dist/middleware/shield-middleware.d.ts.map +1 -0
  56. package/dist/middleware/shield-middleware.js +163 -0
  57. package/dist/middleware/shield-middleware.js.map +1 -0
  58. package/dist/plugin/builtin/auth.d.ts +16 -0
  59. package/dist/plugin/builtin/auth.d.ts.map +1 -0
  60. package/dist/plugin/builtin/auth.js +60 -0
  61. package/dist/plugin/builtin/auth.js.map +1 -0
  62. package/dist/plugin/builtin/cache.d.ts +12 -0
  63. package/dist/plugin/builtin/cache.d.ts.map +1 -0
  64. package/dist/plugin/builtin/cache.js +65 -0
  65. package/dist/plugin/builtin/cache.js.map +1 -0
  66. package/dist/plugin/builtin/circuit-breaker.d.ts +12 -0
  67. package/dist/plugin/builtin/circuit-breaker.d.ts.map +1 -0
  68. package/dist/plugin/builtin/circuit-breaker.js +76 -0
  69. package/dist/plugin/builtin/circuit-breaker.js.map +1 -0
  70. package/dist/plugin/builtin/cors.d.ts +12 -0
  71. package/dist/plugin/builtin/cors.d.ts.map +1 -0
  72. package/dist/plugin/builtin/cors.js +29 -0
  73. package/dist/plugin/builtin/cors.js.map +1 -0
  74. package/dist/plugin/builtin/dedup.d.ts +8 -0
  75. package/dist/plugin/builtin/dedup.d.ts.map +1 -0
  76. package/dist/plugin/builtin/dedup.js +64 -0
  77. package/dist/plugin/builtin/dedup.js.map +1 -0
  78. package/dist/plugin/builtin/dryrun.d.ts +12 -0
  79. package/dist/plugin/builtin/dryrun.d.ts.map +1 -0
  80. package/dist/plugin/builtin/dryrun.js +61 -0
  81. package/dist/plugin/builtin/dryrun.js.map +1 -0
  82. package/dist/plugin/builtin/fallback.d.ts +5 -0
  83. package/dist/plugin/builtin/fallback.d.ts.map +1 -0
  84. package/dist/plugin/builtin/fallback.js +42 -0
  85. package/dist/plugin/builtin/fallback.js.map +1 -0
  86. package/dist/plugin/builtin/i18n.d.ts +12 -0
  87. package/dist/plugin/builtin/i18n.d.ts.map +1 -0
  88. package/dist/plugin/builtin/i18n.js +51 -0
  89. package/dist/plugin/builtin/i18n.js.map +1 -0
  90. package/dist/plugin/builtin/logger-json.d.ts +12 -0
  91. package/dist/plugin/builtin/logger-json.d.ts.map +1 -0
  92. package/dist/plugin/builtin/logger-json.js +52 -0
  93. package/dist/plugin/builtin/logger-json.js.map +1 -0
  94. package/dist/plugin/builtin/logger.d.ts +3 -0
  95. package/dist/plugin/builtin/logger.d.ts.map +1 -0
  96. package/dist/plugin/builtin/logger.js +22 -0
  97. package/dist/plugin/builtin/logger.js.map +1 -0
  98. package/dist/plugin/builtin/metrics.d.ts +14 -0
  99. package/dist/plugin/builtin/metrics.d.ts.map +1 -0
  100. package/dist/plugin/builtin/metrics.js +56 -0
  101. package/dist/plugin/builtin/metrics.js.map +1 -0
  102. package/dist/plugin/builtin/queue.d.ts +12 -0
  103. package/dist/plugin/builtin/queue.d.ts.map +1 -0
  104. package/dist/plugin/builtin/queue.js +98 -0
  105. package/dist/plugin/builtin/queue.js.map +1 -0
  106. package/dist/plugin/builtin/ratelimit-per-user.d.ts +12 -0
  107. package/dist/plugin/builtin/ratelimit-per-user.d.ts.map +1 -0
  108. package/dist/plugin/builtin/ratelimit-per-user.js +45 -0
  109. package/dist/plugin/builtin/ratelimit-per-user.js.map +1 -0
  110. package/dist/plugin/builtin/retry.d.ts +12 -0
  111. package/dist/plugin/builtin/retry.d.ts.map +1 -0
  112. package/dist/plugin/builtin/retry.js +51 -0
  113. package/dist/plugin/builtin/retry.js.map +1 -0
  114. package/dist/plugin/builtin/sanitizer.d.ts +14 -0
  115. package/dist/plugin/builtin/sanitizer.d.ts.map +1 -0
  116. package/dist/plugin/builtin/sanitizer.js +55 -0
  117. package/dist/plugin/builtin/sanitizer.js.map +1 -0
  118. package/dist/plugin/builtin/timeout.d.ts +3 -0
  119. package/dist/plugin/builtin/timeout.d.ts.map +1 -0
  120. package/dist/plugin/builtin/timeout.js +30 -0
  121. package/dist/plugin/builtin/timeout.js.map +1 -0
  122. package/dist/plugin/builtin/transform.d.ts +11 -0
  123. package/dist/plugin/builtin/transform.d.ts.map +1 -0
  124. package/dist/plugin/builtin/transform.js +51 -0
  125. package/dist/plugin/builtin/transform.js.map +1 -0
  126. package/dist/plugin/builtin/validator.d.ts +9 -0
  127. package/dist/plugin/builtin/validator.d.ts.map +1 -0
  128. package/dist/plugin/builtin/validator.js +43 -0
  129. package/dist/plugin/builtin/validator.js.map +1 -0
  130. package/dist/plugin/builtin/webhook.d.ts +16 -0
  131. package/dist/plugin/builtin/webhook.d.ts.map +1 -0
  132. package/dist/plugin/builtin/webhook.js +78 -0
  133. package/dist/plugin/builtin/webhook.js.map +1 -0
  134. package/dist/plugin/index.d.ts +23 -0
  135. package/dist/plugin/index.d.ts.map +1 -0
  136. package/dist/plugin/index.js +34 -0
  137. package/dist/plugin/index.js.map +1 -0
  138. package/dist/plugin/plugin-hook.d.ts +11 -0
  139. package/dist/plugin/plugin-hook.d.ts.map +1 -0
  140. package/dist/plugin/plugin-hook.js +39 -0
  141. package/dist/plugin/plugin-hook.js.map +1 -0
  142. package/dist/plugin/plugin-manager.d.ts +22 -0
  143. package/dist/plugin/plugin-manager.d.ts.map +1 -0
  144. package/dist/plugin/plugin-manager.js +71 -0
  145. package/dist/plugin/plugin-manager.js.map +1 -0
  146. package/dist/plugin/plugin-schema.d.ts +6 -0
  147. package/dist/plugin/plugin-schema.d.ts.map +1 -0
  148. package/dist/plugin/plugin-schema.js +18 -0
  149. package/dist/plugin/plugin-schema.js.map +1 -0
  150. package/dist/prompt/define-prompt.d.ts +3 -0
  151. package/dist/prompt/define-prompt.d.ts.map +1 -0
  152. package/dist/prompt/define-prompt.js +17 -0
  153. package/dist/prompt/define-prompt.js.map +1 -0
  154. package/dist/prompt/index.d.ts +2 -0
  155. package/dist/prompt/index.d.ts.map +1 -0
  156. package/dist/prompt/index.js +4 -0
  157. package/dist/prompt/index.js.map +1 -0
  158. package/dist/resource/define-resource.d.ts +3 -0
  159. package/dist/resource/define-resource.d.ts.map +1 -0
  160. package/dist/resource/define-resource.js +19 -0
  161. package/dist/resource/define-resource.js.map +1 -0
  162. package/dist/resource/index.d.ts +3 -0
  163. package/dist/resource/index.d.ts.map +1 -0
  164. package/dist/resource/index.js +5 -0
  165. package/dist/resource/index.js.map +1 -0
  166. package/dist/resource/resource-template.d.ts +5 -0
  167. package/dist/resource/resource-template.d.ts.map +1 -0
  168. package/dist/resource/resource-template.js +17 -0
  169. package/dist/resource/resource-template.js.map +1 -0
  170. package/dist/server/define-server.d.ts +14 -0
  171. package/dist/server/define-server.d.ts.map +1 -0
  172. package/dist/server/define-server.js +175 -0
  173. package/dist/server/define-server.js.map +1 -0
  174. package/dist/server/index.d.ts +4 -0
  175. package/dist/server/index.d.ts.map +1 -0
  176. package/dist/server/index.js +6 -0
  177. package/dist/server/index.js.map +1 -0
  178. package/dist/server/lifecycle.d.ts +3 -0
  179. package/dist/server/lifecycle.d.ts.map +1 -0
  180. package/dist/server/lifecycle.js +32 -0
  181. package/dist/server/lifecycle.js.map +1 -0
  182. package/dist/server/server-runner.d.ts +42 -0
  183. package/dist/server/server-runner.d.ts.map +1 -0
  184. package/dist/server/server-runner.js +255 -0
  185. package/dist/server/server-runner.js.map +1 -0
  186. package/dist/storage/file-store.d.ts +25 -0
  187. package/dist/storage/file-store.d.ts.map +1 -0
  188. package/dist/storage/file-store.js +177 -0
  189. package/dist/storage/file-store.js.map +1 -0
  190. package/dist/storage/index.d.ts +4 -0
  191. package/dist/storage/index.d.ts.map +1 -0
  192. package/dist/storage/index.js +6 -0
  193. package/dist/storage/index.js.map +1 -0
  194. package/dist/storage/memory-store.d.ts +18 -0
  195. package/dist/storage/memory-store.d.ts.map +1 -0
  196. package/dist/storage/memory-store.js +80 -0
  197. package/dist/storage/memory-store.js.map +1 -0
  198. package/dist/storage/storage-adapter.d.ts +4 -0
  199. package/dist/storage/storage-adapter.d.ts.map +1 -0
  200. package/dist/storage/storage-adapter.js +32 -0
  201. package/dist/storage/storage-adapter.js.map +1 -0
  202. package/dist/telemetry/index.d.ts +3 -0
  203. package/dist/telemetry/index.d.ts.map +1 -0
  204. package/dist/telemetry/index.js +4 -0
  205. package/dist/telemetry/index.js.map +1 -0
  206. package/dist/telemetry/telemetry.d.ts +56 -0
  207. package/dist/telemetry/telemetry.d.ts.map +1 -0
  208. package/dist/telemetry/telemetry.js +95 -0
  209. package/dist/telemetry/telemetry.js.map +1 -0
  210. package/dist/tool/define-tool.d.ts +23 -0
  211. package/dist/tool/define-tool.d.ts.map +1 -0
  212. package/dist/tool/define-tool.js +28 -0
  213. package/dist/tool/define-tool.js.map +1 -0
  214. package/dist/tool/index.d.ts +5 -0
  215. package/dist/tool/index.d.ts.map +1 -0
  216. package/dist/tool/index.js +6 -0
  217. package/dist/tool/index.js.map +1 -0
  218. package/dist/tool/tool-result.d.ts +10 -0
  219. package/dist/tool/tool-result.d.ts.map +1 -0
  220. package/dist/tool/tool-result.js +34 -0
  221. package/dist/tool/tool-result.js.map +1 -0
  222. package/dist/tool/tool-schema.d.ts +7 -0
  223. package/dist/tool/tool-schema.d.ts.map +1 -0
  224. package/dist/tool/tool-schema.js +97 -0
  225. package/dist/tool/tool-schema.js.map +1 -0
  226. package/dist/transport/auto-detect.d.ts +4 -0
  227. package/dist/transport/auto-detect.d.ts.map +1 -0
  228. package/dist/transport/auto-detect.js +21 -0
  229. package/dist/transport/auto-detect.js.map +1 -0
  230. package/dist/transport/http-adapter.d.ts +4 -0
  231. package/dist/transport/http-adapter.d.ts.map +1 -0
  232. package/dist/transport/http-adapter.js +10 -0
  233. package/dist/transport/http-adapter.js.map +1 -0
  234. package/dist/transport/index.d.ts +5 -0
  235. package/dist/transport/index.d.ts.map +1 -0
  236. package/dist/transport/index.js +7 -0
  237. package/dist/transport/index.js.map +1 -0
  238. package/dist/transport/sse-adapter.d.ts +3 -0
  239. package/dist/transport/sse-adapter.d.ts.map +1 -0
  240. package/dist/transport/sse-adapter.js +8 -0
  241. package/dist/transport/sse-adapter.js.map +1 -0
  242. package/dist/transport/stdio-adapter.d.ts +3 -0
  243. package/dist/transport/stdio-adapter.d.ts.map +1 -0
  244. package/dist/transport/stdio-adapter.js +8 -0
  245. package/dist/transport/stdio-adapter.js.map +1 -0
  246. package/dist/types/config.d.ts +101 -0
  247. package/dist/types/config.d.ts.map +1 -0
  248. package/dist/types/config.js +5 -0
  249. package/dist/types/config.js.map +1 -0
  250. package/dist/types/index.d.ts +12 -0
  251. package/dist/types/index.d.ts.map +1 -0
  252. package/dist/types/index.js +4 -0
  253. package/dist/types/index.js.map +1 -0
  254. package/dist/types/middleware.d.ts +48 -0
  255. package/dist/types/middleware.d.ts.map +1 -0
  256. package/dist/types/middleware.js +4 -0
  257. package/dist/types/middleware.js.map +1 -0
  258. package/dist/types/plugin-manifest.d.ts +59 -0
  259. package/dist/types/plugin-manifest.d.ts.map +1 -0
  260. package/dist/types/plugin-manifest.js +9 -0
  261. package/dist/types/plugin-manifest.js.map +1 -0
  262. package/dist/types/plugin.d.ts +50 -0
  263. package/dist/types/plugin.d.ts.map +1 -0
  264. package/dist/types/plugin.js +4 -0
  265. package/dist/types/plugin.js.map +1 -0
  266. package/dist/types/prompt.d.ts +21 -0
  267. package/dist/types/prompt.d.ts.map +1 -0
  268. package/dist/types/prompt.js +4 -0
  269. package/dist/types/prompt.js.map +1 -0
  270. package/dist/types/resource.d.ts +25 -0
  271. package/dist/types/resource.d.ts.map +1 -0
  272. package/dist/types/resource.js +4 -0
  273. package/dist/types/resource.js.map +1 -0
  274. package/dist/types/server.d.ts +54 -0
  275. package/dist/types/server.d.ts.map +1 -0
  276. package/dist/types/server.js +4 -0
  277. package/dist/types/server.js.map +1 -0
  278. package/dist/types/storage.d.ts +40 -0
  279. package/dist/types/storage.d.ts.map +1 -0
  280. package/dist/types/storage.js +4 -0
  281. package/dist/types/storage.js.map +1 -0
  282. package/dist/types/tool.d.ts +54 -0
  283. package/dist/types/tool.d.ts.map +1 -0
  284. package/dist/types/tool.js +4 -0
  285. package/dist/types/tool.js.map +1 -0
  286. package/dist/types/transport.d.ts +12 -0
  287. package/dist/types/transport.d.ts.map +1 -0
  288. package/dist/types/transport.js +4 -0
  289. package/dist/types/transport.js.map +1 -0
  290. package/package.json +23 -0
@@ -0,0 +1,78 @@
1
+ // Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
2
+ // @airmcp-dev/core — plugin/builtin/webhook.ts
3
+ //
4
+ // 도구 호출 결과를 외부 웹훅으로 전송하는 플러그인.
5
+ // 모니터링, Slack 알림, 로그 수집 등에 사용.
6
+ //
7
+ // @example
8
+ // defineServer({
9
+ // use: [webhookPlugin({
10
+ // url: 'https://hooks.slack.com/services/xxx',
11
+ // events: ['tool.call', 'tool.error'],
12
+ // })],
13
+ // });
14
+ export function webhookPlugin(options) {
15
+ const events = new Set(options.events || ['tool.call']);
16
+ const slowMs = options.slowThresholdMs || 5000;
17
+ const batch = [];
18
+ const batchSize = options.batchSize || 1;
19
+ async function sendWebhook(payload) {
20
+ batch.push(payload);
21
+ if (batch.length < batchSize)
22
+ return;
23
+ const items = batch.splice(0);
24
+ try {
25
+ await fetch(options.url, {
26
+ method: 'POST',
27
+ headers: {
28
+ 'Content-Type': 'application/json',
29
+ ...options.headers,
30
+ },
31
+ body: JSON.stringify(items.length === 1 ? items[0] : { events: items }),
32
+ });
33
+ }
34
+ catch (err) {
35
+ console.error(`[air:webhook] Failed to send: ${err.message}`);
36
+ }
37
+ }
38
+ const middleware = {
39
+ name: 'air:webhook',
40
+ after: async (ctx) => {
41
+ if (events.has('tool.call')) {
42
+ await sendWebhook({
43
+ event: 'tool.call',
44
+ tool: ctx.tool.name,
45
+ duration: ctx.duration,
46
+ timestamp: new Date().toISOString(),
47
+ server: ctx.serverName,
48
+ });
49
+ }
50
+ if (events.has('tool.slow') && ctx.duration > slowMs) {
51
+ await sendWebhook({
52
+ event: 'tool.slow',
53
+ tool: ctx.tool.name,
54
+ duration: ctx.duration,
55
+ threshold: slowMs,
56
+ timestamp: new Date().toISOString(),
57
+ });
58
+ }
59
+ },
60
+ onError: async (ctx, error) => {
61
+ if (events.has('tool.error')) {
62
+ await sendWebhook({
63
+ event: 'tool.error',
64
+ tool: ctx.tool.name,
65
+ error: error.message,
66
+ timestamp: new Date().toISOString(),
67
+ server: ctx.serverName,
68
+ });
69
+ }
70
+ return undefined;
71
+ },
72
+ };
73
+ return {
74
+ meta: { name: 'air:webhook', version: '1.0.0' },
75
+ middleware: [middleware],
76
+ };
77
+ }
78
+ //# sourceMappingURL=webhook.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../../src/plugin/builtin/webhook.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ export { PluginManager } from './plugin-manager.js';
2
+ export { PluginHookRunner } from './plugin-hook.js';
3
+ export { resolvePlugin, validatePlugin } from './plugin-schema.js';
4
+ export { builtinLoggerPlugin } from './builtin/logger.js';
5
+ export { builtinMetricsPlugin, getMetrics, resetMetrics } from './builtin/metrics.js';
6
+ export { timeoutPlugin } from './builtin/timeout.js';
7
+ export { retryPlugin } from './builtin/retry.js';
8
+ export { circuitBreakerPlugin } from './builtin/circuit-breaker.js';
9
+ export { fallbackPlugin } from './builtin/fallback.js';
10
+ export { cachePlugin } from './builtin/cache.js';
11
+ export { dedupPlugin } from './builtin/dedup.js';
12
+ export { queuePlugin } from './builtin/queue.js';
13
+ export { authPlugin } from './builtin/auth.js';
14
+ export { sanitizerPlugin } from './builtin/sanitizer.js';
15
+ export { validatorPlugin } from './builtin/validator.js';
16
+ export { corsPlugin } from './builtin/cors.js';
17
+ export { webhookPlugin } from './builtin/webhook.js';
18
+ export { transformPlugin } from './builtin/transform.js';
19
+ export { i18nPlugin } from './builtin/i18n.js';
20
+ export { jsonLoggerPlugin } from './builtin/logger-json.js';
21
+ export { perUserRateLimitPlugin } from './builtin/ratelimit-per-user.js';
22
+ export { dryrunPlugin } from './builtin/dryrun.js';
23
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAInE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGtF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}
@@ -0,0 +1,34 @@
1
+ // Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
2
+ // @airmcp-dev/core — plugin/index.ts (re-export only)
3
+ export { PluginManager } from './plugin-manager.js';
4
+ export { PluginHookRunner } from './plugin-hook.js';
5
+ export { resolvePlugin, validatePlugin } from './plugin-schema.js';
6
+ // ── Builtin Plugins (19) ──
7
+ // 내부 (자동 등록)
8
+ export { builtinLoggerPlugin } from './builtin/logger.js';
9
+ export { builtinMetricsPlugin, getMetrics, resetMetrics } from './builtin/metrics.js';
10
+ // 안정성
11
+ export { timeoutPlugin } from './builtin/timeout.js';
12
+ export { retryPlugin } from './builtin/retry.js';
13
+ export { circuitBreakerPlugin } from './builtin/circuit-breaker.js';
14
+ export { fallbackPlugin } from './builtin/fallback.js';
15
+ // 성능
16
+ export { cachePlugin } from './builtin/cache.js';
17
+ export { dedupPlugin } from './builtin/dedup.js';
18
+ export { queuePlugin } from './builtin/queue.js';
19
+ // 보안/인증
20
+ export { authPlugin } from './builtin/auth.js';
21
+ export { sanitizerPlugin } from './builtin/sanitizer.js';
22
+ export { validatorPlugin } from './builtin/validator.js';
23
+ // 네트워크
24
+ export { corsPlugin } from './builtin/cors.js';
25
+ export { webhookPlugin } from './builtin/webhook.js';
26
+ // 데이터 변환
27
+ export { transformPlugin } from './builtin/transform.js';
28
+ export { i18nPlugin } from './builtin/i18n.js';
29
+ // 모니터링
30
+ export { jsonLoggerPlugin } from './builtin/logger-json.js';
31
+ export { perUserRateLimitPlugin } from './builtin/ratelimit-per-user.js';
32
+ // 개발/테스트
33
+ export { dryrunPlugin } from './builtin/dryrun.js';
34
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,sDAAsD;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEnE,6BAA6B;AAC7B,aAAa;AACb,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEtF,MAAM;AACN,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,KAAK;AACL,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,QAAQ;AACR,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO;AACP,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO;AACP,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}
@@ -0,0 +1,11 @@
1
+ import type { PluginHooks, PluginContext } from '../types/plugin.js';
2
+ import type { AirToolDef } from '../types/tool.js';
3
+ export declare class PluginHookRunner {
4
+ private hooks;
5
+ register(pluginName: string, hooks: PluginHooks): void;
6
+ runOnInit(ctx: PluginContext): Promise<void>;
7
+ runOnStart(ctx: PluginContext): Promise<void>;
8
+ runOnStop(ctx: PluginContext): Promise<void>;
9
+ runOnToolRegister(tool: AirToolDef, ctx: PluginContext): AirToolDef;
10
+ }
11
+ //# sourceMappingURL=plugin-hook.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-hook.d.ts","sourceRoot":"","sources":["../../src/plugin/plugin-hook.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAmD;IAEhE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;IAIzC,SAAS,CAAC,GAAG,EAAE,aAAa;IAM5B,UAAU,CAAC,GAAG,EAAE,aAAa;IAM7B,SAAS,CAAC,GAAG,EAAE,aAAa;IAMlC,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,GAAG,UAAU;CAUpE"}
@@ -0,0 +1,39 @@
1
+ // Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
2
+ // @airmcp-dev/core — plugin/plugin-hook.ts
3
+ // 플러그인 훅 실행기
4
+ export class PluginHookRunner {
5
+ hooks = [];
6
+ register(pluginName, hooks) {
7
+ this.hooks.push({ name: pluginName, hooks });
8
+ }
9
+ async runOnInit(ctx) {
10
+ for (const { hooks } of this.hooks) {
11
+ if (hooks.onInit)
12
+ await hooks.onInit(ctx);
13
+ }
14
+ }
15
+ async runOnStart(ctx) {
16
+ for (const { hooks } of this.hooks) {
17
+ if (hooks.onStart)
18
+ await hooks.onStart(ctx);
19
+ }
20
+ }
21
+ async runOnStop(ctx) {
22
+ for (const { hooks } of this.hooks) {
23
+ if (hooks.onStop)
24
+ await hooks.onStop(ctx);
25
+ }
26
+ }
27
+ runOnToolRegister(tool, ctx) {
28
+ let result = tool;
29
+ for (const { hooks } of this.hooks) {
30
+ if (hooks.onToolRegister) {
31
+ const modified = hooks.onToolRegister(result, ctx);
32
+ if (modified)
33
+ result = modified;
34
+ }
35
+ }
36
+ return result;
37
+ }
38
+ }
39
+ //# sourceMappingURL=plugin-hook.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-hook.js","sourceRoot":"","sources":["../../src/plugin/plugin-hook.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,2CAA2C;AAC3C,aAAa;AAKb,MAAM,OAAO,gBAAgB;IACnB,KAAK,GAAgD,EAAE,CAAC;IAEhE,QAAQ,CAAC,UAAkB,EAAE,KAAkB;QAC7C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAkB;QAChC,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,MAAM;gBAAE,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAkB;QACjC,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,OAAO;gBAAE,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAkB;QAChC,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,MAAM;gBAAE,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,IAAgB,EAAE,GAAkB;QACpD,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;gBACzB,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBACnD,IAAI,QAAQ;oBAAE,MAAM,GAAG,QAAQ,CAAC;YAClC,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
@@ -0,0 +1,22 @@
1
+ import type { AirPlugin, AirPluginFactory, PluginContext } from '../types/plugin.js';
2
+ import type { AirMiddleware } from '../types/middleware.js';
3
+ import type { AirToolDef } from '../types/tool.js';
4
+ import type { AirResourceDef } from '../types/resource.js';
5
+ import { PluginHookRunner } from './plugin-hook.js';
6
+ export declare class PluginManager {
7
+ private plugins;
8
+ readonly hookRunner: PluginHookRunner;
9
+ /** 플러그인 등록 */
10
+ register(input: AirPlugin | AirPluginFactory): void;
11
+ /** 등록된 모든 플러그인의 미들웨어를 수집 */
12
+ collectMiddleware(): AirMiddleware[];
13
+ /** 등록된 모든 플러그인의 도구를 수집 */
14
+ collectTools(): AirToolDef[];
15
+ /** 등록된 모든 플러그인의 리소스를 수집 */
16
+ collectResources(): AirResourceDef[];
17
+ /** 등록된 플러그인 목록 */
18
+ list(): import("../index.js").AirPluginMeta[];
19
+ /** 플러그인 컨텍스트 생성 */
20
+ createContext(serverName: string, config: Record<string, any>, state: Record<string, any>): PluginContext;
21
+ }
22
+ //# sourceMappingURL=plugin-manager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-manager.d.ts","sourceRoot":"","sources":["../../src/plugin/plugin-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAmB;IAClC,QAAQ,CAAC,UAAU,mBAA0B;IAE7C,cAAc;IACd,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB;IAe5C,4BAA4B;IAC5B,iBAAiB,IAAI,aAAa,EAAE;IAQpC,0BAA0B;IAC1B,YAAY,IAAI,UAAU,EAAE;IAQ5B,2BAA2B;IAC3B,gBAAgB,IAAI,cAAc,EAAE;IAQpC,kBAAkB;IAClB,IAAI;IAIJ,mBAAmB;IACnB,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB,aAAa;CAajB"}
@@ -0,0 +1,71 @@
1
+ // Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
2
+ // @airmcp-dev/core — plugin/plugin-manager.ts
3
+ // 플러그인 등록, 로드, 해제
4
+ import { resolvePlugin, validatePlugin } from './plugin-schema.js';
5
+ import { PluginHookRunner } from './plugin-hook.js';
6
+ export class PluginManager {
7
+ plugins = [];
8
+ hookRunner = new PluginHookRunner();
9
+ /** 플러그인 등록 */
10
+ register(input) {
11
+ const plugin = resolvePlugin(input);
12
+ const errors = validatePlugin(plugin);
13
+ if (errors.length > 0) {
14
+ throw new Error(`Invalid plugin "${plugin.meta?.name}": ${errors.join(', ')}`);
15
+ }
16
+ this.plugins.push(plugin);
17
+ // 훅 등록
18
+ if (plugin.hooks) {
19
+ this.hookRunner.register(plugin.meta.name, plugin.hooks);
20
+ }
21
+ }
22
+ /** 등록된 모든 플러그인의 미들웨어를 수집 */
23
+ collectMiddleware() {
24
+ const result = [];
25
+ for (const p of this.plugins) {
26
+ if (p.middleware)
27
+ result.push(...p.middleware);
28
+ }
29
+ return result;
30
+ }
31
+ /** 등록된 모든 플러그인의 도구를 수집 */
32
+ collectTools() {
33
+ const result = [];
34
+ for (const p of this.plugins) {
35
+ if (p.tools)
36
+ result.push(...p.tools);
37
+ }
38
+ return result;
39
+ }
40
+ /** 등록된 모든 플러그인의 리소스를 수집 */
41
+ collectResources() {
42
+ const result = [];
43
+ for (const p of this.plugins) {
44
+ if (p.resources)
45
+ result.push(...p.resources);
46
+ }
47
+ return result;
48
+ }
49
+ /** 등록된 플러그인 목록 */
50
+ list() {
51
+ return this.plugins.map((p) => p.meta);
52
+ }
53
+ /** 플러그인 컨텍스트 생성 */
54
+ createContext(serverName, config, state) {
55
+ return {
56
+ serverName,
57
+ config,
58
+ state,
59
+ log: (level, message, data) => {
60
+ const prefix = `[air:plugin]`;
61
+ if (level === 'error')
62
+ console.error(prefix, message, data || '');
63
+ else if (level === 'warn')
64
+ console.warn(prefix, message, data || '');
65
+ else
66
+ console.log(prefix, message, data || '');
67
+ },
68
+ };
69
+ }
70
+ }
71
+ //# sourceMappingURL=plugin-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-manager.js","sourceRoot":"","sources":["../../src/plugin/plugin-manager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { AirPlugin, AirPluginFactory } from '../types/plugin.js';
2
+ /** 플러그인 또는 팩토리를 AirPlugin 인스턴스로 정규화 */
3
+ export declare function resolvePlugin(input: AirPlugin | AirPluginFactory): AirPlugin;
4
+ /** 플러그인 기본 검증 */
5
+ export declare function validatePlugin(plugin: AirPlugin): string[];
6
+ //# sourceMappingURL=plugin-schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-schema.d.ts","sourceRoot":"","sources":["../../src/plugin/plugin-schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtE,uCAAuC;AACvC,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAK5E;AAED,iBAAiB;AACjB,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,CAI1D"}
@@ -0,0 +1,18 @@
1
+ // Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
2
+ // @airmcp-dev/core — plugin/plugin-schema.ts
3
+ // AirPlugin 유효성 검증
4
+ /** 플러그인 또는 팩토리를 AirPlugin 인스턴스로 정규화 */
5
+ export function resolvePlugin(input) {
6
+ if (typeof input === 'function') {
7
+ return input();
8
+ }
9
+ return input;
10
+ }
11
+ /** 플러그인 기본 검증 */
12
+ export function validatePlugin(plugin) {
13
+ const errors = [];
14
+ if (!plugin.meta?.name)
15
+ errors.push('plugin.meta.name is required');
16
+ return errors;
17
+ }
18
+ //# sourceMappingURL=plugin-schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-schema.js","sourceRoot":"","sources":["../../src/plugin/plugin-schema.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,6CAA6C;AAC7C,mBAAmB;AAInB,uCAAuC;AACvC,MAAM,UAAU,aAAa,CAAC,KAAmC;IAC/D,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,KAAK,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iBAAiB;AACjB,MAAM,UAAU,cAAc,CAAC,MAAiB;IAC9C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI;QAAE,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { AirPromptDef } from '../types/prompt.js';
2
+ export declare function definePrompt(nameOrOptions: string | AirPromptDef, options?: Omit<AirPromptDef, 'name'>): AirPromptDef;
3
+ //# sourceMappingURL=define-prompt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"define-prompt.d.ts","sourceRoot":"","sources":["../../src/prompt/define-prompt.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,GAAG,YAAY,EACpC,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GACnC,YAAY,CAOd"}
@@ -0,0 +1,17 @@
1
+ // Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
2
+ // @airmcp-dev/core — prompt/define-prompt.ts
3
+ //
4
+ // definePrompt() — MCP 프롬프트 템플릿을 정의한다.
5
+ //
6
+ // 두 가지 호출 방식:
7
+ // definePrompt('name', { description, args, handler })
8
+ // definePrompt({ name, description, args, handler })
9
+ export function definePrompt(nameOrOptions, options) {
10
+ if (typeof nameOrOptions === 'string') {
11
+ if (!options)
12
+ throw new Error('definePrompt: options required when first arg is name string');
13
+ return { name: nameOrOptions, ...options };
14
+ }
15
+ return nameOrOptions;
16
+ }
17
+ //# sourceMappingURL=define-prompt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"define-prompt.js","sourceRoot":"","sources":["../../src/prompt/define-prompt.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,6CAA6C;AAC7C,EAAE;AACF,uCAAuC;AACvC,EAAE;AACF,cAAc;AACd,yDAAyD;AACzD,uDAAuD;AAIvD,MAAM,UAAU,YAAY,CAC1B,aAAoC,EACpC,OAAoC;IAEpC,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC9F,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,CAAC;IAC7C,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { definePrompt } from './define-prompt.js';
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
@@ -0,0 +1,4 @@
1
+ // Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
2
+ // @airmcp-dev/core — prompt/index.ts (re-export only)
3
+ export { definePrompt } from './define-prompt.js';
4
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,sDAAsD;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { AirResourceDef } from '../types/resource.js';
2
+ export declare function defineResource(uriOrOptions: string | AirResourceDef, options?: Omit<AirResourceDef, 'uri'>): AirResourceDef;
3
+ //# sourceMappingURL=define-resource.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"define-resource.d.ts","sourceRoot":"","sources":["../../src/resource/define-resource.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,GAAG,cAAc,EACrC,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,GACpC,cAAc,CAShB"}
@@ -0,0 +1,19 @@
1
+ // Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
2
+ // @airmcp-dev/core — resource/define-resource.ts
3
+ //
4
+ // defineResource() — MCP 리소스를 정의한다.
5
+ //
6
+ // 두 가지 호출 방식 지원:
7
+ // defineResource('file:///path', { name, handler, ... })
8
+ // defineResource({ uri, name, handler, ... })
9
+ export function defineResource(uriOrOptions, options) {
10
+ if (typeof uriOrOptions === 'string') {
11
+ // defineResource('file:///path', { name, handler })
12
+ if (!options)
13
+ throw new Error('defineResource: options required when first arg is uri string');
14
+ return { uri: uriOrOptions, ...options };
15
+ }
16
+ // defineResource({ uri, name, handler })
17
+ return uriOrOptions;
18
+ }
19
+ //# sourceMappingURL=define-resource.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"define-resource.js","sourceRoot":"","sources":["../../src/resource/define-resource.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,iDAAiD;AACjD,EAAE;AACF,oCAAoC;AACpC,EAAE;AACF,iBAAiB;AACjB,2DAA2D;AAC3D,gDAAgD;AAIhD,MAAM,UAAU,cAAc,CAC5B,YAAqC,EACrC,OAAqC;IAErC,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,oDAAoD;QACpD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QAC/F,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3C,CAAC;IAED,yCAAyC;IACzC,OAAO,YAAY,CAAC;AACtB,CAAC"}
@@ -0,0 +1,3 @@
1
+ export { defineResource } from './define-resource.js';
2
+ export { extractTemplateVars, matchTemplate } from './resource-template.js';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resource/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}
@@ -0,0 +1,5 @@
1
+ // Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
2
+ // @airmcp-dev/core — resource/index.ts (re-export only)
3
+ export { defineResource } from './define-resource.js';
4
+ export { extractTemplateVars, matchTemplate } from './resource-template.js';
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resource/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,wDAAwD;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}
@@ -0,0 +1,5 @@
1
+ /** URI 템플릿에서 변수 추출 */
2
+ export declare function extractTemplateVars(uri: string): string[];
3
+ /** URI가 템플릿 패턴과 매칭되는지 확인 */
4
+ export declare function matchTemplate(template: string, uri: string): Record<string, string> | null;
5
+ //# sourceMappingURL=resource-template.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resource-template.d.ts","sourceRoot":"","sources":["../../src/resource/resource-template.ts"],"names":[],"mappings":"AAMA,sBAAsB;AACtB,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAIzD;AAED,4BAA4B;AAC5B,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAI1F"}
@@ -0,0 +1,17 @@
1
+ // Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
2
+ // @airmcp-dev/core — resource/resource-template.ts
3
+ // URI 템플릿 기반 동적 리소스 (예: "file:///{path}")
4
+ /** URI 템플릿에서 변수 추출 */
5
+ export function extractTemplateVars(uri) {
6
+ const matches = uri.match(/\{(\w+)\}/g);
7
+ if (!matches)
8
+ return [];
9
+ return matches.map((m) => m.slice(1, -1));
10
+ }
11
+ /** URI가 템플릿 패턴과 매칭되는지 확인 */
12
+ export function matchTemplate(template, uri) {
13
+ const regex = template.replace(/\{(\w+)\}/g, '(?<$1>[^/]+)');
14
+ const match = uri.match(new RegExp(`^${regex}$`));
15
+ return match?.groups ?? null;
16
+ }
17
+ //# sourceMappingURL=resource-template.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resource-template.js","sourceRoot":"","sources":["../../src/resource/resource-template.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,mDAAmD;AACnD,0CAA0C;AAI1C,sBAAsB;AACtB,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,GAAW;IACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IAClD,OAAO,KAAK,EAAE,MAAM,IAAI,IAAI,CAAC;AAC/B,CAAC"}
@@ -0,0 +1,14 @@
1
+ import type { AirServerOptions, AirServer } from '../types/server.js';
2
+ /**
3
+ * MCP 서버를 정의한다.
4
+ *
5
+ * 내장 기능 (자동 적용):
6
+ * - 입력 검증 (zod)
7
+ * - 에러 → MCP 프로토콜 변환
8
+ * - 로깅 (builtin logger plugin)
9
+ * - 보안 (shield 설정 시: 정책, 위협탐지, 레이트리밋, 감사)
10
+ * - 측정 (meter 설정 시: 7-Layer 분류, 호출 추적, 지연시간)
11
+ * - Graceful shutdown (SIGTERM/SIGINT)
12
+ */
13
+ export declare function defineServer(options: AirServerOptions): AirServer;
14
+ //# sourceMappingURL=define-server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"define-server.d.ts","sourceRoot":"","sources":["../../src/server/define-server.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAiBtE;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAyJjE"}