@liorium/youtube-omni-mcp 0.1.2 → 0.2.2

package/.env.example

@@ -1,9 +1,10 @@
 # Optional for public YouTube Data API reads
 YOUTUBE_API_KEY=
 
-# Optional cache/outlier provider, disabled by default
+# Optional cache/outlier provider. When enabled with MongoDB URI, public YouTube API responses are cached.
 YOUTUBE_OMNI_ENABLE_OUTLIER=false
-YOUTUBE_OMNI_MONGO_URI=
+YOUTUBE_OMNI_MONGO_URI=mongodb://127.0.0.1:27018/youtube_omni_mcp
+YOUTUBE_OMNI_CACHE_TTL_SECONDS=21600
 
 # Safety defaults
 YOUTUBE_OMNI_MAX_RESULTS=50

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.2.2 - 2026-05-14
+
+- Document the dedicated local MongoDB backing-service names under the `youtube-omni-mcp` package prefix.
+- Standardize local Docker resources as `youtube-omni-mcp-mongo:7`, `youtube-omni-mcp-mongo`, and `youtube-omni-mcp-mongo-data`.
+- Keep the dedicated MongoDB connection on `127.0.0.1:27018/youtube_omni_mcp` with cache collection `youtube_omni_cache`.
+
+## 0.2.1 - 2026-05-14
+
+- Use the live YouTube Data API provider when `YOUTUBE_API_KEY` is configured instead of always using mock data.
+- Add MongoDB cache provider activated by `YOUTUBE_OMNI_ENABLE_OUTLIER=true` plus `YOUTUBE_OMNI_MONGO_URI`.
+- Add cache TTL configuration via `YOUTUBE_OMNI_CACHE_TTL_SECONDS` and document new-environment MCP setup.
+- Keep mock provider fallback for safe schema/smoke testing when no API key is present.
+
+## 0.2.0 - 2026-05-14
+
+- Add five Creator Research tools: outlier video discovery, hook comparison, topic angle extraction, comment pain-point summarization, and video angle matrix generation.
+- Add governed operation tool foundations for metadata, upload, thumbnail, playlist, comment moderation, and community post workflows.
+- Keep operation tools hidden by default and dry-run-only when explicitly gated with `YOUTUBE_OMNI_ENABLE_WRITE_TOOLS=true` and `YOUTUBE_OMNI_DRY_RUN_WRITES=true`.
+- Add concrete MCP schemas for research and gated operation tools.
+- Update safety policy and capability reporting for the v0.2 phase.
+
 ## 0.1.2 - 2026-05-14
 
 - Add concrete MCP `inputSchema` definitions for all v0 tools so agents can pass required arguments reliably.

package/README.md

@@ -2,11 +2,11 @@
 
 `youtube-omni` is a full-scope YouTube Creator Intelligence + Operations + Analytics + Production MCP project.
 
-Current implementation phase: **v0 read-only foundation**.
+Current implementation phase: **v0.2.1 live YouTube Data API + MongoDB cache foundation**.
 
-## v0 boundary
+## v0.2 default boundary
 
-Enabled in v0:
+Enabled by default:
 
 - public discovery/search
 - video details/comparison
@@ -14,6 +14,7 @@ Enabled in v0:
 - transcript segments/full text/structure analysis
 - comments read/summarize
 - research brief drafts
+- Creator Research synthesis tools
 - safety/capability reporting
 
 Locked for later phases, but part of final scope:
@@ -29,8 +30,9 @@ Locked for later phases, but part of final scope:
 
 ## Safety defaults
 
-- No write tools are exposed in v0.
-- No download tools are exposed in v0.
+- No write tools are exposed by default.
+- No download tools are exposed by default.
+- Operation tools are dry-run-only stubs when `YOUTUBE_OMNI_ENABLE_WRITE_TOOLS=true` and `YOUTUBE_OMNI_DRY_RUN_WRITES=true` are both set.
 - Secrets must be supplied via environment variables and are never committed.
 - Write/download/destructive namespaces remain environment-gated for later phases.
 
