youtube-knowledge-mcp 2.1.0 → 2.2.0

package/dist/utils/ytdlp-env.js

@@ -0,0 +1,121 @@
+import { accessSync, constants, statSync } from 'node:fs';
+import { envEnum, envString } from './env.js';
+import { assertInsideHome } from './validate.js';
+/**
+ * The session options yt-dlp is started with, read from the environment.
+ *
+ * Cookies are how yt-dlp reads age-restricted, members-only and sign-in-gated
+ * videos, and how it gets past the "confirm you're not a bot" check YouTube
+ * sometimes applies to an address. They are also the user's own account, so
+ * everything here is careful about two things: the values are validated at
+ * boot and never at request time, and neither the cookie path nor its contents
+ * ever appear in a log line, a tool result or an error message.
+ */
+export const COOKIE_BROWSERS = [
+    'brave',
+    'chrome',
+    'chromium',
+    'edge',
+    'firefox',
+    'opera',
+    'safari',
+    'vivaldi',
+    'whale',
+];
+const PROXY_SCHEMES = new Set(['http:', 'https:', 'socks4:', 'socks4a:', 'socks5:', 'socks5h:']);
+function readCookiesFile(env) {
+    const raw = envString('YOUTUBE_MCP_COOKIES_FILE', env);
+    if (raw === undefined)
+        return undefined;
+    // The message names the variable and never the path: the path is the one
+    // thing about a cookies file that should not travel.
+    const rejected = (reason) => new Error(`YOUTUBE_MCP_COOKIES_FILE ${reason}. Point it at a readable cookies file in your home directory.`);
+    let path;
+    try {
+        path = assertInsideHome(raw, 'cookies file');
+    }
+    catch {
+        throw rejected('must be inside your home directory');
+    }
+    try {
+        if (!statSync(path).isFile())
+            throw rejected('is not a regular file');
+        accessSync(path, constants.R_OK);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.startsWith('YOUTUBE_MCP_COOKIES_FILE'))
+            throw error;
+        throw rejected('could not be read');
+    }
+    return path;
+}
+function readProxy(env) {
+    const raw = envString('YOUTUBE_MCP_PROXY', env);
+    if (raw === undefined)
+        return undefined;
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        throw new Error('YOUTUBE_MCP_PROXY must be a URL such as socks5h://127.0.0.1:1080.');
+    }
+    if (!PROXY_SCHEMES.has(url.protocol)) {
+        throw new Error(`YOUTUBE_MCP_PROXY must use one of ${[...PROXY_SCHEMES].map((s) => s.slice(0, -1)).join(', ')}.`);
+    }
+    return url.toString();
+}
+function readSleep(env) {
+    const raw = envString('YOUTUBE_MCP_SLEEP_REQUESTS_S', env);
+    if (raw === undefined)
+        return undefined;
+    const seconds = Number(raw);
+    if (!Number.isFinite(seconds) || seconds < 0) {
+        throw new Error('YOUTUBE_MCP_SLEEP_REQUESTS_S must be a non-negative number of seconds.');
+    }
+    return seconds;
+}
+/**
+ * Validate the session settings and turn them into yt-dlp flags.
+ *
+ * Throws a plain `Error` naming the variable: this runs at boot, where a bad
+ * setting should stop the server before a transport starts, not surface as a
+ * puzzling failure on the first tool call.
+ */
+export function readYtDlpEnv(env = process.env) {
+    const cookiesFile = readCookiesFile(env);
+    const browser = envEnum('YOUTUBE_MCP_COOKIES_FROM_BROWSER', COOKIE_BROWSERS, env);
+    const proxy = readProxy(env);
+    const sleep = readSleep(env);
+    if (cookiesFile !== undefined && browser !== undefined) {
+        throw new Error('Set either YOUTUBE_MCP_COOKIES_FILE or YOUTUBE_MCP_COOKIES_FROM_BROWSER, not both.');
+    }
+    const args = [];
+    if (cookiesFile !== undefined)
+        args.push('--cookies', cookiesFile);
+    if (browser !== undefined)
+        args.push('--cookies-from-browser', browser);
+    if (proxy !== undefined)
+        args.push('--proxy', proxy);
+    if (sleep !== undefined)
+        args.push('--sleep-requests', String(sleep));
+    return {
+        args,
+        cookies: cookiesFile !== undefined ? 'file' : browser !== undefined ? 'browser' : 'none',
+        ...(browser === undefined ? {} : { browser }),
+        proxy: proxy !== undefined,
+        ...(sleep === undefined ? {} : { sleepRequestsSeconds: sleep }),
+    };
+}
+/** One line for the boot log: what is configured, never what it is. */
+export function describeYtDlpEnv(settings) {
+    const cookies = settings.cookies === 'browser'
+        ? `browser (${settings.browser ?? 'unknown'})`
+        : settings.cookies;
+    const parts = [`yt-dlp cookies: ${cookies}`, `proxy: ${settings.proxy ? 'configured' : 'none'}`];
+    if (settings.sleepRequestsSeconds !== undefined) {
+        parts.push(`sleep between requests: ${settings.sleepRequestsSeconds}s`);
+    }
+    return parts.join(' · ');
+}
+//# sourceMappingURL=ytdlp-env.js.map

