@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.
- package/LICENSE +17 -0
- package/dist/config/defaults.d.ts +3 -0
- package/dist/config/defaults.d.ts.map +1 -0
- package/dist/config/defaults.js +11 -0
- package/dist/config/defaults.js.map +1 -0
- package/dist/config/index.d.ts +3 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +5 -0
- package/dist/config/index.js.map +1 -0
- package/dist/config/loader.d.ts +4 -0
- package/dist/config/loader.d.ts.map +1 -0
- package/dist/config/loader.js +59 -0
- package/dist/config/loader.js.map +1 -0
- package/dist/context/index.d.ts +3 -0
- package/dist/context/index.d.ts.map +1 -0
- package/dist/context/index.js +5 -0
- package/dist/context/index.js.map +1 -0
- package/dist/context/request-context.d.ts +4 -0
- package/dist/context/request-context.d.ts.map +1 -0
- package/dist/context/request-context.js +14 -0
- package/dist/context/request-context.js.map +1 -0
- package/dist/context/server-context.d.ts +12 -0
- package/dist/context/server-context.d.ts.map +1 -0
- package/dist/context/server-context.js +25 -0
- package/dist/context/server-context.js.map +1 -0
- package/dist/index.d.ts +47 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +62 -0
- package/dist/index.js.map +1 -0
- package/dist/middleware/after-hook.d.ts +4 -0
- package/dist/middleware/after-hook.d.ts.map +1 -0
- package/dist/middleware/after-hook.js +18 -0
- package/dist/middleware/after-hook.js.map +1 -0
- package/dist/middleware/before-hook.d.ts +4 -0
- package/dist/middleware/before-hook.d.ts.map +1 -0
- package/dist/middleware/before-hook.js +40 -0
- package/dist/middleware/before-hook.js.map +1 -0
- package/dist/middleware/chain.d.ts +11 -0
- package/dist/middleware/chain.d.ts.map +1 -0
- package/dist/middleware/chain.js +84 -0
- package/dist/middleware/chain.js.map +1 -0
- package/dist/middleware/error-handler.d.ts +27 -0
- package/dist/middleware/error-handler.d.ts.map +1 -0
- package/dist/middleware/error-handler.js +63 -0
- package/dist/middleware/error-handler.js.map +1 -0
- package/dist/middleware/index.d.ts +7 -0
- package/dist/middleware/index.d.ts.map +1 -0
- package/dist/middleware/index.js +9 -0
- package/dist/middleware/index.js.map +1 -0
- package/dist/middleware/meter-middleware.d.ts +19 -0
- package/dist/middleware/meter-middleware.d.ts.map +1 -0
- package/dist/middleware/meter-middleware.js +139 -0
- package/dist/middleware/meter-middleware.js.map +1 -0
- package/dist/middleware/shield-middleware.d.ts +16 -0
- package/dist/middleware/shield-middleware.d.ts.map +1 -0
- package/dist/middleware/shield-middleware.js +163 -0
- package/dist/middleware/shield-middleware.js.map +1 -0
- package/dist/plugin/builtin/auth.d.ts +16 -0
- package/dist/plugin/builtin/auth.d.ts.map +1 -0
- package/dist/plugin/builtin/auth.js +60 -0
- package/dist/plugin/builtin/auth.js.map +1 -0
- package/dist/plugin/builtin/cache.d.ts +12 -0
- package/dist/plugin/builtin/cache.d.ts.map +1 -0
- package/dist/plugin/builtin/cache.js +65 -0
- package/dist/plugin/builtin/cache.js.map +1 -0
- package/dist/plugin/builtin/circuit-breaker.d.ts +12 -0
- package/dist/plugin/builtin/circuit-breaker.d.ts.map +1 -0
- package/dist/plugin/builtin/circuit-breaker.js +76 -0
- package/dist/plugin/builtin/circuit-breaker.js.map +1 -0
- package/dist/plugin/builtin/cors.d.ts +12 -0
- package/dist/plugin/builtin/cors.d.ts.map +1 -0
- package/dist/plugin/builtin/cors.js +29 -0
- package/dist/plugin/builtin/cors.js.map +1 -0
- package/dist/plugin/builtin/dedup.d.ts +8 -0
- package/dist/plugin/builtin/dedup.d.ts.map +1 -0
- package/dist/plugin/builtin/dedup.js +64 -0
- package/dist/plugin/builtin/dedup.js.map +1 -0
- package/dist/plugin/builtin/dryrun.d.ts +12 -0
- package/dist/plugin/builtin/dryrun.d.ts.map +1 -0
- package/dist/plugin/builtin/dryrun.js +61 -0
- package/dist/plugin/builtin/dryrun.js.map +1 -0
- package/dist/plugin/builtin/fallback.d.ts +5 -0
- package/dist/plugin/builtin/fallback.d.ts.map +1 -0
- package/dist/plugin/builtin/fallback.js +42 -0
- package/dist/plugin/builtin/fallback.js.map +1 -0
- package/dist/plugin/builtin/i18n.d.ts +12 -0
- package/dist/plugin/builtin/i18n.d.ts.map +1 -0
- package/dist/plugin/builtin/i18n.js +51 -0
- package/dist/plugin/builtin/i18n.js.map +1 -0
- package/dist/plugin/builtin/logger-json.d.ts +12 -0
- package/dist/plugin/builtin/logger-json.d.ts.map +1 -0
- package/dist/plugin/builtin/logger-json.js +52 -0
- package/dist/plugin/builtin/logger-json.js.map +1 -0
- package/dist/plugin/builtin/logger.d.ts +3 -0
- package/dist/plugin/builtin/logger.d.ts.map +1 -0
- package/dist/plugin/builtin/logger.js +22 -0
- package/dist/plugin/builtin/logger.js.map +1 -0
- package/dist/plugin/builtin/metrics.d.ts +14 -0
- package/dist/plugin/builtin/metrics.d.ts.map +1 -0
- package/dist/plugin/builtin/metrics.js +56 -0
- package/dist/plugin/builtin/metrics.js.map +1 -0
- package/dist/plugin/builtin/queue.d.ts +12 -0
- package/dist/plugin/builtin/queue.d.ts.map +1 -0
- package/dist/plugin/builtin/queue.js +98 -0
- package/dist/plugin/builtin/queue.js.map +1 -0
- package/dist/plugin/builtin/ratelimit-per-user.d.ts +12 -0
- package/dist/plugin/builtin/ratelimit-per-user.d.ts.map +1 -0
- package/dist/plugin/builtin/ratelimit-per-user.js +45 -0
- package/dist/plugin/builtin/ratelimit-per-user.js.map +1 -0
- package/dist/plugin/builtin/retry.d.ts +12 -0
- package/dist/plugin/builtin/retry.d.ts.map +1 -0
- package/dist/plugin/builtin/retry.js +51 -0
- package/dist/plugin/builtin/retry.js.map +1 -0
- package/dist/plugin/builtin/sanitizer.d.ts +14 -0
- package/dist/plugin/builtin/sanitizer.d.ts.map +1 -0
- package/dist/plugin/builtin/sanitizer.js +55 -0
- package/dist/plugin/builtin/sanitizer.js.map +1 -0
- package/dist/plugin/builtin/timeout.d.ts +3 -0
- package/dist/plugin/builtin/timeout.d.ts.map +1 -0
- package/dist/plugin/builtin/timeout.js +30 -0
- package/dist/plugin/builtin/timeout.js.map +1 -0
- package/dist/plugin/builtin/transform.d.ts +11 -0
- package/dist/plugin/builtin/transform.d.ts.map +1 -0
- package/dist/plugin/builtin/transform.js +51 -0
- package/dist/plugin/builtin/transform.js.map +1 -0
- package/dist/plugin/builtin/validator.d.ts +9 -0
- package/dist/plugin/builtin/validator.d.ts.map +1 -0
- package/dist/plugin/builtin/validator.js +43 -0
- package/dist/plugin/builtin/validator.js.map +1 -0
- package/dist/plugin/builtin/webhook.d.ts +16 -0
- package/dist/plugin/builtin/webhook.d.ts.map +1 -0
- package/dist/plugin/builtin/webhook.js +78 -0
- package/dist/plugin/builtin/webhook.js.map +1 -0
- package/dist/plugin/index.d.ts +23 -0
- package/dist/plugin/index.d.ts.map +1 -0
- package/dist/plugin/index.js +34 -0
- package/dist/plugin/index.js.map +1 -0
- package/dist/plugin/plugin-hook.d.ts +11 -0
- package/dist/plugin/plugin-hook.d.ts.map +1 -0
- package/dist/plugin/plugin-hook.js +39 -0
- package/dist/plugin/plugin-hook.js.map +1 -0
- package/dist/plugin/plugin-manager.d.ts +22 -0
- package/dist/plugin/plugin-manager.d.ts.map +1 -0
- package/dist/plugin/plugin-manager.js +71 -0
- package/dist/plugin/plugin-manager.js.map +1 -0
- package/dist/plugin/plugin-schema.d.ts +6 -0
- package/dist/plugin/plugin-schema.d.ts.map +1 -0
- package/dist/plugin/plugin-schema.js +18 -0
- package/dist/plugin/plugin-schema.js.map +1 -0
- package/dist/prompt/define-prompt.d.ts +3 -0
- package/dist/prompt/define-prompt.d.ts.map +1 -0
- package/dist/prompt/define-prompt.js +17 -0
- package/dist/prompt/define-prompt.js.map +1 -0
- package/dist/prompt/index.d.ts +2 -0
- package/dist/prompt/index.d.ts.map +1 -0
- package/dist/prompt/index.js +4 -0
- package/dist/prompt/index.js.map +1 -0
- package/dist/resource/define-resource.d.ts +3 -0
- package/dist/resource/define-resource.d.ts.map +1 -0
- package/dist/resource/define-resource.js +19 -0
- package/dist/resource/define-resource.js.map +1 -0
- package/dist/resource/index.d.ts +3 -0
- package/dist/resource/index.d.ts.map +1 -0
- package/dist/resource/index.js +5 -0
- package/dist/resource/index.js.map +1 -0
- package/dist/resource/resource-template.d.ts +5 -0
- package/dist/resource/resource-template.d.ts.map +1 -0
- package/dist/resource/resource-template.js +17 -0
- package/dist/resource/resource-template.js.map +1 -0
- package/dist/server/define-server.d.ts +14 -0
- package/dist/server/define-server.d.ts.map +1 -0
- package/dist/server/define-server.js +175 -0
- package/dist/server/define-server.js.map +1 -0
- package/dist/server/index.d.ts +4 -0
- package/dist/server/index.d.ts.map +1 -0
- package/dist/server/index.js +6 -0
- package/dist/server/index.js.map +1 -0
- package/dist/server/lifecycle.d.ts +3 -0
- package/dist/server/lifecycle.d.ts.map +1 -0
- package/dist/server/lifecycle.js +32 -0
- package/dist/server/lifecycle.js.map +1 -0
- package/dist/server/server-runner.d.ts +42 -0
- package/dist/server/server-runner.d.ts.map +1 -0
- package/dist/server/server-runner.js +255 -0
- package/dist/server/server-runner.js.map +1 -0
- package/dist/storage/file-store.d.ts +25 -0
- package/dist/storage/file-store.d.ts.map +1 -0
- package/dist/storage/file-store.js +177 -0
- package/dist/storage/file-store.js.map +1 -0
- package/dist/storage/index.d.ts +4 -0
- package/dist/storage/index.d.ts.map +1 -0
- package/dist/storage/index.js +6 -0
- package/dist/storage/index.js.map +1 -0
- package/dist/storage/memory-store.d.ts +18 -0
- package/dist/storage/memory-store.d.ts.map +1 -0
- package/dist/storage/memory-store.js +80 -0
- package/dist/storage/memory-store.js.map +1 -0
- package/dist/storage/storage-adapter.d.ts +4 -0
- package/dist/storage/storage-adapter.d.ts.map +1 -0
- package/dist/storage/storage-adapter.js +32 -0
- package/dist/storage/storage-adapter.js.map +1 -0
- package/dist/telemetry/index.d.ts +3 -0
- package/dist/telemetry/index.d.ts.map +1 -0
- package/dist/telemetry/index.js +4 -0
- package/dist/telemetry/index.js.map +1 -0
- package/dist/telemetry/telemetry.d.ts +56 -0
- package/dist/telemetry/telemetry.d.ts.map +1 -0
- package/dist/telemetry/telemetry.js +95 -0
- package/dist/telemetry/telemetry.js.map +1 -0
- package/dist/tool/define-tool.d.ts +23 -0
- package/dist/tool/define-tool.d.ts.map +1 -0
- package/dist/tool/define-tool.js +28 -0
- package/dist/tool/define-tool.js.map +1 -0
- package/dist/tool/index.d.ts +5 -0
- package/dist/tool/index.d.ts.map +1 -0
- package/dist/tool/index.js +6 -0
- package/dist/tool/index.js.map +1 -0
- package/dist/tool/tool-result.d.ts +10 -0
- package/dist/tool/tool-result.d.ts.map +1 -0
- package/dist/tool/tool-result.js +34 -0
- package/dist/tool/tool-result.js.map +1 -0
- package/dist/tool/tool-schema.d.ts +7 -0
- package/dist/tool/tool-schema.d.ts.map +1 -0
- package/dist/tool/tool-schema.js +97 -0
- package/dist/tool/tool-schema.js.map +1 -0
- package/dist/transport/auto-detect.d.ts +4 -0
- package/dist/transport/auto-detect.d.ts.map +1 -0
- package/dist/transport/auto-detect.js +21 -0
- package/dist/transport/auto-detect.js.map +1 -0
- package/dist/transport/http-adapter.d.ts +4 -0
- package/dist/transport/http-adapter.d.ts.map +1 -0
- package/dist/transport/http-adapter.js +10 -0
- package/dist/transport/http-adapter.js.map +1 -0
- package/dist/transport/index.d.ts +5 -0
- package/dist/transport/index.d.ts.map +1 -0
- package/dist/transport/index.js +7 -0
- package/dist/transport/index.js.map +1 -0
- package/dist/transport/sse-adapter.d.ts +3 -0
- package/dist/transport/sse-adapter.d.ts.map +1 -0
- package/dist/transport/sse-adapter.js +8 -0
- package/dist/transport/sse-adapter.js.map +1 -0
- package/dist/transport/stdio-adapter.d.ts +3 -0
- package/dist/transport/stdio-adapter.d.ts.map +1 -0
- package/dist/transport/stdio-adapter.js +8 -0
- package/dist/transport/stdio-adapter.js.map +1 -0
- package/dist/types/config.d.ts +101 -0
- package/dist/types/config.d.ts.map +1 -0
- package/dist/types/config.js +5 -0
- package/dist/types/config.js.map +1 -0
- package/dist/types/index.d.ts +12 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +4 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/middleware.d.ts +48 -0
- package/dist/types/middleware.d.ts.map +1 -0
- package/dist/types/middleware.js +4 -0
- package/dist/types/middleware.js.map +1 -0
- package/dist/types/plugin-manifest.d.ts +59 -0
- package/dist/types/plugin-manifest.d.ts.map +1 -0
- package/dist/types/plugin-manifest.js +9 -0
- package/dist/types/plugin-manifest.js.map +1 -0
- package/dist/types/plugin.d.ts +50 -0
- package/dist/types/plugin.d.ts.map +1 -0
- package/dist/types/plugin.js +4 -0
- package/dist/types/plugin.js.map +1 -0
- package/dist/types/prompt.d.ts +21 -0
- package/dist/types/prompt.d.ts.map +1 -0
- package/dist/types/prompt.js +4 -0
- package/dist/types/prompt.js.map +1 -0
- package/dist/types/resource.d.ts +25 -0
- package/dist/types/resource.d.ts.map +1 -0
- package/dist/types/resource.js +4 -0
- package/dist/types/resource.js.map +1 -0
- package/dist/types/server.d.ts +54 -0
- package/dist/types/server.d.ts.map +1 -0
- package/dist/types/server.js +4 -0
- package/dist/types/server.js.map +1 -0
- package/dist/types/storage.d.ts +40 -0
- package/dist/types/storage.d.ts.map +1 -0
- package/dist/types/storage.js +4 -0
- package/dist/types/storage.js.map +1 -0
- package/dist/types/tool.d.ts +54 -0
- package/dist/types/tool.d.ts.map +1 -0
- package/dist/types/tool.js +4 -0
- package/dist/types/tool.js.map +1 -0
- package/dist/types/transport.d.ts +12 -0
- package/dist/types/transport.d.ts.map +1 -0
- package/dist/types/transport.js +4 -0
- package/dist/types/transport.js.map +1 -0
- 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 @@
|
|
|
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 @@
|
|
|
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 @@
|
|
|
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 @@
|
|
|
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 @@
|
|
|
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"}
|