@@ -55,8 +57,11 @@ Use this shape in an `mcp.json`-style client configuration:
       "env": {
         "YOUTUBE_API_KEY": "YOUR_YOUTUBE_DATA_API_KEY",
         "YOUTUBE_OMNI_MAX_RESULTS": "50",
-        "YOUTUBE_OMNI_ENABLE_OUTLIER": "false",
+        "YOUTUBE_OMNI_ENABLE_OUTLIER": "true",
+        "YOUTUBE_OMNI_MONGO_URI": "mongodb://127.0.0.1:27018/youtube_omni_mcp",
+        "YOUTUBE_OMNI_CACHE_TTL_SECONDS": "21600",
         "YOUTUBE_OMNI_ENABLE_WRITE_TOOLS": "false",
+        "YOUTUBE_OMNI_DRY_RUN_WRITES": "false",
         "YOUTUBE_OMNI_ENABLE_DOWNLOAD_TOOLS": "false",
         "YOUTUBE_OMNI_ENABLE_DESTRUCTIVE_TOOLS": "false"
       }
@@ -69,7 +74,30 @@ For local development before publishing, use a packed tarball:
 
 ```bash
 npm pack
-npx -y ./liorium-youtube-omni-mcp-0.1.2.tgz
+npx -y ./liorium-youtube-omni-mcp-0.2.1.tgz
+```
+
+## MongoDB cache mode
+
+For a new Hermes/MCP environment, set both the flag and the URI:
+
+```yaml
+YOUTUBE_OMNI_ENABLE_OUTLIER: 'true'
+YOUTUBE_OMNI_MONGO_URI: mongodb://127.0.0.1:27018/youtube_omni_mcp
+YOUTUBE_OMNI_CACHE_TTL_SECONDS: '21600'
+```
+
+When `YOUTUBE_API_KEY` is present, youtube-omni uses the live YouTube Data API provider. When Mongo cache mode is also enabled, public Data API reads are wrapped by a MongoDB cache (`youtube_omni_cache` collection) so repeated research/planning calls reuse previous results instead of spending quota again. Without `YOUTUBE_API_KEY`, the server falls back to the mock provider for safe schema/smoke testing.
+
+For local Docker-backed deployments, keep resource names under the package prefix:
+
+```text
+image: youtube-omni-mcp-mongo:7
+container: youtube-omni-mcp-mongo
+volume: youtube-omni-mcp-mongo-data
+port: 127.0.0.1:27018 -> 27017
+db: youtube_omni_mcp
+collection: youtube_omni_cache
 ```
 
 ## Development
@@ -93,7 +121,7 @@ All research/specification documents are under `research/`. Implementation docs
 
 Key docs:
 
-- `docs/v0-spec.md` — current read-only boundary
-- `docs/tool-schema.md` — v0 tool contract
+- `docs/v0-spec.md` — original read-only foundation boundary
+- `docs/tool-schema.md` — v0.2 default and gated tool contract
 - `docs/safety-policy.md` — risk gates and default locks
-- `docs/v0.2-ac-plan.md` — next implementation plan for Creator Research + governed write foundations
+- `docs/v0.2-ac-plan.md` — implementation plan for Creator Research + governed write foundations

package/dist/src/config.d.ts

@@ -4,7 +4,10 @@ export interface YoutubeOmniConfig {
     mongoUri?: string;
     maxResults: number;
     enableWriteTools: boolean;
+    dryRunWrites: boolean;
+    approvalAuditPath?: string;
     enableDownloadTools: boolean;
+    cacheTtlSeconds: number;
 }
 export declare function loadConfig(env?: NodeJS.ProcessEnv): YoutubeOmniConfig;
 export declare function redactedConfig(config: YoutubeOmniConfig): Record<string, unknown>;

package/dist/src/config.js

