@airmcp-dev/core 0.1.0

package/dist/types/plugin.d.ts

@@ -0,0 +1,50 @@
+import type { AirMiddleware } from './middleware.js';
+import type { AirToolDef } from './tool.js';
+import type { AirResourceDef } from './resource.js';
+/** 플러그인 메타 정보 */
+export interface AirPluginMeta {
+    /** 플러그인 이름 */
+    name: string;
+    /** 버전 */
+    version?: string;
+    /** 설명 */
+    description?: string;
+}
+/** 플러그인 훅 — 서버 라이프사이클에 끼어드는 확장점 */
+export interface PluginHooks {
+    /** 서버 초기화 직후 */
+    onInit?: (ctx: PluginContext) => Promise<void> | void;
+    /** 서버 시작 직후 */
+    onStart?: (ctx: PluginContext) => Promise<void> | void;
+    /** 서버 종료 직전 */
+    onStop?: (ctx: PluginContext) => Promise<void> | void;
+    /** 도구가 등록될 때 */
+    onToolRegister?: (tool: AirToolDef, ctx: PluginContext) => AirToolDef | void;
+}
+/** 플러그인 컨텍스트 — 플러그인이 서버에 접근하는 통로 */
+export interface PluginContext {
+    /** 서버 이름 */
+    serverName: string;
+    /** 서버 설정 */
+    config: Record<string, any>;
+    /** 글로벌 상태 */
+    state: Record<string, any>;
+    /** 로거 */
+    log: (level: string, message: string, data?: any) => void;
+}
+/** 플러그인 정의 — 서드파티가 구현하는 인터페이스 */
+export interface AirPlugin {
+    /** 메타 정보 */
+    meta: AirPluginMeta;
+    /** 미들웨어 추가 */
+    middleware?: AirMiddleware[];
+    /** 도구 추가 */
+    tools?: AirToolDef[];
+    /** 리소스 추가 */
+    resources?: AirResourceDef[];
+    /** 라이프사이클 훅 */
+    hooks?: PluginHooks;
+}
+/** 플러그인 팩토리 — 설정을 받아서 플러그인 인스턴스 반환 */
+export type AirPluginFactory<T = any> = (options?: T) => AirPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,iBAAiB;AACjB,MAAM,WAAW,aAAa;IAC5B,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS;IACT,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS;IACT,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,eAAe;IACf,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,eAAe;IACf,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,gBAAgB;IAChB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,KAAK,UAAU,GAAG,IAAI,CAAC;CAC9E;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,aAAa;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,SAAS;IACT,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;CAC3D;AAED,iCAAiC;AACjC,MAAM,WAAW,SAAS;IACxB,YAAY;IACZ,IAAI,EAAE,aAAa,CAAC;IACpB,cAAc;IACd,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,YAAY;IACZ,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,aAAa;IACb,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,eAAe;IACf,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,sCAAsC;AACtC,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC"}

package/dist/types/plugin.js

@@ -0,0 +1,4 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — types/plugin.ts
+export {};
+//# sourceMappingURL=plugin.js.map

package/dist/types/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,qCAAqC"}

package/dist/types/prompt.d.ts

