@airmcp-dev/core 0.1.0

package/dist/storage/file-store.js

@@ -0,0 +1,177 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — storage/file-store.ts
+//
+// 파일 기반 StorageAdapter 구현.
+// 네임스페이스별로 JSON 파일에 저장한다.
+// 외부 의존성 없이 Node.js fs만 사용.
+//
+// 저장 구조:
+//   {basePath}/
+//     {namespace}.json      — key-value 데이터
+//     {namespace}.log.jsonl — append-only 로그
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export class FileStore {
+    basePath;
+    cache = new Map();
+    dirty = new Set();
+    flushTimer = null;
+    constructor(basePath) {
+        this.basePath = basePath || join(process.cwd(), '.air', 'data');
+    }
+    async init() {
+        await mkdir(this.basePath, { recursive: true });
+        // 주기적 flush (5초마다 dirty 네임스페이스만 저장)
+        this.flushTimer = setInterval(() => this.flushAll(), 5000);
+    }
+    async set(namespace, key, value, ttl) {
+        const ns = await this.loadNamespace(namespace);
+        const expireAt = ttl ? Date.now() + ttl * 1000 : undefined;
+        ns.set(key, { value, expireAt });
+        this.dirty.add(namespace);
+    }
+    async get(namespace, key) {
+        const ns = await this.loadNamespace(namespace);
+        const entry = ns.get(key);
+        if (!entry)
+            return null;
+        if (entry.expireAt && Date.now() > entry.expireAt) {
+            ns.delete(key);
+            this.dirty.add(namespace);
+            return null;
+        }
+        return entry.value;
+    }
+    async delete(namespace, key) {
+        const ns = await this.loadNamespace(namespace);
+        const existed = ns.delete(key);
+        if (existed)
+            this.dirty.add(namespace);
+        return existed;
+    }
+    async list(namespace, prefix) {
+        const ns = await this.loadNamespace(namespace);
+        this.cleanExpired(ns, namespace);
+        const keys = [];
+        for (const k of ns.keys()) {
+            if (!prefix || k.startsWith(prefix))
+                keys.push(k);
+        }
+        return keys;
+    }
+    async entries(namespace, prefix) {
+        const ns = await this.loadNamespace(namespace);
+        this.cleanExpired(ns, namespace);
+        const result = [];
+        for (const [k, entry] of ns.entries()) {
+            if (!prefix || k.startsWith(prefix)) {
+                result.push({ key: k, value: entry.value });
+            }
+        }
+        return result;
+    }
+    async append(namespace, entry) {
+        const logPath = join(this.basePath, `${namespace}.log.jsonl`);
+        const line = JSON.stringify({ ...entry, _ts: Date.now() }) + '\n';
+        try {
+            const existing = await readFile(logPath, 'utf-8').catch(() => '');
+            await writeFile(logPath, existing + line, 'utf-8');
+        }
+        catch {
+            await writeFile(logPath, line, 'utf-8');
+        }
+    }
+    async query(namespace, opts) {
+        const logPath = join(this.basePath, `${namespace}.log.jsonl`);
+        let content;
+        try {
+            content = await readFile(logPath, 'utf-8');
+        }
+        catch {
+            return [];
+        }
+        let entries = content
+            .split('\n')
+            .filter((line) => line.trim())
+            .map((line) => {
+            try {
+                return JSON.parse(line);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter(Boolean);
+        if (opts?.since)
+            entries = entries.filter((e) => e._ts >= opts.since.getTime());
+        if (opts?.until)
+            entries = entries.filter((e) => e._ts <= opts.until.getTime());
+        if (opts?.filter) {
+            entries = entries.filter((e) => {
+                for (const [k, v] of Object.entries(opts.filter)) {
+                    if (e[k] !== v)
+                        return false;
+                }
+                return true;
+            });
+        }
+        entries.sort((a, b) => b._ts - a._ts);
+        const offset = opts?.offset || 0;
+        const limit = opts?.limit || 100;
+        return entries.slice(offset, offset + limit);
+    }
+    async close() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        await this.flushAll();
+        this.cache.clear();
+    }
+    // ── 내부 메서드 ──
+    async loadNamespace(namespace) {
+        if (this.cache.has(namespace))
+            return this.cache.get(namespace);
+        const filePath = join(this.basePath, `${namespace}.json`);
+        const ns = new Map();
+        try {
+            const raw = await readFile(filePath, 'utf-8');
+            const data = JSON.parse(raw);
+            for (const [k, v] of Object.entries(data)) {
+                ns.set(k, v);
+            }
+        }
+        catch {
+            // 파일 없으면 빈 맵
+        }
+        this.cache.set(namespace, ns);
+        return ns;
+    }
+    async flushNamespace(namespace) {
+        const ns = this.cache.get(namespace);
+        if (!ns)
+            return;
+        const filePath = join(this.basePath, `${namespace}.json`);
+        const data = {};
+        for (const [k, v] of ns.entries()) {
+            data[k] = v;
+        }
+        await writeFile(filePath, JSON.stringify(data, null, 2), 'utf-8');
+    }
+    async flushAll() {
+        for (const ns of this.dirty) {
+            await this.flushNamespace(ns);
+        }
+        this.dirty.clear();
+    }
+    cleanExpired(ns, namespace) {
+        const now = Date.now();
+        for (const [k, entry] of ns.entries()) {
+            if (entry.expireAt && now > entry.expireAt) {
+                ns.delete(k);
+                this.dirty.add(namespace);
+            }
+        }
+    }
+}
+//# sourceMappingURL=file-store.js.map

package/dist/storage/file-store.js.map

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

package/dist/storage/index.d.ts

@@ -0,0 +1,4 @@
+export { createStorage } from './storage-adapter.js';
+export { MemoryStore } from './memory-store.js';
+export { FileStore } from './file-store.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,6 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — storage/index.ts (re-export only)
+export { createStorage } from './storage-adapter.js';
+export { MemoryStore } from './memory-store.js';
+export { FileStore } from './file-store.js';
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,uDAAuD;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/storage/memory-store.d.ts

@@ -0,0 +1,18 @@
+import type { StorageAdapter, QueryOptions } from '../types/storage.js';
+export declare class MemoryStore implements StorageAdapter {
+    private data;
+    private logs;
+    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>;
+    list(namespace: string, prefix?: string): Promise<string[]>;
+    entries<T = any>(namespace: string, prefix?: string): Promise<Array<{
+        key: string;
+        value: T;
+    }>>;
+    append(namespace: string, entry: any): Promise<void>;
+    query(namespace: string, opts?: QueryOptions): Promise<any[]>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/storage/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/storage/memory-store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOxE,qBAAa,WAAY,YAAW,cAAc;IAChD,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,IAAI,CAA4B;IAElC,IAAI;IAIJ,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM;IAM5D,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAW/D,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS3D,OAAO,CAAC,CAAC,GAAG,GAAG,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAWtC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAKpC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAqB7D,KAAK;CAIZ"}

package/dist/storage/memory-store.js

@@ -0,0 +1,80 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — storage/memory-store.ts
+// 인메모리 StorageAdapter 구현 (개발용 기본값)
+export class MemoryStore {
+    data = new Map();
+    logs = new Map();
+    async init() {
+        /* no-op */
+    }
+    async set(namespace, key, value, ttl) {
+        const fullKey = `${namespace}:${key}`;
+        const expireAt = ttl ? Date.now() + ttl * 1000 : undefined;
+        this.data.set(fullKey, { value, expireAt });
+    }
+    async get(namespace, key) {
+        const fullKey = `${namespace}:${key}`;
+        const entry = this.data.get(fullKey);
+        if (!entry)
+            return null;
+        if (entry.expireAt && Date.now() > entry.expireAt) {
+            this.data.delete(fullKey);
+            return null;
+        }
+        return entry.value;
+    }
+    async delete(namespace, key) {
+        return this.data.delete(`${namespace}:${key}`);
+    }
+    async list(namespace, prefix) {
+        const nsPrefix = prefix ? `${namespace}:${prefix}` : `${namespace}:`;
+        const keys = [];
+        for (const k of this.data.keys()) {
+            if (k.startsWith(nsPrefix))
+                keys.push(k.slice(namespace.length + 1));
+        }
+        return keys;
+    }
+    async entries(namespace, prefix) {
+        const nsPrefix = prefix ? `${namespace}:${prefix}` : `${namespace}:`;
+        const result = [];
+        for (const [k, entry] of this.data.entries()) {
+            if (!k.startsWith(nsPrefix))
+                continue;
+            if (entry.expireAt && Date.now() > entry.expireAt)
+                continue;
+            result.push({ key: k.slice(namespace.length + 1), value: entry.value });
+        }
+        return result;
+    }
+    async append(namespace, entry) {
+        if (!this.logs.has(namespace))
+            this.logs.set(namespace, []);
+        this.logs.get(namespace).push({ ...entry, _ts: Date.now() });
+    }
+    async query(namespace, opts) {
+        let entries = this.logs.get(namespace) || [];
+        if (opts?.since)
+            entries = entries.filter((e) => e._ts >= opts.since.getTime());
+        if (opts?.until)
+            entries = entries.filter((e) => e._ts <= opts.until.getTime());
+        if (opts?.filter) {
+            entries = entries.filter((e) => {
+                for (const [k, v] of Object.entries(opts.filter)) {
+                    if (e[k] !== v)
+                        return false;
+                }
+                return true;
+            });
+        }
+        entries.sort((a, b) => b._ts - a._ts);
+        const offset = opts?.offset || 0;
+        const limit = opts?.limit || 100;
+        return entries.slice(offset, offset + limit);
+    }
+    async close() {
+        this.data.clear();
+        this.logs.clear();
+    }
+}
+//# sourceMappingURL=memory-store.js.map

package/dist/storage/memory-store.js.map

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

package/dist/storage/storage-adapter.d.ts

@@ -0,0 +1,4 @@
+import type { StorageAdapter, StoreOptions } from '../types/storage.js';
+/** StoreOptions에 따라 적절한 StorageAdapter를 생성 */
+export declare function createStorage(options?: StoreOptions): Promise<StorageAdapter>;
+//# sourceMappingURL=storage-adapter.d.ts.map

package/dist/storage/storage-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter.d.ts","sourceRoot":"","sources":["../../src/storage/storage-adapter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxE,8CAA8C;AAC9C,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CA4BnF"}

package/dist/storage/storage-adapter.js

@@ -0,0 +1,32 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — storage/storage-adapter.ts
+// StorageAdapter 팩토리
+import { MemoryStore } from './memory-store.js';
+import { FileStore } from './file-store.js';
+/** StoreOptions에 따라 적절한 StorageAdapter를 생성 */
+export async function createStorage(options) {
+    const type = options?.type || 'memory';
+    switch (type) {
+        case 'memory': {
+            const store = new MemoryStore();
+            await store.init();
+            return store;
+        }
+        case 'file': {
+            const store = new FileStore(options?.path);
+            await store.init();
+            return store;
+        }
+        case 'sqlite': {
+            // SQLite는 별도 패키지(@airmcp-dev/storage-sqlite)로 제공 예정
+            // 지금은 FileStore로 fallback
+            console.warn('[air] SQLite storage not yet available — using FileStore');
+            const store = new FileStore(options?.path);
+            await store.init();
+            return store;
+        }
+        default:
+            throw new Error(`Unknown storage type: ${type}. Available: memory, file, sqlite`);
+    }
+}
+//# sourceMappingURL=storage-adapter.js.map

package/dist/storage/storage-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter.js","sourceRoot":"","sources":["../../src/storage/storage-adapter.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,gDAAgD;AAChD,qBAAqB;AAGrB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,8CAA8C;AAC9C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAsB;IACxD,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,QAAQ,CAAC;IAEvC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC;YAChC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC3C,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,oDAAoD;YACpD,0BAA0B;YAC1B,OAAO,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;YACzE,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC3C,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,mCAAmC,CAAC,CAAC;IACtF,CAAC;AACH,CAAC"}

package/dist/telemetry/index.d.ts

@@ -0,0 +1,3 @@
+export { TelemetryManager } from './telemetry.js';
+export type { TelemetryConfig, TelemetryEvent } from './telemetry.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/telemetry/index.js

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

package/dist/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yDAAyD;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/telemetry/telemetry.d.ts

@@ -0,0 +1,56 @@
+/** 텔레메트리 설정 */
+export interface TelemetryConfig {
+    /** 활성화 여부 (기본: false, opt-in) */
+    enabled: boolean;
+    /** 수집 엔드포인트 (기본: https://telemetry.airmcp.dev/v1/collect) */
+    endpoint?: string;
+}
+/** 텔레메트리 이벤트 */
+export interface TelemetryEvent {
+    /** 이벤트 타입 */
+    event: 'server.start' | 'server.stop';
+    /** 익명 서버 ID (서버 이름 SHA-256 해시의 앞 12자) */
+    serverId: string;
+    /** air 프레임워크 버전 */
+    airVersion: string;
+    /** 도구 수 */
+    toolCount: number;
+    /** 리소스 수 */
+    resourceCount: number;
+    /** 프롬프트 수 */
+    promptCount: number;
+    /** 활성 플러그인 이름 목록 */
+    plugins: string[];
+    /** transport 타입 */
+    transport: string;
+    /** Node.js 버전 */
+    nodeVersion: string;
+    /** OS */
+    os: string;
+    /** 아키텍처 */
+    arch: string;
+    /** 타임스탬프 */
+    timestamp: string;
+}
+/** 텔레메트리 매니저 */
+export declare class TelemetryManager {
+    private config;
+    private endpoint;
+    constructor(config?: Partial<TelemetryConfig>);
+    /** 텔레메트리 이벤트 전송 (비동기, 실패해도 무시) */
+    send(event: TelemetryEvent): Promise<void>;
+    /** 서버 시작 이벤트 생성 */
+    createStartEvent(options: {
+        serverName: string;
+        airVersion: string;
+        toolCount: number;
+        resourceCount: number;
+        promptCount: number;
+        plugins: string[];
+        transport: string;
+    }): TelemetryEvent;
+    /** 서버 중지 이벤트 생성 */
+    createStopEvent(serverName: string, airVersion: string): TelemetryEvent;
+    get isEnabled(): boolean;
+}
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry.ts"],"names":[],"mappings":"AAwBA,eAAe;AACf,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gBAAgB;AAChB,MAAM,WAAW,cAAc;IAC7B,aAAa;IACb,KAAK,EAAE,cAAc,GAAG,aAAa,CAAC;IACtC,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS;IACT,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AASD,gBAAgB;AAChB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAO7C,kCAAkC;IAC5B,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBhD,mBAAmB;IACnB,gBAAgB,CAAC,OAAO,EAAE;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,cAAc;IAiBlB,mBAAmB;IACnB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc;IAiBvE,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF"}

package/dist/telemetry/telemetry.js

@@ -0,0 +1,95 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — telemetry/telemetry.ts
+//
+// 텔레메트리 모듈 — opt-in 익명 사용 통계 수집.
+// 개인 정보 일절 수집하지 않음.
+//
+// 수집 항목:
+//   - 서버 시작/중지 이벤트
+//   - 등록된 도구/리소스/프롬프트 수
+//   - 사용 중인 플러그인 이름 (설정값 X)
+//   - transport 타입
+//   - Node.js 버전
+//   - OS 플랫폼
+//   - air 프레임워크 버전
+//
+// 수집하지 않는 것:
+//   - 도구 파라미터, 응답 내용
+//   - IP 주소 (서버 사이드에서도 저장 안 함)
+//   - 사용자 식별 정보
+//   - 서버 이름, 도구 이름 (해시만 전송)
+import { platform, release, arch } from 'node:os';
+import { createHash } from 'node:crypto';
+const DEFAULT_ENDPOINT = 'https://telemetry.airmcp.dev/v1/collect';
+/** 서버 이름을 익명 해시로 변환 */
+function anonymize(name) {
+    return createHash('sha256').update(name).digest('hex').slice(0, 12);
+}
+/** 텔레메트리 매니저 */
+export class TelemetryManager {
+    config;
+    endpoint;
+    constructor(config) {
+        this.config = {
+            enabled: config?.enabled ?? false,
+        };
+        this.endpoint = config?.endpoint ?? DEFAULT_ENDPOINT;
+    }
+    /** 텔레메트리 이벤트 전송 (비동기, 실패해도 무시) */
+    async send(event) {
+        if (!this.config.enabled)
+            return;
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 3000);
+            await fetch(this.endpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(event),
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+        }
+        catch {
+            // 텔레메트리 실패는 무시 — 서버 동작에 영향 없음
+        }
+    }
+    /** 서버 시작 이벤트 생성 */
+    createStartEvent(options) {
+        return {
+            event: 'server.start',
+            serverId: anonymize(options.serverName),
+            airVersion: options.airVersion,
+            toolCount: options.toolCount,
+            resourceCount: options.resourceCount,
+            promptCount: options.promptCount,
+            plugins: options.plugins,
+            transport: options.transport,
+            nodeVersion: process.version,
+            os: `${platform()}-${release()}`,
+            arch: arch(),
+            timestamp: new Date().toISOString(),
+        };
+    }
+    /** 서버 중지 이벤트 생성 */
+    createStopEvent(serverName, airVersion) {
+        return {
+            event: 'server.stop',
+            serverId: anonymize(serverName),
+            airVersion,
+            toolCount: 0,
+            resourceCount: 0,
+            promptCount: 0,
+            plugins: [],
+            transport: '',
+            nodeVersion: process.version,
+            os: `${platform()}-${release()}`,
+            arch: arch(),
+            timestamp: new Date().toISOString(),
+        };
+    }
+    get isEnabled() {
+        return this.config.enabled;
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry/telemetry.js.map

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

package/dist/tool/define-tool.d.ts

@@ -0,0 +1,23 @@
+import type { AirToolDef, AirToolParams, AirToolHandler } from '../types/tool.js';
+/**
+ * MCP 도구를 정의한다.
+ *
+ * @example
+ * ```ts
+ * const search = defineTool('search', {
+ *   description: '고객 검색',
+ *   params: { query: 'string', limit: 'number?' },
+ *   handler: async ({ query, limit }) => {
+ *     return db.find({ query }).limit(limit ?? 10);
+ *   },
+ * });
+ * ```
+ */
+export declare function defineTool(name: string, options: {
+    description?: string;
+    params?: AirToolParams;
+    handler: AirToolHandler;
+    layer?: number;
+    tags?: string[];
+}): AirToolDef;
+//# sourceMappingURL=define-tool.d.ts.map

package/dist/tool/define-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool.d.ts","sourceRoot":"","sources":["../../src/tool/define-tool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,GACA,UAAU,CASZ"}

package/dist/tool/define-tool.js

@@ -0,0 +1,28 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — tool/define-tool.ts
+// defineTool() — 도구 정의 헬퍼. 타입 안전한 도구를 간결하게 정의.
+/**
+ * MCP 도구를 정의한다.
+ *
+ * @example
+ * ```ts
+ * const search = defineTool('search', {
+ *   description: '고객 검색',
+ *   params: { query: 'string', limit: 'number?' },
+ *   handler: async ({ query, limit }) => {
+ *     return db.find({ query }).limit(limit ?? 10);
+ *   },
+ * });
+ * ```
+ */
+export function defineTool(name, options) {
+    return {
+        name,
+        description: options.description,
+        params: options.params,
+        handler: options.handler,
+        layer: options.layer,
+        tags: options.tags,
+    };
+}
+//# sourceMappingURL=define-tool.js.map

package/dist/tool/define-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool.js","sourceRoot":"","sources":["../../src/tool/define-tool.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yCAAyC;AACzC,+CAA+C;AAI/C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,OAMC;IAED,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC;AACJ,CAAC"}

package/dist/tool/index.d.ts

@@ -0,0 +1,5 @@
+export { defineTool } from './define-tool.js';
+export { paramsToZodSchema, paramsToJsonSchema } from './tool-schema.js';
+export { normalizeResult } from './tool-result.js';
+export type { McpContent } from './tool-result.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tool/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/tool/index.js

@@ -0,0 +1,6 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — tool/index.ts (re-export only)
+export { defineTool } from './define-tool.js';
+export { paramsToZodSchema, paramsToJsonSchema } from './tool-schema.js';
+export { normalizeResult } from './tool-result.js';
+//# sourceMappingURL=index.js.map

package/dist/tool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tool/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,oDAAoD;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/tool/tool-result.d.ts

@@ -0,0 +1,10 @@
+import type { AirToolResponse } from '../types/tool.js';
+export interface McpContent {
+    type: 'text' | 'image' | 'resource';
+    text?: string;
+    data?: string;
+    mimeType?: string;
+}
+/** AirToolResponse를 MCP content 배열로 변환 */
+export declare function normalizeResult(result: AirToolResponse): McpContent[];
+//# sourceMappingURL=tool-result.d.ts.map