@@ -6,7 +6,10 @@ export function loadConfig(env = process.env) {
         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'
+        dryRunWrites: env.YOUTUBE_OMNI_DRY_RUN_WRITES === 'true',
+        approvalAuditPath: env.YOUTUBE_OMNI_APPROVAL_AUDIT_PATH,
+        enableDownloadTools: env.YOUTUBE_OMNI_ENABLE_DOWNLOAD_TOOLS === 'true',
+        cacheTtlSeconds: Number(env.YOUTUBE_OMNI_CACHE_TTL_SECONDS ?? 21600)
     };
 }
 export function redactedConfig(config) {

package/dist/src/config.js.map

@@ -1 +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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAcpD,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,YAAY,EAAE,GAAG,CAAC,2BAA2B,KAAK,MAAM;QACxD,iBAAiB,EAAE,GAAG,CAAC,gCAAgC;QACvD,mBAAmB,EAAE,GAAG,CAAC,kCAAkC,KAAK,MAAM;QACtE,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,8BAA8B,IAAI,KAAK,CAAC;KACrE,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/errors.d.ts

@@ -35,6 +35,9 @@ export declare const YOUTUBE_OMNI_ERRORS: {
     readonly SAFETY_BLOCKED: {
         readonly retryable: false;
     };
+    readonly APPROVAL_REQUIRED_OR_WRITE_DISABLED: {
+        readonly retryable: false;
+    };
 };
 export type YoutubeOmniErrorCode = keyof typeof YOUTUBE_OMNI_ERRORS;
 export declare class YoutubeOmniError extends Error {

package/dist/src/core/errors.js

@@ -10,7 +10,8 @@ export const YOUTUBE_OMNI_ERRORS = {
     COMMENTS_DISABLED: { retryable: false },
     UNSUPPORTED_REGION: { retryable: false },
     PROVIDER_ERROR: { retryable: true },
-    SAFETY_BLOCKED: { retryable: false }
+    SAFETY_BLOCKED: { retryable: false },
+    APPROVAL_REQUIRED_OR_WRITE_DISABLED: { retryable: false }
 };
 export class YoutubeOmniError extends Error {
     code;

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

@@ -1 +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"}
+{"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;IACpC,mCAAmC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;CACjD,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/risk.d.ts

@@ -1,5 +1,7 @@
 export declare const V0_LOCKED_PATTERNS: readonly ["upload", "update_video", "delete", "set_thumbnail", "reply_to_comment", "moderate", "publish", "download_video", "clip_segment", "revenue"];
+export type RiskLabel = 'none' | 'low' | 'medium' | 'high' | 'destructive';
 export interface ActionRisk {
+    risk: RiskLabel;
     riskTier: 0 | 1 | 2 | 3 | 4 | 5;
     authTier: 'none' | 'api_key' | 'oauth_readonly' | 'oauth_write' | 'hosted' | 'experimental';
     allowedInV0: boolean;

package/dist/src/core/risk.js

@@ -13,19 +13,35 @@ export const V0_LOCKED_PATTERNS = [
 export function isAllowedInV0(action) {
     return !V0_LOCKED_PATTERNS.some((pattern) => action.includes(pattern));
 }
+function operationRisk(action) {
+    if (!action.includes('youtube.operations.'))
+        return undefined;
+    const destructive = ['delete_video', 'delete', 'remove'].some((pattern) => action.includes(pattern));
+    return {
+        risk: destructive ? 'destructive' : 'high',
+        riskTier: destructive ? 5 : 4,
+        authTier: 'oauth_write',
+        allowedInV0: false,
+        requiredControls: destructive ? ['approval', 'double_confirmation', 'audit'] : ['approval', 'preview', 'audit', 'dry_run']
+    };
+}
 export function classifyActionRisk(action) {
+    const operation = operationRisk(action);
+    if (operation)
+        return operation;
     if (!isAllowedInV0(action)) {
         const destructive = ['delete', 'download_video', 'clip_segment', 'revenue'].some((pattern) => action.includes(pattern));
         return {
+            risk: destructive ? 'destructive' : 'high',
             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'] };
+    if (action.includes('transcript') || action.includes('comments') || action.includes('planning') || action.includes('research')) {
+        return { risk: 'low', riskTier: 1, authTier: 'api_key', allowedInV0: true, requiredControls: ['rate_limit', 'privacy_warning'] };
     }
-    return { riskTier: 0, authTier: 'api_key', allowedInV0: true, requiredControls: ['rate_limit'] };
+    return { risk: 'none', riskTier: 0, authTier: 'api_key', allowedInV0: true, requiredControls: ['rate_limit'] };
 }
 //# sourceMappingURL=risk.js.map

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

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

package/dist/src/index.js

@@ -21,7 +21,7 @@ rl.on('line', async (line) => {
     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.1' } });
+            respond(request.id, { protocolVersion: '2024-11-05', capabilities: { tools: {} }, serverInfo: { name: 'youtube-omni-mcp', version: '0.2.2' } });
             return;
         }
         if (request.method === 'tools/list') {

package/dist/src/providers/mongo-cache-provider.d.ts

@@ -0,0 +1,82 @@
+import type { ProviderHealth, YoutubeOmniProvider } from './types.js';
+export interface CacheStore {
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    close?(): Promise<void>;
+}
+export declare class MongoCacheProvider implements YoutubeOmniProvider {
+    readonly upstream: YoutubeOmniProvider;
+    private readonly store;
+    private readonly ttlSeconds;
+    id: string;
+    name: string;
+    authTier: import("../core/envelope.js").AuthTier;
+    capabilities: string[];
+    constructor(upstream: YoutubeOmniProvider, store: CacheStore, ttlSeconds?: number);
+    isConfigured(): boolean;
+    healthCheck(): Promise<ProviderHealth>;
+    private cached;
+    searchVideos(input: {
+        query: string;
+        maxResults: number;
+    }): Promise<{
+        videos: any[];
+    }>;
+    searchChannels(input: {
+        query: string;
+        maxResults: number;
+    }): Promise<{
+        channels: any[];
+    }>;
+    getTrendingVideos(input: {
+        regionCode: string;
+        categoryId?: string;
+        maxResults: number;
+    }): Promise<{
+        videos: any[];
+    }>;
+    getVideoCategories(input: {
+        regionCode: string;
+    }): Promise<{
+        regionCode: string;
+        categories: any[];
+    }>;
+    getVideoDetails(input: {
+        videoIds: string[];
+        includeTags?: boolean;
+        descriptionDetail?: string;
+    }): Promise<{
+        videos: any[];
+    }>;
+    getChannelStatistics(input: {
+        channelIds: string[];
+    }): Promise<{
+        channels: any[];
+    }>;
+    getChannelTopVideos(input: {
+        channelId: string;
+        maxResults: number;
+    }): Promise<{
+        channelId: string;
+        videos: any[];
+    }>;
+    getVideoComments(input: {
+        videoId: string;
+        maxResults: number;
+        maxReplies: number;
+    }): Promise<{
+        videoId: string;
+        comments: any[];
+    }>;
+}
+export declare class MongoCacheStore implements CacheStore {
+    private readonly uri;
+    private readonly dbName;
+    private readonly collectionName;
+    private clientPromise?;
+    constructor(uri: string, dbName?: string, collectionName?: string);
+    private collection;
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/src/providers/mongo-cache-provider.js

@@ -0,0 +1,118 @@
+function stableStringify(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableStringify).join(',')}]`;
+    if (value && typeof value === 'object') {
+        return `{${Object.entries(value)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([key, val]) => `${JSON.stringify(key)}:${stableStringify(val)}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+function cacheKey(providerId, method, input) {
+    return `youtube-omni:v1:${providerId}:${method}:${stableStringify(input)}`;
+}
+export class MongoCacheProvider {
+    upstream;
+    store;
+    ttlSeconds;
+    id = 'mongo_cache';
+    name = 'MongoDB cached YouTube provider';
+    authTier;
+    capabilities;
+    constructor(upstream, store, ttlSeconds = 6 * 60 * 60) {
+        this.upstream = upstream;
+        this.store = store;
+        this.ttlSeconds = ttlSeconds;
+        this.authTier = upstream.authTier;
+        this.capabilities = [...upstream.capabilities];
+    }
+    isConfigured() { return this.upstream.isConfigured(); }
+    async healthCheck() {
+        const upstream = await this.upstream.healthCheck();
+        return {
+            provider: this.id,
+            configured: this.isConfigured(),
+            authTier: this.authTier,
+            capabilities: this.capabilities,
+            warnings: [`Caching upstream provider: ${upstream.provider}`, ...upstream.warnings]
+        };
+    }
+    async cached(method, input, fetcher) {
+        const key = cacheKey(this.upstream.id, method, input);
+        const cached = await this.store.get(key);
+        if (cached !== undefined)
+            return cached;
+        const fresh = await fetcher();
+        await this.store.set(key, fresh, this.ttlSeconds);
+        return fresh;
+    }
+    async searchVideos(input) {
+        return this.cached('searchVideos', input, () => this.upstream.searchVideos(input));
+    }
+    async searchChannels(input) {
+        return this.cached('searchChannels', input, () => this.upstream.searchChannels(input));
+    }
+    async getTrendingVideos(input) {
+        return this.cached('getTrendingVideos', input, () => this.upstream.getTrendingVideos(input));
+    }
+    async getVideoCategories(input) {
+        return this.cached('getVideoCategories', input, () => this.upstream.getVideoCategories(input));
+    }
+    async getVideoDetails(input) {
+        return this.cached('getVideoDetails', input, () => this.upstream.getVideoDetails(input));
+    }
+    async getChannelStatistics(input) {
+        return this.cached('getChannelStatistics', input, () => this.upstream.getChannelStatistics(input));
+    }
+    async getChannelTopVideos(input) {
+        return this.cached('getChannelTopVideos', input, () => this.upstream.getChannelTopVideos(input));
+    }
+    async getVideoComments(input) {
+        return this.cached('getVideoComments', input, () => this.upstream.getVideoComments(input));
+    }
+}
+export class MongoCacheStore {
+    uri;
+    dbName;
+    collectionName;
+    clientPromise;
+    constructor(uri, dbName = databaseNameFromUri(uri), collectionName = 'youtube_omni_cache') {
+        this.uri = uri;
+        this.dbName = dbName;
+        this.collectionName = collectionName;
+    }
+    async collection() {
+        if (!this.clientPromise) {
+            const { MongoClient } = await import('mongodb');
+            const client = new MongoClient(this.uri, { serverSelectionTimeoutMS: 5000 });
+            this.clientPromise = client.connect().then(() => client);
+        }
+        const client = await this.clientPromise;
+        const collection = client.db(this.dbName).collection(this.collectionName);
+        await collection.createIndex({ expiresAt: 1 }, { expireAfterSeconds: 0 });
+        return collection;
+    }
+    async get(key) {
+        const hit = await (await this.collection()).findOne({ _id: key, $or: [{ expiresAt: { $exists: false } }, { expiresAt: { $gt: new Date() } }] });
+        return hit?.value;
+    }
+    async set(key, value, ttlSeconds = 6 * 60 * 60) {
+        const expiresAt = new Date(Date.now() + ttlSeconds * 1000);
+        await (await this.collection()).updateOne({ _id: key }, { $set: { value, expiresAt, updatedAt: new Date() }, $setOnInsert: { createdAt: new Date() } }, { upsert: true });
+    }
+    async close() {
+        const client = await this.clientPromise;
+        await client?.close();
+    }
+}
+function databaseNameFromUri(uri) {
+    try {
+        const parsed = new URL(uri);
+        return parsed.pathname.replace(/^\//, '') || 'youtube_mcp';
+    }
+    catch {
+        return 'youtube_mcp';
+    }
+}
+//# sourceMappingURL=mongo-cache-provider.js.map

package/dist/src/providers/mongo-cache-provider.js.map

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

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

@@ -6,4 +6,28 @@ export declare class TranscriptProvider implements YoutubeOmniProvider {
     capabilities: string[];
     isConfigured(): boolean;
     healthCheck(): Promise<ProviderHealth>;
+    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;
+    }>;
 }

package/dist/src/providers/transcript-provider.js

@@ -4,6 +4,14 @@ export class TranscriptProvider {
     authTier = 'none';
     capabilities = ['transcript'];
     isConfigured() { return true; }
-    async healthCheck() { return { provider: this.id, configured: true, authTier: this.authTier, capabilities: this.capabilities, warnings: ['Placeholder provider returns TRANSCRIPT_UNAVAILABLE until a real transcript adapter is configured'] }; }
+    async healthCheck() {
+        return { provider: this.id, configured: true, authTier: this.authTier, capabilities: this.capabilities, warnings: ['Transcript provider returns unavailable placeholders until a real transcript adapter is configured'] };
+    }
+    async getTranscriptSegments(input) {
+        return { transcripts: input.videoIds.map((videoId) => ({ videoId, language: input.lang, format: input.format, intro: '', outro: '', availability: 'unavailable' })) };
+    }
+    async getTranscriptFullText(input) {
+        return { videoId: input.videoId, language: input.lang, text: '', truncated: false };
+    }
 }
 //# sourceMappingURL=transcript-provider.js.map

package/dist/src/providers/transcript-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"transcript-provider.js","sourceRoot":"","sources":["../../../src/providers/transcript-provider.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,kBAAkB;IAC7B,EAAE,GAAG,wBAAwB,CAAC;IAC9B,IAAI,GAAG,iCAAiC,CAAC;IACzC,QAAQ,GAAG,MAAe,CAAC;IAC3B,YAAY,GAAG,CAAC,YAAY,CAAC,CAAC;IAC9B,YAAY,KAAc,OAAO,IAAI,CAAC,CAAC,CAAC;IACxC,KAAK,CAAC,WAAW,KAA8B,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,CAAC,mGAAmG,CAAC,EAAE,CAAC,CAAC,CAAC;CAC5Q"}
+{"version":3,"file":"transcript-provider.js","sourceRoot":"","sources":["../../../src/providers/transcript-provider.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,kBAAkB;IAC7B,EAAE,GAAG,wBAAwB,CAAC;IAC9B,IAAI,GAAG,iCAAiC,CAAC;IACzC,QAAQ,GAAG,MAAe,CAAC;IAC3B,YAAY,GAAG,CAAC,YAAY,CAAC,CAAC;IAE9B,YAAY,KAAc,OAAO,IAAI,CAAC,CAAC,CAAC;IAExC,KAAK,CAAC,WAAW;QACf,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,CAAC,oGAAoG,CAAC,EAAE,CAAC;IAC7N,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,KAAmE;QAC7F,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC;IACxK,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,KAA0D;QACpF,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACtF,CAAC;CACF"}

package/dist/src/providers/youtube-data-api.d.ts

@@ -1,11 +1,75 @@
 import type { ProviderHealth, YoutubeOmniProvider } from './types.js';
+type FetchLike = typeof fetch;
 export declare class YoutubeDataApiProvider implements YoutubeOmniProvider {
     id: string;
     name: string;
     authTier: "api_key";
     capabilities: string[];
     private readonly apiKey?;
-    constructor(apiKey?: string);
+    private readonly fetchImpl;
+    constructor(apiKey?: string, fetchImpl?: FetchLike);
     isConfigured(): boolean;
     healthCheck(): Promise<ProviderHealth>;
+    private get;
+    searchVideos(input: {
+        query: string;
+        maxResults: number;
+        order?: string;
+        videoDuration?: string;
+        recency?: string;
+        regionCode?: string;
+    }): Promise<{
+        videos: any;
+    }>;
+    searchChannels(input: {
+        query: string;
+        maxResults: number;
+        regionCode?: string;
+    }): Promise<{
+        channels: any;
+    }>;
+    getTrendingVideos(input: {
+        regionCode: string;
+        categoryId?: string;
+        maxResults: number;
+    }): Promise<{
+        videos: any;
+    }>;
+    getVideoCategories(input: {
+        regionCode: string;
+    }): Promise<{
+        regionCode: string;
+        categories: any;
+    }>;
+    getVideoDetails(input: {
+        videoIds: string[];
+        includeTags?: boolean;
+        descriptionDetail?: string;
+    }): Promise<{
+        videos: any;
+    }>;
+    getChannelStatistics(input: {
+        channelIds: string[];
+    }): Promise<{
+        channels: any;
+    }>;
+    getChannelTopVideos(input: {
+        channelId: string;
+        maxResults: number;
+        includeTags?: boolean;
+        descriptionDetail?: string;
+    }): Promise<{
+        channelId: string;
+        videos: any;
+    }>;
+    getVideoComments(input: {
+        videoId: string;
+        maxResults: number;
+        maxReplies: number;
+        order?: string;
+    }): Promise<{
+        videoId: string;
+        comments: any;
+    }>;
 }
+export {};