package/dist/utils/ytdlp-env.js.map

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

package/dist/utils/ytdlp-limiter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Takes a concurrency slot, waiting for one when the limiter is full.
+ *
+ * The wait honours the request's abort signal. It used to be a bare promise
+ * with no way out, so a client that gave up stayed queued forever — and since a
+ * media transfer runs without a wall-clock timeout, three stalled downloads
+ * held every slot and every later call queued behind them, uncancellable. The
+ * server was not slow, it was wedged, and no tool could run again.
+ */
+export declare function acquireSlot(signal: AbortSignal | undefined): Promise<void>;
+/**
+ * Hands the slot to the next waiter rather than freeing it and letting them
+ * race for it: decrementing first left `active` below the limit for a tick, so
+ * a fresh caller could take the slot the queue was already promised and the
+ * limiter would run over its own ceiling.
+ */
+export declare function releaseSlot(): void;
+/** Test seam: lets the suite assert the limiter without spawning processes. */
+export declare function concurrencyState(): {
+    active: number;
+    queued: number;
+    limit: number;
+};
+//# sourceMappingURL=ytdlp-limiter.d.ts.map

package/dist/utils/ytdlp-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ytdlp-limiter.d.ts","sourceRoot":"","sources":["../../src/utils/ytdlp-limiter.ts"],"names":[],"mappings":"AAqBA;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BhF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAOlC;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAEpF"}

package/dist/utils/ytdlp-limiter.js

@@ -0,0 +1,69 @@
+import { envInt } from './env.js';
+import { YouTubeError } from './errors.js';
+/**
+ * The concurrency limiter every yt-dlp spawn passes through.
+ *
+ * A cap so batch operations do not look like a scraper to YouTube, with a queue
+ * that honours cancellation so an abandoned request never holds a place in it.
+ */
+/** A limit of 0 (or NaN) would queue every call forever, so the floor is 1. */
+const MAX_CONCURRENT = envInt('YOUTUBE_MCP_MAX_CONCURRENCY', 3, { min: 1, max: 32 });
+let active = 0;
+const waiting = [];
+/**
+ * Takes a concurrency slot, waiting for one when the limiter is full.
+ *
+ * The wait honours the request's abort signal. It used to be a bare promise
+ * with no way out, so a client that gave up stayed queued forever — and since a
+ * media transfer runs without a wall-clock timeout, three stalled downloads
+ * held every slot and every later call queued behind them, uncancellable. The
+ * server was not slow, it was wedged, and no tool could run again.
+ */
+export async function acquireSlot(signal) {
+    // No already-aborted check here: `runYtDlp` makes it before every attempt and
+    // nothing awaits in between, so a second one could never fire — an
+    // unreachable guard that reads like a reachable one.
+    if (active < MAX_CONCURRENT) {
+        active++;
+        return;
+    }
+    await new Promise((resolve, reject) => {
+        const waiter = {
+            grant: () => {
+                signal?.removeEventListener('abort', onAbort);
+                resolve();
+            },
+            cancel: (error) => {
+                signal?.removeEventListener('abort', onAbort);
+                reject(error);
+            },
+        };
+        function onAbort() {
+            const index = waiting.indexOf(waiter);
+            if (index !== -1)
+                waiting.splice(index, 1);
+            waiter.cancel(new YouTubeError('CANCELLED', 'The request was cancelled.'));
+        }
+        signal?.addEventListener('abort', onAbort, { once: true });
+        waiting.push(waiter);
+    });
+}
+/**
+ * Hands the slot to the next waiter rather than freeing it and letting them
+ * race for it: decrementing first left `active` below the limit for a tick, so
+ * a fresh caller could take the slot the queue was already promised and the
+ * limiter would run over its own ceiling.
+ */
+export function releaseSlot() {
+    const next = waiting.shift();
+    if (next) {
+        next.grant();
+        return;
+    }
+    active--;
+}
+/** Test seam: lets the suite assert the limiter without spawning processes. */
+export function concurrencyState() {
+    return { active, queued: waiting.length, limit: MAX_CONCURRENT };
+}
+//# sourceMappingURL=ytdlp-limiter.js.map

