@liorium/youtube-omni-mcp 0.1.0

package/.env.example

@@ -0,0 +1,11 @@
+# Optional for public YouTube Data API reads
+YOUTUBE_API_KEY=
+
+# Optional cache/outlier provider, disabled by default
+YOUTUBE_OMNI_ENABLE_OUTLIER=false
+YOUTUBE_OMNI_MONGO_URI=
+
+# Safety defaults
+YOUTUBE_OMNI_MAX_RESULTS=50
+YOUTUBE_OMNI_ENABLE_WRITE_TOOLS=false
+YOUTUBE_OMNI_ENABLE_DOWNLOAD_TOOLS=false

package/README.md

@@ -0,0 +1,86 @@
+# YouTube Omni MCP
+
+`youtube-omni` is a full-scope YouTube Creator Intelligence + Operations + Analytics + Production MCP project.
+
+Current implementation phase: **v0 read-only foundation**.
+
+## v0 boundary
+
+Enabled in v0:
+
+- public discovery/search
+- video details/comparison
+- channel statistics/top videos
+- transcript segments/full text/structure analysis
+- comments read/summarize
+- research brief drafts
+- safety/capability reporting
+
+Locked for later phases, but part of final scope:
+
+- upload/scheduling
+- metadata/thumbnail/playlist writes
+- comments/community writes
+- YouTube Analytics/Reporting/revenue/retention
+- yt-dlp download/clip/audio/frame extraction
+- Shorts production
+- YouTube Music private/library features
+- governed automation
+
+## Safety defaults
+
+- No write tools are exposed in v0.
+- No download tools are exposed in v0.
+- No Hermes MCP registration is performed by this repository setup.
+- Secrets must be supplied via environment variables and are never committed.
+
+## Development
+
+```bash
+npm install
+npm test
+npm run build
+npm run validate:v0
+npm run validate:secrets
+npm run smoke:mcp
+```
+
+## Environment
+
+See `.env.example`.
+
+## Use with npx / Hermes MCP
+
+The package is intended to run as a stdio MCP server via `npx`:
+
+```bash
+npx -y @liorium/youtube-omni-mcp
+```
+
+Hermes config example:
+
+```yaml
+mcp_servers:
+  youtube-omni:
+    command: "npx"
+    args:
+      - "-y"
+      - "@liorium/youtube-omni-mcp"
+    timeout: 300
+    connect_timeout: 60
+    env:
+      YOUTUBE_API_KEY: "..."
+      YOUTUBE_OMNI_ENABLE_WRITE_TOOLS: "false"
+      YOUTUBE_OMNI_ENABLE_DOWNLOAD_TOOLS: "false"
+```
+
+For local development before publishing, use a packed tarball:
+
+```bash
+npm pack
+npx -y ./liorium-youtube-omni-mcp-0.1.0.tgz
+```
+
+## Research and specs
+
+All research/specification documents are under `research/`. Implementation docs copied for convenience are under `docs/`.

package/dist/src/config.d.ts

@@ -0,0 +1,10 @@
+export interface YoutubeOmniConfig {
+    youtubeApiKey?: string;
+    enableOutlier: boolean;
+    mongoUri?: string;
+    maxResults: number;
+    enableWriteTools: boolean;
+    enableDownloadTools: boolean;
+}
+export declare function loadConfig(env?: NodeJS.ProcessEnv): YoutubeOmniConfig;
+export declare function redactedConfig(config: YoutubeOmniConfig): Record<string, unknown>;

package/dist/src/config.js

