@airmcp-dev/core 0.1.0

package/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+   Copyright 2026 CodePedia Labs (labs@codepedia.kr)

package/dist/config/defaults.d.ts

@@ -0,0 +1,3 @@
+import type { AirConfig } from '../types/config.js';
+export declare const DEFAULT_CONFIG: Required<Pick<AirConfig, 'version' | 'transport' | 'storage' | 'logging' | 'metrics' | 'dev'>>;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,eAAO,MAAM,cAAc,EAAE,QAAQ,CACnC,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC,CAQrF,CAAC"}

package/dist/config/defaults.js

@@ -0,0 +1,11 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — config/defaults.ts
+export const DEFAULT_CONFIG = {
+    version: '0.1.0',
+    transport: { type: 'auto' },
+    storage: { type: 'memory' },
+    logging: { level: 'info', format: 'pretty' },
+    metrics: { enabled: true, layerClassification: false },
+    dev: { hotReload: true, port: 3100 },
+};
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,wCAAwC;AAIxC,MAAM,CAAC,MAAM,cAAc,GAEvB;IACF,OAAO,EAAE,OAAO;IAChB,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IAC3B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC3B,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE;IAC5C,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE;IACtD,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;CACrC,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export { loadConfig } from './loader.js';
+export { DEFAULT_CONFIG } from './defaults.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,5 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — config/index.ts (re-export only)
+export { loadConfig } from './loader.js';
+export { DEFAULT_CONFIG } from './defaults.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,sDAAsD;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/config/loader.d.ts

@@ -0,0 +1,4 @@
+import type { AirConfig } from '../types/config.js';
+/** air.config.ts 또는 air.config.json을 로드하여 기본값과 병합 */
+export declare function loadConfig(cwd?: string): Promise<AirConfig>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGpD,qDAAqD;AACrD,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAqCjE"}

package/dist/config/loader.js

