@airmcp-dev/core 0.1.0

package/dist/plugin/builtin/circuit-breaker.d.ts

@@ -0,0 +1,12 @@
+import type { AirPlugin } from '../../types/plugin.js';
+interface CircuitBreakerOptions {
+    /** 연속 실패 임계값 (기본: 5) */
+    failureThreshold?: number;
+    /** 서킷 오픈 후 반개방까지 대기 시간 ms (기본: 30000) */
+    resetTimeoutMs?: number;
+    /** 도구별 개별 서킷 (기본: true) */
+    perTool?: boolean;
+}
+export declare function circuitBreakerPlugin(options?: CircuitBreakerOptions): AirPlugin;
+export {};
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/plugin/builtin/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/circuit-breaker.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAKvD,UAAU,qBAAqB;IAC7B,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAQD,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAmE/E"}

package/dist/plugin/builtin/circuit-breaker.js

@@ -0,0 +1,76 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/circuit-breaker.ts
+//
+// 서킷 브레이커 플러그인.
+// 연속 에러가 임계값을 넘으면 도구 호출을 차단(open).
+// 일정 시간 후 반개방(half-open)으로 전환하여 재시도.
+//
+// @example
+//   defineServer({
+//     use: [circuitBreakerPlugin({
+//       failureThreshold: 5,
+//       resetTimeoutMs: 30_000,
+//     })],
+//   });
+export function circuitBreakerPlugin(options) {
+    const threshold = options?.failureThreshold ?? 5;
+    const resetTimeout = options?.resetTimeoutMs ?? 30_000;
+    const perTool = options?.perTool !== false;
+    const circuits = new Map();
+    function getCircuit(key) {
+        if (!circuits.has(key)) {
+            circuits.set(key, { state: 'closed', failures: 0, lastFailureAt: 0 });
+        }
+        return circuits.get(key);
+    }
+    const middleware = {
+        name: 'air:circuit-breaker',
+        before: async (ctx) => {
+            const key = perTool ? ctx.tool.name : '_global';
+            const circuit = getCircuit(key);
+            // 반개방 전환 체크
+            if (circuit.state === 'open') {
+                if (Date.now() - circuit.lastFailureAt > resetTimeout) {
+                    circuit.state = 'half-open';
+                }
+                else {
+                    return {
+                        abort: true,
+                        abortResponse: {
+                            content: [{ type: 'text', text: `[CircuitBreaker] "${ctx.tool.name}" is temporarily unavailable (circuit open). Retry in ${Math.ceil((resetTimeout - (Date.now() - circuit.lastFailureAt)) / 1000)}s.` }],
+                            isError: true,
+                        },
+                    };
+                }
+            }
+            ctx.meta._circuitKey = key;
+        },
+        after: async (ctx) => {
+            const key = ctx.meta._circuitKey;
+            if (!key)
+                return;
+            const circuit = getCircuit(key);
+            // 성공하면 서킷 리셋
+            circuit.state = 'closed';
+            circuit.failures = 0;
+        },
+        onError: async (ctx, error) => {
+            const key = ctx.meta._circuitKey;
+            if (!key)
+                return undefined;
+            const circuit = getCircuit(key);
+            circuit.failures++;
+            circuit.lastFailureAt = Date.now();
+            if (circuit.failures >= threshold) {
+                circuit.state = 'open';
+                console.warn(`[air:circuit-breaker] "${ctx.tool.name}" circuit OPEN after ${circuit.failures} failures`);
+            }
+            return undefined; // 에러는 다음 핸들러에 위임
+        },
+    };
+    return {
+        meta: { name: 'air:circuit-breaker', version: '1.0.0' },
+        middleware: [middleware],
+    };
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/plugin/builtin/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../../src/plugin/builtin/circuit-breaker.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,uDAAuD;AACvD,EAAE;AACF,gBAAgB;AAChB,mCAAmC;AACnC,qCAAqC;AACrC,EAAE;AACF,WAAW;AACX,mBAAmB;AACnB,mCAAmC;AACnC,6BAA6B;AAC7B,gCAAgC;AAChC,WAAW;AACX,QAAQ;AAsBR,MAAM,UAAU,oBAAoB,CAAC,OAA+B;IAClE,MAAM,SAAS,GAAG,OAAO,EAAE,gBAAgB,IAAI,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,OAAO,EAAE,cAAc,IAAI,MAAM,CAAC;IACvD,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,KAAK,KAAK,CAAC;IAE3C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEhD,SAAS,UAAU,CAAC,GAAW;QAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IAC5B,CAAC;IAED,MAAM,UAAU,GAAkB;QAChC,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpB,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YAChD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YAEhC,YAAY;YACZ,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;gBAC7B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,aAAa,GAAG,YAAY,EAAE,CAAC;oBACtD,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC;gBAC9B,CAAC;qBAAM,CAAC;oBACN,OAAO;wBACL,KAAK,EAAE,IAAI;wBACX,aAAa,EAAE;4BACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,CAAC,IAAI,CAAC,IAAI,yDAAyD,IAAI,CAAC,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;4BACzM,OAAO,EAAE,IAAI;yBACd;qBACF,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;QAC7B,CAAC;QACD,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACnB,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,WAAqB,CAAC;YAC3C,IAAI,CAAC,GAAG;gBAAE,OAAO;YAEjB,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YAChC,aAAa;YACb,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;YACzB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,WAAqB,CAAC;YAC3C,IAAI,CAAC,GAAG;gBAAE,OAAO,SAAS,CAAC;YAE3B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YAChC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAEnC,IAAI,OAAO,CAAC,QAAQ,IAAI,SAAS,EAAE,CAAC;gBAClC,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,0BAA0B,GAAG,CAAC,IAAI,CAAC,IAAI,wBAAwB,OAAO,CAAC,QAAQ,WAAW,CAAC,CAAC;YAC3G,CAAC;YAED,OAAO,SAAS,CAAC,CAAC,iBAAiB;QACrC,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,OAAO,EAAE;QACvD,UAAU,EAAE,CAAC,UAAU,CAAC;KACzB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { AirPlugin } from '../../types/plugin.js';
+interface CorsOptions {
+    /** 허용 origin (기본: '*') */
+    origins?: string[];
+    /** 허용 메서드 */
+    methods?: string[];
+    /** 허용 헤더 */
+    headers?: string[];
+}
+export declare function corsPlugin(options?: CorsOptions): AirPlugin;
+export {};
+//# sourceMappingURL=cors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cors.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/cors.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,UAAU,WAAW;IACnB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY;IACZ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAiB3D"}

package/dist/plugin/builtin/cors.js

@@ -0,0 +1,29 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/cors.ts
+//
+// CORS 헤더 플러그인.
+// HTTP/SSE transport 사용 시 브라우저에서 접근 가능하게 CORS를 설정.
+// 서버 상태에 CORS 설정을 저장하여 HTTP 핸들러에서 참조.
+//
+// @example
+//   defineServer({
+//     use: [corsPlugin({ origins: ['http://localhost:3000'] })],
+//   });
+export function corsPlugin(options) {
+    const origins = options?.origins || ['*'];
+    const methods = options?.methods || ['GET', 'POST', 'OPTIONS', 'DELETE'];
+    const headers = options?.headers || ['Content-Type', 'Accept', 'Mcp-Session-Id'];
+    return {
+        meta: { name: 'air:cors', version: '1.0.0' },
+        hooks: {
+            onInit: async (ctx) => {
+                ctx.state._cors = {
+                    origins,
+                    methods: methods.join(', '),
+                    headers: headers.join(', '),
+                };
+            },
+        },
+    };
+}
+//# sourceMappingURL=cors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cors.js","sourceRoot":"","sources":["../../../src/plugin/builtin/cors.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,4CAA4C;AAC5C,EAAE;AACF,gBAAgB;AAChB,mDAAmD;AACnD,sCAAsC;AACtC,EAAE;AACF,WAAW;AACX,mBAAmB;AACnB,iEAAiE;AACjE,QAAQ;AAaR,MAAM,UAAU,UAAU,CAAC,OAAqB;IAC9C,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,CAAC,cAAc,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAEjF,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE;QAC5C,KAAK,EAAE;YACL,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBACpB,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG;oBAChB,OAAO;oBACP,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;oBAC3B,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;iBAC5B,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { AirPlugin } from '../../types/plugin.js';
+interface DedupOptions {
+    /** 중복 제거 윈도우 ms (기본: 1000) */
+    windowMs?: number;
+}
+export declare function dedupPlugin(options?: DedupOptions): AirPlugin;
+export {};
+//# sourceMappingURL=dedup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/dedup.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,UAAU,YAAY;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAwD7D"}

package/dist/plugin/builtin/dedup.js

@@ -0,0 +1,64 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/dedup.ts
+//
+// 중복 호출 방지 플러그인.
+// 같은 파라미터로 동시에 여러 호출이 오면 하나만 실행하고 나머지는 같은 결과를 공유.
+// (Request Deduplication / Coalescing)
+//
+// @example
+//   defineServer({
+//     use: [dedupPlugin()],
+//   });
+export function dedupPlugin(options) {
+    const windowMs = options?.windowMs ?? 1000;
+    const inflight = new Map();
+    function makeKey(toolName, params) {
+        return `${toolName}:${JSON.stringify(params, Object.keys(params).sort())}`;
+    }
+    // 주기적으로 만료된 항목 정리
+    setInterval(() => {
+        const now = Date.now();
+        for (const [key, entry] of inflight.entries()) {
+            if (now - entry.timestamp > windowMs * 2)
+                inflight.delete(key);
+        }
+    }, windowMs * 5);
+    const middleware = {
+        name: 'air:dedup',
+        before: async (ctx) => {
+            const key = makeKey(ctx.tool.name, ctx.params);
+            const existing = inflight.get(key);
+            if (existing && Date.now() - existing.timestamp < windowMs) {
+                // 동일 호출이 진행 중 — 결과를 공유
+                const result = await existing.promise;
+                ctx.meta._deduped = true;
+                return {
+                    abort: true,
+                    abortResponse: result,
+                };
+            }
+            // 새 호출 — inflight에 등록 (promise는 after에서 resolve)
+            let resolveInflight;
+            const promise = new Promise((r) => { resolveInflight = r; });
+            inflight.set(key, { promise, timestamp: Date.now() });
+            ctx.meta._dedupKey = key;
+            ctx.meta._dedupResolve = resolveInflight;
+        },
+        after: async (ctx) => {
+            if (ctx.meta._deduped)
+                return;
+            const key = ctx.meta._dedupKey;
+            const resolve = ctx.meta._dedupResolve;
+            if (key && resolve) {
+                resolve(ctx.result);
+                // 짧은 시간 유지 후 삭제
+                setTimeout(() => inflight.delete(key), windowMs);
+            }
+        },
+    };
+    return {
+        meta: { name: 'air:dedup', version: '1.0.0' },
+        middleware: [middleware],
+    };
+}
+//# sourceMappingURL=dedup.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { AirPlugin } from '../../types/plugin.js';
+interface DryrunOptions {
+    /** 드라이런 활성화 (기본: false) */
+    enabled?: boolean;
+    /** 파라미터에 _dryrun=true 가 있으면 해당 호출만 드라이런 */
+    perCall?: boolean;
+    /** 커스텀 드라이런 응답 생성기 */
+    mockResponse?: (toolName: string, params: Record<string, any>) => any;
+}
+export declare function dryrunPlugin(options?: DryrunOptions): AirPlugin;
+export {};
+//# sourceMappingURL=dryrun.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dryrun.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/dryrun.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,UAAU,aAAa;IACrB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sBAAsB;IACtB,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC;CACvE;AAED,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CA2C/D"}

package/dist/plugin/builtin/dryrun.js

@@ -0,0 +1,61 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/dryrun.ts
+//
+// 드라이런 플러그인.
+// 실제 핸들러를 실행하지 않고 파라미터 검증 + 예상 결과만 반환.
+// 테스트, CI, 스키마 검증에 사용.
+//
+// 사용 방법:
+//   1. 전역 모드: dryrunPlugin({ enabled: true }) — 모든 호출을 드라이런
+//   2. 환경변수: dryrunPlugin({ enabled: process.env.DRY_RUN === 'true' })
+//   3. callTool API: server.callTool('name', { _dryrun: true }) — MCP 프로토콜 우회 시
+//
+// NOTE: MCP SDK가 스키마에 없는 파라미터를 제거하기 때문에
+// perCall 모드는 MCP 프로토콜 경유(클라이언트→서버) 시 동작하지 않음.
+// server.callTool() 직접 호출 시에만 perCall이 동작.
+//
+// @example
+//   defineServer({
+//     use: [dryrunPlugin({ enabled: process.env.DRY_RUN === 'true' })],
+//   });
+export function dryrunPlugin(options) {
+    const globalEnabled = options?.enabled ?? false;
+    const perCall = options?.perCall ?? true;
+    const mockFn = options?.mockResponse;
+    const middleware = {
+        name: 'air:dryrun',
+        before: async (ctx) => {
+            const isDryrun = globalEnabled || (perCall && (ctx.params._dryrun === true || ctx.params._dryrun === 'true'));
+            if (!isDryrun)
+                return;
+            // _dryrun 파라미터 제거
+            const { _dryrun, ...cleanParams } = ctx.params;
+            const response = mockFn
+                ? mockFn(ctx.tool.name, cleanParams)
+                : {
+                    dryrun: true,
+                    tool: ctx.tool.name,
+                    params: cleanParams,
+                    description: ctx.tool.description,
+                    schema: ctx.tool.params
+                        ? Object.entries(ctx.tool.params).map(([k, v]) => ({
+                            name: k,
+                            type: typeof v === 'string' ? v : v.type || 'any',
+                            provided: k in cleanParams,
+                            value: cleanParams[k] ?? null,
+                        }))
+                        : [],
+                    message: `[Dryrun] "${ctx.tool.name}" would be called with: ${JSON.stringify(cleanParams)}`,
+                };
+            return {
+                abort: true,
+                abortResponse: typeof response === 'string' ? response : JSON.stringify(response, null, 2),
+            };
+        },
+    };
+    return {
+        meta: { name: 'air:dryrun', version: '1.0.0' },
+        middleware: [middleware],
+    };
+}
+//# sourceMappingURL=dryrun.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dryrun.js","sourceRoot":"","sources":["../../../src/plugin/builtin/dryrun.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,8CAA8C;AAC9C,EAAE;AACF,aAAa;AACb,uCAAuC;AACvC,uBAAuB;AACvB,EAAE;AACF,SAAS;AACT,4DAA4D;AAC5D,uEAAuE;AACvE,gFAAgF;AAChF,EAAE;AACF,wCAAwC;AACxC,+CAA+C;AAC/C,2CAA2C;AAC3C,EAAE;AACF,WAAW;AACX,mBAAmB;AACnB,wEAAwE;AACxE,QAAQ;AAcR,MAAM,UAAU,YAAY,CAAC,OAAuB;IAClD,MAAM,aAAa,GAAG,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC;IAChD,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;IACzC,MAAM,MAAM,GAAG,OAAO,EAAE,YAAY,CAAC;IAErC,MAAM,UAAU,GAAkB;QAChC,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpB,MAAM,QAAQ,GAAG,aAAa,IAAI,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC;YAC9G,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAEtB,kBAAkB;YAClB,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;YAE/C,MAAM,QAAQ,GAAG,MAAM;gBACrB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;gBACpC,CAAC,CAAC;oBACE,MAAM,EAAE,IAAI;oBACZ,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI;oBACnB,MAAM,EAAE,WAAW;oBACnB,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW;oBACjC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM;wBACrB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BAC/C,IAAI,EAAE,CAAC;4BACP,IAAI,EAAE,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAS,CAAC,IAAI,IAAI,KAAK;4BAC1D,QAAQ,EAAE,CAAC,IAAI,WAAW;4BAC1B,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI;yBAC9B,CAAC,CAAC;wBACL,CAAC,CAAC,EAAE;oBACN,OAAO,EAAE,aAAa,GAAG,CAAC,IAAI,CAAC,IAAI,2BAA2B,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE;iBAC5F,CAAC;YAEN,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,aAAa,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;aAC3F,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE;QAC9C,UAAU,EAAE,CAAC,UAAU,CAAC;KACzB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { AirPlugin } from '../../types/plugin.js';
+type FallbackMap = Record<string, string>;
+export declare function fallbackPlugin(fallbacks: FallbackMap): AirPlugin;
+export {};
+//# sourceMappingURL=fallback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/fallback.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE1C,wBAAgB,cAAc,CAAC,SAAS,EAAE,WAAW,GAAG,SAAS,CA6BhE"}

package/dist/plugin/builtin/fallback.js

@@ -0,0 +1,42 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/fallback.ts
+//
+// 도구 폴백 플러그인.
+// 특정 도구가 에러나면 대체 도구를 자동으로 호출.
+//
+// @example
+//   defineServer({
+//     use: [fallbackPlugin({
+//       'search_primary': 'search_backup',
+//       'fetch_api': 'fetch_cached',
+//     })],
+//   });
+export function fallbackPlugin(fallbacks) {
+    const middleware = {
+        name: 'air:fallback',
+        onError: async (ctx, error) => {
+            const fallbackTool = fallbacks[ctx.tool.name];
+            if (!fallbackTool)
+                return undefined;
+            console.warn(`[air:fallback] "${ctx.tool.name}" failed, trying "${fallbackTool}"`);
+            // 같은 서버의 도구 목록에서 폴백 도구를 찾아 실행
+            // ctx.meta에 서버의 callTool이 있으면 사용
+            if (ctx.meta._serverCallTool) {
+                try {
+                    const result = await ctx.meta._serverCallTool(fallbackTool, ctx.params);
+                    return result;
+                }
+                catch (fallbackError) {
+                    console.error(`[air:fallback] Fallback "${fallbackTool}" also failed: ${fallbackError.message}`);
+                    return undefined;
+                }
+            }
+            return undefined;
+        },
+    };
+    return {
+        meta: { name: 'air:fallback', version: '1.0.0' },
+        middleware: [middleware],
+    };
+}
+//# sourceMappingURL=fallback.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.js","sourceRoot":"","sources":["../../../src/plugin/builtin/fallback.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,gDAAgD;AAChD,EAAE;AACF,cAAc;AACd,8BAA8B;AAC9B,EAAE;AACF,WAAW;AACX,mBAAmB;AACnB,6BAA6B;AAC7B,2CAA2C;AAC3C,qCAAqC;AACrC,WAAW;AACX,QAAQ;AAOR,MAAM,UAAU,cAAc,CAAC,SAAsB;IACnD,MAAM,UAAU,GAAkB;QAChC,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YAC5B,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,CAAC,YAAY;gBAAE,OAAO,SAAS,CAAC;YAEpC,OAAO,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,IAAI,CAAC,IAAI,qBAAqB,YAAY,GAAG,CAAC,CAAC;YAEnF,8BAA8B;YAC9B,iCAAiC;YACjC,IAAI,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;oBACxE,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAAC,OAAO,aAAkB,EAAE,CAAC;oBAC5B,OAAO,CAAC,KAAK,CAAC,4BAA4B,YAAY,kBAAkB,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC;oBACjG,OAAO,SAAS,CAAC;gBACnB,CAAC;YACH,CAAC;YAED,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE;QAChD,UAAU,EAAE,CAAC,UAAU,CAAC;KACzB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { AirPlugin } from '../../types/plugin.js';
+interface I18nOptions {
+    /** 기본 언어 (기본: 'en') */
+    defaultLang?: string;
+    /** 번역 사전: key → { lang: text } */
+    translations?: Record<string, Record<string, string>>;
+    /** 언어 감지 파라미터 이름 (기본: '_lang') */
+    langParam?: string;
+}
+export declare function i18nPlugin(options?: I18nOptions): AirPlugin;
+export {};
+//# sourceMappingURL=i18n.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/i18n.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,UAAU,WAAW;IACnB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAmC3D"}

package/dist/plugin/builtin/i18n.js

@@ -0,0 +1,51 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/i18n.ts
+//
+// 다국어 응답 변환 플러그인.
+// 도구 응답을 사용자의 언어에 맞게 변환.
+// 번역 사전을 등록하면 자동으로 매칭.
+//
+// @example
+//   defineServer({
+//     use: [i18nPlugin({
+//       defaultLang: 'ko',
+//       translations: {
+//         'saved': { ko: '저장 완료', en: 'Saved', ja: '保存完了' },
+//         'not_found': { ko: '찾을 수 없습니다', en: 'Not found', ja: '見つかりません' },
+//       },
+//     })],
+//   });
+export function i18nPlugin(options) {
+    const defaultLang = options?.defaultLang ?? 'en';
+    const translations = options?.translations ?? {};
+    const langParam = options?.langParam ?? '_lang';
+    function translate(text, lang) {
+        let result = text;
+        for (const [key, dict] of Object.entries(translations)) {
+            const translated = dict[lang] || dict[defaultLang] || key;
+            result = result.replaceAll(`{{${key}}}`, translated);
+        }
+        return result;
+    }
+    const middleware = {
+        name: 'air:i18n',
+        before: async (ctx) => {
+            // 언어 파라미터를 meta에 저장하고 params에서 제거
+            const lang = ctx.params[langParam] || defaultLang;
+            ctx.meta._lang = lang;
+            const { [langParam]: _, ...cleanParams } = ctx.params;
+            return { params: cleanParams };
+        },
+        after: async (ctx) => {
+            const lang = ctx.meta._lang || defaultLang;
+            if (typeof ctx.result === 'string') {
+                ctx.result = translate(ctx.result, lang);
+            }
+        },
+    };
+    return {
+        meta: { name: 'air:i18n', version: '1.0.0' },
+        middleware: [middleware],
+    };
+}
+//# sourceMappingURL=i18n.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../../src/plugin/builtin/i18n.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,4CAA4C;AAC5C,EAAE;AACF,kBAAkB;AAClB,yBAAyB;AACzB,uBAAuB;AACvB,EAAE;AACF,WAAW;AACX,mBAAmB;AACnB,yBAAyB;AACzB,2BAA2B;AAC3B,wBAAwB;AACxB,6DAA6D;AAC7D,4EAA4E;AAC5E,WAAW;AACX,WAAW;AACX,QAAQ;AAcR,MAAM,UAAU,UAAU,CAAC,OAAqB;IAC9C,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC;IACjD,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,EAAE,CAAC;IACjD,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,OAAO,CAAC;IAEhD,SAAS,SAAS,CAAC,IAAY,EAAE,IAAY;QAC3C,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YACvD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC;YAC1D,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,UAAU,GAAkB;QAChC,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpB,kCAAkC;YAClC,MAAM,IAAI,GAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAY,IAAI,WAAW,CAAC;YAC9D,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YACtB,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,GAAG,WAAW,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;YACtD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QACjC,CAAC;QACD,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACnB,MAAM,IAAI,GAAI,GAAG,CAAC,IAAI,CAAC,KAAgB,IAAI,WAAW,CAAC;YACvD,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACnC,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE;QAC5C,UAAU,EAAE,CAAC,UAAU,CAAC;KACzB,CAAC;AACJ,CAAC"}

package/dist/plugin/builtin/logger-json.d.ts

@@ -0,0 +1,12 @@
+import type { AirPlugin } from '../../types/plugin.js';
+interface JsonLoggerOptions {
+    /** 출력 대상 (기본: 'stderr') */
+    output?: 'stderr' | 'stdout';
+    /** 추가 필드 */
+    extraFields?: Record<string, any>;
+    /** 파라미터를 로그에 포함할지 (기본: false) */
+    logParams?: boolean;
+}
+export declare function jsonLoggerPlugin(options?: JsonLoggerOptions): AirPlugin;
+export {};
+//# sourceMappingURL=logger-json.d.ts.map

package/dist/plugin/builtin/logger-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-json.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/logger-json.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,UAAU,iBAAiB;IACzB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B,YAAY;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAyCvE"}

package/dist/plugin/builtin/logger-json.js

@@ -0,0 +1,52 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/logger-json.ts
+//
+// JSON 구조화 로깅 플러그인.
+// 프로덕션 환경에서 JSON 형태로 도구 호출 로그를 출력.
+// ELK, Datadog, CloudWatch 등 로그 수집기와 호환.
+//
+// @example
+//   defineServer({
+//     use: [jsonLoggerPlugin({ output: 'stderr' })],
+//   });
+export function jsonLoggerPlugin(options) {
+    const logFn = options?.output === 'stdout' ? console.log : console.error;
+    const extra = options?.extraFields || {};
+    const logParams = options?.logParams ?? false;
+    const middleware = {
+        name: 'air:json-logger',
+        after: async (ctx) => {
+            const entry = {
+                level: 'info',
+                event: 'tool.call',
+                tool: ctx.tool.name,
+                duration_ms: ctx.duration,
+                request_id: ctx.requestId,
+                server: ctx.serverName,
+                timestamp: new Date().toISOString(),
+                ...(logParams ? { params: ctx.params } : {}),
+                ...extra,
+            };
+            logFn(JSON.stringify(entry));
+        },
+        onError: async (ctx, error) => {
+            const entry = {
+                level: 'error',
+                event: 'tool.error',
+                tool: ctx.tool.name,
+                error: error.message,
+                request_id: ctx.requestId,
+                server: ctx.serverName,
+                timestamp: new Date().toISOString(),
+                ...extra,
+            };
+            logFn(JSON.stringify(entry));
+            return undefined;
+        },
+    };
+    return {
+        meta: { name: 'air:json-logger', version: '1.0.0' },
+        middleware: [middleware],
+    };
+}
+//# sourceMappingURL=logger-json.js.map

package/dist/plugin/builtin/logger-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-json.js","sourceRoot":"","sources":["../../../src/plugin/builtin/logger-json.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,mDAAmD;AACnD,EAAE;AACF,oBAAoB;AACpB,mCAAmC;AACnC,yCAAyC;AACzC,EAAE;AACF,WAAW;AACX,mBAAmB;AACnB,qDAAqD;AACrD,QAAQ;AAcR,MAAM,UAAU,gBAAgB,CAAC,OAA2B;IAC1D,MAAM,KAAK,GAAG,OAAO,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACzE,MAAM,KAAK,GAAG,OAAO,EAAE,WAAW,IAAI,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,KAAK,CAAC;IAE9C,MAAM,UAAU,GAAkB;QAChC,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACnB,MAAM,KAAK,GAAG;gBACZ,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,WAAW;gBAClB,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI;gBACnB,WAAW,EAAE,GAAG,CAAC,QAAQ;gBACzB,UAAU,EAAE,GAAG,CAAC,SAAS;gBACzB,MAAM,EAAE,GAAG,CAAC,UAAU;gBACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5C,GAAG,KAAK;aACT,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YAC5B,MAAM,KAAK,GAAG;gBACZ,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,YAAY;gBACnB,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI;gBACnB,KAAK,EAAE,KAAK,CAAC,OAAO;gBACpB,UAAU,EAAE,GAAG,CAAC,SAAS;gBACzB,MAAM,EAAE,GAAG,CAAC,UAAU;gBACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,GAAG,KAAK;aACT,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,EAAE;QACnD,UAAU,EAAE,CAAC,UAAU,CAAC;KACzB,CAAC;AACJ,CAAC"}

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

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

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

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

package/dist/plugin/builtin/logger.js

@@ -0,0 +1,22 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — plugin/builtin/logger.ts
+// 내장 로깅 플러그인 — core만 설치해도 기본 로깅 동작
+import { loggingMiddleware } from '../../middleware/after-hook.js';
+export function builtinLoggerPlugin(level = 'info') {
+    const shouldLog = (msgLevel) => {
+        const levels = ['debug', 'info', 'warn', 'error', 'silent'];
+        return levels.indexOf(msgLevel) >= levels.indexOf(level);
+    };
+    return {
+        meta: { name: 'air:builtin-logger', version: '0.1.0', description: 'Built-in logging' },
+        middleware: [
+            loggingMiddleware((msg) => {
+                if (shouldLog('info')) {
+                    const ts = new Date().toISOString().slice(11, 23);
+                    console.log(`${ts} ${msg}`);
+                }
+            }),
+        ],
+    };
+}
+//# sourceMappingURL=logger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/plugin/builtin/logger.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,8CAA8C;AAC9C,mCAAmC;AAGnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,MAAM,UAAU,mBAAmB,CAAC,QAAgB,MAAM;IACxD,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC5D,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE;QACvF,UAAU,EAAE;YACV,iBAAiB,CAAC,CAAC,GAAG,EAAE,EAAE;gBACxB,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;oBACtB,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBAClD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC,CAAC;SACH;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { AirPlugin } from '../../types/plugin.js';
+interface ToolMetric {
+    calls: number;
+    errors: number;
+    totalDuration: number;
+    lastCalledAt: number;
+}
+export declare function getMetrics(): Record<string, ToolMetric & {
+    avgDuration: number;
+}>;
+export declare function resetMetrics(): void;
+export declare function builtinMetricsPlugin(): AirPlugin;
+export {};
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/plugin/builtin/metrics.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,wBAAgB,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CASjF;AAED,wBAAgB,YAAY,SAE3B;AAED,wBAAgB,oBAAoB,IAAI,SAAS,CAsChD"}