video-context-mcp-server 0.23.7-beta → 0.24.0-beta

package/dist/generated/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.23.7-beta";
+export declare const VERSION = "0.24.0-beta";
 //# sourceMappingURL=version.d.ts.map

package/dist/generated/version.js

@@ -1,3 +1,3 @@
 // Auto-generated by scripts/sync-version.ts — do not edit
-export const VERSION = '0.23.7-beta';
+export const VERSION = '0.24.0-beta';
 //# sourceMappingURL=version.js.map

package/dist/index.js

@@ -9,6 +9,7 @@ import { searchTimestampTool } from './tools/searchTimestamp.js';
 import { getVideoInfoTool } from './tools/getVideoInfo.js';
 import { transcribeVideoTool } from './tools/transcribeVideo.js';
 import { setLoggerServer } from './utils/logger.js';
+import { triggerUpdateCheck, wrapWithUpdateNotice, } from './utils/updateCheck.js';
 import { VERSION } from './generated/version.js';
 import { analyzeVideoSchema, summarizeVideoSchema, extractFramesSchema, searchTimestampSchema, getVideoInfoSchema, transcribeVideoSchema, } from './tools/schemas.js';
 /**
@@ -27,43 +28,52 @@ async function main() {
     });
     // Wire up the logger so tools can emit progress notifications
     setLoggerServer(server);
+    /**
+     * Wrap a tool handler to:
+     *   1. Trigger the background update-check on the first call (fire-and-forget)
+     *   2. Prepend any pending update notice to the response (single-shot)
+     */
+    const withUpdateCheck = (handler) => async (params) => {
+        triggerUpdateCheck();
+        return wrapWithUpdateNotice(await handler(params));
+    };
     // Register all video analysis tools
     // Tool 1: analyze_video - Ask questions about video content
     server.registerTool('analyze_video', {
         title: 'Analyze Video',
         description: 'Ask questions about video content and get AI-powered answers. Supports both local files and URLs.',
         inputSchema: analyzeVideoSchema,
-    }, analyzeVideoTool);
+    }, withUpdateCheck(analyzeVideoTool));
     // Tool 2: summarize_video - Generate structured video summary
     server.registerTool('summarize_video', {
         title: 'Summarize Video',
         description: 'Generate a structured summary of the video including overview, key scenes, and timeline. For long videos (>5 min), extracts keyframes to reduce token usage (unless using Gemini, which processes natively).',
         inputSchema: summarizeVideoSchema,
-    }, summarizeVideoTool);
+    }, withUpdateCheck(summarizeVideoTool));
     // Tool 3: extract_frames - Extract frames from video
     server.registerTool('extract_frames', {
         title: 'Extract Frames',
         description: 'Extract frames from a video at specific timestamps or intervals. Supports local files (including file:// URIs) and remote http(s) URLs. No AI backend required.',
         inputSchema: extractFramesSchema,
-    }, extractFramesTool);
+    }, withUpdateCheck(extractFramesTool));
     // Tool 4: search_timestamp - Find when something happens in video
     server.registerTool('search_timestamp', {
         title: 'Search Timestamp',
         description: 'Find the timestamp when something specific happens in a video. Extracts frames and uses AI to locate the content. Supports local files (including file:// URIs) and remote http(s) URLs.',
         inputSchema: searchTimestampSchema,
-    }, searchTimestampTool);
+    }, withUpdateCheck(searchTimestampTool));
     // Tool 5: get_video_info - Get video metadata
     server.registerTool('get_video_info', {
         title: 'Get Video Info',
         description: 'Get video metadata including duration, resolution, fps, codec, file size, and format. Supports local files (including file:// URIs) and remote http(s) URLs. No AI backend required.',
         inputSchema: getVideoInfoSchema,
-    }, getVideoInfoTool);
+    }, withUpdateCheck(getVideoInfoTool));
     // Tool 6: transcribe_video - Transcribe audio from a video
     server.registerTool('transcribe_video', {
         title: 'Transcribe Video',
         description: 'Extract audio from a video and transcribe it using a dedicated speech-to-text provider (Deepgram, AssemblyAI, Groq/Whisper, or Gemini). Supports speaker diarization and translation to English.',
         inputSchema: transcribeVideoSchema,
-    }, transcribeVideoTool);
+    }, withUpdateCheck(transcribeVideoTool));
     // Connect to VS Code via stdio transport
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/index.js.map

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