@@ -0,0 +1,15 @@
+import { redactSecrets } from './core/redaction.js';
+export function loadConfig(env = process.env) {
+    return {
+        youtubeApiKey: env.YOUTUBE_API_KEY,
+        enableOutlier: env.YOUTUBE_OMNI_ENABLE_OUTLIER === 'true',
+        mongoUri: env.YOUTUBE_OMNI_MONGO_URI,
+        maxResults: Number(env.YOUTUBE_OMNI_MAX_RESULTS ?? 50),
+        enableWriteTools: env.YOUTUBE_OMNI_ENABLE_WRITE_TOOLS === 'true',
+        enableDownloadTools: env.YOUTUBE_OMNI_ENABLE_DOWNLOAD_TOOLS === 'true'
+    };
+}
+export function redactedConfig(config) {
+    return JSON.parse(redactSecrets(JSON.stringify(config)));
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWpD,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,OAAO;QACL,aAAa,EAAE,GAAG,CAAC,eAAe;QAClC,aAAa,EAAE,GAAG,CAAC,2BAA2B,KAAK,MAAM;QACzD,QAAQ,EAAE,GAAG,CAAC,sBAAsB;QACpC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,wBAAwB,IAAI,EAAE,CAAC;QACtD,gBAAgB,EAAE,GAAG,CAAC,+BAA+B,KAAK,MAAM;QAChE,mBAAmB,EAAE,GAAG,CAAC,kCAAkC,KAAK,MAAM;KACvE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAyB;IACtD,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/src/core/envelope.d.ts

@@ -0,0 +1,40 @@
+import type { YoutubeOmniErrorCode } from './errors.js';
+export type AuthTier = 'none' | 'api_key' | 'oauth_readonly' | 'oauth_write' | 'hosted' | 'experimental';
+export interface ToolEnvelope<T> {
+    ok: boolean;
+    tool: string;
+    timestamp: string;
+    source: {
+        provider: string;
+        authTier: AuthTier;
+        quotaCost?: number;
+        cacheHit?: boolean;
+    };
+    data?: T;
+    warnings: string[];
+    nextActions?: string[];
+    error?: {
+        code: YoutubeOmniErrorCode;
+        message: string;
+        retryable: boolean;
+    };
+}
+export declare function makeEnvelope<T>(input: {
+    tool: string;
+    provider: string;
+    authTier: AuthTier;
+    data: T;
+    warnings?: string[];
+    nextActions?: string[];
+    quotaCost?: number;
+    cacheHit?: boolean;
+}): ToolEnvelope<T>;
+export declare function makeErrorEnvelope(input: {
+    tool: string;
+    provider: string;
+    authTier: AuthTier;
+    code: YoutubeOmniErrorCode;
+    message: string;
+    retryable: boolean;
+    warnings?: string[];
+}): ToolEnvelope<never>;

package/dist/src/core/envelope.js

@@ -0,0 +1,31 @@
+export function makeEnvelope(input) {
+    return {
+        ok: true,
+        tool: input.tool,
+        timestamp: new Date().toISOString(),
+        source: {
+            provider: input.provider,
+            authTier: input.authTier,
+            quotaCost: input.quotaCost,
+            cacheHit: input.cacheHit
+        },
+        data: input.data,
+        warnings: input.warnings ?? [],
+        nextActions: input.nextActions ?? []
+    };
+}
+export function makeErrorEnvelope(input) {
+    return {
+        ok: false,
+        tool: input.tool,
+        timestamp: new Date().toISOString(),
+        source: { provider: input.provider, authTier: input.authTier },
+        warnings: input.warnings ?? [],
+        error: {
+            code: input.code,
+            message: input.message,
+            retryable: input.retryable
+        }
+    };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/src/core/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../src/core/envelope.ts"],"names":[],"mappings":"AAwBA,MAAM,UAAU,YAAY,CAAI,KAS/B;IACC,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM,EAAE;YACN,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB;QACD,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAQjC;IACC,OAAO;QACL,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;QAC9D,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,KAAK,EAAE;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B;KACF,CAAC;AACJ,CAAC"}

package/dist/src/core/errors.d.ts

@@ -0,0 +1,44 @@
+export declare const YOUTUBE_OMNI_ERRORS: {
+    readonly INVALID_ARGUMENT: {
+        readonly retryable: false;
+    };
+    readonly PROVIDER_NOT_CONFIGURED: {
+        readonly retryable: false;
+    };
+    readonly AUTH_REQUIRED: {
+        readonly retryable: false;
+    };
+    readonly QUOTA_EXCEEDED: {
+        readonly retryable: true;
+    };
+    readonly RATE_LIMITED: {
+        readonly retryable: true;
+    };
+    readonly VIDEO_NOT_FOUND: {
+        readonly retryable: false;
+    };
+    readonly CHANNEL_NOT_FOUND: {
+        readonly retryable: false;
+    };
+    readonly TRANSCRIPT_UNAVAILABLE: {
+        readonly retryable: false;
+    };
+    readonly COMMENTS_DISABLED: {
+        readonly retryable: false;
+    };
+    readonly UNSUPPORTED_REGION: {
+        readonly retryable: false;
+    };
+    readonly PROVIDER_ERROR: {
+        readonly retryable: true;
+    };
+    readonly SAFETY_BLOCKED: {
+        readonly retryable: false;
+    };
+};
+export type YoutubeOmniErrorCode = keyof typeof YOUTUBE_OMNI_ERRORS;
+export declare class YoutubeOmniError extends Error {
+    readonly code: YoutubeOmniErrorCode;
+    readonly retryable: boolean;
+    constructor(code: YoutubeOmniErrorCode, message: string);
+}

package/dist/src/core/errors.js

@@ -0,0 +1,25 @@
+export const YOUTUBE_OMNI_ERRORS = {
+    INVALID_ARGUMENT: { retryable: false },
+    PROVIDER_NOT_CONFIGURED: { retryable: false },
+    AUTH_REQUIRED: { retryable: false },
+    QUOTA_EXCEEDED: { retryable: true },
+    RATE_LIMITED: { retryable: true },
+    VIDEO_NOT_FOUND: { retryable: false },
+    CHANNEL_NOT_FOUND: { retryable: false },
+    TRANSCRIPT_UNAVAILABLE: { retryable: false },
+    COMMENTS_DISABLED: { retryable: false },
+    UNSUPPORTED_REGION: { retryable: false },
+    PROVIDER_ERROR: { retryable: true },
+    SAFETY_BLOCKED: { retryable: false }
+};
+export class YoutubeOmniError extends Error {
+    code;
+    retryable;
+    constructor(code, message) {
+        super(`${code}: ${message}`);
+        this.name = 'YoutubeOmniError';
+        this.code = code;
+        this.retryable = YOUTUBE_OMNI_ERRORS[code].retryable;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,gBAAgB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACtC,uBAAuB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IAC7C,aAAa,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACnC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;IACnC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;IACjC,eAAe,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACrC,iBAAiB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACvC,sBAAsB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IAC5C,iBAAiB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACvC,kBAAkB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACxC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;IACnC,cAAc,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;CAC5B,CAAC;AAIX,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAuB;IAC3B,SAAS,CAAU;IAE5B,YAAY,IAA0B,EAAE,OAAe;QACrD,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;IACvD,CAAC;CACF"}

package/dist/src/core/provider-registry.d.ts

@@ -0,0 +1,6 @@
+import type { YoutubeOmniProvider } from '../providers/types.js';
+export declare class ProviderRegistry {
+    readonly providers: YoutubeOmniProvider[];
+    constructor(providers: YoutubeOmniProvider[]);
+    requireCapability(capability: string): YoutubeOmniProvider;
+}

package/dist/src/core/provider-registry.js

@@ -0,0 +1,14 @@
+import { YoutubeOmniError } from './errors.js';
+export class ProviderRegistry {
+    providers;
+    constructor(providers) {
+        this.providers = providers;
+    }
+    requireCapability(capability) {
+        const provider = this.providers.find((candidate) => candidate.isConfigured() && candidate.capabilities.includes(capability));
+        if (!provider)
+            throw new YoutubeOmniError('PROVIDER_NOT_CONFIGURED', `No provider configured for capability: ${capability}`);
+        return provider;
+    }
+}
+//# sourceMappingURL=provider-registry.js.map

package/dist/src/core/provider-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.js","sourceRoot":"","sources":["../../../src/core/provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,MAAM,OAAO,gBAAgB;IAClB,SAAS,CAAwB;IAE1C,YAAY,SAAgC;QAC1C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,iBAAiB,CAAC,UAAkB;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7H,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,gBAAgB,CAAC,yBAAyB,EAAE,0CAA0C,UAAU,EAAE,CAAC,CAAC;QAC7H,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/src/core/quota.d.ts

@@ -0,0 +1,2 @@
+export declare function estimateQuotaCost(toolName: string): number;
+export declare function enforceMaxResults(value: number, hardCap?: number): number;

package/dist/src/core/quota.js

@@ -0,0 +1,15 @@
+export function estimateQuotaCost(toolName) {
+    if (toolName.includes('search'))
+        return 100;
+    if (toolName.includes('get_video_categories'))
+        return 1;
+    if (toolName.includes('comments'))
+        return 1;
+    if (toolName.includes('transcript'))
+        return 0;
+    return 1;
+}
+export function enforceMaxResults(value, hardCap = 50) {
+    return Math.min(Math.max(1, value), hardCap);
+}
+//# sourceMappingURL=quota.js.map

package/dist/src/core/quota.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.js","sourceRoot":"","sources":["../../../src/core/quota.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,GAAG,CAAC;IAC5C,IAAI,QAAQ,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAAE,OAAO,CAAC,CAAC;IACxD,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,OAAO,GAAG,EAAE;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC"}

package/dist/src/core/redaction.d.ts

@@ -0,0 +1 @@
+export declare function redactSecrets(value: string): string;

package/dist/src/core/redaction.js

@@ -0,0 +1,23 @@
+const SECRET_PATTERNS = [
+    /AIza[0-9A-Za-z_\-]+/g,
+    /(Authorization:\s*Bearer\s+)[^\s;]+/gi,
+    /(Bearer\s+)[A-Za-z0-9._\-]+/g,
+    /(token\s*=\s*)[^\s;]+/gi,
+    /(key\s*=\s*)[^\s;]+/gi,
+    /(api[_-]?key\s*=\s*)[^\s;]+/gi,
+    /(password\s*=\s*)[^\s;]+/gi,
+    /(secret\s*=\s*)[^\s;]+/gi,
+    /(Cookie:\s*)[^\n]+/gi,
+    /([A-Z0-9_]*TOKEN[A-Z0-9_]*\s*=\s*)[^\s;]+/gi,
+    /(YOUTUBE_API_KEY\s*=\s*)[^\s;]+/gi
+];
+export function redactSecrets(value) {
+    return SECRET_PATTERNS.reduce((acc, pattern) => {
+        return acc.replace(pattern, (match, prefix) => {
+            if (typeof prefix === 'string' && match.startsWith(prefix))
+                return `${prefix}[REDACTED]`;
+            return '[REDACTED]';
+        });
+    }, value);
+}
+//# sourceMappingURL=redaction.js.map

package/dist/src/core/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../../src/core/redaction.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAa;IAChC,sBAAsB;IACtB,uCAAuC;IACvC,8BAA8B;IAC9B,yBAAyB;IACzB,uBAAuB;IACvB,+BAA+B;IAC/B,4BAA4B;IAC5B,0BAA0B;IAC1B,sBAAsB;IACtB,6CAA6C;IAC7C,mCAAmC;CACpC,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;QAC7C,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAC5C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,GAAG,MAAM,YAAY,CAAC;YACzF,OAAO,YAAY,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,KAAK,CAAC,CAAC;AACZ,CAAC"}

package/dist/src/core/risk.d.ts

@@ -0,0 +1,9 @@
+export declare const V0_LOCKED_PATTERNS: readonly ["upload", "update_video", "delete", "set_thumbnail", "reply_to_comment", "moderate", "publish", "download_video", "clip_segment", "revenue"];
+export interface ActionRisk {
+    riskTier: 0 | 1 | 2 | 3 | 4 | 5;
+    authTier: 'none' | 'api_key' | 'oauth_readonly' | 'oauth_write' | 'hosted' | 'experimental';
+    allowedInV0: boolean;
+    requiredControls: string[];
+}
+export declare function isAllowedInV0(action: string): boolean;
+export declare function classifyActionRisk(action: string): ActionRisk;

package/dist/src/core/risk.js

@@ -0,0 +1,31 @@
+export const V0_LOCKED_PATTERNS = [
+    'upload',
+    'update_video',
+    'delete',
+    'set_thumbnail',
+    'reply_to_comment',
+    'moderate',
+    'publish',
+    'download_video',
+    'clip_segment',
+    'revenue'
+];
+export function isAllowedInV0(action) {
+    return !V0_LOCKED_PATTERNS.some((pattern) => action.includes(pattern));
+}
+export function classifyActionRisk(action) {
+    if (!isAllowedInV0(action)) {
+        const destructive = ['delete', 'download_video', 'clip_segment', 'revenue'].some((pattern) => action.includes(pattern));
+        return {
+            riskTier: destructive ? 5 : 4,
+            authTier: action.includes('download') || action.includes('clip') ? 'experimental' : 'oauth_write',
+            allowedInV0: false,
+            requiredControls: destructive ? ['approval', 'double_confirmation', 'audit'] : ['approval', 'preview', 'audit']
+        };
+    }
+    if (action.includes('transcript') || action.includes('comments') || action.includes('planning')) {
+        return { riskTier: 1, authTier: 'api_key', allowedInV0: true, requiredControls: ['rate_limit', 'privacy_warning'] };
+    }
+    return { riskTier: 0, authTier: 'api_key', allowedInV0: true, requiredControls: ['rate_limit'] };
+}
+//# sourceMappingURL=risk.js.map

package/dist/src/core/risk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk.js","sourceRoot":"","sources":["../../../src/core/risk.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ;IACR,cAAc;IACd,QAAQ;IACR,eAAe;IACf,kBAAkB;IAClB,UAAU;IACV,SAAS;IACT,gBAAgB;IAChB,cAAc;IACd,SAAS;CACD,CAAC;AASX,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACxH,OAAO;YACL,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa;YACjG,WAAW,EAAE,KAAK;YAClB,gBAAgB,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC;SAChH,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAChG,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,YAAY,EAAE,iBAAiB,CAAC,EAAE,CAAC;IACtH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;AACnG,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { createInterface } from 'node:readline';
+import { createToolHandlers, V0_TOOL_NAMES } from './server.js';
+import { redactSecrets } from './core/redaction.js';
+const handlers = createToolHandlers();
+const rl = createInterface({ input: process.stdin, output: process.stdout, terminal: false });
+process.stdout.on('error', (caught) => {
+    if (caught.code === 'EPIPE')
+        process.exit(0);
+    throw caught;
+});
+function respond(id, result) {
+    process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id, result })}\n`);
+}
+function error(id, code, message) {
+    process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id, error: { code, message: redactSecrets(message) } })}\n`);
+}
+rl.on('line', async (line) => {
+    if (!line.trim())
+        return;
+    try {
+        const request = JSON.parse(line);
+        if (request.method === 'initialize') {
+            respond(request.id, { protocolVersion: '2024-11-05', capabilities: { tools: {} }, serverInfo: { name: 'youtube-omni-mcp', version: '0.1.0' } });
+            return;
+        }
+        if (request.method === 'tools/list') {
+            respond(request.id, { tools: V0_TOOL_NAMES.map((name) => ({ name, description: `YouTube Omni v0 read-only tool: ${name}`, inputSchema: { type: 'object' } })) });
+            return;
+        }
+        if (request.method === 'tools/call') {
+            const name = request.params?.name;
+            const handler = handlers[name];
+            if (!handler) {
+                error(request.id, -32601, `Unknown tool: ${String(name)}`);
+                return;
+            }
+            const result = await handler(request.params?.arguments ?? {});
+            respond(request.id, { content: [{ type: 'text', text: JSON.stringify(result) }] });
+            return;
+        }
+        if (request.method === 'notifications/initialized')
+            return;
+        error(request.id, -32601, `Unknown method: ${request.method}`);
+    }
+    catch (caught) {
+        error(null, -32700, caught instanceof Error ? caught.message : String(caught));
+    }
+});
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/providers/mock-provider.d.ts