package/dist/utils/ytdlp-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ytdlp-limiter.js","sourceRoot":"","sources":["../../src/utils/ytdlp-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;GAKG;AAEH,+EAA+E;AAC/E,MAAM,cAAc,GAAG,MAAM,CAAC,6BAA6B,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;AAOrF,IAAI,MAAM,GAAG,CAAC,CAAC;AACf,MAAM,OAAO,GAAa,EAAE,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAA+B;IAC/D,8EAA8E;IAC9E,mEAAmE;IACnE,qDAAqD;IACrD,IAAI,MAAM,GAAG,cAAc,EAAE,CAAC;QAC5B,MAAM,EAAE,CAAC;QACT,OAAO;IACT,CAAC;IAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,MAAM,GAAW;YACrB,KAAK,EAAE,GAAG,EAAE;gBACV,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC9C,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;gBAChB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;SACF,CAAC;QAEF,SAAS,OAAO;YACd,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACtC,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC3C,MAAM,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,WAAW,EAAE,4BAA4B,CAAC,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7B,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IACD,MAAM,EAAE,CAAC;AACX,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB;IAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;AACnE,CAAC"}

package/dist/utils/ytdlp-parse.d.ts

@@ -0,0 +1,13 @@
+import type { z } from 'zod';
+/**
+ * Parse yt-dlp JSON output against a schema.
+ *
+ * Every JSON.parse in this codebase used to be unguarded, so a truncated or
+ * non-JSON response surfaced as a raw SyntaxError; and the guard that replaced
+ * it only checked for an object, so a field of the wrong type still reached
+ * the code that read it.
+ */
+export declare function parseYtDlpJson<T>(stdout: string, schema: z.ZodType<T, z.ZodTypeDef, unknown>, what: string): T;
+/** Parse newline-delimited JSON, skipping rows that do not parse or do not match. */
+export declare function parseYtDlpJsonLines<T>(stdout: string, schema: z.ZodType<T, z.ZodTypeDef, unknown>): T[];
+//# sourceMappingURL=ytdlp-parse.d.ts.map

package/dist/utils/ytdlp-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ytdlp-parse.d.ts","sourceRoot":"","sources":["../../src/utils/ytdlp-parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAa7B;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,EAC3C,IAAI,EAAE,MAAM,GACX,CAAC,CAWH;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,GAC1C,CAAC,EAAE,CAcL"}

package/dist/utils/ytdlp-parse.js