@@ -0,0 +1,59 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — config/loader.ts
+// air.config.ts / air.config.json 로더
+import { readFileSync, existsSync } from 'fs';
+import { resolve } from 'path';
+import { DEFAULT_CONFIG } from './defaults.js';
+/** air.config.ts 또는 air.config.json을 로드하여 기본값과 병합 */
+export async function loadConfig(cwd) {
+    const dir = cwd || process.cwd();
+    // 1. air.config.ts (ESM dynamic import)
+    const tsPath = resolve(dir, 'air.config.ts');
+    if (existsSync(tsPath)) {
+        try {
+            const mod = await import(tsPath);
+            return mergeConfig(mod.default || mod);
+        }
+        catch {
+            // ts 로드 실패 시 json으로 폴백
+        }
+    }
+    // 2. air.config.json
+    const jsonPath = resolve(dir, 'air.config.json');
+    if (existsSync(jsonPath)) {
+        try {
+            const raw = readFileSync(jsonPath, 'utf-8');
+            return mergeConfig(JSON.parse(raw));
+        }
+        catch {
+            // json 파싱 실패
+        }
+    }
+    // 3. package.json의 "air" 필드
+    const pkgPath = resolve(dir, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            if (pkg.air)
+                return mergeConfig(pkg.air);
+        }
+        catch {
+            // 무시
+        }
+    }
+    return mergeConfig({ name: 'air-server' });
+}
+function mergeConfig(userConfig) {
+    return {
+        name: userConfig.name || 'air-server',
+        version: userConfig.version || DEFAULT_CONFIG.version,
+        description: userConfig.description,
+        transport: { ...DEFAULT_CONFIG.transport, ...userConfig.transport },
+        storage: { ...DEFAULT_CONFIG.storage, ...userConfig.storage },
+        logging: { ...DEFAULT_CONFIG.logging, ...userConfig.logging },
+        metrics: { ...DEFAULT_CONFIG.metrics, ...userConfig.metrics },
+        dev: { ...DEFAULT_CONFIG.dev, ...userConfig.dev },
+        plugins: userConfig.plugins,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,sCAAsC;AACtC,qCAAqC;AAErC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAY;IAC3C,MAAM,GAAG,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEjC,wCAAwC;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;YACjC,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IACjD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC5C,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,aAAa;QACf,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YACvD,IAAI,GAAG,CAAC,GAAG;gBAAE,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,KAAK;QACP,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,WAAW,CAAC,UAA8B;IACjD,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,YAAY;QACrC,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO;QACrD,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,SAAS,EAAE,EAAE,GAAG,cAAc,CAAC,SAAS,EAAE,GAAG,UAAU,CAAC,SAAS,EAAE;QACnE,OAAO,EAAE,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE;QAC7D,OAAO,EAAE,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE;QAC7D,OAAO,EAAE,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE;QAC7D,GAAG,EAAE,EAAE,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE;QACjD,OAAO,EAAE,UAAU,CAAC,OAAO;KAC5B,CAAC;AACJ,CAAC"}

package/dist/context/index.d.ts

@@ -0,0 +1,3 @@
+export { createRequestContext } from './request-context.js';
+export { ServerContext } from './server-context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/context/index.js

@@ -0,0 +1,5 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — context/index.ts (re-export only)
+export { createRequestContext } from './request-context.js';
+export { ServerContext } from './server-context.js';
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,uDAAuD;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/context/request-context.d.ts

@@ -0,0 +1,4 @@
+import type { AirToolContext } from '../types/tool.js';
+/** 새 요청 컨텍스트 생성 */
+export declare function createRequestContext(serverName: string, state: Record<string, any>): AirToolContext;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/context/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/context/request-context.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,mBAAmB;AACnB,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB,cAAc,CAOhB"}

package/dist/context/request-context.js

@@ -0,0 +1,14 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — context/request-context.ts
+// 요청별 컨텍스트 — 각 도구 호출마다 생성
+import { randomUUID } from 'crypto';
+/** 새 요청 컨텍스트 생성 */
+export function createRequestContext(serverName, state) {
+    return {
+        requestId: randomUUID(),
+        serverName,
+        startedAt: Date.now(),
+        state,
+    };
+}
+//# sourceMappingURL=request-context.js.map

package/dist/context/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../src/context/request-context.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,gDAAgD;AAChD,0BAA0B;AAE1B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGpC,mBAAmB;AACnB,MAAM,UAAU,oBAAoB,CAClC,UAAkB,EAClB,KAA0B;IAE1B,OAAO;QACL,SAAS,EAAE,UAAU,EAAE;QACvB,UAAU;QACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/context/server-context.d.ts

@@ -0,0 +1,12 @@
+export declare class ServerContext {
+    readonly name: string;
+    readonly version: string;
+    readonly startedAt: Date;
+    readonly state: Record<string, any>;
+    private _status;
+    constructor(name: string, version: string);
+    get status(): typeof this._status;
+    set status(s: typeof this._status);
+    get uptime(): number;
+}
+//# sourceMappingURL=server-context.d.ts.map

package/dist/context/server-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-context.d.ts","sourceRoot":"","sources":["../../src/context/server-context.ts"],"names":[],"mappings":"AAIA,qBAAa,aAAa;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAM;IAEzC,OAAO,CAAC,OAAO,CAA8E;gBAEjF,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAMzC,IAAI,MAAM,IAGI,OAAO,IAAI,CAAC,OAAO,CADhC;IACD,IAAI,MAAM,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,OAAO,EAEhC;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/dist/context/server-context.js

@@ -0,0 +1,25 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — context/server-context.ts
+// 서버 글로벌 컨텍스트 — 서버 전체에서 공유되는 상태
+export class ServerContext {
+    name;
+    version;
+    startedAt;
+    state = {};
+    _status = 'idle';
+    constructor(name, version) {
+        this.name = name;
+        this.version = version;
+        this.startedAt = new Date();
+    }
+    get status() {
+        return this._status;
+    }
+    set status(s) {
+        this._status = s;
+    }
+    get uptime() {
+        return Date.now() - this.startedAt.getTime();
+    }
+}
+//# sourceMappingURL=server-context.js.map

package/dist/context/server-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-context.js","sourceRoot":"","sources":["../../src/context/server-context.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,+CAA+C;AAC/C,gCAAgC;AAEhC,MAAM,OAAO,aAAa;IACf,IAAI,CAAS;IACb,OAAO,CAAS;IAChB,SAAS,CAAO;IAChB,KAAK,GAAwB,EAAE,CAAC;IAEjC,OAAO,GAAuE,MAAM,CAAC;IAE7F,YAAY,IAAY,EAAE,OAAe;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IACD,IAAI,MAAM,CAAC,CAAsB;QAC/B,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;IAC/C,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+export { defineServer } from './server/index.js';
+export { onShutdown } from './server/index.js';
+export { defineTool } from './tool/index.js';
+export { paramsToZodSchema, paramsToJsonSchema } from './tool/index.js';
+export { normalizeResult } from './tool/index.js';
+export { defineResource } from './resource/index.js';
+export { extractTemplateVars, matchTemplate } from './resource/index.js';
+export { definePrompt } from './prompt/index.js';
+export { MiddlewareChain } from './middleware/index.js';
+export { validationMiddleware } from './middleware/index.js';
+export { loggingMiddleware } from './middleware/index.js';
+export { errorBoundaryMiddleware } from './middleware/index.js';
+export { AirError, McpErrors } from './middleware/index.js';
+export { createShieldMiddleware, getAuditLog, clearAuditLog } from './middleware/index.js';
+export { createMeterMiddleware, getMetricsSnapshot, resetMetricsHistory } from './middleware/index.js';
+export { loadConfig } from './config/index.js';
+export { DEFAULT_CONFIG } from './config/index.js';
+export { detectTransport } from './transport/index.js';
+export { createRequestContext } from './context/index.js';
+export { ServerContext } from './context/index.js';
+export { createStorage } from './storage/index.js';
+export { MemoryStore } from './storage/index.js';
+export { FileStore } from './storage/index.js';
+export { PluginManager } from './plugin/index.js';
+export { builtinLoggerPlugin } from './plugin/index.js';
+export { builtinMetricsPlugin, getMetrics, resetMetrics } from './plugin/index.js';
+export { timeoutPlugin } from './plugin/index.js';
+export { retryPlugin } from './plugin/index.js';
+export { circuitBreakerPlugin } from './plugin/index.js';
+export { fallbackPlugin } from './plugin/index.js';
+export { cachePlugin } from './plugin/index.js';
+export { dedupPlugin } from './plugin/index.js';
+export { queuePlugin } from './plugin/index.js';
+export { authPlugin } from './plugin/index.js';
+export { sanitizerPlugin } from './plugin/index.js';
+export { validatorPlugin } from './plugin/index.js';
+export { corsPlugin } from './plugin/index.js';
+export { webhookPlugin } from './plugin/index.js';
+export { transformPlugin } from './plugin/index.js';
+export { i18nPlugin } from './plugin/index.js';
+export { jsonLoggerPlugin } from './plugin/index.js';
+export { perUserRateLimitPlugin } from './plugin/index.js';
+export { dryrunPlugin } from './plugin/index.js';
+export { TelemetryManager } from './telemetry/index.js';
+export type { TelemetryConfig, TelemetryEvent } from './telemetry/index.js';
+export type { AirConfig, ShieldConfig, MeterConfig, TransportType, TransportConfig, ParamShorthand, AirToolParams, AirToolHandler, AirToolContext, AirToolResponse, AirToolDef, AirResourceDef, AirResourceContext, AirResourceContent, AirPromptDef, AirPromptArg, AirPromptMessage, MiddlewareContext, MiddlewareResult, BeforeMiddleware, AfterMiddleware, ErrorMiddleware, AirMiddleware, StorageAdapter, QueryOptions, StoreOptions, AirPluginMeta, PluginHooks, PluginContext, AirPlugin, AirPluginFactory, AirPluginManifest, PluginCategory, PluginRegistryEntry, PluginRegistryConfig, DEFAULT_REGISTRY_URL, AirServerOptions, AirServer, AirServerStatus, } from './types/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,62 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — index.ts
+// 공개 API (re-export only)
+//
+// 사용자가 import하는 모든 것은 이 파일을 통해 접근한다.
+// 로직 없음. import/export만.
+// ── 서버 ──
+export { defineServer } from './server/index.js';
+export { onShutdown } from './server/index.js';
+// ── 도구 ──
+export { defineTool } from './tool/index.js';
+export { paramsToZodSchema, paramsToJsonSchema } from './tool/index.js';
+export { normalizeResult } from './tool/index.js';
+// ── 리소스 ──
+export { defineResource } from './resource/index.js';
+export { extractTemplateVars, matchTemplate } from './resource/index.js';
+// ── 프롬프트 ──
+export { definePrompt } from './prompt/index.js';
+// ── 미들웨어 ──
+export { MiddlewareChain } from './middleware/index.js';
+export { validationMiddleware } from './middleware/index.js';
+export { loggingMiddleware } from './middleware/index.js';
+export { errorBoundaryMiddleware } from './middleware/index.js';
+export { AirError, McpErrors } from './middleware/index.js';
+export { createShieldMiddleware, getAuditLog, clearAuditLog } from './middleware/index.js';
+export { createMeterMiddleware, getMetricsSnapshot, resetMetricsHistory } from './middleware/index.js';
+// ── 설정 ──
+export { loadConfig } from './config/index.js';
+export { DEFAULT_CONFIG } from './config/index.js';
+// ── Transport ──
+export { detectTransport } from './transport/index.js';
+// ── 컨텍스트 ──
+export { createRequestContext } from './context/index.js';
+export { ServerContext } from './context/index.js';
+// ── 스토리지 ──
+export { createStorage } from './storage/index.js';
+export { MemoryStore } from './storage/index.js';
+export { FileStore } from './storage/index.js';
+// ── 플러그인 (19개) ──
+export { PluginManager } from './plugin/index.js';
+export { builtinLoggerPlugin } from './plugin/index.js';
+export { builtinMetricsPlugin, getMetrics, resetMetrics } from './plugin/index.js';
+export { timeoutPlugin } from './plugin/index.js';
+export { retryPlugin } from './plugin/index.js';
+export { circuitBreakerPlugin } from './plugin/index.js';
+export { fallbackPlugin } from './plugin/index.js';
+export { cachePlugin } from './plugin/index.js';
+export { dedupPlugin } from './plugin/index.js';
+export { queuePlugin } from './plugin/index.js';
+export { authPlugin } from './plugin/index.js';
+export { sanitizerPlugin } from './plugin/index.js';
+export { validatorPlugin } from './plugin/index.js';
+export { corsPlugin } from './plugin/index.js';
+export { webhookPlugin } from './plugin/index.js';
+export { transformPlugin } from './plugin/index.js';
+export { i18nPlugin } from './plugin/index.js';
+export { jsonLoggerPlugin } from './plugin/index.js';
+export { perUserRateLimitPlugin } from './plugin/index.js';
+export { dryrunPlugin } from './plugin/index.js';
+// ── 텔레메트리 ──
+export { TelemetryManager } from './telemetry/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/middleware/after-hook.d.ts

@@ -0,0 +1,4 @@
+import type { AirMiddleware } from '../types/middleware.js';
+/** 도구 호출 로깅 미들웨어 */
+export declare function loggingMiddleware(logFn?: (msg: string) => void): AirMiddleware;
+//# sourceMappingURL=after-hook.d.ts.map

package/dist/middleware/after-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"after-hook.d.ts","sourceRoot":"","sources":["../../src/middleware/after-hook.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,oBAAoB;AACpB,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,aAAa,CAa9E"}

package/dist/middleware/after-hook.js

@@ -0,0 +1,18 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — middleware/after-hook.ts
+// 내장 after 미들웨어 — 기본 로깅
+/** 도구 호출 로깅 미들웨어 */
+export function loggingMiddleware(logFn) {
+    const log = logFn || ((msg) => console.log(`[air] ${msg}`));
+    return {
+        name: 'air:logging',
+        after: async (ctx) => {
+            log(`${ctx.tool.name} (${ctx.duration}ms) [${ctx.requestId}]`);
+        },
+        onError: async (ctx, error) => {
+            log(`${ctx.tool.name} ERROR: ${error.message} [${ctx.requestId}]`);
+            return undefined; // 에러를 먹지 않고 다음 핸들러에 위임
+        },
+    };
+}
+//# sourceMappingURL=after-hook.js.map

package/dist/middleware/after-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"after-hook.js","sourceRoot":"","sources":["../../src/middleware/after-hook.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,8CAA8C;AAC9C,wBAAwB;AAIxB,oBAAoB;AACpB,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,MAAM,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC;IAEpE,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACnB,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,QAAQ,QAAQ,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YAC5B,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,WAAW,KAAK,CAAC,OAAO,KAAK,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;YACnE,OAAO,SAAS,CAAC,CAAC,uBAAuB;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/middleware/before-hook.d.ts

@@ -0,0 +1,4 @@
+import type { AirMiddleware } from '../types/middleware.js';
+/** 입력 파라미터 자동 검증 미들웨어 */
+export declare function validationMiddleware(): AirMiddleware;
+//# sourceMappingURL=before-hook.d.ts.map

package/dist/middleware/before-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"before-hook.d.ts","sourceRoot":"","sources":["../../src/middleware/before-hook.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI5D,yBAAyB;AACzB,wBAAgB,oBAAoB,IAAI,aAAa,CAmCpD"}

package/dist/middleware/before-hook.js

@@ -0,0 +1,40 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — middleware/before-hook.ts
+// 내장 before 미들웨어 — 입력 검증
+import { paramsToZodSchema } from '../tool/tool-schema.js';
+/** 입력 파라미터 자동 검증 미들웨어 */
+export function validationMiddleware() {
+    return {
+        name: 'air:validation',
+        before: async (ctx) => {
+            const schema = paramsToZodSchema(ctx.tool.params);
+            if (!schema)
+                return;
+            const result = schema.safeParse(ctx.params);
+            if (!result.success) {
+                const details = result.error.errors.map((e) => ({
+                    field: e.path.join('.') || '(root)',
+                    message: e.message,
+                    code: e.code,
+                    expected: e.expected,
+                    received: e.received,
+                }));
+                const summary = details
+                    .map((d) => `  - ${d.field}: ${d.message}${d.expected ? ` (expected: ${d.expected}, got: ${d.received})` : ''}`)
+                    .join('\n');
+                return {
+                    abort: true,
+                    abortResponse: {
+                        content: [{
+                                type: 'text',
+                                text: `[Validation] Invalid parameters for "${ctx.tool.name}":\n${summary}\n\nExpected schema:\n${Object.entries(ctx.tool.params || {}).map(([k, v]) => `  - ${k}: ${typeof v === 'string' ? v : v.type || 'any'}${v?.optional ? ' (optional)' : ''}`).join('\n')}`,
+                            }],
+                        isError: true,
+                    },
+                };
+            }
+            return { params: result.data };
+        },
+    };
+}
+//# sourceMappingURL=before-hook.js.map

package/dist/middleware/before-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"before-hook.js","sourceRoot":"","sources":["../../src/middleware/before-hook.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,+CAA+C;AAC/C,yBAAyB;AAGzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,yBAAyB;AACzB,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpB,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,MAAM;gBAAE,OAAO;YAEpB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC9C,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ;oBACnC,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAG,CAAS,CAAC,QAAQ;oBAC7B,QAAQ,EAAG,CAAS,CAAC,QAAQ;iBAC9B,CAAC,CAAC,CAAC;gBAEJ,MAAM,OAAO,GAAG,OAAO;qBACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,QAAQ,UAAU,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;qBAC/G,IAAI,CAAC,IAAI,CAAC,CAAC;gBAEd,OAAO;oBACL,KAAK,EAAE,IAAI;oBACX,aAAa,EAAE;wBACb,OAAO,EAAE,CAAC;gCACR,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,wCAAwC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,OAAO,yBAAyB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAS,CAAC,IAAI,IAAI,KAAK,GAAI,CAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;6BACtR,CAAC;wBACF,OAAO,EAAE,IAAI;qBACd;iBACF,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/middleware/chain.d.ts

@@ -0,0 +1,11 @@
+import type { AirMiddleware } from '../types/middleware.js';
+import type { AirToolDef, AirToolContext } from '../types/tool.js';
+export declare class MiddlewareChain {
+    private middlewares;
+    add(mw: AirMiddleware): void;
+    addAll(mws: AirMiddleware[]): void;
+    /** 미들웨어 체인을 실행하고 도구 핸들러를 호출 */
+    execute(tool: AirToolDef, params: Record<string, any>, toolCtx: AirToolContext): Promise<import("../tool/tool-result.js").McpContent[]>;
+    private handleError;
+}
+//# sourceMappingURL=chain.d.ts.map

package/dist/middleware/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../src/middleware/chain.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,wBAAwB,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGnE,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAuB;IAE1C,GAAG,CAAC,EAAE,EAAE,aAAa;IAIrB,MAAM,CAAC,GAAG,EAAE,aAAa,EAAE;IAI3B,+BAA+B;IACzB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,cAAc;YAkDtE,WAAW;CAc1B"}

package/dist/middleware/chain.js

@@ -0,0 +1,84 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — middleware/chain.ts
+// 미들웨어 체인 실행기 — before → handler → after, 에러 시 onError
+import { normalizeResult } from '../tool/tool-result.js';
+export class MiddlewareChain {
+    middlewares = [];
+    add(mw) {
+        this.middlewares.push(mw);
+    }
+    addAll(mws) {
+        this.middlewares.push(...mws);
+    }
+    /** 미들웨어 체인을 실행하고 도구 핸들러를 호출 */
+    async execute(tool, params, toolCtx) {
+        const ctx = {
+            tool,
+            params: { ...params },
+            requestId: toolCtx.requestId,
+            serverName: toolCtx.serverName,
+            startedAt: toolCtx.startedAt,
+            meta: {},
+        };
+        // ── before 미들웨어 ──
+        for (const mw of this.middlewares) {
+            if (!mw.before)
+                continue;
+            try {
+                const result = await mw.before(ctx);
+                if (result?.abort) {
+                    return result.abortResponse
+                        ? normalizeResult(result.abortResponse)
+                        : normalizeResult('Request aborted by middleware');
+                }
+                if (result?.params)
+                    ctx.params = result.params;
+                if (result?.meta)
+                    Object.assign(ctx.meta, result.meta);
+            }
+            catch (err) {
+                return this.handleError(ctx, err);
+            }
+        }
+        // ── 핸들러 실행 ──
+        let handlerResult;
+        try {
+            handlerResult = await tool.handler(ctx.params, toolCtx);
+        }
+        catch (err) {
+            return this.handleError(ctx, err);
+        }
+        // ── after 미들웨어 ──
+        const duration = Date.now() - ctx.startedAt;
+        const afterCtx = { ...ctx, result: handlerResult, duration };
+        for (const mw of this.middlewares) {
+            if (!mw.after)
+                continue;
+            try {
+                await mw.after(afterCtx);
+            }
+            catch {
+                // after 미들웨어 에러는 무시 (결과는 이미 나왔으므로)
+            }
+        }
+        return normalizeResult(afterCtx.result);
+    }
+    async handleError(ctx, error) {
+        // onError 미들웨어가 있으면 위임
+        for (const mw of this.middlewares) {
+            if (!mw.onError)
+                continue;
+            try {
+                const recovery = await mw.onError(ctx, error);
+                if (recovery !== undefined)
+                    return normalizeResult(recovery);
+            }
+            catch {
+                // onError도 실패하면 다음으로
+            }
+        }
+        // 아무도 처리 못하면 에러 메시지 반환
+        return normalizeResult({ text: `Error: ${error.message}` });
+    }
+}
+//# sourceMappingURL=chain.js.map

package/dist/middleware/chain.js.map

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

package/dist/middleware/error-handler.d.ts

@@ -0,0 +1,27 @@
+import type { AirMiddleware } from '../types/middleware.js';
+/** air 전용 에러 클래스 — 에러 코드와 메타데이터를 포함 */
+export declare class AirError extends Error {
+    code: number;
+    details?: Record<string, any>;
+    constructor(message: string, code?: number, details?: Record<string, any>);
+}
+/** MCP 표준 에러 팩토리 */
+export declare const McpErrors: {
+    /** 도구를 찾을 수 없음 */
+    toolNotFound: (name: string) => AirError;
+    /** 파라미터 검증 실패 */
+    invalidParams: (message: string, params?: Record<string, any>) => AirError;
+    /** 내부 서버 에러 */
+    internal: (message: string, cause?: Error) => AirError;
+    /** 접근 거부 */
+    forbidden: (message: string) => AirError;
+    /** 레이트 리밋 초과 */
+    rateLimited: (tool: string, retryAfterMs?: number) => AirError;
+    /** 위협 감지 */
+    threatDetected: (type: string, severity: string) => AirError;
+    /** 타임아웃 */
+    timeout: (tool: string, timeoutMs: number) => AirError;
+};
+/** 에러 → MCP 응답 변환 미들웨어 */
+export declare function errorBoundaryMiddleware(): AirMiddleware;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/middleware/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/middleware/error-handler.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,wBAAwB,CAAC;AAE/E,uCAAuC;AACvC,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAe,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAMlF;AAED,oBAAoB;AACpB,eAAO,MAAM,SAAS;IACpB,kBAAkB;yBACG,MAAM;IAG3B,iBAAiB;6BACQ,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAG7D,eAAe;wBACK,MAAM,UAAU,KAAK;IAGzC,YAAY;yBACS,MAAM;IAG3B,gBAAgB;wBACI,MAAM,iBAAiB,MAAM;IAGjD,YAAY;2BACW,MAAM,YAAY,MAAM;IAG/C,WAAW;oBACK,MAAM,aAAa,MAAM;CAE1C,CAAC;AAiBF,0BAA0B;AAC1B,wBAAgB,uBAAuB,IAAI,aAAa,CAcvD"}