@@ -0,0 +1,150 @@
+import type { ProviderHealth, YoutubeOmniProvider } from './types.js';
+export declare class MockYoutubeProvider implements YoutubeOmniProvider {
+    id: string;
+    name: string;
+    authTier: "none";
+    capabilities: string[];
+    isConfigured(): boolean;
+    healthCheck(): Promise<ProviderHealth>;
+    searchVideos(input: {
+        query: string;
+        maxResults: number;
+    }): Promise<{
+        videos: {
+            videoId: string;
+            title: string;
+            channelId: string;
+            channelTitle: string;
+            publishedAt: string;
+            descriptionSnippet: string;
+            url: string;
+        }[];
+    }>;
+    searchChannels(input: {
+        query: string;
+        maxResults: number;
+    }): Promise<{
+        channels: {
+            channelId: string;
+            title: string;
+            descriptionSnippet: string;
+            url: string;
+        }[];
+    }>;
+    getTrendingVideos(input: {
+        maxResults: number;
+    }): Promise<{
+        videos: {
+            videoId: string;
+            title: string;
+            channelId: string;
+            channelTitle: string;
+            publishedAt: string;
+            descriptionSnippet: string;
+            url: string;
+        }[];
+    }>;
+    getVideoCategories(input: {
+        regionCode: string;
+    }): Promise<{
+        regionCode: string;
+        categories: {
+            id: string;
+            title: string;
+            assignable: boolean;
+        }[];
+    }>;
+    getVideoDetails(input: {
+        videoIds: string[];
+        includeTags?: boolean;
+    }): Promise<{
+        videos: {
+            videoId: string;
+            title: string;
+            channelId: string;
+            channelTitle: string;
+            publishedAt: string;
+            duration: string;
+            categoryId: string;
+            statistics: {
+                viewCount: number;
+                likeCount: number;
+                commentCount: number;
+            };
+            tags: string[];
+            description: string;
+        }[];
+    }>;
+    getChannelStatistics(input: {
+        channelIds: string[];
+    }): Promise<{
+        channels: {
+            channelId: string;
+            title: string;
+            subscriberCount: number;
+            viewCount: number;
+            videoCount: number;
+            publishedAt: string;
+        }[];
+    }>;
+    getChannelTopVideos(input: {
+        channelId: string;
+        maxResults: number;
+    }): Promise<{
+        channelId: string;
+        videos: {
+            videoId: string;
+            title: string;
+            channelId: string;
+            channelTitle: string;
+            publishedAt: string;
+            duration: string;
+            categoryId: string;
+            statistics: {
+                viewCount: number;
+                likeCount: number;
+                commentCount: number;
+            };
+            tags: string[];
+            description: string;
+        }[];
+    }>;
+    getTranscriptSegments(input: {
+        videoIds: string[];
+        lang: string;
+        format: 'key_segments';
+    }): Promise<{
+        transcripts: {
+            videoId: string;
+            language: string;
+            format: "key_segments";
+            intro: string;
+            outro: string;
+            availability: string;
+        }[];
+    }>;
+    getTranscriptFullText(input: {
+        videoId: string;
+        lang: string;
+        maxChars: number;
+    }): Promise<{
+        videoId: string;
+        language: string;
+        text: string;
+        truncated: boolean;
+    }>;
+    getVideoComments(input: {
+        videoId: string;
+        maxResults: number;
+        maxReplies: number;
+    }): Promise<{
+        videoId: string;
+        comments: {
+            commentId: string;
+            text: string;
+            likeCount: number;
+            publishedAt: string;
+            replyCount: number;
+        }[];
+    }>;
+}