package/dist/utils/logger.d.ts

@@ -20,4 +20,10 @@ export declare function setLoggerServer(server: McpServer): void;
  * @param message - Human-readable progress message
  */
 export declare function logProgress(message: string): Promise<void>;
+/**
+ * Emit a warning-level log via the MCP logging notification.
+ * Silently swallows errors so that logging failures never break a tool call.
+ * @param message - Human-readable warning message
+ */
+export declare function logWarning(message: string): Promise<void>;
 //# sourceMappingURL=logger.d.ts.map

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

@@ -1 +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"}
+{"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;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/D"}

package/dist/utils/logger.js

@@ -31,4 +31,19 @@ export async function logProgress(message) {
         // Swallow logging errors – never break a tool call because of logging
     }
 }
+/**
+ * Emit a warning-level log via the MCP logging notification.
+ * Silently swallows errors so that logging failures never break a tool call.
+ * @param message - Human-readable warning message
+ */
+export async function logWarning(message) {
+    if (!_server)
+        return;
+    try {
+        await _server.sendLoggingMessage({ level: 'warning', data: message });
+    }
+    catch {
+        // Swallow logging errors – never break a tool call because of logging
+    }
+}
 //# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -1 +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"}
+{"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;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAe;IAC9C,IAAI,CAAC,OAAO;QAAE,OAAM;IACpB,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;IACxE,CAAC;AACH,CAAC"}

package/dist/utils/updateCheck.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Silent update notification for globally-installed video-context-mcp-server.
+ *
+ * On the first tool call, spawns `npm outdated -g video-context-mcp-server --json`
+ * as a fire-and-forget background process. If an update is available, stores a
+ * one-line notice that is prepended to the next tool call response (single-shot).
+ *
+ * When running via npx, the package is not globally installed, so
+ * `npm outdated -g` returns `{}` — no special npx detection is needed.
+ */
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Fire-and-forget: spawn `npm outdated -g <package> --json` once per session.
+ * The result is stored in `_updateNotice` when the child process completes.
+ *
+ * Safe to call on every tool invocation — no-ops after the first call.
+ * Never throws; all errors are silently swallowed.
+ */
+export declare function triggerUpdateCheck(): void;
+/**
+ * Returns the stored update notice, or `null` if:
+ *  - no update was found
+ *  - the background check is still running or hasn't been triggered yet
+ *  - the check failed (network error, parse error, etc.)
+ */
+export declare function getUpdateNotice(): string | null;
+/**
+ * If an update notice is stored, prepend it to the tool result's content
+ * array and clear the stored notice (single-shot — appears only once per session).
+ * Returns the result unchanged when no notice is available.
+ */
+export declare function wrapWithUpdateNotice(result: CallToolResult): CallToolResult;
+/**
+ * Reset all module-level state.
+ * @internal — for unit tests only
+ */
+export declare function _resetForTests(): void;
+//# sourceMappingURL=updateCheck.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"updateCheck.d.ts","sourceRoot":"","sources":["../../src/utils/updateCheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AASxE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAmCzC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAS3E;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC"}

package/dist/utils/updateCheck.js

