@awarecorp/mcp-logger 0.0.2-dev.0 → 0.0.2-dev.1

package/dist/sdk/instrumentation.js

@@ -1 +1,99 @@
-import"@opentelemetry/sdk-node";import"@opentelemetry/exporter-trace-otlp-http";import"@opentelemetry/resources";import"@opentelemetry/api";function e(e,t=!1){throw new Error("[MCP Logger SDK] Tracer not initialized. Call initMCPLogger first.")}export{e as instrumentMCPServer};
+/**
+ * MCP Server 자동 계측
+ *
+ * setRequestHandler를 오버라이드하여 모든 요청/응답을 자동으로 추적합니다.
+ */
+import { getTracer } from '../shared/telemetry.js';
+import { setSpanAttributes, addSpanEvent, recordSpanError, markSpanSuccess, safeStringify } from '../shared/span-utils.js';
+/**
+ * MCP Server에 자동 계측 적용
+ */
+export function instrumentMCPServer(server, debug = false) {
+    const tracer = getTracer();
+    if (!tracer) {
+        throw new Error('[MCP Logger SDK] Tracer not initialized. Call initMCPLogger first.');
+    }
+    // 원본 setRequestHandler 저장
+    const originalSetRequestHandler = server.setRequestHandler.bind(server);
+    // setRequestHandler 오버라이드
+    server.setRequestHandler = function (requestSchema, handler) {
+        // requestSchema에서 method 추출
+        const methodLiteral = requestSchema.shape?.method;
+        const method = methodLiteral?._def?.value || 'unknown';
+        if (debug) {
+            console.log(`[MCP Logger SDK] Instrumenting handler: ${method}`);
+        }
+        // 래핑된 핸들러 생성
+        const wrappedHandler = async (request, extra) => {
+            const spanName = `mcp.${method}`;
+            return await tracer.startActiveSpan(spanName, {
+                attributes: {
+                    'mcp.method': method,
+                    'mcp.request.method': request.method,
+                },
+            }, async (span) => {
+                const startTime = Date.now();
+                try {
+                    // Request 로깅
+                    const paramsStr = safeStringify(request.params || {});
+                    setSpanAttributes(span, {
+                        'mcp.request.id': 'unknown', // MCPRequest에 id가 없으므로 'unknown'으로 설정
+                        'mcp.request.params.size': paramsStr?.length,
+                    });
+                    if (paramsStr && paramsStr.length < 1000) {
+                        span.setAttribute('mcp.request.params', paramsStr);
+                    }
+                    addSpanEvent(span, 'mcp.request.received', {
+                        'request.method': request.method,
+                        'request.timestamp': startTime,
+                    }, debug);
+                    if (debug) {
+                        console.log(`[MCP Logger SDK] Request received:`, {
+                            method: request.method,
+                            params: request.params,
+                        });
+                    }
+                    // 원본 핸들러 실행
+                    const result = await handler(request, extra);
+                    const endTime = Date.now();
+                    const duration = endTime - startTime;
+                    // Response 로깅
+                    const resultStr = safeStringify(result);
+                    setSpanAttributes(span, {
+                        'mcp.duration_ms': duration,
+                        'mcp.response.size': resultStr?.length,
+                    });
+                    if (resultStr && resultStr.length < 1000) {
+                        span.setAttribute('mcp.response.result', resultStr);
+                    }
+                    addSpanEvent(span, 'mcp.response.sent', {
+                        'response.timestamp': endTime,
+                        'response.duration_ms': duration,
+                    }, debug);
+                    markSpanSuccess(span);
+                    if (debug) {
+                        console.log(`[MCP Logger SDK] Response sent (${duration}ms):`, result);
+                    }
+                    return result;
+                }
+                catch (error) {
+                    // Error 로깅
+                    recordSpanError(span, error, debug);
+                    if (debug) {
+                        console.error(`[MCP Logger SDK] Error occurred:`, error);
+                    }
+                    throw error;
+                }
+                finally {
+                    span.end();
+                }
+            });
+        };
+        // 래핑된 핸들러로 등록
+        return originalSetRequestHandler(requestSchema, wrappedHandler);
+    };
+    if (debug) {
+        console.log('[MCP Logger SDK] Server instrumentation complete');
+    }
+}
+//# sourceMappingURL=instrumentation.js.map

package/dist/sdk/instrumentation.js.map

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

package/dist/sdk/types.d.ts

