video-context-mcp-server 1.0.0-beta.10

package/dist/tools/searchTimestamp.js

@@ -0,0 +1,146 @@
+/**
+ * Tool: search_timestamp
+ * Find when something specific happens in a video
+ */
+import { extractFramesAtInterval, getVideoMetadata, } from '../services/ffmpeg.js';
+import { createGLMClient } from '../services/glmClient.js';
+import { createKimiClient } from '../services/kimiClient.js';
+import { createGeminiClient } from '../services/geminiClient.js';
+import { getDefaultProvider, resolveProviderWithFallback, } from '../services/providerRouter.js';
+import { bufferToBase64String } from '../utils/base64.js';
+import { createTempDir, cleanupTempDir } from '../utils/tempFiles.js';
+import { isRemoteUrl, normalizeVideoPath, downloadVideoToTemp, } from '../utils/videoUtils.js';
+import { logProgress } from '../utils/logger.js';
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+function parseLikelyFrameIndex(responseText, maxIndex) {
+    const matches = responseText.match(/\d+/g);
+    if (!matches || matches.length === 0) {
+        return 0;
+    }
+    for (const match of matches) {
+        const value = Number.parseInt(match, 10);
+        if (!Number.isNaN(value) && value >= 0 && value <= maxIndex) {
+            return value;
+        }
+    }
+    return clamp(Number.parseInt(matches[0], 10) || 0, 0, maxIndex);
+}
+export const searchTimestampTool = async (params) => {
+    let tempDir = null;
+    try {
+        const { videoPath, query } = params;
+        const provider = params.provider ?? getDefaultProvider();
+        let resolvedPath;
+        if (isRemoteUrl(videoPath)) {
+            tempDir = await createTempDir();
+            await logProgress('Downloading remote video...');
+            resolvedPath = await downloadVideoToTemp(videoPath, tempDir);
+        }
+        else {
+            resolvedPath = normalizeVideoPath(videoPath);
+        }
+        const metadata = await getVideoMetadata(resolvedPath);
+        const glmClient = createGLMClient();
+        const kimiClient = createKimiClient();
+        const geminiClient = createGeminiClient();
+        const selectedProvider = resolveProviderWithFallback(provider, Boolean(kimiClient), Boolean(glmClient), Boolean(geminiClient));
+        if (selectedProvider === 'gemini') {
+            if (!geminiClient) {
+                throw new Error('Gemini client is unavailable. Set GEMINI_API_KEY.');
+            }
+            await logProgress('Uploading to Gemini...');
+            const uploadedVideo = await geminiClient.uploadVideo(resolvedPath);
+            await logProgress('Waiting for Gemini to process video...');
+            await geminiClient.waitForFileProcessing(uploadedVideo.name);
+            await logProgress('Searching timestamp...');
+            const modelResponse = await geminiClient.searchTimestamp(uploadedVideo, query);
+            if (tempDir)
+                await cleanupTempDir(tempDir);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: modelResponse,
+                    },
+                    {
+                        type: 'text',
+                        text: `Provider used: ${selectedProvider}`,
+                    },
+                ],
+            };
+        }
+        await logProgress('Extracting frames...');
+        const intervalSec = clamp(Math.ceil(metadata.duration / 20), 2, 15);
+        const frames = await extractFramesAtInterval(resolvedPath, intervalSec);
+        if (frames.length === 0) {
+            throw new Error('No frames were extracted for timestamp search.');
+        }
+        const images = frames.map((frameBuffer) => ({
+            data: bufferToBase64String(frameBuffer),
+            mimeType: 'image/png',
+        }));
+        const searchPrompt = [
+            `You are given sequential frames sampled every ${intervalSec} seconds from a video.`,
+            `Find which frame index best matches this query: "${query}".`,
+            'Return a short answer in this format:',
+            'FrameIndex: <number>',
+            'Reason: <one sentence>',
+            `Valid frame index range: 0 to ${frames.length - 1}.`,
+        ].join('\n');
+        let modelResponse;
+        if (selectedProvider === 'glm') {
+            if (!glmClient) {
+                throw new Error('GLM client is unavailable. Set Z_AI_API_KEY.');
+            }
+            await logProgress('Searching timestamp...');
+            modelResponse = await glmClient.analyzeImages(images, searchPrompt);
+        }
+        else {
+            if (!kimiClient) {
+                throw new Error('Kimi client is unavailable. Set MOONSHOT_API_KEY.');
+            }
+            await logProgress('Searching timestamp...');
+            modelResponse = await kimiClient.analyzeImages(images, searchPrompt);
+        }
+        const frameIndex = parseLikelyFrameIndex(modelResponse, frames.length - 1);
+        const timestampSec = frameIndex * intervalSec;
+        const startRange = Math.max(0, timestampSec - intervalSec / 2);
+        const endRange = Math.min(metadata.duration, timestampSec + intervalSec / 2);
+        if (tempDir)
+            await cleanupTempDir(tempDir);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        `Best match for "${query}" appears near ${timestampSec.toFixed(1)}s.`,
+                        `Estimated range: ${startRange.toFixed(1)}s - ${endRange.toFixed(1)}s.`,
+                        `Provider used: ${selectedProvider}.`,
+                        `Model response: ${modelResponse}`,
+                    ].join('\n'),
+                },
+                {
+                    type: 'image',
+                    data: images[frameIndex].data,
+                    mimeType: 'image/png',
+                },
+            ],
+        };
+    }
+    catch (error) {
+        if (tempDir)
+            await cleanupTempDir(tempDir).catch(() => { });
+        return {
+            isError: true,
+            content: [
+                {
+                    type: 'text',
+                    text: `Error searching timestamp: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+        };
+    }
+};
+//# sourceMappingURL=searchTimestamp.js.map

package/dist/tools/searchTimestamp.js.map

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

package/dist/tools/summarizeVideo.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Tool: summarize_video
+ * Generate a structured summary of the video
+ */
+export declare const summarizeVideoTool: (params: any) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    isError: boolean;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=summarizeVideo.d.ts.map

package/dist/tools/summarizeVideo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarizeVideo.d.ts","sourceRoot":"","sources":["../../src/tools/summarizeVideo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH,eAAO,MAAM,kBAAkB,GAAU,QAAQ,GAAG;;;;;;;;;;;;EA+JnD,CAAA"}

package/dist/tools/summarizeVideo.js

@@ -0,0 +1,159 @@
+/**
+ * Tool: summarize_video
+ * Generate a structured summary of the video
+ */
+import * as fs from 'fs/promises';
+import { createReadStream } from 'fs';
+import { extractFramesEvenly, getVideoMetadata } from '../services/ffmpeg.js';
+import { createGLMClient } from '../services/glmClient.js';
+import { createKimiClient } from '../services/kimiClient.js';
+import { createGeminiClient } from '../services/geminiClient.js';
+import { getDefaultProvider, getMaxFrames, resolveProviderWithFallback, } from '../services/providerRouter.js';
+import { bufferToBase64String } from '../utils/base64.js';
+import { createTempDir, cleanupTempDir } from '../utils/tempFiles.js';
+import { isRemoteUrl, normalizeVideoPath, downloadVideoToTemp, } from '../utils/videoUtils.js';
+import { logProgress } from '../utils/logger.js';
+const LONG_VIDEO_THRESHOLD_SEC = 5 * 60;
+function buildSummaryPrompt() {
+    return [
+        'Provide a structured summary of this video.',
+        'Format your response with sections:',
+        '1) Overview',
+        '2) Key scenes',
+        '3) Timeline (with approximate timestamps)',
+        '4) Notable details',
+    ].join('\n');
+}
+export const summarizeVideoTool = async (params) => {
+    let tempDir = null;
+    try {
+        const { videoPath } = params;
+        const provider = params.provider ?? getDefaultProvider();
+        const glmClient = createGLMClient();
+        const kimiClient = createKimiClient();
+        const geminiClient = createGeminiClient();
+        const prompt = buildSummaryPrompt();
+        let selectedProvider;
+        let summary;
+        if (isRemoteUrl(videoPath)) {
+            if (provider === 'kimi') {
+                throw new Error('Kimi provider does not support direct remote URLs. Use provider=glm, provider=gemini, or a local file.');
+            }
+            selectedProvider = resolveProviderWithFallback(provider, Boolean(kimiClient), Boolean(glmClient), Boolean(geminiClient));
+            if (selectedProvider === 'gemini') {
+                if (!geminiClient) {
+                    throw new Error('Gemini client is unavailable. Set GEMINI_API_KEY.');
+                }
+                tempDir = await createTempDir();
+                await logProgress('Downloading remote video...');
+                const localPath = await downloadVideoToTemp(videoPath, tempDir);
+                await logProgress('Uploading to Gemini...');
+                const uploadedVideo = await geminiClient.uploadVideo(localPath);
+                await logProgress('Waiting for Gemini to process video...');
+                await geminiClient.waitForFileProcessing(uploadedVideo.name);
+                await logProgress('Summarizing video...');
+                summary = await geminiClient.analyzeVideo(uploadedVideo, prompt);
+            }
+            else if (selectedProvider === 'glm') {
+                if (!glmClient) {
+                    throw new Error('GLM provider is required for URL video summarization, but Z_AI_API_KEY is not configured.');
+                }
+                await logProgress('Summarizing remote video...');
+                summary = await glmClient.analyzeVideoUrl(videoPath, prompt);
+            }
+            else {
+                throw new Error('No suitable provider found for remote URL summarization.');
+            }
+        }
+        else {
+            const resolvedPath = normalizeVideoPath(videoPath);
+            const metadata = await getVideoMetadata(resolvedPath);
+            selectedProvider = resolveProviderWithFallback(provider, Boolean(kimiClient), Boolean(glmClient), Boolean(geminiClient));
+            if (selectedProvider === 'gemini') {
+                if (!geminiClient) {
+                    throw new Error('Gemini client is unavailable. Set GEMINI_API_KEY.');
+                }
+                await logProgress('Uploading to Gemini...');
+                const uploadedVideo = await geminiClient.uploadVideo(resolvedPath);
+                await logProgress('Waiting for Gemini to process video...');
+                await geminiClient.waitForFileProcessing(uploadedVideo.name);
+                await logProgress('Summarizing video...');
+                summary = await geminiClient.analyzeVideo(uploadedVideo, prompt);
+            }
+            else {
+                const isLongVideo = metadata.duration > LONG_VIDEO_THRESHOLD_SEC;
+                if (isLongVideo) {
+                    await logProgress('Extracting keyframes...');
+                    const frames = await extractFramesEvenly(resolvedPath, getMaxFrames());
+                    const images = frames.map((frameBuffer) => ({
+                        data: bufferToBase64String(frameBuffer),
+                        mimeType: 'image/png',
+                    }));
+                    if (selectedProvider === 'glm') {
+                        if (!glmClient) {
+                            throw new Error('GLM client is unavailable. Set Z_AI_API_KEY.');
+                        }
+                        await logProgress('Summarizing video...');
+                        summary = await glmClient.analyzeImages(images, prompt);
+                    }
+                    else {
+                        if (!kimiClient) {
+                            throw new Error('Kimi client is unavailable. Set MOONSHOT_API_KEY.');
+                        }
+                        await logProgress('Summarizing video...');
+                        summary = await kimiClient.analyzeImages(images, prompt);
+                    }
+                }
+                else {
+                    if (selectedProvider === 'glm') {
+                        if (!glmClient) {
+                            throw new Error('GLM client is unavailable. Set Z_AI_API_KEY.');
+                        }
+                        await logProgress('Summarizing video...');
+                        const videoBuffer = await fs.readFile(resolvedPath);
+                        summary = await glmClient.analyzeVideoBase64(bufferToBase64String(videoBuffer), prompt);
+                    }
+                    else {
+                        if (!kimiClient) {
+                            throw new Error('Kimi client is unavailable. Set MOONSHOT_API_KEY.');
+                        }
+                        await logProgress('Uploading to Kimi...');
+                        const uploadedVideo = await kimiClient.uploadVideo(createReadStream(resolvedPath));
+                        await logProgress('Summarizing video...');
+                        summary = await kimiClient.analyzeVideo(uploadedVideo.id, prompt);
+                    }
+                }
+            }
+        }
+        if (tempDir) {
+            await cleanupTempDir(tempDir);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: summary,
+                },
+                {
+                    type: 'text',
+                    text: `Provider used: ${selectedProvider}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        if (tempDir) {
+            await cleanupTempDir(tempDir).catch(() => { });
+        }
+        return {
+            isError: true,
+            content: [
+                {
+                    type: 'text',
+                    text: `Error summarizing video: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+        };
+    }
+};
+//# sourceMappingURL=summarizeVideo.js.map

package/dist/tools/summarizeVideo.js.map

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

package/dist/utils/base64.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Base64 encoding utilities for images and videos
+ */
+/**
+ * Convert a Buffer to a base64 data URI
+ * @param buffer - The data buffer
+ * @param mimeType - MIME type (e.g., "image/png", "video/mp4")
+ * @returns Base64 data URI string
+ */
+export declare function bufferToBase64(buffer: Buffer, mimeType: string): string;
+/**
+ * Convert a Buffer to base64 without the data URI prefix
+ * @param buffer - The data buffer
+ * @returns Base64 string
+ */
+export declare function bufferToBase64String(buffer: Buffer): string;
+/**
+ * Extract the MIME type from a data URI
+ * @param dataUri - Data URI string (e.g., "data:image/png;base64,abc123...")
+ * @returns MIME type (e.g., "image/png")
+ */
+export declare function getMimeTypeFromDataUri(dataUri: string): string;
+/**
+ * Extract the base64 content from a data URI
+ * @param dataUri - Data URI string (e.g., "data:image/png;base64,abc123...")
+ * @returns Base64 string without prefix
+ */
+export declare function getBase64FromDataUri(dataUri: string): string;
+/**
+ * Convert base64 string to Buffer
+ * @param base64 - Base64 string (with or without data URI prefix)
+ * @returns Buffer
+ */
+export declare function base64ToBuffer(base64: string): Buffer;
+//# sourceMappingURL=base64.d.ts.map

package/dist/utils/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../src/utils/base64.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIrD"}

package/dist/utils/base64.js

@@ -0,0 +1,50 @@
+/**
+ * Base64 encoding utilities for images and videos
+ */
+/**
+ * Convert a Buffer to a base64 data URI
+ * @param buffer - The data buffer
+ * @param mimeType - MIME type (e.g., "image/png", "video/mp4")
+ * @returns Base64 data URI string
+ */
+export function bufferToBase64(buffer, mimeType) {
+    const base64 = buffer.toString('base64');
+    return `data:${mimeType};base64,${base64}`;
+}
+/**
+ * Convert a Buffer to base64 without the data URI prefix
+ * @param buffer - The data buffer
+ * @returns Base64 string
+ */
+export function bufferToBase64String(buffer) {
+    return buffer.toString('base64');
+}
+/**
+ * Extract the MIME type from a data URI
+ * @param dataUri - Data URI string (e.g., "data:image/png;base64,abc123...")
+ * @returns MIME type (e.g., "image/png")
+ */
+export function getMimeTypeFromDataUri(dataUri) {
+    const match = dataUri.match(/^data:([^;]+);base64,/);
+    return match ? match[1] : 'application/octet-stream';
+}
+/**
+ * Extract the base64 content from a data URI
+ * @param dataUri - Data URI string (e.g., "data:image/png;base64,abc123...")
+ * @returns Base64 string without prefix
+ */
+export function getBase64FromDataUri(dataUri) {
+    const match = dataUri.match(/^data:[^;]+;base64,(.+)$/);
+    return match ? match[1] : dataUri;
+}
+/**
+ * Convert base64 string to Buffer
+ * @param base64 - Base64 string (with or without data URI prefix)
+ * @returns Buffer
+ */
+export function base64ToBuffer(base64) {
+    // Remove data URI prefix if present
+    const cleanBase64 = base64.includes(',') ? base64.split(',')[1] : base64;
+    return Buffer.from(cleanBase64, 'base64');
+}
+//# sourceMappingURL=base64.js.map

package/dist/utils/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../src/utils/base64.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,QAAgB;IAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACxC,OAAO,QAAQ,QAAQ,WAAW,MAAM,EAAE,CAAA;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAA;IACpD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAA;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAA;IACvD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,oCAAoC;IACpC,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IACxE,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;AAC3C,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Logger utility for emitting MCP progress notifications from tool handlers.
+ *
+ * Usage:
+ *   // In index.ts after creating the server:
+ *   setLoggerServer(server)
+ *
+ *   // In tool handlers:
+ *   await logProgress('Uploading to Gemini...')
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Register the McpServer instance so that logProgress can use it.
+ * Call this once from index.ts after creating the server.
+ */
+export declare function setLoggerServer(server: McpServer): void;
+/**
+ * Emit an info-level progress log via the MCP logging notification.
+ * Silently swallows errors so that logging failures never break a tool call.
+ * @param message - Human-readable progress message
+ */
+export declare function logProgress(message: string): Promise<void>;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAIxE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEvD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhE"}

package/dist/utils/logger.js

@@ -0,0 +1,34 @@
+/**
+ * Logger utility for emitting MCP progress notifications from tool handlers.
+ *
+ * Usage:
+ *   // In index.ts after creating the server:
+ *   setLoggerServer(server)
+ *
+ *   // In tool handlers:
+ *   await logProgress('Uploading to Gemini...')
+ */
+let _server = null;
+/**
+ * Register the McpServer instance so that logProgress can use it.
+ * Call this once from index.ts after creating the server.
+ */
+export function setLoggerServer(server) {
+    _server = server;
+}
+/**
+ * Emit an info-level progress log via the MCP logging notification.
+ * Silently swallows errors so that logging failures never break a tool call.
+ * @param message - Human-readable progress message
+ */
+export async function logProgress(message) {
+    if (!_server)
+        return;
+    try {
+        await _server.sendLoggingMessage({ level: 'info', data: message });
+    }
+    catch {
+        // Swallow logging errors – never break a tool call because of logging
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,IAAI,OAAO,GAAqB,IAAI,CAAA;AAEpC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,OAAO,GAAG,MAAM,CAAA;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAe;IAC/C,IAAI,CAAC,OAAO;QAAE,OAAM;IACpB,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;IACxE,CAAC;AACH,CAAC"}

package/dist/utils/tempFiles.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Temp directory manager for frame extraction operations
+ */
+/**
+ * Create a temporary directory for video processing
+ * @returns Path to the created temp directory
+ */
+export declare function createTempDir(): Promise<string>;
+/**
+ * Clean up a temporary directory
+ * @param dirPath - Path to the temp directory to clean up
+ */
+export declare function cleanupTempDir(dirPath: string): Promise<void>;
+/**
+ * Generate a unique temp filename
+ * @param extension - File extension (e.g., ".png")
+ * @returns Unique filename
+ */
+export declare function generateTempFilename(extension: string): string;
+//# sourceMappingURL=tempFiles.d.ts.map

package/dist/utils/tempFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tempFiles.d.ts","sourceRoot":"","sources":["../../src/utils/tempFiles.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAErD;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI9D"}

package/dist/utils/tempFiles.js

@@ -0,0 +1,31 @@
+import * as path from 'path';
+import { mkdtemp, rm } from 'fs/promises';
+import { tmpdir } from 'os';
+/**
+ * Temp directory manager for frame extraction operations
+ */
+/**
+ * Create a temporary directory for video processing
+ * @returns Path to the created temp directory
+ */
+export async function createTempDir() {
+    return await mkdtemp(path.join(tmpdir(), 'video-mcp-'));
+}
+/**
+ * Clean up a temporary directory
+ * @param dirPath - Path to the temp directory to clean up
+ */
+export async function cleanupTempDir(dirPath) {
+    await rm(dirPath, { recursive: true, force: true });
+}
+/**
+ * Generate a unique temp filename
+ * @param extension - File extension (e.g., ".png")
+ * @returns Unique filename
+ */
+export function generateTempFilename(extension) {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).substring(2, 9);
+    return `${timestamp}-${random}${extension}`;
+}
+//# sourceMappingURL=tempFiles.js.map

package/dist/utils/tempFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tempFiles.js","sourceRoot":"","sources":["../../src/utils/tempFiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAC5B,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAA;AAE3B;;GAEG;AAEH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAA;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe;IAClD,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACzD,OAAO,GAAG,SAAS,IAAI,MAAM,GAAG,SAAS,EAAE,CAAA;AAC7C,CAAC"}

package/dist/utils/videoUtils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared video utilities for path normalization, URL detection, and video downloading
+ */
+/**
+ * Returns true if the value is an http or https URL
+ */
+export declare function isRemoteUrl(value: string): boolean;
+/**
+ * Normalizes a video path, stripping file:// URIs to local filesystem paths.
+ * Non-file:// paths are returned as-is.
+ */
+export declare function normalizeVideoPath(videoPath: string): string;
+/**
+ * Downloads a remote video URL to a temp directory and returns the local path.
+ * @param url - Remote http(s) URL
+ * @param tempDir - Directory to download into
+ */
+export declare function downloadVideoToTemp(url: string, tempDir: string): Promise<string>;
+//# sourceMappingURL=videoUtils.d.ts.map

package/dist/utils/videoUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoUtils.d.ts","sourceRoot":"","sources":["../../src/utils/videoUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAQjB"}

package/dist/utils/videoUtils.js

@@ -0,0 +1,38 @@
+/**
+ * Shared video utilities for path normalization, URL detection, and video downloading
+ */
+import { createWriteStream } from 'fs';
+import * as path from 'path';
+import { pipeline } from 'stream/promises';
+import { generateTempFilename } from './tempFiles.js';
+/**
+ * Returns true if the value is an http or https URL
+ */
+export function isRemoteUrl(value) {
+    return /^https?:\/\//i.test(value);
+}
+/**
+ * Normalizes a video path, stripping file:// URIs to local filesystem paths.
+ * Non-file:// paths are returned as-is.
+ */
+export function normalizeVideoPath(videoPath) {
+    if (videoPath.startsWith('file://')) {
+        return decodeURIComponent(videoPath.replace(/^file:\/\//i, ''));
+    }
+    return videoPath;
+}
+/**
+ * Downloads a remote video URL to a temp directory and returns the local path.
+ * @param url - Remote http(s) URL
+ * @param tempDir - Directory to download into
+ */
+export async function downloadVideoToTemp(url, tempDir) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to download video: ${response.statusText}`);
+    }
+    const tempFilePath = path.join(tempDir, generateTempFilename('.mp4'));
+    await pipeline(response.body, createWriteStream(tempFilePath));
+    return tempFilePath;
+}
+//# sourceMappingURL=videoUtils.js.map

package/dist/utils/videoUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoUtils.js","sourceRoot":"","sources":["../../src/utils/videoUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,IAAI,CAAA;AACtC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAErD;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,IAAI,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,OAAO,kBAAkB,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,OAAe;IAEf,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IACjC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;IACrE,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAA;IACrE,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAW,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAA;IACrE,OAAO,YAAY,CAAA;AACrB,CAAC"}