@@ -0,0 +1,85 @@
+/**
+ * Silent update notification for globally-installed video-context-mcp-server.
+ *
+ * On the first tool call, spawns `npm outdated -g video-context-mcp-server --json`
+ * as a fire-and-forget background process. If an update is available, stores a
+ * one-line notice that is prepended to the next tool call response (single-shot).
+ *
+ * When running via npx, the package is not globally installed, so
+ * `npm outdated -g` returns `{}` — no special npx detection is needed.
+ */
+import { exec } from 'node:child_process';
+import { logWarning } from './logger.js';
+const PACKAGE_NAME = 'video-context-mcp-server';
+const TIMEOUT_MS = 15_000;
+let _checkTriggered = false;
+let _updateNotice = null;
+/**
+ * Fire-and-forget: spawn `npm outdated -g <package> --json` once per session.
+ * The result is stored in `_updateNotice` when the child process completes.
+ *
+ * Safe to call on every tool invocation — no-ops after the first call.
+ * Never throws; all errors are silently swallowed.
+ */
+export function triggerUpdateCheck() {
+    if (_checkTriggered)
+        return;
+    _checkTriggered = true;
+    exec(`npm outdated -g ${PACKAGE_NAME} --json`, { timeout: TIMEOUT_MS }, (error, stdout) => {
+        try {
+            // `npm outdated` exits with code 1 when packages are outdated — this is
+            // intentional npm behaviour. Treat code 1 + valid JSON as "update available".
+            // All other error codes (ENOENT, timeout kill, etc.) are silently ignored.
+            const exitCode = error?.code ?? 0;
+            if (exitCode !== 1 || !stdout?.trim())
+                return;
+            const parsed = JSON.parse(stdout);
+            const info = parsed[PACKAGE_NAME];
+            if (!info?.current || !info?.latest)
+                return;
+            if (info.current === info.latest)
+                return;
+            const { current, latest } = info;
+            _updateNotice =
+                `⬆️ Update available: ${PACKAGE_NAME} v${latest} ` +
+                    `(current: v${current}). Run: npm install -g ${PACKAGE_NAME}@latest`;
+            void logWarning(`[video-mcp] ${_updateNotice}`);
+        }
+        catch {
+            // Malformed JSON or any other unexpected output — silently ignore
+        }
+    });
+}
+/**
+ * Returns the stored update notice, or `null` if:
+ *  - no update was found
+ *  - the background check is still running or hasn't been triggered yet
+ *  - the check failed (network error, parse error, etc.)
+ */
+export function getUpdateNotice() {
+    return _updateNotice;
+}
+/**
+ * If an update notice is stored, prepend it to the tool result's content
+ * array and clear the stored notice (single-shot — appears only once per session).
+ * Returns the result unchanged when no notice is available.
+ */
+export function wrapWithUpdateNotice(result) {
+    const notice = _updateNotice;
+    if (!notice)
+        return result;
+    _updateNotice = null;
+    return {
+        ...result,
+        content: [{ type: 'text', text: notice }, ...result.content],
+    };
+}
+/**
+ * Reset all module-level state.
+ * @internal — for unit tests only
+ */
+export function _resetForTests() {
+    _checkTriggered = false;
+    _updateNotice = null;
+}
+//# sourceMappingURL=updateCheck.js.map

package/dist/utils/updateCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateCheck.js","sourceRoot":"","sources":["../../src/utils/updateCheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,MAAM,YAAY,GAAG,0BAA0B,CAAA;AAC/C,MAAM,UAAU,GAAG,MAAM,CAAA;AAEzB,IAAI,eAAe,GAAG,KAAK,CAAA;AAC3B,IAAI,aAAa,GAAkB,IAAI,CAAA;AAEvC;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,eAAe;QAAE,OAAM;IAC3B,eAAe,GAAG,IAAI,CAAA;IAEtB,IAAI,CACF,mBAAmB,YAAY,SAAS,EACxC,EAAE,OAAO,EAAE,UAAU,EAAE,EACvB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAChB,IAAI,CAAC;YACH,wEAAwE;YACxE,8EAA8E;YAC9E,2EAA2E;YAC3E,MAAM,QAAQ,GACX,KAA4C,EAAE,IAAI,IAAI,CAAC,CAAA;YAC1D,IAAI,QAAQ,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE;gBAAE,OAAM;YAE7C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAG/B,CAAA;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,CAAA;YACjC,IAAI,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM;gBAAE,OAAM;YAC3C,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,MAAM;gBAAE,OAAM;YAExC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;YAChC,aAAa;gBACX,wBAAwB,YAAY,KAAK,MAAM,GAAG;oBAClD,cAAc,OAAO,0BAA0B,YAAY,SAAS,CAAA;YAEtE,KAAK,UAAU,CAAC,eAAe,aAAa,EAAE,CAAC,CAAA;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,kEAAkE;QACpE,CAAC;IACH,CAAC,CACF,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,CAAA;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAsB;IACzD,MAAM,MAAM,GAAG,aAAa,CAAA;IAC5B,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAA;IAE1B,aAAa,GAAG,IAAI,CAAA;IACpB,OAAO;QACL,GAAG,MAAM;QACT,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;KAC7D,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,eAAe,GAAG,KAAK,CAAA;IACvB,aAAa,GAAG,IAAI,CAAA;AACtB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "video-context-mcp-server",
-  "version": "0.23.7-beta",
+  "version": "0.24.0-beta",
   "description": "A Model Context Protocol server that gives GitHub Copilot the ability to understand and analyze video content",
   "type": "module",
   "main": "dist/index.js",