@@ -0,0 +1,21 @@
+/** 프롬프트 템플릿 정의 */
+export interface AirPromptDef {
+    /** 프롬프트 이름 */
+    name: string;
+    /** 설명 */
+    description?: string;
+    /** 인자 정의 */
+    arguments?: AirPromptArg[];
+    /** 프롬프트 생성 함수 */
+    handler: (args: Record<string, string>) => Promise<AirPromptMessage[]> | AirPromptMessage[];
+}
+export interface AirPromptArg {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+export interface AirPromptMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+//# sourceMappingURL=prompt.d.ts.map

package/dist/types/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/types/prompt.ts"],"names":[],"mappings":"AAGA,kBAAkB;AAClB,MAAM,WAAW,YAAY;IAC3B,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS;IACT,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY;IACZ,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,iBAAiB;IACjB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,gBAAgB,EAAE,CAAC,GAAG,gBAAgB,EAAE,CAAC;CAC7F;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/prompt.js

@@ -0,0 +1,4 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — types/prompt.ts
+export {};
+//# sourceMappingURL=prompt.js.map

package/dist/types/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/types/prompt.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,qCAAqC"}

package/dist/types/resource.d.ts

@@ -0,0 +1,25 @@
+/** 리소스 정의 */
+export interface AirResourceDef {
+    /** 리소스 URI (예: "file:///{path}") */
+    uri: string;
+    /** 이름 */
+    name: string;
+    /** 설명 */
+    description?: string;
+    /** MIME 타입 (기본: text/plain) */
+    mimeType?: string;
+    /** 리소스 핸들러 */
+    handler: (uri: string, context: AirResourceContext) => Promise<AirResourceContent> | AirResourceContent;
+}
+export interface AirResourceContext {
+    requestId: string;
+    serverName: string;
+}
+export type AirResourceContent = string | {
+    text: string;
+    mimeType?: string;
+} | {
+    blob: string;
+    mimeType: string;
+};
+//# sourceMappingURL=resource.d.ts.map

package/dist/types/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/types/resource.ts"],"names":[],"mappings":"AAGA,aAAa;AACb,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS;IACT,IAAI,EAAE,MAAM,CAAC;IACb,SAAS;IACT,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,OAAO,EAAE,CACP,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,kBAAkB,KACxB,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAAC;CACvD;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types/resource.js

@@ -0,0 +1,4 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — types/resource.ts
+export {};
+//# sourceMappingURL=resource.js.map

package/dist/types/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/types/resource.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,uCAAuC"}

package/dist/types/server.d.ts

@@ -0,0 +1,54 @@
+import type { AirToolDef } from './tool.js';
+import type { AirResourceDef } from './resource.js';
+import type { AirPromptDef } from './prompt.js';
+import type { AirMiddleware } from './middleware.js';
+import type { AirPlugin, AirPluginFactory } from './plugin.js';
+import type { AirConfig } from './config.js';
+/** defineServer()에 전달하는 옵션 */
+export interface AirServerOptions extends AirConfig {
+    /** 도구 목록 */
+    tools?: AirToolDef[];
+    /** 리소스 목록 */
+    resources?: AirResourceDef[];
+    /** 프롬프트 목록 */
+    prompts?: AirPromptDef[];
+    /** 미들웨어 목록 (실행 순서 = 배열 순서) */
+    middleware?: AirMiddleware[];
+    /** 플러그인 목록 */
+    use?: Array<AirPlugin | AirPluginFactory>;
+}
+/** defineServer()가 반환하는 서버 인스턴스 */
+export interface AirServer {
+    /** 서버 이름 */
+    readonly name: string;
+    /** 서버 시작 */
+    start(): Promise<void>;
+    /** 서버 종료 */
+    stop(): Promise<void>;
+    /** 서버 상태 */
+    status(): AirServerStatus;
+    /** 등록된 도구 목록 */
+    tools(): AirToolDef[];
+    /** 등록된 리소스 목록 */
+    resources(): AirResourceDef[];
+    /** 미들웨어 체인을 거쳐 도구를 호출한다 (shield/meter 자동 적용) */
+    callTool(toolName: string, params?: Record<string, any>): Promise<any>;
+    /** 런타임에 도구 추가 */
+    addTool(tool: AirToolDef): void;
+    /** 런타임에 미들웨어 추가 */
+    addMiddleware(mw: AirMiddleware): void;
+    /** 런타임에 플러그인 추가 */
+    addPlugin(plugin: AirPlugin | AirPluginFactory): void;
+    /** 글로벌 상태 */
+    state: Record<string, any>;
+}
+export interface AirServerStatus {
+    name: string;
+    version: string;
+    state: 'idle' | 'starting' | 'running' | 'stopping' | 'stopped' | 'error';
+    uptime: number;
+    toolCount: number;
+    resourceCount: number;
+    transport: string;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/types/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/types/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,8BAA8B;AAC9B,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,YAAY;IACZ,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,aAAa;IACb,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,cAAc;IACd,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,cAAc;IACd,GAAG,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,gBAAgB,CAAC,CAAC;CAC3C;AAED,mCAAmC;AACnC,MAAM,WAAW,SAAS;IACxB,YAAY;IACZ,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,YAAY;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,YAAY;IACZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,YAAY;IACZ,MAAM,IAAI,eAAe,CAAC;IAC1B,gBAAgB;IAChB,KAAK,IAAI,UAAU,EAAE,CAAC;IACtB,iBAAiB;IACjB,SAAS,IAAI,cAAc,EAAE,CAAC;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACvE,iBAAiB;IACjB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,mBAAmB;IACnB,aAAa,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,CAAC;IACvC,mBAAmB;IACnB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAAC;IACtD,aAAa;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/server.js

@@ -0,0 +1,4 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — types/server.ts
+export {};
+//# sourceMappingURL=server.js.map

package/dist/types/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/types/server.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,qCAAqC"}

package/dist/types/storage.d.ts

@@ -0,0 +1,40 @@
+/** 스토리지 어댑터 인터페이스 (PG 종속 없음) */
+export interface StorageAdapter {
+    /** 초기화 */
+    init(): Promise<void>;
+    /** 값 저장 */
+    set(namespace: string, key: string, value: any, ttl?: number): Promise<void>;
+    /** 값 조회 */
+    get<T = any>(namespace: string, key: string): Promise<T | null>;
+    /** 값 삭제 */
+    delete(namespace: string, key: string): Promise<boolean>;
+    /** namespace 내 모든 키 조회 */
+    list(namespace: string, prefix?: string): Promise<string[]>;
+    /** namespace 내 모든 항목 조회 */
+    entries<T = any>(namespace: string, prefix?: string): Promise<Array<{
+        key: string;
+        value: T;
+    }>>;
+    /** append-only 로그 추가 (감사/메트릭용) */
+    append(namespace: string, entry: any): Promise<void>;
+    /** append 로그 조회 (최신순) */
+    query(namespace: string, opts?: QueryOptions): Promise<any[]>;
+    /** 종료 */
+    close(): Promise<void>;
+}
+export interface QueryOptions {
+    limit?: number;
+    offset?: number;
+    since?: Date;
+    until?: Date;
+    filter?: Record<string, any>;
+}
+export interface StoreOptions {
+    /** 스토리지 타입 */
+    type: 'memory' | 'file' | 'sqlite';
+    /** file/sqlite 경로 (기본: .air/data/) */
+    path?: string;
+    /** TTL 기본값 (초, 0=무제한) */
+    defaultTtl?: number;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/types/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/types/storage.ts"],"names":[],"mappings":"AAGA,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,UAAU;IACV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,WAAW;IACX,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,WAAW;IACX,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAChE,WAAW;IACX,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,0BAA0B;IAC1B,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5D,2BAA2B;IAC3B,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;IAChG,kCAAkC;IAClC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,yBAAyB;IACzB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9D,SAAS;IACT,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc;IACd,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IACnC,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/storage.js

@@ -0,0 +1,4 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — types/storage.ts
+export {};
+//# sourceMappingURL=storage.js.map

package/dist/types/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/types/storage.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,sCAAsC"}

package/dist/types/tool.d.ts

@@ -0,0 +1,54 @@
+import type { z } from 'zod';
+/** 파라미터 단축 타입 → zod로 변환됨 */
+export type ParamShorthand = 'string' | 'number' | 'boolean' | 'string?' | 'number?' | 'boolean?' | 'object' | 'object?';
+/** 파라미터 객체 형식 정의 */
+export interface ParamObjectDef {
+    type: 'string' | 'number' | 'boolean' | 'object';
+    description?: string;
+    optional?: boolean;
+}
+/** 파라미터 정의: zod 스키마, 단축 표기, 또는 객체 형식 */
+export type AirToolParams = Record<string, ParamShorthand | ParamObjectDef | z.ZodType>;
+/** 도구 핸들러 함수 */
+export type AirToolHandler<P = Record<string, any>> = (params: P, context: AirToolContext) => Promise<AirToolResponse> | AirToolResponse;
+/** 도구 호출 시 전달되는 컨텍스트 */
+export interface AirToolContext {
+    /** 요청 고유 ID */
+    requestId: string;
+    /** 서버 이름 */
+    serverName: string;
+    /** 호출 시각 (ms) */
+    startedAt: number;
+    /** 서버 글로벌 상태 접근 */
+    state: Record<string, any>;
+}
+/** 도구 응답 (자동으로 MCP content 형식으로 변환됨) */
+export type AirToolResponse = string | number | boolean | Record<string, any> | any[] | {
+    text: string;
+} | {
+    image: string;
+    mimeType?: string;
+} | {
+    content: Array<{
+        type: string;
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+};
+/** 도구 정의 객체 */
+export interface AirToolDef {
+    /** 도구 이름 (MCP 등록명) */
+    name: string;
+    /** 설명 (LLM이 도구를 선택할 때 참고) */
+    description?: string;
+    /** 파라미터 정의 */
+    params?: AirToolParams;
+    /** 핸들러 함수 */
+    handler: AirToolHandler;
+    /** 7-Layer 계층 힌트 (1~7, 선택) */
+    layer?: number;
+    /** 태그 (분류/필터용) */
+    tags?: string[];
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/types/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,4BAA4B;AAC5B,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,GACT,SAAS,GACT,UAAU,GACV,QAAQ,GACR,SAAS,CAAC;AAEd,oBAAoB;AACpB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wCAAwC;AACxC,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;AAExF,gBAAgB;AAChB,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CACpD,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAC;AAEhD,wBAAwB;AACxB,MAAM,WAAW,cAAc;IAC7B,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B;AAED,wCAAwC;AACxC,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACnB,GAAG,EAAE,GACL;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAE1F,eAAe;AACf,MAAM,WAAW,UAAU;IACzB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,aAAa;IACb,OAAO,EAAE,cAAc,CAAC;IACxB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/types/tool.js

@@ -0,0 +1,4 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — types/tool.ts
+export {};
+//# sourceMappingURL=tool.js.map

package/dist/types/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,mCAAmC"}

package/dist/types/transport.d.ts

@@ -0,0 +1,12 @@
+export type TransportType = 'stdio' | 'http' | 'sse' | 'auto';
+export interface TransportConfig {
+    /** transport 타입 (기본: auto → 환경에 따라 stdio 또는 http) */
+    type?: TransportType;
+    /** HTTP/SSE 포트 */
+    port?: number;
+    /** HTTP/SSE 호스트 (기본: localhost) */
+    host?: string;
+    /** HTTP 기본 경로 (기본: /) */
+    basePath?: string;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/types/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/types/transport.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/transport.js

@@ -0,0 +1,4 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — types/transport.ts
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/types/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/types/transport.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,wCAAwC"}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@airmcp-dev/core",
+  "version": "0.1.0",
+  "author": "CodePedia Labs",
+  "license": "Apache-2.0",
+  "description": "MCP server framework — defineServer, defineTool, middleware, transport",
+  "type": "module",
+  "files": ["dist", "README.md", "LICENSE"],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0",
+    "@types/node": "^20.0.0"
+  }
+}