@@ -1,66 +1,37 @@
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { ZodObject, ZodLiteral } from 'zod';
-import { Request, Result } from '@modelcontextprotocol/sdk/types.js';
-
-/**
- * 공통 타입 정의
- */
-/**
- * 텔레메트리 초기화 옵션
- */
-interface TelemetryOptions {
-    /**
-     * API Key for authentication (필수)
-     */
-    apiKey: string;
-    /**
-     * 서비스 이름 (옵션)
-     * 지정하지 않으면 자동으로 'mcp-server-{random}' 형식으로 생성
-     */
-    serviceName?: string;
-    /**
-     * 커스텀 OTLP 엔드포인트 (옵션)
-     * 기본값: CONFIG.ENDPOINT
-     */
-    endpoint?: string;
-    /**
-     * 디버그 로그 활성화 (옵션)
-     */
-    debug?: boolean;
-}
-
 /**
  * SDK 타입 정의
  */
-
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { ZodObject, ZodLiteral } from 'zod';
+import type { Request, Result } from '@modelcontextprotocol/sdk/types.js';
+import type { TelemetryOptions } from '../shared/types.js';
 /**
  * SDK 초기화 옵션 (TelemetryOptions 확장)
  */
-interface SDKInitOptions extends TelemetryOptions {
+export interface SDKInitOptions extends TelemetryOptions {
 }
 /**
  * MCP JSON-RPC Request 타입
  */
-type MCPRequest = Request;
+export type MCPRequest = Request;
 /**
  * MCP Result 타입
  */
-type MCPResult = Result;
+export type MCPResult = Result;
 /**
  * MCP Request Schema 타입
  */
-type MCPRequestSchema = ZodObject<{
+export type MCPRequestSchema = ZodObject<{
     method: ZodLiteral<string>;
 }>;
 /**
  * Request Handler Extra 타입
  */
-interface RequestHandlerExtra {
+export interface RequestHandlerExtra {
     signal: AbortSignal;
 }
 /**
  * MCP Server 타입 (재export)
  */
-type MCPServer = Server;
-
-export type { MCPRequest, MCPRequestSchema, MCPResult, MCPServer, RequestHandlerExtra, SDKInitOptions };
+export type MCPServer = Server;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sdk/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,gBAAgB;CAAG;AAE3D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC;IACvC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;CAC5B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC"}

package/dist/sdk/types.js

@@ -0,0 +1,5 @@
+/**
+ * SDK 타입 정의
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sdk/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sdk/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/shared/config.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 공통 설정 상수
+ */
+export declare const CONFIG: {
+    /**
+     * OTLP Endpoint (하드코딩)
+     */
+    readonly ENDPOINT: "https://aware.mcypher.com/v1/traces";
+    /**
+     * SDK 버전
+     */
+    readonly SDK_VERSION: "1.0.0";
+    /**
+     * 서비스 이름 접두사
+     */
+    readonly SERVICE_NAME_PREFIX: "mcp-server";
+};
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,MAAM;IACjB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAEK,CAAC"}

package/dist/shared/config.js

@@ -1 +1,18 @@
-const e={ENDPOINT:"https://aware.mcypher.com/v1/traces",SDK_VERSION:"1.0.0",SERVICE_NAME_PREFIX:"mcp-server"};export{e as CONFIG};
+/**
+ * 공통 설정 상수
+ */
+export const CONFIG = {
+    /**
+     * OTLP Endpoint (하드코딩)
+     */
+    ENDPOINT: 'https://aware.mcypher.com/v1/traces',
+    /**
+     * SDK 버전
+     */
+    SDK_VERSION: '1.0.0',
+    /**
+     * 서비스 이름 접두사
+     */
+    SERVICE_NAME_PREFIX: 'mcp-server',
+};
+//# sourceMappingURL=config.js.map

package/dist/shared/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB;;OAEG;IACH,QAAQ,EAAE,qCAAqC;IAE/C;;OAEG;IACH,WAAW,EAAE,OAAO;IAEpB;;OAEG;IACH,mBAAmB,EAAE,YAAY;CACzB,CAAC"}

package/dist/shared/span-utils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Span 생성 및 관리 유틸리티
+ */
+import { Span } from '@opentelemetry/api';
+import type { SpanAttributes } from './types.js';
+/**
+ * Span에 안전하게 속성 추가
+ */
+export declare function setSpanAttributes(span: Span, attributes: SpanAttributes): void;
+/**
+ * Span에 이벤트 추가 (에러 핸들링 포함)
+ */
+export declare function addSpanEvent(span: Span, name: string, attributes?: SpanAttributes, debug?: boolean): void;
+/**
+ * Span에 에러 기록
+ */
+export declare function recordSpanError(span: Span, error: Error | unknown, debug?: boolean): void;
+/**
+ * Span을 성공으로 마크
+ */
+export declare function markSpanSuccess(span: Span): void;
+/**
+ * 객체를 안전하게 JSON 문자열로 변환
+ * (circular reference 처리)
+ */
+export declare function safeStringify(obj: any, maxLength?: number): string | null;
+/**
+ * Trace context 전파 헤더 생성
+ */
+export declare function getTraceHeaders(): Record<string, string>;
+//# sourceMappingURL=span-utils.d.ts.map

package/dist/shared/span-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-utils.d.ts","sourceRoot":"","sources":["../../src/shared/span-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAkC,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,GAAG,IAAI,CAM9E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,cAAc,EAC3B,KAAK,CAAC,EAAE,OAAO,GACd,IAAI,CAYN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,GAAG,OAAO,EACtB,KAAK,CAAC,EAAE,OAAO,GACd,IAAI,CAoBN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAEhD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,GAAE,MAAc,GAAG,MAAM,GAAG,IAAI,CAUhF;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxD"}

package/dist/shared/span-utils.js

@@ -1 +1,90 @@
-import{SpanStatusCode as t,context as r,trace as e}from"@opentelemetry/api";function n(t,r){for(const[e,n]of Object.entries(r))null!=n&&t.setAttribute(e,n)}function o(t,r,e,n){try{e?t.addEvent(r,e):t.addEvent(r)}catch(t){n&&console.error("[MCP Logger] Failed to add span event:",t)}}function c(r,e,n){const o=e instanceof Error?e.message:"Unknown error",c=e instanceof Error?e.constructor.name:"Error";e instanceof Error&&r.recordException(e),r.setStatus({code:t.ERROR,message:o}),r.setAttribute("error",!0),r.setAttribute("error.type",c),r.setAttribute("error.message",o),n&&console.error("[MCP Logger] Error recorded in span:",e)}function s(r){r.setStatus({code:t.OK})}function a(t,r=1e4){try{const e=JSON.stringify(t);return e.length>r?e.slice(0,r)+"... (truncated)":e}catch(t){return null}}function i(){const t={},n=r.active(),o=e.getSpan(n);if(o){const r=o.spanContext();r&&(t.traceparent=`00-${r.traceId}-${r.spanId}-01`)}return t}export{o as addSpanEvent,i as getTraceHeaders,s as markSpanSuccess,c as recordSpanError,a as safeStringify,n as setSpanAttributes};
+/**
+ * Span 생성 및 관리 유틸리티
+ */
+import { SpanStatusCode, context, trace } from '@opentelemetry/api';
+/**
+ * Span에 안전하게 속성 추가
+ */
+export function setSpanAttributes(span, attributes) {
+    for (const [key, value] of Object.entries(attributes)) {
+        if (value !== undefined && value !== null) {
+            span.setAttribute(key, value);
+        }
+    }
+}
+/**
+ * Span에 이벤트 추가 (에러 핸들링 포함)
+ */
+export function addSpanEvent(span, name, attributes, debug) {
+    try {
+        if (attributes) {
+            span.addEvent(name, attributes);
+        }
+        else {
+            span.addEvent(name);
+        }
+    }
+    catch (err) {
+        if (debug) {
+            console.error('[MCP Logger] Failed to add span event:', err);
+        }
+    }
+}
+/**
+ * Span에 에러 기록
+ */
+export function recordSpanError(span, error, debug) {
+    const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+    const errorName = error instanceof Error ? error.constructor.name : 'Error';
+    if (error instanceof Error) {
+        span.recordException(error);
+    }
+    span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: errorMessage,
+    });
+    span.setAttribute('error', true);
+    span.setAttribute('error.type', errorName);
+    span.setAttribute('error.message', errorMessage);
+    if (debug) {
+        console.error('[MCP Logger] Error recorded in span:', error);
+    }
+}
+/**
+ * Span을 성공으로 마크
+ */
+export function markSpanSuccess(span) {
+    span.setStatus({ code: SpanStatusCode.OK });
+}
+/**
+ * 객체를 안전하게 JSON 문자열로 변환
+ * (circular reference 처리)
+ */
+export function safeStringify(obj, maxLength = 10000) {
+    try {
+        const str = JSON.stringify(obj);
+        if (str.length > maxLength) {
+            return str.slice(0, maxLength) + '... (truncated)';
+        }
+        return str;
+    }
+    catch (err) {
+        return null;
+    }
+}
+/**
+ * Trace context 전파 헤더 생성
+ */
+export function getTraceHeaders() {
+    const headers = {};
+    const ctx = context.active();
+    const span = trace.getSpan(ctx);
+    if (span) {
+        const spanContext = span.spanContext();
+        if (spanContext) {
+            headers['traceparent'] = `00-${spanContext.traceId}-${spanContext.spanId}-01`;
+        }
+    }
+    return headers;
+}
+//# sourceMappingURL=span-utils.js.map

package/dist/shared/span-utils.js.map

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

package/dist/shared/telemetry.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 공통 텔레메트리 레이어
+ *
+ * OpenTelemetry SDK 초기화 및 관리를 담당합니다.
+ * SDK와 CLI 양쪽에서 공통으로 사용됩니다.
+ */
+import { Tracer } from '@opentelemetry/api';
+import type { TelemetryOptions } from './types.js';
+/**
+ * OpenTelemetry SDK 초기화
+ */
+export declare function initializeTelemetry(options: TelemetryOptions): Tracer;
+/**
+ * 현재 Tracer 반환
+ */
+export declare function getTracer(): Tracer | null;
+/**
+ * 초기화 여부 확인
+ */
+export declare function isInitializedTelemetry(): boolean;
+/**
+ * Telemetry 종료
+ */
+export declare function shutdownTelemetry(): Promise<void>;
+//# sourceMappingURL=telemetry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/shared/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAS,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMnD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAoDrE;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAWvD"}

package/dist/shared/telemetry.js

@@ -1 +1,91 @@
-import{NodeSDK as e}from"@opentelemetry/sdk-node";import{OTLPTraceExporter as r}from"@opentelemetry/exporter-trace-otlp-http";import{Resource as o}from"@opentelemetry/resources";import{trace as t}from"@opentelemetry/api";const n="https://aware.mcypher.com/v1/traces",i="1.0.0";let c=null,s=null,l=!1;function a(a){if(l)return a.debug&&console.error("[MCP Logger] Telemetry already initialized, returning existing tracer"),s;const g=a.serviceName||`mcp-server-${Math.random().toString(36).slice(2,8)}`;a.debug&&(console.error("[MCP Logger] Initializing telemetry..."),console.error(`[MCP Logger] Endpoint: ${a.endpoint||n}`),console.error(`[MCP Logger] Service: ${g}`)),c=new e({resource:new o({"service.name":g,"service.version":i}),traceExporter:new r({url:a.endpoint||n,headers:{"x-api-key":a.apiKey}})}),c.start(),s=t.getTracer("mcp-logger",i),l=!0,a.debug&&console.error("[MCP Logger] Telemetry initialized successfully");const p=async()=>{a.debug&&console.error("[MCP Logger] Shutting down telemetry..."),await u()};return process.once("SIGTERM",p),process.once("SIGINT",p),s}function g(){return s}function p(){return l}async function u(){if(c)try{await c.shutdown(),c=null,s=null,l=!1}catch(e){console.error("[MCP Logger] Error shutting down telemetry:",e)}}export{g as getTracer,a as initializeTelemetry,p as isInitializedTelemetry,u as shutdownTelemetry};
+/**
+ * 공통 텔레메트리 레이어
+ *
+ * OpenTelemetry SDK 초기화 및 관리를 담당합니다.
+ * SDK와 CLI 양쪽에서 공통으로 사용됩니다.
+ */
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { Resource } from '@opentelemetry/resources';
+import { trace } from '@opentelemetry/api';
+import { CONFIG } from './config.js';
+let sdk = null;
+let tracer = null;
+let isInitialized = false;
+/**
+ * OpenTelemetry SDK 초기화
+ */
+export function initializeTelemetry(options) {
+    if (isInitialized) {
+        if (options.debug) {
+            console.error('[MCP Logger] Telemetry already initialized, returning existing tracer');
+        }
+        return tracer;
+    }
+    // 서비스 이름 생성
+    const serviceName = options.serviceName ||
+        `${CONFIG.SERVICE_NAME_PREFIX}-${Math.random().toString(36).slice(2, 8)}`;
+    if (options.debug) {
+        console.error('[MCP Logger] Initializing telemetry...');
+        console.error(`[MCP Logger] Endpoint: ${options.endpoint || CONFIG.ENDPOINT}`);
+        console.error(`[MCP Logger] Service: ${serviceName}`);
+    }
+    // SDK 초기화
+    sdk = new NodeSDK({
+        resource: new Resource({
+            ["service.name"]: serviceName,
+            ["service.version"]: CONFIG.SDK_VERSION,
+        }),
+        traceExporter: new OTLPTraceExporter({
+            url: options.endpoint || CONFIG.ENDPOINT,
+            headers: {
+                'x-api-key': options.apiKey,
+            },
+        }),
+    });
+    sdk.start();
+    tracer = trace.getTracer('mcp-logger', CONFIG.SDK_VERSION);
+    isInitialized = true;
+    if (options.debug) {
+        console.error('[MCP Logger] Telemetry initialized successfully');
+    }
+    // 프로세스 종료 시 정리
+    const cleanup = async () => {
+        if (options.debug) {
+            console.error('[MCP Logger] Shutting down telemetry...');
+        }
+        await shutdownTelemetry();
+    };
+    process.once('SIGTERM', cleanup);
+    process.once('SIGINT', cleanup);
+    return tracer;
+}
+/**
+ * 현재 Tracer 반환
+ */
+export function getTracer() {
+    return tracer;
+}
+/**
+ * 초기화 여부 확인
+ */
+export function isInitializedTelemetry() {
+    return isInitialized;
+}
+/**
+ * Telemetry 종료
+ */
+export async function shutdownTelemetry() {
+    if (sdk) {
+        try {
+            await sdk.shutdown();
+            sdk = null;
+            tracer = null;
+            isInitialized = false;
+        }
+        catch (err) {
+            console.error('[MCP Logger] Error shutting down telemetry:', err);
+        }
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/shared/telemetry.js.map

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

package/dist/shared/types.d.ts

@@ -4,7 +4,7 @@
 /**
  * 텔레메트리 초기화 옵션
  */
-interface TelemetryOptions {
+export interface TelemetryOptions {
     /**
      * API Key for authentication (필수)
      */
@@ -27,17 +27,17 @@ interface TelemetryOptions {
 /**
  * Span 속성 인터페이스
  */
-interface SpanAttributes {
+export interface SpanAttributes {
     [key: string]: string | number | boolean | undefined;
 }
 /**
  * MCP 메시지 방향
  */
-type MessageDirection = 'request' | 'response';
+export type MessageDirection = 'request' | 'response';
 /**
  * JSON-RPC 메시지 타입
  */
-interface JSONRPCMessage {
+export interface JSONRPCMessage {
     jsonrpc: '2.0';
     id?: string | number;
     method?: string;
@@ -49,5 +49,4 @@ interface JSONRPCMessage {
         data?: any;
     };
 }
-
-export type { JSONRPCMessage, MessageDirection, SpanAttributes, TelemetryOptions };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,GAAG,CAAC;KACZ,CAAC;CACH"}

package/dist/shared/types.js

@@ -0,0 +1,5 @@
+/**
+ * 공통 타입 정의
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awarecorp/mcp-logger",
-  "version": "0.0.2-dev.0",
+  "version": "0.0.2-dev.1",
   "description": "Unified MCP observability solution - SDK for code integration and CLI for zero-config wrapping",
   "type": "module",
   "main": "dist/index.js",
@@ -14,12 +14,11 @@
     "!dist/cli/**/*.d.ts"
   ],
   "scripts": {
-    "build": "npm run clean && rollup -c",
-    "build:readable": "npm run clean && tsc",
+    "build": "tsc",
     "prepublishOnly": "npm run build",
     "clean": "rm -rf dist",
     "dev": "tsc --watch",
-    "test:cli": "npm run build:readable && node bin/mcp-logger.js --help",
+    "test:cli": "npm run build && node bin/mcp-logger.js --help",
     "publish:stable": "npm run build && npm publish --access public",
     "publish:dev": "npm run build && npm publish --access public --tag dev",
     "version:patch": "npm version patch",
@@ -49,21 +48,16 @@
     }
   },
   "dependencies": {
+    "@opentelemetry/sdk-node": "^0.52.0",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.52.0",
     "@opentelemetry/resources": "^1.25.0",
-    "@opentelemetry/sdk-node": "^0.52.0",
     "@opentelemetry/semantic-conventions": "^1.25.0",
     "commander": "^11.1.0"
   },
   "devDependencies": {
-    "@modelcontextprotocol/sdk": "^0.5.0",
-    "@rollup/plugin-terser": "^0.4.4",
-    "@rollup/plugin-typescript": "^12.1.4",
     "@types/node": "^20.0.0",
-    "rollup": "^4.52.5",
-    "rollup-plugin-dts": "^6.2.3",
-    "tslib": "^2.8.1",
+    "@modelcontextprotocol/sdk": "^0.5.0",
     "typescript": "^5.3.0"
   },
   "engines": {