@su-record/vibe 2.7.2 → 2.7.5

package/dist/tools/vision/index.js

@@ -0,0 +1,328 @@
+/**
+ * Vision MCP Tools — Phase 4-3
+ *
+ * - core_vision_start: Vision 세션 시작
+ * - core_vision_stop: Vision 세션 종료
+ * - core_vision_mode: 모드 전환
+ * - core_vision_snapshot: 단발 캡처
+ * - core_vision_ask: 현재 화면에 질문
+ */
+import { ScreenCaptureEngine, LocalCaptureSource, CDPCaptureSource, RemoteCaptureSource } from '../../interface/vision/ScreenCaptureEngine.js';
+import { VisionSessionManager } from '../../interface/vision/VisionSession.js';
+import { GeminiLiveStream } from '../../interface/vision/GeminiLiveStream.js';
+// ============================================================================
+// Singleton
+// ============================================================================
+let sessionManager = null;
+let captureEngine = null;
+let liveStream = null;
+function getLogger() {
+    return (level, message) => {
+        if (level === 'error') {
+            console.error(`[vision] ${message}`);
+        }
+    };
+}
+function ensureEngine() {
+    if (!captureEngine) {
+        const logger = getLogger();
+        const sources = [
+            new LocalCaptureSource(logger),
+            new CDPCaptureSource(logger),
+            new RemoteCaptureSource(),
+        ];
+        captureEngine = new ScreenCaptureEngine(sources, logger);
+    }
+    return captureEngine;
+}
+function ensureSessionManager() {
+    if (!sessionManager) {
+        sessionManager = new VisionSessionManager(getLogger());
+    }
+    return sessionManager;
+}
+function ensureLiveStream() {
+    if (!liveStream) {
+        const apiKey = process.env.GEMINI_API_KEY ?? '';
+        if (!apiKey) {
+            throw new Error('GEMINI_API_KEY 환경변수가 설정되지 않았습니다.');
+        }
+        liveStream = new GeminiLiveStream(apiKey, getLogger());
+    }
+    return liveStream;
+}
+function validateRegion(x, y, width, height) {
+    if (x < 0 || y < 0)
+        return '좌표는 0 이상이어야 합니다.';
+    if (width < 100 || height < 100)
+        return '최소 캡처 영역은 100x100px입니다.';
+    if (width > 7680 || height > 4320)
+        return '최대 캡처 영역은 7680x4320px입니다.';
+    if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(width) || !Number.isFinite(height)) {
+        return '좌표값이 유효하지 않습니다.';
+    }
+    return null;
+}
+function successResult(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+function errorResult(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return { content: [{ type: 'text', text: JSON.stringify({ error: msg }, null, 2) }] };
+}
+// ============================================================================
+// Tool Definitions
+// ============================================================================
+export const visionStartDefinition = {
+    name: 'core_vision_start',
+    description: 'vision start|screen share - Start a vision session with screen capture',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            mode: { type: 'string', enum: ['full', 'region', 'window'], description: 'Capture mode (default: full)' },
+            x: { type: 'number', description: 'Region X coordinate' },
+            y: { type: 'number', description: 'Region Y coordinate' },
+            width: { type: 'number', description: 'Region width' },
+            height: { type: 'number', description: 'Region height' },
+            windowId: { type: 'string', description: 'Window ID for window mode' },
+        },
+    },
+    annotations: {
+        title: 'Vision Start',
+        audience: ['assistant'],
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+};
+export const visionStopDefinition = {
+    name: 'core_vision_stop',
+    description: 'vision stop|screen share stop - Stop vision session',
+    inputSchema: { type: 'object', properties: {} },
+    annotations: {
+        title: 'Vision Stop',
+        audience: ['assistant'],
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+};
+export const visionModeDefinition = {
+    name: 'core_vision_mode',
+    description: 'vision mode|change capture mode - Switch capture mode',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            mode: { type: 'string', enum: ['full', 'region', 'window'], description: 'New capture mode' },
+            x: { type: 'number', description: 'Region X' },
+            y: { type: 'number', description: 'Region Y' },
+            width: { type: 'number', description: 'Region width' },
+            height: { type: 'number', description: 'Region height' },
+            windowId: { type: 'string', description: 'Window ID' },
+        },
+        required: ['mode'],
+    },
+    annotations: {
+        title: 'Vision Mode',
+        audience: ['assistant'],
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+};
+export const visionSnapshotDefinition = {
+    name: 'core_vision_snapshot',
+    description: 'vision snapshot|screenshot - Take a single screenshot',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            mode: { type: 'string', enum: ['full', 'region', 'window'], description: 'Capture mode' },
+            x: { type: 'number', description: 'Region X' },
+            y: { type: 'number', description: 'Region Y' },
+            width: { type: 'number', description: 'Region width' },
+            height: { type: 'number', description: 'Region height' },
+        },
+    },
+    annotations: {
+        title: 'Vision Snapshot',
+        audience: ['user', 'assistant'],
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+export const visionAskDefinition = {
+    name: 'core_vision_ask',
+    description: 'vision ask|ask about screen - Ask a question about the current screen',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            question: { type: 'string', description: 'Question about the screen' },
+        },
+        required: ['question'],
+    },
+    annotations: {
+        title: 'Vision Ask',
+        audience: ['user', 'assistant'],
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+// ============================================================================
+// Tool Handlers
+// ============================================================================
+export async function visionStart(args) {
+    try {
+        const engine = ensureEngine();
+        const mgr = ensureSessionManager();
+        const validModes = ['full', 'region', 'window'];
+        const mode = validModes.includes(args.mode) ? args.mode : 'full';
+        let region;
+        if (mode === 'region' && args.x != null && args.y != null && args.width != null && args.height != null) {
+            const err = validateRegion(args.x, args.y, args.width, args.height);
+            if (err)
+                return errorResult({ message: err });
+            region = { x: args.x, y: args.y, width: args.width, height: args.height };
+        }
+        const session = mgr.create('local', engine, {
+            initialMode: mode,
+            initialRegion: region,
+            initialWindowId: args.windowId,
+        });
+        session.start();
+        return successResult({
+            sessionId: session.sessionId,
+            mode,
+            state: session.getState(),
+            message: 'Vision 세션이 시작되었습니다.',
+        });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+}
+export async function visionStop() {
+    try {
+        const mgr = ensureSessionManager();
+        const session = mgr.get('local');
+        if (!session) {
+            return successResult({ message: '활성 Vision 세션이 없습니다.' });
+        }
+        session.end('user_request');
+        return successResult({ message: 'Vision 세션이 종료되었습니다.' });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+}
+export async function visionMode(args) {
+    try {
+        const mgr = ensureSessionManager();
+        const session = mgr.get('local');
+        if (!session) {
+            return errorResult({ message: '활성 Vision 세션이 없습니다.' });
+        }
+        const validModes = ['full', 'region', 'window'];
+        const mode = validModes.includes(args.mode) ? args.mode : 'full';
+        let region;
+        if (mode === 'region' && args.x != null && args.y != null && args.width != null && args.height != null) {
+            const err = validateRegion(args.x, args.y, args.width, args.height);
+            if (err)
+                return errorResult({ message: err });
+            region = { x: args.x, y: args.y, width: args.width, height: args.height };
+        }
+        session.changeMode(mode, region, args.windowId);
+        return successResult({ mode, message: `모드가 ${mode}으로 전환되었습니다.` });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+}
+export async function visionSnapshot(args) {
+    try {
+        const engine = ensureEngine();
+        const validModes = ['full', 'region', 'window'];
+        const mode = validModes.includes(args.mode) ? args.mode : 'full';
+        let region;
+        if (mode === 'region' && args.x != null && args.y != null && args.width != null && args.height != null) {
+            const err = validateRegion(args.x, args.y, args.width, args.height);
+            if (err)
+                return errorResult({ message: err });
+            region = { x: args.x, y: args.y, width: args.width, height: args.height };
+        }
+        const result = await engine.capture(mode, region);
+        return successResult({
+            mode,
+            format: result.format,
+            width: result.width,
+            height: result.height,
+            sizeBytes: result.sizeBytes,
+            capturedAt: result.capturedAt,
+            base64Length: result.buffer.toString('base64').length,
+        });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+}
+export async function visionAsk(args) {
+    try {
+        const engine = ensureEngine();
+        const result = await engine.capture('full');
+        const frameBase64 = result.buffer.toString('base64');
+        // Use Gemini REST fallback for single-shot question
+        const apiKey = process.env.GEMINI_API_KEY ?? '';
+        if (!apiKey) {
+            return errorResult({ message: 'GEMINI_API_KEY 환경변수가 설정되지 않았습니다.' });
+        }
+        const model = 'gemini-2.5-flash';
+        const url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${apiKey}`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 30_000);
+        try {
+            const res = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    contents: [{
+                            parts: [
+                                { text: args.question },
+                                { inlineData: { mimeType: `image/${result.format}`, data: frameBase64 } },
+                            ],
+                        }],
+                }),
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            if (!res.ok) {
+                throw new Error(`Gemini API HTTP ${res.status}`);
+            }
+            const data = (await res.json());
+            const answer = data.candidates?.[0]?.content?.parts?.[0]?.text ?? '';
+            return successResult({ question: args.question, answer: answer.trim() });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+}
+/** 서비스 종료 */
+export function shutdownVisionService() {
+    sessionManager?.endAll();
+    if (liveStream) {
+        liveStream.disconnect().catch(() => { });
+    }
+    captureEngine = null;
+    sessionManager = null;
+    liveStream = null;
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/vision/index.js.map

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

package/dist/tools/voice/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Voice MCP Tools — STT/TTS/Session 도구
+ *
+ * - core_voice_status: 음성 세션 상태
+ * - core_tts_speak: 텍스트 → 음성 변환
+ * - core_stt_transcribe: 오디오 → 텍스트 변환
+ */
+import type { ToolResult, ToolDefinition } from '../../infra/types/tool.js';
+export declare const voiceStatusDefinition: ToolDefinition;
+export declare const ttsSpeakDefinition: ToolDefinition;
+export declare const sttTranscribeDefinition: ToolDefinition;
+export declare function voiceStatus(): Promise<ToolResult>;
+export declare function ttsSpeak(args: {
+    text: string;
+    voice?: string;
+    format?: string;
+}): Promise<ToolResult>;
+export declare function sttTranscribe(args: {
+    audioPath: string;
+    language?: string;
+}): Promise<ToolResult>;
+/** 서비스 종료 */
+export declare function shutdownVoiceService(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/voice/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/voice/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAwD5E,eAAO,MAAM,qBAAqB,EAAE,cAYnC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAoBhC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,cAmBrC,CAAC;AAMF,wBAAsB,WAAW,IAAI,OAAO,CAAC,UAAU,CAAC,CAkBvD;AAED,wBAAsB,QAAQ,CAC5B,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD,OAAO,CAAC,UAAU,CAAC,CAwBrB;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,UAAU,CAAC,CA2BrB;AAED,aAAa;AACb,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C"}

package/dist/tools/voice/index.js

@@ -0,0 +1,204 @@
+/**
+ * Voice MCP Tools — STT/TTS/Session 도구
+ *
+ * - core_voice_status: 음성 세션 상태
+ * - core_tts_speak: 텍스트 → 음성 변환
+ * - core_stt_transcribe: 오디오 → 텍스트 변환
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { STTProviderChain, getDefaultSTTConfigs } from '../../interface/voice/STTProvider.js';
+import { TTSProviderChain, getDefaultTTSConfigs } from '../../interface/voice/TTSProvider.js';
+import { VoiceSessionManager } from '../../interface/voice/VoiceSession.js';
+// ============================================================================
+// Singleton
+// ============================================================================
+let sttChain = null;
+let ttsChain = null;
+let sessionManager = null;
+function getLogger() {
+    return (level, message) => {
+        if (level === 'error') {
+            console.error(`[voice] ${message}`);
+        }
+    };
+}
+function ensureSTT() {
+    if (!sttChain) {
+        sttChain = new STTProviderChain(getDefaultSTTConfigs(), getLogger());
+    }
+    return sttChain;
+}
+function ensureTTS() {
+    if (!ttsChain) {
+        ttsChain = new TTSProviderChain(getDefaultTTSConfigs(), getLogger());
+    }
+    return ttsChain;
+}
+function ensureSessionManager() {
+    if (!sessionManager) {
+        sessionManager = new VoiceSessionManager(getLogger());
+    }
+    return sessionManager;
+}
+function successResult(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+function errorResult(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return { content: [{ type: 'text', text: JSON.stringify({ error: msg }, null, 2) }] };
+}
+// ============================================================================
+// Tool Definitions
+// ============================================================================
+export const voiceStatusDefinition = {
+    name: 'core_voice_status',
+    description: 'voice status|audio status - Check voice pipeline status and active sessions',
+    inputSchema: { type: 'object', properties: {} },
+    annotations: {
+        title: 'Voice Status',
+        audience: ['user', 'assistant'],
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+};
+export const ttsSpeakDefinition = {
+    name: 'core_tts_speak',
+    description: 'speak text|text to speech|tts - Convert text to speech audio file',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            text: { type: 'string', description: 'Text to convert to speech' },
+            voice: { type: 'string', description: 'Voice name (optional)' },
+            format: { type: 'string', enum: ['mp3', 'opus', 'wav'], description: 'Audio format (default: mp3)' },
+        },
+        required: ['text'],
+    },
+    annotations: {
+        title: 'TTS Speak',
+        audience: ['assistant'],
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+};
+export const sttTranscribeDefinition = {
+    name: 'core_stt_transcribe',
+    description: 'transcribe audio|speech to text|stt - Transcribe audio file to text',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            audioPath: { type: 'string', description: 'Path to audio file' },
+            language: { type: 'string', description: 'Language (default: Korean)' },
+        },
+        required: ['audioPath'],
+    },
+    annotations: {
+        title: 'STT Transcribe',
+        audience: ['assistant'],
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+// ============================================================================
+// Tool Handlers
+// ============================================================================
+export async function voiceStatus() {
+    try {
+        const stt = ensureSTT();
+        const tts = ensureTTS();
+        const mgr = ensureSessionManager();
+        return successResult({
+            stt: {
+                providers: stt.getAvailableProviders(),
+            },
+            tts: {
+                providers: tts.getAvailableProviders(),
+            },
+            sessions: mgr.getActiveSessions(),
+        });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+}
+export async function ttsSpeak(args) {
+    try {
+        const tts = ensureTTS();
+        const validFormats = ['mp3', 'opus', 'wav'];
+        const format = validFormats.includes(args.format)
+            ? args.format
+            : 'mp3';
+        const result = await tts.synthesize(args.text, {
+            voice: args.voice,
+            format,
+        });
+        return successResult({
+            success: true,
+            audioPath: result.audioPath,
+            format: result.format,
+            provider: result.providerUsed,
+            durationMs: result.durationMs,
+            sizeBytes: result.sizeBytes,
+        });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+}
+export async function sttTranscribe(args) {
+    try {
+        const resolvedPath = path.resolve(args.audioPath);
+        // 경로 순회 방어: 프로젝트 루트 또는 홈 디렉토리 하위만 허용
+        const cwd = process.cwd();
+        const home = process.env.HOME ?? process.env.USERPROFILE ?? cwd;
+        if (!resolvedPath.startsWith(cwd) && !resolvedPath.startsWith(home)) {
+            return errorResult({ message: '허용되지 않은 경로입니다. 프로젝트 또는 홈 디렉토리 내 파일만 접근할 수 있습니다.' });
+        }
+        if (!fs.existsSync(resolvedPath)) {
+            return errorResult({ message: `Audio file not found: ${resolvedPath}` });
+        }
+        const audio = fs.readFileSync(resolvedPath);
+        const mime = detectMime(resolvedPath);
+        const stt = ensureSTT();
+        const result = await stt.transcribe(audio, mime, args.language ?? 'Korean');
+        return successResult({
+            text: result.text,
+            provider: result.providerUsed,
+            durationMs: result.durationMs,
+        });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+}
+/** 서비스 종료 */
+export function shutdownVoiceService() {
+    sessionManager?.endAll();
+    sttChain = null;
+    ttsChain = null;
+    sessionManager = null;
+}
+// ============================================================================
+// Utils
+// ============================================================================
+function detectMime(filePath) {
+    const ext = filePath.split('.').pop()?.toLowerCase() ?? '';
+    const mimeMap = {
+        wav: 'audio/wav',
+        mp3: 'audio/mpeg',
+        ogg: 'audio/ogg',
+        opus: 'audio/opus',
+        webm: 'audio/webm',
+        flac: 'audio/flac',
+        m4a: 'audio/x-m4a',
+        aac: 'audio/aac',
+    };
+    return mimeMap[ext] ?? 'audio/wav';
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/voice/index.js.map

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

package/dist/types/tool.d.ts

@@ -0,0 +1,64 @@
+export interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    [key: string]: unknown;
+}
+export interface ToolAnnotation {
+    audience?: string[];
+    title?: string;
+    progress?: number;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, any>;
+        required?: string[];
+    };
+    annotations?: ToolAnnotation;
+}
+export interface MemoryRelation {
+    sourceKey: string;
+    targetKey: string;
+    relationType: string;
+    strength: number;
+    metadata?: Record<string, any>;
+    timestamp: string;
+}
+export interface MemoryGraphNode {
+    key: string;
+    value: string;
+    category: string;
+    relations: MemoryRelation[];
+}
+export interface MemoryGraph {
+    nodes: MemoryGraphNode[];
+    edges: MemoryRelation[];
+    clusters: string[][];
+}
+export type SearchStrategy = 'keyword' | 'fulltext' | 'graph_traversal' | 'temporal' | 'priority' | 'context_aware';
+export interface ToolUsage {
+    toolName: string;
+    timestamp: string;
+    duration: number;
+    success: boolean;
+    errorMessage?: string;
+}
+export interface UsageStats {
+    totalCalls: number;
+    successRate: number;
+    avgDuration: number;
+    topTools: Array<{
+        name: string;
+        count: number;
+    }>;
+    errorsByTool: Record<string, number>;
+}
+//# 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":"AAEA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B;AAGD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC;CACtB;AAGD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,eAAe,CAAC;AAGpH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC"}

package/dist/types/tool.js

@@ -0,0 +1,3 @@
+// Common MCP tool type definitions (v2.0)
+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,0CAA0C"}