@airmcp-dev/core 0.1.0

package/dist/plugin/builtin/metrics.js

@@ -0,0 +1,56 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/metrics.ts
+// 내장 메트릭 플러그인 — 호출 수, 에러율, 지연시간 자동 수집
+const metrics = new Map();
+export function getMetrics() {
+    const result = {};
+    for (const [name, m] of metrics) {
+        result[name] = {
+            ...m,
+            avgDuration: m.calls > 0 ? Math.round(m.totalDuration / m.calls) : 0,
+        };
+    }
+    return result;
+}
+export function resetMetrics() {
+    metrics.clear();
+}
+export function builtinMetricsPlugin() {
+    const mw = {
+        name: 'air:builtin-metrics',
+        after: async (ctx) => {
+            const m = metrics.get(ctx.tool.name) || {
+                calls: 0,
+                errors: 0,
+                totalDuration: 0,
+                lastCalledAt: 0,
+            };
+            m.calls++;
+            m.totalDuration += ctx.duration;
+            m.lastCalledAt = Date.now();
+            metrics.set(ctx.tool.name, m);
+        },
+        onError: async (ctx, _error) => {
+            const m = metrics.get(ctx.tool.name) || {
+                calls: 0,
+                errors: 0,
+                totalDuration: 0,
+                lastCalledAt: 0,
+            };
+            m.calls++;
+            m.errors++;
+            m.lastCalledAt = Date.now();
+            metrics.set(ctx.tool.name, m);
+            return undefined; // 에러를 먹지 않음
+        },
+    };
+    return {
+        meta: {
+            name: 'air:builtin-metrics',
+            version: '0.1.0',
+            description: 'Built-in metrics collection',
+        },
+        middleware: [mw],
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/plugin/builtin/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/plugin/builtin/metrics.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,+CAA+C;AAC/C,sCAAsC;AAYtC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;AAE9C,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,GAAG;YACb,GAAG,CAAC;YACJ,WAAW,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;SACrE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,MAAM,EAAE,GAAkB;QACxB,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACnB,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBACtC,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE,CAAC;gBACT,aAAa,EAAE,CAAC;gBAChB,YAAY,EAAE,CAAC;aAChB,CAAC;YACF,CAAC,CAAC,KAAK,EAAE,CAAC;YACV,CAAC,CAAC,aAAa,IAAI,GAAG,CAAC,QAAQ,CAAC;YAChC,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;YAC7B,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBACtC,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE,CAAC;gBACT,aAAa,EAAE,CAAC;gBAChB,YAAY,EAAE,CAAC;aAChB,CAAC;YACF,CAAC,CAAC,KAAK,EAAE,CAAC;YACV,CAAC,CAAC,MAAM,EAAE,CAAC;YACX,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC9B,OAAO,SAAS,CAAC,CAAC,YAAY;QAChC,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,6BAA6B;SAC3C;QACD,UAAU,EAAE,CAAC,EAAE,CAAC;KACjB,CAAC;AACJ,CAAC"}

package/dist/plugin/builtin/queue.d.ts

@@ -0,0 +1,12 @@
+import type { AirPlugin } from '../../types/plugin.js';
+interface QueueOptions {
+    /** 도구별 동시 실행 수 (기본: '*': 10) */
+    concurrency?: Record<string, number>;
+    /** 대기열 최대 크기 (기본: 100) */
+    maxQueueSize?: number;
+    /** 대기 타임아웃 ms (기본: 30000) */
+    queueTimeoutMs?: number;
+}
+export declare function queuePlugin(options?: QueueOptions): AirPlugin;
+export {};
+//# sourceMappingURL=queue.d.ts.map

package/dist/plugin/builtin/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/queue.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,UAAU,YAAY;IACpB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAQD,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CA0F7D"}

package/dist/plugin/builtin/queue.js

@@ -0,0 +1,98 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/queue.ts
+//
+// 동시성 제어 큐 플러그인.
+// 도구별로 동시 실행 수를 제한. 초과 시 대기열에 넣고 순차 처리.
+// DB 커넥션 풀, 외부 API 호출 제한 등에 사용.
+//
+// @example
+//   defineServer({
+//     use: [queuePlugin({
+//       concurrency: { 'db_query': 3, '*': 10 },
+//     })],
+//   });
+export function queuePlugin(options) {
+    const concurrencyMap = options?.concurrency ?? { '*': 10 };
+    const maxQueueSize = options?.maxQueueSize ?? 100;
+    const queueTimeoutMs = options?.queueTimeoutMs ?? 30_000;
+    const active = new Map();
+    const queues = new Map();
+    function getLimit(toolName) {
+        return concurrencyMap[toolName] ?? concurrencyMap['*'] ?? 10;
+    }
+    function getActive(toolName) {
+        return active.get(toolName) ?? 0;
+    }
+    function acquire(toolName) {
+        const limit = getLimit(toolName);
+        const current = getActive(toolName);
+        if (current < limit) {
+            active.set(toolName, current + 1);
+            return Promise.resolve();
+        }
+        // 대기열에 추가
+        const queue = queues.get(toolName) ?? [];
+        if (queue.length >= maxQueueSize) {
+            return Promise.reject(new Error(`[Queue] Queue full for "${toolName}" (max: ${maxQueueSize})`));
+        }
+        return new Promise((resolve, reject) => {
+            const entry = { resolve, reject, addedAt: Date.now() };
+            queue.push(entry);
+            queues.set(toolName, queue);
+            // 타임아웃
+            setTimeout(() => {
+                const idx = queue.indexOf(entry);
+                if (idx >= 0) {
+                    queue.splice(idx, 1);
+                    reject(new Error(`[Queue] Timeout waiting for "${toolName}" (${queueTimeoutMs}ms)`));
+                }
+            }, queueTimeoutMs);
+        });
+    }
+    function release(toolName) {
+        const current = getActive(toolName);
+        if (current <= 0)
+            return;
+        const queue = queues.get(toolName);
+        if (queue && queue.length > 0) {
+            // 대기 중인 요청을 깨움
+            const next = queue.shift();
+            next.resolve();
+        }
+        else {
+            active.set(toolName, current - 1);
+        }
+    }
+    const middleware = {
+        name: 'air:queue',
+        before: async (ctx) => {
+            try {
+                await acquire(ctx.tool.name);
+                ctx.meta._queued = true;
+            }
+            catch (err) {
+                return {
+                    abort: true,
+                    abortResponse: {
+                        content: [{ type: 'text', text: err.message }],
+                        isError: true,
+                    },
+                };
+            }
+        },
+        after: async (ctx) => {
+            if (ctx.meta._queued)
+                release(ctx.tool.name);
+        },
+        onError: async (ctx) => {
+            if (ctx.meta._queued)
+                release(ctx.tool.name);
+            return undefined;
+        },
+    };
+    return {
+        meta: { name: 'air:queue', version: '1.0.0' },
+        middleware: [middleware],
+    };
+}
+//# sourceMappingURL=queue.js.map

package/dist/plugin/builtin/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../src/plugin/builtin/queue.ts"],"names":[],"mappings":"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"}

package/dist/plugin/builtin/ratelimit-per-user.d.ts

@@ -0,0 +1,12 @@
+import type { AirPlugin } from '../../types/plugin.js';
+interface PerUserRateLimitOptions {
+    /** 윈도우 내 최대 호출 수 (기본: 10) */
+    maxCalls?: number;
+    /** 윈도우 크기 ms (기본: 60000) */
+    windowMs?: number;
+    /** 사용자 식별 파라미터 이름 (기본: '_userId') */
+    identifyBy?: string;
+}
+export declare function perUserRateLimitPlugin(options?: PerUserRateLimitOptions): AirPlugin;
+export {};
+//# sourceMappingURL=ratelimit-per-user.d.ts.map

package/dist/plugin/builtin/ratelimit-per-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratelimit-per-user.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/ratelimit-per-user.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,UAAU,uBAAuB;IAC/B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAiCnF"}

package/dist/plugin/builtin/ratelimit-per-user.js

@@ -0,0 +1,45 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/ratelimit-per-user.ts
+//
+// 사용자별 레이트 리밋 플러그인.
+// shield의 글로벌 레이트 리밋과 달리, 사용자/세션별 개별 추적.
+//
+// @example
+//   defineServer({
+//     use: [perUserRateLimitPlugin({
+//       maxCalls: 10,
+//       windowMs: 60_000,
+//       identifyBy: '_userId',
+//     })],
+//   });
+export function perUserRateLimitPlugin(options) {
+    const maxCalls = options?.maxCalls ?? 10;
+    const windowMs = options?.windowMs ?? 60_000;
+    const identifyBy = options?.identifyBy ?? '_userId';
+    const windows = new Map();
+    const middleware = {
+        name: 'air:per-user-ratelimit',
+        before: async (ctx) => {
+            const userId = ctx.params[identifyBy] || 'anonymous';
+            const now = Date.now();
+            const key = `${userId}:${ctx.tool.name}`;
+            const timestamps = (windows.get(key) || []).filter((t) => t > now - windowMs);
+            if (timestamps.length >= maxCalls) {
+                return {
+                    abort: true,
+                    abortResponse: {
+                        content: [{ type: 'text', text: `[RateLimit] User "${userId}" exceeded ${maxCalls} calls per ${windowMs / 1000}s for "${ctx.tool.name}".` }],
+                        isError: true,
+                    },
+                };
+            }
+            timestamps.push(now);
+            windows.set(key, timestamps);
+        },
+    };
+    return {
+        meta: { name: 'air:per-user-ratelimit', version: '1.0.0' },
+        middleware: [middleware],
+    };
+}
+//# sourceMappingURL=ratelimit-per-user.js.map

package/dist/plugin/builtin/ratelimit-per-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratelimit-per-user.js","sourceRoot":"","sources":["../../../src/plugin/builtin/ratelimit-per-user.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,0DAA0D;AAC1D,EAAE;AACF,oBAAoB;AACpB,yCAAyC;AACzC,EAAE;AACF,WAAW;AACX,mBAAmB;AACnB,qCAAqC;AACrC,sBAAsB;AACtB,0BAA0B;AAC1B,+BAA+B;AAC/B,WAAW;AACX,QAAQ;AAcR,MAAM,UAAU,sBAAsB,CAAC,OAAiC;IACtE,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,MAAM,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,SAAS,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE5C,MAAM,UAAU,GAAkB;QAChC,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpB,MAAM,MAAM,GAAI,GAAG,CAAC,MAAM,CAAC,UAAU,CAAY,IAAI,WAAW,CAAC;YACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACzC,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,QAAQ,CAAC,CAAC;YAE9E,IAAI,UAAU,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAClC,OAAO;oBACL,KAAK,EAAE,IAAI;oBACX,aAAa,EAAE;wBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,MAAM,cAAc,QAAQ,cAAc,QAAQ,GAAG,IAAI,UAAU,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;wBAC5I,OAAO,EAAE,IAAI;qBACd;iBACF,CAAC;YACJ,CAAC;YAED,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC/B,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,OAAO,EAAE;QAC1D,UAAU,EAAE,CAAC,UAAU,CAAC;KACzB,CAAC;AACJ,CAAC"}

package/dist/plugin/builtin/retry.d.ts

@@ -0,0 +1,12 @@
+import type { AirPlugin } from '../../types/plugin.js';
+interface RetryOptions {
+    /** 최대 재시도 횟수 (기본: 3) */
+    maxRetries?: number;
+    /** 초기 대기 시간 ms (기본: 200) */
+    delayMs?: number;
+    /** 재시도할 에러 패턴 (기본: 전부) */
+    retryOn?: (error: Error) => boolean;
+}
+export declare function retryPlugin(options?: RetryOptions): AirPlugin;
+export {};
+//# sourceMappingURL=retry.d.ts.map

package/dist/plugin/builtin/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/retry.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,UAAU,YAAY;IACpB,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;CACrC;AAED,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CA4C7D"}

package/dist/plugin/builtin/retry.js

@@ -0,0 +1,51 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/retry.ts
+//
+// 도구 실행 재시도 플러그인.
+// 핸들러에서 에러가 발생하면 지정 횟수만큼 재시도.
+// 지수 백오프(exponential backoff) 적용.
+//
+// @example
+//   defineServer({
+//     use: [retryPlugin({ maxRetries: 3, delayMs: 200 })],
+//   });
+export function retryPlugin(options) {
+    const maxRetries = options?.maxRetries ?? 3;
+    const baseDelay = options?.delayMs ?? 200;
+    const retryOn = options?.retryOn ?? (() => true);
+    const middleware = {
+        name: 'air:retry',
+        onError: async (ctx, error) => {
+            if (!retryOn(error))
+                return undefined;
+            const retryCount = (ctx.meta._retryCount || 0);
+            if (retryCount >= maxRetries)
+                return undefined; // 재시도 초과
+            ctx.meta._retryCount = retryCount + 1;
+            const delay = baseDelay * Math.pow(2, retryCount);
+            console.warn(`[air:retry] ${ctx.tool.name} failed (attempt ${retryCount + 1}/${maxRetries}), retrying in ${delay}ms...`);
+            await new Promise((r) => setTimeout(r, delay));
+            // 핸들러 재실행
+            try {
+                const result = await ctx.tool.handler(ctx.params, {
+                    requestId: ctx.requestId,
+                    serverName: ctx.serverName,
+                    startedAt: ctx.startedAt,
+                    state: {},
+                });
+                return result;
+            }
+            catch (retryError) {
+                if (ctx.meta._retryCount < maxRetries) {
+                    return undefined; // 다음 onError 미들웨어에서 다시 시도
+                }
+                return undefined;
+            }
+        },
+    };
+    return {
+        meta: { name: 'air:retry', version: '1.0.0' },
+        middleware: [middleware],
+    };
+}
+//# sourceMappingURL=retry.js.map

package/dist/plugin/builtin/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/plugin/builtin/retry.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,6CAA6C;AAC7C,EAAE;AACF,kBAAkB;AAClB,8BAA8B;AAC9B,kCAAkC;AAClC,EAAE;AACF,WAAW;AACX,mBAAmB;AACnB,2DAA2D;AAC3D,QAAQ;AAcR,MAAM,UAAU,WAAW,CAAC,OAAsB;IAChD,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,OAAO,EAAE,OAAO,IAAI,GAAG,CAAC;IAC1C,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAEjD,MAAM,UAAU,GAAkB;QAChC,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YAC5B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAC;YAEtC,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,CAAW,CAAC;YACzD,IAAI,UAAU,IAAI,UAAU;gBAAE,OAAO,SAAS,CAAC,CAAC,SAAS;YAEzD,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,UAAU,GAAG,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YAElD,OAAO,CAAC,IAAI,CACV,eAAe,GAAG,CAAC,IAAI,CAAC,IAAI,oBAAoB,UAAU,GAAG,CAAC,IAAI,UAAU,kBAAkB,KAAK,OAAO,CAC3G,CAAC;YAEF,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;YAE/C,UAAU;YACV,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;oBAChD,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,KAAK,EAAE,EAAE;iBACV,CAAC,CAAC;gBACH,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,UAAU,EAAE,CAAC;gBACpB,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,UAAU,EAAE,CAAC;oBACtC,OAAO,SAAS,CAAC,CAAC,0BAA0B;gBAC9C,CAAC;gBACD,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE;QAC7C,UAAU,EAAE,CAAC,UAAU,CAAC;KACzB,CAAC;AACJ,CAAC"}

package/dist/plugin/builtin/sanitizer.d.ts

@@ -0,0 +1,14 @@
+import type { AirPlugin } from '../../types/plugin.js';
+interface SanitizerOptions {
+    /** HTML 태그 제거 (기본: true) */
+    stripHtml?: boolean;
+    /** 제어 문자 제거 (기본: true) */
+    stripControl?: boolean;
+    /** 최대 문자열 길이 (기본: 10000) */
+    maxStringLength?: number;
+    /** 적용 제외 도구 */
+    exclude?: string[];
+}
+export declare function sanitizerPlugin(options?: SanitizerOptions): AirPlugin;
+export {};
+//# sourceMappingURL=sanitizer.d.ts.map

package/dist/plugin/builtin/sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizer.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/sanitizer.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,UAAU,gBAAgB;IACxB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4BAA4B;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAqBD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAuBrE"}

package/dist/plugin/builtin/sanitizer.js

@@ -0,0 +1,55 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/sanitizer.ts
+//
+// 입력 데이터 정제 플러그인.
+// XSS, HTML 태그, 제어 문자를 자동으로 제거.
+//
+// @example
+//   defineServer({
+//     use: [sanitizerPlugin()],
+//   });
+function sanitizeValue(value, opts) {
+    if (typeof value === 'string') {
+        let s = value;
+        if (opts.stripHtml)
+            s = s.replace(/<[^>]*>/g, '');
+        if (opts.stripControl)
+            s = s.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '');
+        if (s.length > opts.maxStringLength)
+            s = s.slice(0, opts.maxStringLength);
+        return s;
+    }
+    if (Array.isArray(value))
+        return value.map((v) => sanitizeValue(v, opts));
+    if (value && typeof value === 'object') {
+        const cleaned = {};
+        for (const [k, v] of Object.entries(value)) {
+            cleaned[k] = sanitizeValue(v, opts);
+        }
+        return cleaned;
+    }
+    return value;
+}
+export function sanitizerPlugin(options) {
+    const opts = {
+        stripHtml: options?.stripHtml !== false,
+        stripControl: options?.stripControl !== false,
+        maxStringLength: options?.maxStringLength ?? 10_000,
+        exclude: options?.exclude || [],
+    };
+    const excludeSet = new Set(opts.exclude);
+    const middleware = {
+        name: 'air:sanitizer',
+        before: async (ctx) => {
+            if (excludeSet.has(ctx.tool.name))
+                return;
+            const cleaned = sanitizeValue(ctx.params, opts);
+            return { params: cleaned };
+        },
+    };
+    return {
+        meta: { name: 'air:sanitizer', version: '1.0.0' },
+        middleware: [middleware],
+    };
+}
+//# sourceMappingURL=sanitizer.js.map

package/dist/plugin/builtin/sanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizer.js","sourceRoot":"","sources":["../../../src/plugin/builtin/sanitizer.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,iDAAiD;AACjD,EAAE;AACF,kBAAkB;AAClB,gCAAgC;AAChC,EAAE;AACF,WAAW;AACX,mBAAmB;AACnB,gCAAgC;AAChC,QAAQ;AAgBR,SAAS,aAAa,CAAC,KAAU,EAAE,IAAgC;IACjE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,KAAK,CAAC;QACd,IAAI,IAAI,CAAC,SAAS;YAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI,IAAI,CAAC,YAAY;YAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,eAAe;YAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1E,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1E,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,OAAO,GAAwB,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA0B;IACxD,MAAM,IAAI,GAAG;QACX,SAAS,EAAE,OAAO,EAAE,SAAS,KAAK,KAAK;QACvC,YAAY,EAAE,OAAO,EAAE,YAAY,KAAK,KAAK;QAC7C,eAAe,EAAE,OAAO,EAAE,eAAe,IAAI,MAAM;QACnD,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE;KAChC,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEzC,MAAM,UAAU,GAAkB;QAChC,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpB,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO;YAC1C,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAChD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC7B,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE;QACjD,UAAU,EAAE,CAAC,UAAU,CAAC;KACzB,CAAC;AACJ,CAAC"}

package/dist/plugin/builtin/timeout.d.ts

@@ -0,0 +1,3 @@
+import type { AirPlugin } from '../../types/plugin.js';
+export declare function timeoutPlugin(timeoutMs?: number): AirPlugin;
+//# sourceMappingURL=timeout.d.ts.map

package/dist/plugin/builtin/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/timeout.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,wBAAgB,aAAa,CAAC,SAAS,GAAE,MAAe,GAAG,SAAS,CAqBnE"}

package/dist/plugin/builtin/timeout.js

@@ -0,0 +1,30 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/timeout.ts
+//
+// 도구 실행 타임아웃 플러그인.
+// 지정 시간 내에 핸들러가 완료되지 않으면 자동으로 에러를 반환.
+//
+// @example
+//   defineServer({
+//     use: [timeoutPlugin(5000)],  // 5초 타임아웃
+//   });
+export function timeoutPlugin(timeoutMs = 30_000) {
+    const middleware = {
+        name: 'air:timeout',
+        before: async (ctx) => {
+            ctx.meta._timeoutMs = timeoutMs;
+            ctx.meta._timeoutStart = Date.now();
+        },
+        after: async (ctx) => {
+            const elapsed = Date.now() - (ctx.meta._timeoutStart || ctx.startedAt);
+            if (elapsed > timeoutMs) {
+                console.warn(`[air:timeout] ${ctx.tool.name} took ${elapsed}ms (limit: ${timeoutMs}ms)`);
+            }
+        },
+    };
+    return {
+        meta: { name: 'air:timeout', version: '1.0.0' },
+        middleware: [middleware],
+    };
+}
+//# sourceMappingURL=timeout.js.map

package/dist/plugin/builtin/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../../src/plugin/builtin/timeout.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,+CAA+C;AAC/C,EAAE;AACF,mBAAmB;AACnB,sCAAsC;AACtC,EAAE;AACF,WAAW;AACX,mBAAmB;AACnB,8CAA8C;AAC9C,QAAQ;AAKR,MAAM,UAAU,aAAa,CAAC,YAAoB,MAAM;IACtD,MAAM,UAAU,GAAkB;QAChC,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpB,GAAG,CAAC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;YAChC,GAAG,CAAC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtC,CAAC;QACD,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;YACvE,IAAI,OAAO,GAAG,SAAS,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,CACV,iBAAiB,GAAG,CAAC,IAAI,CAAC,IAAI,SAAS,OAAO,cAAc,SAAS,KAAK,CAC3E,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE;QAC/C,UAAU,EAAE,CAAC,UAAU,CAAC;KACzB,CAAC;AACJ,CAAC"}

package/dist/plugin/builtin/transform.d.ts

@@ -0,0 +1,11 @@
+import type { AirPlugin } from '../../types/plugin.js';
+type TransformFn = (data: any) => any;
+interface TransformOptions {
+    /** 입력 파라미터 변환 (도구명 → 변환 함수, '*'는 전체 적용) */
+    before?: Record<string, TransformFn>;
+    /** 출력 결과 변환 */
+    after?: Record<string, TransformFn>;
+}
+export declare function transformPlugin(options: TransformOptions): AirPlugin;
+export {};
+//# sourceMappingURL=transform.d.ts.map

package/dist/plugin/builtin/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/transform.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC;AAEtC,UAAU,gBAAgB;IACxB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAoCpE"}

package/dist/plugin/builtin/transform.js

@@ -0,0 +1,51 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/transform.ts
+//
+// 도구 입출력 변환 플러그인.
+// 파라미터 전처리, 응답 후처리를 선언적으로 등록.
+//
+// @example
+//   defineServer({
+//     use: [transformPlugin({
+//       before: {
+//         '*': (params) => ({ ...params, _caller: 'air' }),
+//         'search': (params) => ({ ...params, query: params.query.trim() }),
+//       },
+//       after: {
+//         '*': (result) => ({ ...result, _processedAt: new Date().toISOString() }),
+//       },
+//     })],
+//   });
+export function transformPlugin(options) {
+    const beforeMap = options.before || {};
+    const afterMap = options.after || {};
+    const middleware = {
+        name: 'air:transform',
+        before: async (ctx) => {
+            const toolName = ctx.tool.name;
+            // 글로벌 변환
+            if (beforeMap['*']) {
+                ctx.params = beforeMap['*'](ctx.params);
+            }
+            // 도구별 변환
+            if (beforeMap[toolName]) {
+                ctx.params = beforeMap[toolName](ctx.params);
+            }
+            return { params: ctx.params };
+        },
+        after: async (ctx) => {
+            const toolName = ctx.tool.name;
+            if (afterMap['*']) {
+                ctx.result = afterMap['*'](ctx.result);
+            }
+            if (afterMap[toolName]) {
+                ctx.result = afterMap[toolName](ctx.result);
+            }
+        },
+    };
+    return {
+        meta: { name: 'air:transform', version: '1.0.0' },
+        middleware: [middleware],
+    };
+}
+//# sourceMappingURL=transform.js.map

package/dist/plugin/builtin/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../src/plugin/builtin/transform.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,iDAAiD;AACjD,EAAE;AACF,kBAAkB;AAClB,8BAA8B;AAC9B,EAAE;AACF,WAAW;AACX,mBAAmB;AACnB,8BAA8B;AAC9B,kBAAkB;AAClB,4DAA4D;AAC5D,6EAA6E;AAC7E,WAAW;AACX,iBAAiB;AACjB,oFAAoF;AACpF,WAAW;AACX,WAAW;AACX,QAAQ;AAcR,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IAErC,MAAM,UAAU,GAAkB;QAChC,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpB,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAE/B,SAAS;YACT,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnB,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC1C,CAAC;YACD,SAAS;YACT,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACxB,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC/C,CAAC;YAED,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;QAChC,CAAC;QACD,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACnB,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAE/B,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClB,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACzC,CAAC;YACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvB,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE;QACjD,UAAU,EAAE,CAAC,UAAU,CAAC;KACzB,CAAC;AACJ,CAAC"}

package/dist/plugin/builtin/validator.d.ts

@@ -0,0 +1,9 @@
+import type { AirPlugin } from '../../types/plugin.js';
+type ValidationRule = (params: Record<string, any>) => string | null;
+interface ValidatorOptions {
+    /** 도구별 검증 규칙 */
+    rules: Record<string, ValidationRule>;
+}
+export declare function validatorPlugin(options: ValidatorOptions): AirPlugin;
+export {};
+//# sourceMappingURL=validator.d.ts.map

package/dist/plugin/builtin/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/validator.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,KAAK,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM,GAAG,IAAI,CAAC;AAErE,UAAU,gBAAgB;IACxB,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACvC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAwBpE"}

package/dist/plugin/builtin/validator.js

@@ -0,0 +1,43 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/validator.ts
+//
+// 커스텀 검증 플러그인.
+// zod 스키마 외에 비즈니스 로직 검증을 추가.
+// 도구별로 검증 규칙을 등록할 수 있다.
+//
+// @example
+//   defineServer({
+//     use: [validatorPlugin({
+//       rules: {
+//         'transfer': (params) => {
+//           if (params.amount > 10000) return 'Amount exceeds limit';
+//           return null; // OK
+//         },
+//       },
+//     })],
+//   });
+export function validatorPlugin(options) {
+    const middleware = {
+        name: 'air:validator',
+        before: async (ctx) => {
+            const rule = options.rules[ctx.tool.name];
+            if (!rule)
+                return;
+            const error = rule(ctx.params);
+            if (error) {
+                return {
+                    abort: true,
+                    abortResponse: {
+                        content: [{ type: 'text', text: `[Validator] ${ctx.tool.name}: ${error}` }],
+                        isError: true,
+                    },
+                };
+            }
+        },
+    };
+    return {
+        meta: { name: 'air:validator', version: '1.0.0' },
+        middleware: [middleware],
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/plugin/builtin/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../../src/plugin/builtin/validator.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,iDAAiD;AACjD,EAAE;AACF,eAAe;AACf,6BAA6B;AAC7B,wBAAwB;AACxB,EAAE;AACF,WAAW;AACX,mBAAmB;AACnB,8BAA8B;AAC9B,iBAAiB;AACjB,oCAAoC;AACpC,sEAAsE;AACtE,+BAA+B;AAC/B,aAAa;AACb,WAAW;AACX,WAAW;AACX,QAAQ;AAYR,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,UAAU,GAAkB;QAChC,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,CAAC,IAAI;gBAAE,OAAO;YAElB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO;oBACL,KAAK,EAAE,IAAI;oBACX,aAAa,EAAE;wBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;wBAC3E,OAAO,EAAE,IAAI;qBACd;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE;QACjD,UAAU,EAAE,CAAC,UAAU,CAAC;KACzB,CAAC;AACJ,CAAC"}

package/dist/plugin/builtin/webhook.d.ts

@@ -0,0 +1,16 @@
+import type { AirPlugin } from '../../types/plugin.js';
+interface WebhookOptions {
+    /** 웹훅 URL */
+    url: string;
+    /** 전송할 이벤트 타입 (기본: ['tool.call']) */
+    events?: Array<'tool.call' | 'tool.error' | 'tool.slow'>;
+    /** 느린 호출 기준 ms (기본: 5000) */
+    slowThresholdMs?: number;
+    /** 요청 헤더 */
+    headers?: Record<string, string>;
+    /** 배치 크기 (기본: 1, 즉시 전송) */
+    batchSize?: number;
+}
+export declare function webhookPlugin(options: WebhookOptions): AirPlugin;
+export {};
+//# sourceMappingURL=webhook.d.ts.map

package/dist/plugin/builtin/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/webhook.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,UAAU,cAAc;IACtB,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,MAAM,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,YAAY,GAAG,WAAW,CAAC,CAAC;IACzD,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAiEhE"}