@@ -0,0 +1,48 @@
+import { YouTubeError } from './errors.js';
+/** Reading yt-dlp's JSON output without trusting its shape. */
+function outOfDate(what, detail, cause) {
+    return new YouTubeError('MALFORMED_RESPONSE', `yt-dlp returned ${detail} for ${what}.`, {
+        nextStep: 'This usually means yt-dlp is out of date. Run `yt-dlp -U` and try again.',
+        retryable: cause !== undefined,
+        cause,
+    });
+}
+/**
+ * Parse yt-dlp JSON output against a schema.
+ *
+ * Every JSON.parse in this codebase used to be unguarded, so a truncated or
+ * non-JSON response surfaced as a raw SyntaxError; and the guard that replaced
+ * it only checked for an object, so a field of the wrong type still reached
+ * the code that read it.
+ */
+export function parseYtDlpJson(stdout, schema, what) {
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch (error) {
+        throw outOfDate(what, 'unreadable output', error);
+    }
+    const result = schema.safeParse(parsed);
+    if (!result.success)
+        throw outOfDate(what, 'an unexpected shape');
+    return result.data;
+}
+/** Parse newline-delimited JSON, skipping rows that do not parse or do not match. */
+export function parseYtDlpJsonLines(stdout, schema) {
+    const results = [];
+    for (const line of stdout.trim().split('\n')) {
+        if (!line.trim())
+            continue;
+        try {
+            const result = schema.safeParse(JSON.parse(line));
+            if (result.success)
+                results.push(result.data);
+        }
+        catch {
+            // A single malformed row should not lose the whole result set.
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=ytdlp-parse.js.map

package/dist/utils/ytdlp-parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ytdlp-parse.js","sourceRoot":"","sources":["../../src/utils/ytdlp-parse.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,+DAA+D;AAE/D,SAAS,SAAS,CAAC,IAAY,EAAE,MAAc,EAAE,KAAe;IAC9D,OAAO,IAAI,YAAY,CAAC,oBAAoB,EAAE,mBAAmB,MAAM,QAAQ,IAAI,GAAG,EAAE;QACtF,QAAQ,EAAE,0EAA0E;QACpF,SAAS,EAAE,KAAK,KAAK,SAAS;QAC9B,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,MAA2C,EAC3C,IAAY;IAEZ,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,SAAS,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,SAAS,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAClE,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,MAA2C;IAE3C,MAAM,OAAO,GAAQ,EAAE,CAAC;IAExB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAS;QAC3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAClD,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;QACjE,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/ytdlp.d.ts

@@ -1,3 +1,5 @@
+export { concurrencyState } from './ytdlp-limiter.js';
+export { parseYtDlpJson, parseYtDlpJsonLines } from './ytdlp-parse.js';
 /**
  * The single place this server spawns yt-dlp.
  *
@@ -17,12 +19,6 @@ export declare const TIMEOUTS: {
     /** Media transfers: unbounded here; cancellation is the client's lever. */
     readonly download: 0;
 };
-/** Test seam: lets the suite assert the limiter without spawning processes. */
-export declare function concurrencyState(): {
-    active: number;
-    queued: number;
-    limit: number;
-};
 export interface RunOptions {
     /** Milliseconds before the child is killed. 0 disables the timeout. */
     timeoutMs?: number;
@@ -30,22 +26,21 @@ export interface RunOptions {
     retry?: boolean;
     /** Human-readable operation name, used in log lines. */
     label?: string;
+    /**
+     * The URL, search expression or id yt-dlp operates on.
+     *
+     * Always the last argument and always preceded by a literal `--`, so a value
+     * that begins with a dash is a target yt-dlp fails to fetch, never an option
+     * it obeys. Required rather than defaulted: a call site cannot forget it.
+     */
+    target: string;
 }
 /**
  * Run yt-dlp and return its stdout.
  *
  * Arguments are always passed as an array — never a shell string — so video
- * titles and user-supplied queries cannot become shell metacharacters.
- */
-export declare function runYtDlp(args: string[], options?: RunOptions): Promise<string>;
-/**
- * Parse yt-dlp JSON output behind a type guard.
- *
- * Every JSON.parse in this codebase used to be unguarded, so a truncated or
- * non-JSON response surfaced as a raw SyntaxError.
+ * titles and user-supplied queries cannot become shell metacharacters. The
+ * target follows a `--` terminator, so it cannot become a yt-dlp option either.
  */
-export declare function parseYtDlpJson<T>(stdout: string, guard: (value: unknown) => value is T, what: string): T;
-/** Parse newline-delimited JSON, skipping unparseable lines rather than failing the call. */
-export declare function parseYtDlpJsonLines<T>(stdout: string, guard: (value: unknown) => value is T): T[];
-export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function runYtDlp(args: string[], options: RunOptions): Promise<string>;
 //# sourceMappingURL=ytdlp.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ytdlp.d.ts","sourceRoot":"","sources":["../../src/utils/ytdlp.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,kFAAkF;AAClF,eAAO,MAAM,QAAQ;IACnB,wDAAwD;;IAExD,gDAAgD;;IAEhD,iEAAiE;;IAEjE,2EAA2E;;CAEnE,CAAC;AAmFX,+EAA+E;AAC/E,wBAAgB,gBAAgB,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAEpF;AAED,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAsBD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBxF;AAoED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EACrC,IAAI,EAAE,MAAM,GACX,CAAC,CAuBH;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAcjG;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}
+{"version":3,"file":"ytdlp.d.ts","sourceRoot":"","sources":["../../src/utils/ytdlp.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvE;;;;;;;GAOG;AAEH,kFAAkF;AAClF,eAAO,MAAM,QAAQ;IACnB,wDAAwD;;IAExD,gDAAgD;;IAEhD,iEAAiE;;IAEjE,2EAA2E;;CAEnE,CAAC;AAkBX,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAsBD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBnF"}

package/dist/utils/ytdlp.js

@@ -1,6 +1,10 @@
 import { execa, ExecaError } from 'execa';
 import { currentContext, log } from './context.js';
 import { YouTubeError, classifyYtDlpFailure } from './errors.js';
+import { acquireSlot, releaseSlot } from './ytdlp-limiter.js';
+import { readYtDlpEnv } from './ytdlp-env.js';
+export { concurrencyState } from './ytdlp-limiter.js';
+export { parseYtDlpJson, parseYtDlpJsonLines } from './ytdlp-parse.js';
 /**
  * The single place this server spawns yt-dlp.
  *
@@ -20,7 +24,6 @@ export const TIMEOUTS = {
     /** Media transfers: unbounded here; cancellation is the client's lever. */
     download: 0,
 };
-const MAX_CONCURRENT = Number(process.env.YOUTUBE_MCP_MAX_CONCURRENCY ?? '3');
 const MAX_ATTEMPTS = 3;
 const BASE_BACKOFF_MS = 750;
 /** Guards against a pathological video description blowing up memory. */
@@ -35,64 +38,6 @@ const MAX_OUTPUT_BYTES = 64 * 1024 * 1024;
  * progress is never interrupted.
  */
 const SOCKET_TIMEOUT_S = '30';
-let active = 0;
-const waiting = [];
-/**
- * Takes a concurrency slot, waiting for one when the limiter is full.
- *
- * The wait honours the request's abort signal. It used to be a bare promise
- * with no way out, so a client that gave up stayed queued forever — and since a
- * media transfer runs without a wall-clock timeout, three stalled downloads
- * held every slot and every later call queued behind them, uncancellable. The
- * server was not slow, it was wedged, and no tool could run again.
- */
-async function acquireSlot(signal) {
-    // No already-aborted check here: `runYtDlp` makes it before every attempt and
-    // nothing awaits in between, so a second one could never fire — an
-    // unreachable guard that reads like a reachable one.
-    if (active < MAX_CONCURRENT) {
-        active++;
-        return;
-    }
-    await new Promise((resolve, reject) => {
-        const waiter = {
-            grant: () => {
-                signal?.removeEventListener('abort', onAbort);
-                resolve();
-            },
-            cancel: (error) => {
-                signal?.removeEventListener('abort', onAbort);
-                reject(error);
-            },
-        };
-        function onAbort() {
-            const index = waiting.indexOf(waiter);
-            if (index !== -1)
-                waiting.splice(index, 1);
-            waiter.cancel(new YouTubeError('CANCELLED', 'The request was cancelled.'));
-        }
-        signal?.addEventListener('abort', onAbort, { once: true });
-        waiting.push(waiter);
-    });
-}
-/**
- * Hands the slot to the next waiter rather than freeing it and letting them
- * race for it: decrementing first left `active` below the limit for a tick, so
- * a fresh caller could take the slot the queue was already promised and the
- * limiter would run over its own ceiling.
- */
-function releaseSlot() {
-    const next = waiting.shift();
-    if (next) {
-        next.grant();
-        return;
-    }
-    active--;
-}
-/** Test seam: lets the suite assert the limiter without spawning processes. */
-export function concurrencyState() {
-    return { active, queued: waiting.length, limit: MAX_CONCURRENT };
-}
 function backoffDelay(attempt) {
     // Exponential with full jitter, so parallel callers do not retry in lockstep.
     const ceiling = BASE_BACKOFF_MS * 2 ** (attempt - 1);
@@ -115,10 +60,11 @@ async function sleep(ms, signal) {
  * Run yt-dlp and return its stdout.
  *
  * Arguments are always passed as an array — never a shell string — so video
- * titles and user-supplied queries cannot become shell metacharacters.
+ * titles and user-supplied queries cannot become shell metacharacters. The
+ * target follows a `--` terminator, so it cannot become a yt-dlp option either.
  */
-export async function runYtDlp(args, options = {}) {
-    const { timeoutMs = TIMEOUTS.metadata, retry = true, label = 'yt-dlp' } = options;
+export async function runYtDlp(args, options) {
+    const { timeoutMs = TIMEOUTS.metadata, retry = true, label = 'yt-dlp', target } = options;
     const { signal } = currentContext();
     const maxAttempts = retry ? MAX_ATTEMPTS : 1;
     for (let attempt = 1;; attempt++) {
@@ -129,7 +75,7 @@ export async function runYtDlp(args, options = {}) {
             throw new YouTubeError('CANCELLED', 'The request was cancelled.');
         }
         try {
-            return await spawnOnce(args, timeoutMs, signal);
+            return await spawnOnce(args, target, timeoutMs, signal);
         }
         catch (error) {
             const failure = translateExecaFailure(error, timeoutMs);
@@ -143,10 +89,20 @@ export async function runYtDlp(args, options = {}) {
     }
 }
 /** One attempt, holding a concurrency slot for exactly its duration. */
-async function spawnOnce(args, timeoutMs, signal) {
+async function spawnOnce(args, target, timeoutMs, signal) {
     await acquireSlot(signal);
     try {
-        const { stdout } = await execa('yt-dlp', ['--socket-timeout', SOCKET_TIMEOUT_S, ...args], {
+        // Session flags (cookies, proxy, pacing) go first so a caller's argument can
+        // never be read as their value; the target goes last, behind `--`.
+        const argv = [
+            '--socket-timeout',
+            SOCKET_TIMEOUT_S,
+            ...readYtDlpEnv().args,
+            ...args,
+            '--',
+            target,
+        ];
+        const { stdout } = await execa('yt-dlp', argv, {
             timeout: timeoutMs > 0 ? timeoutMs : undefined,
             cancelSignal: signal,
             maxBuffer: MAX_OUTPUT_BYTES,
@@ -193,49 +149,4 @@ function asText(value) {
     }
     return '';
 }
-/**
- * Parse yt-dlp JSON output behind a type guard.
- *
- * Every JSON.parse in this codebase used to be unguarded, so a truncated or
- * non-JSON response surfaced as a raw SyntaxError.
- */
-export function parseYtDlpJson(stdout, guard, what) {
-    let parsed;
-    try {
-        parsed = JSON.parse(stdout);
-    }
-    catch (error) {
-        throw new YouTubeError('MALFORMED_RESPONSE', `yt-dlp returned unreadable output for ${what}.`, {
-            nextStep: 'This usually means yt-dlp is out of date. Run `yt-dlp -U` and try again.',
-            retryable: true,
-            cause: error,
-        });
-    }
-    if (!guard(parsed)) {
-        throw new YouTubeError('MALFORMED_RESPONSE', `yt-dlp returned an unexpected shape for ${what}.`, {
-            nextStep: 'This usually means yt-dlp is out of date. Run `yt-dlp -U` and try again.',
-        });
-    }
-    return parsed;
-}
-/** Parse newline-delimited JSON, skipping unparseable lines rather than failing the call. */
-export function parseYtDlpJsonLines(stdout, guard) {
-    const results = [];
-    for (const line of stdout.trim().split('\n')) {
-        if (!line.trim())
-            continue;
-        try {
-            const parsed = JSON.parse(line);
-            if (guard(parsed))
-                results.push(parsed);
-        }
-        catch {
-            // A single malformed row should not lose the whole result set.
-        }
-    }
-    return results;
-}
-export function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
 //# sourceMappingURL=ytdlp.js.map

package/dist/utils/ytdlp.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "youtube-knowledge-mcp",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "MCP Server for extracting and managing YouTube video knowledge",
   "author": "teobouancheau",
   "repository": {
@@ -40,6 +40,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
+    "test:e2e": "npm run build && vitest run -c vitest.e2e.config.ts",
     "typecheck": "tsc --noEmit",
     "validate": "npm run typecheck && npm run lint && npm run format:check && npm run test:coverage",
     "prepare": "husky",