@mkterswingman/5mghost-yonder 0.0.37 → 0.0.39

package/dist/cli/check.js

@@ -1,6 +1,6 @@
 import { existsSync } from "node:fs";
 import { PATHS, loadConfig } from "../utils/config.js";
-import { TokenManager } from "../auth/tokenManager.js";
+import { TokenManager } from "@mkterswingman/5mghost-shared-client/auth";
 import { hasSIDCookies, areCookiesExpired } from "../utils/cookies.js";
 import { getYtDlpVersion } from "../utils/ytdlpPath.js";
 import { runRuntimeCommand } from "./runtime.js";
@@ -9,7 +9,11 @@ import { runRuntimeCommand } from "./runtime.js";
  */
 export async function runCheck() {
     const config = loadConfig();
-    const tm = new TokenManager(config.auth_url);
+    const tm = new TokenManager({
+        authUrl: config.auth_url,
+        authJsonPath: PATHS.sharedAuthJson,
+        envTokenName: "YT_MCP_TOKEN",
+    });
     console.log("yt-mcp check\n");
     // 1. Token
     const token = await tm.getValidToken();

package/dist/cli/index.js

@@ -28,6 +28,7 @@ Commands:
   setup-cookies  Refresh YouTube cookies using browser login
   runtime        Manage required runtimes
   check          Check auth, runtime, cookies, and connectivity
+  doctor         Alias for check; diagnose local install and runtime health
   uninstall      Remove MCP registrations and local yt-mcp config
   update         Update the main package and required runtimes
   version        Show current version
@@ -70,6 +71,13 @@ export async function runUnifiedUpdate(deps) {
 const command = process.argv[2];
 async function main() {
     switch (command) {
+        case undefined:
+        case "help":
+        case "--help":
+        case "-h": {
+            console.log(buildHelpText(getVersion()));
+            break;
+        }
         case "setup": {
             const { runSetup } = await import("./setup.js");
             await runSetup();
@@ -118,6 +126,11 @@ async function main() {
             await runCheck();
             break;
         }
+        case "doctor": {
+            const { runCheck } = await import("./check.js");
+            await runCheck();
+            break;
+        }
         case "update": {
             const current = getVersion();
             console.log(`Current version: ${current}`);
@@ -165,7 +178,7 @@ async function main() {
         }
         default:
             console.log(buildHelpText(getVersion()));
-            process.exit(command ? 1 : 0);
+            process.exit(1);
     }
 }
 main().catch((err) => {

package/dist/cli/installSkills.js

@@ -1,16 +1,9 @@
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
-import { execFileSync } from "node:child_process";
-import { buildSkillInstallPlan, installSkillTarget, } from "../utils/skills.js";
-function detectCli(name) {
-    try {
-        execFileSync(name, ["--version"], { stdio: "pipe" });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
+import { buildSkillInstallPlan, installSkillTarget, } from "@mkterswingman/5mghost-shared-client/registration";
+import { detectCli } from "@mkterswingman/5mghost-shared-client";
+import { getWorkBuddySkillsDir, isWorkBuddyInstallLikelyInstalled } from "../utils/workBuddy.js";
+import { getCodeBuddySkillsDir, isCodeBuddyInstallLikelyInstalled } from "../utils/codeBuddy.js";
 function resolvePackageRoot() {
     return join(dirname(fileURLToPath(import.meta.url)), "..", "..");
 }
@@ -24,10 +17,26 @@ export async function runInstallSkills() {
         "gemini-internal",
         "gemini",
     ].filter(detectCli);
-    const plan = buildSkillInstallPlan(packageRoot, {
+    const plan = buildSkillInstallPlan(packageRoot, "use-yt-mcp", {
         availableCliNames,
         includeOpenClaw: process.env.YT_MCP_INSTALL_OPENCLAW_SKILL === "1",
     });
+    if (isWorkBuddyInstallLikelyInstalled() && !plan.some((target) => target.client === "workbuddy")) {
+        plan.push({
+            client: "workbuddy",
+            label: "WorkBuddy",
+            sourceDir: join(packageRoot, "skills", "use-yt-mcp"),
+            targetDir: join(getWorkBuddySkillsDir(), "use-yt-mcp"),
+        });
+    }
+    if (isCodeBuddyInstallLikelyInstalled() && !plan.some((target) => target.client === "codebuddy")) {
+        plan.push({
+            client: "codebuddy",
+            label: "CodeBuddy",
+            sourceDir: join(packageRoot, "skills", "use-yt-mcp"),
+            targetDir: join(getCodeBuddySkillsDir(), "use-yt-mcp"),
+        });
+    }
     if (plan.length === 0) {
         console.log("[yt-mcp] No supported AI client detected for bundled skill install.");
         return;

package/dist/cli/serve.js

@@ -1,11 +1,15 @@
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { loadConfig } from "../utils/config.js";
-import { TokenManager } from "../auth/tokenManager.js";
+import { loadConfig, PATHS } from "../utils/config.js";
+import { TokenManager } from "@mkterswingman/5mghost-shared-client/auth";
 import { DownloadJobManager } from "../download/jobManager.js";
 import { createServer } from "../server.js";
 export async function runServe() {
     const config = loadConfig();
-    const tokenManager = new TokenManager(config.auth_url);
+    const tokenManager = new TokenManager({
+        authUrl: config.auth_url,
+        authJsonPath: PATHS.sharedAuthJson,
+        envTokenName: "YT_MCP_TOKEN",
+    });
     const downloadJobManager = new DownloadJobManager();
     // PAT mode via env var (don't persist — just keep in memory for this session)
     const pat = process.env.YT_MCP_TOKEN;

package/dist/cli/setup.js

@@ -2,25 +2,17 @@ import { execFileSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { createInterface } from "node:readline/promises";
 import { loadConfig, saveConfig, PATHS, ensureConfigDir } from "../utils/config.js";
-import { TokenManager } from "../auth/tokenManager.js";
-import { runOAuthFlow } from "../auth/oauthFlow.js";
+import { TokenManager } from "@mkterswingman/5mghost-shared-client/auth";
+import { runOAuthFlow } from "@mkterswingman/5mghost-shared-client/auth";
 import { hasSIDCookies } from "../utils/cookies.js";
 import { buildLauncherCommand, writeLauncherFile } from "../utils/launcher.js";
 import { buildBrowserOpenCommand } from "../utils/browserLaunch.js";
+import { getWorkBuddyConfigPath, isWorkBuddyInstallLikelyInstalled, writeWorkBuddyConfig, } from "../utils/workBuddy.js";
+import { getCodeBuddyConfigPath, isCodeBuddyInstallLikelyInstalled, writeCodeBuddyConfig, } from "../utils/codeBuddy.js";
 import { checkAll } from "../runtime/installers.js";
 import { runInstallSkills } from "./installSkills.js";
-import { getOpenClawConfigPath, isOpenClawInstallLikelyInstalled, writeOpenClawConfig, } from "../utils/openClaw.js";
-import { getCodexInternalConfigPath, writeCodexInternalConfig, } from "../utils/codexInternal.js";
-import { MCP_REGISTER_TIMEOUT_MS, classifyRegistrationFailure, } from "../utils/mcpRegistration.js";
-function detectCli(name) {
-    try {
-        execFileSync(name, ["--version"], { stdio: "pipe" });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
+import { registerCliCandidates, registerOpenClaw, } from "@mkterswingman/5mghost-shared-client/registration";
+import { getOpenClawConfigPath, getCodexInternalConfigPath, writeCodexInternalConfig, detectCli, isOpenClawInstallLikelyInstalled, MCP_REGISTER_TIMEOUT_MS, classifyRegistrationFailure, } from "@mkterswingman/5mghost-shared-client";
 function tryRegisterMcp(cmd, label) {
     try {
         execFileSync(cmd.file, cmd.args, { stdio: "pipe", timeout: MCP_REGISTER_TIMEOUT_MS });
@@ -215,7 +207,11 @@ export async function runSetup() {
     console.log(`  ✅ Shared auth: ${PATHS.sharedAuthJson}`);
     // ── Step 3: Authentication ──
     console.log("Step 3/5: Authentication...");
-    const tokenManager = new TokenManager(config.auth_url);
+    const tokenManager = new TokenManager({
+        authUrl: config.auth_url,
+        authJsonPath: PATHS.sharedAuthJson,
+        envTokenName: "YT_MCP_TOKEN",
+    });
     const pat = process.env.YT_MCP_TOKEN;
     if (pat) {
         // Explicit PAT provided via env var
@@ -270,7 +266,11 @@ export async function runSetup() {
             }
             console.log(`  OAuth 等待上限：${Math.round(oauthTimeoutMs / 1000)}s`);
             try {
-                const tokens = await runOAuthFlow(config.auth_url, { timeoutMs: oauthTimeoutMs });
+                const tokens = await runOAuthFlow({
+                    clientName: "yt-mcp-cli",
+                    authUrl: config.auth_url,
+                    timeoutMs: oauthTimeoutMs,
+                });
                 await tokenManager.saveTokens(tokens.accessToken, tokens.refreshToken, tokens.expiresIn, tokens.clientId);
                 console.log("  ✅ OAuth login successful");
                 console.log("  ℹ️  Other first-party local MCPs on this machine can reuse this login.");
@@ -363,18 +363,10 @@ export async function runSetup() {
     // ── Step 5: MCP Registration ──
     console.log("Step 5/5: Registering MCP in AI clients...");
     const launcherCommand = buildLauncherCommand();
-    let registered = false;
-    let skillsInstalled = false;
-    for (const { bin, label, command } of buildSetupCliCandidates({
-        file: launcherCommand.command,
-        args: launcherCommand.args,
-    })) {
-        if (!detectCli(bin))
-            continue;
-        if (tryRegisterMcp(command, label)) {
-            registered = true;
-        }
-    }
+    let registered = registerCliCandidates({
+        serverName: "yt-mcp",
+        launcherCommand,
+    });
     if (isOpenClawInstallLikelyInstalled(detectCli)) {
         try {
             let openClawRegistered = false;
@@ -385,10 +377,11 @@ export async function runSetup() {
                 }), "OpenClaw (mcporter config)");
             }
             if (!openClawRegistered) {
-                const status = writeOpenClawConfig("yt-mcp", launcherCommand);
-                const suffix = status === "created" ? "created" : "updated";
-                console.log(`  ✅ MCP registered in OpenClaw (${suffix} ${getOpenClawConfigPath()})`);
-                openClawRegistered = true;
+                const result = registerOpenClaw("yt-mcp", launcherCommand);
+                if (result) {
+                    console.log(`  ✅ MCP registered in OpenClaw (${result.method === "cli" ? "mcporter config" : result.status} ${getOpenClawConfigPath()})`);
+                    openClawRegistered = true;
+                }
             }
             if (openClawRegistered) {
                 registered = true;
@@ -409,6 +402,29 @@ export async function runSetup() {
             console.log(`  ⚠️  Codex CLI (internal) auto-register failed: ${err instanceof Error ? err.message : String(err)}`);
         }
     }
+    if (isWorkBuddyInstallLikelyInstalled(getWorkBuddyConfigPath())) {
+        try {
+            const status = writeWorkBuddyConfig("yt-mcp", launcherCommand);
+            const suffix = status === "created" ? "created" : "updated";
+            console.log(`  ✅ MCP registered in WorkBuddy (${suffix} ${getWorkBuddyConfigPath()})`);
+            registered = true;
+        }
+        catch (err) {
+            console.log(`  ⚠️  WorkBuddy auto-register failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (isCodeBuddyInstallLikelyInstalled(getCodeBuddyConfigPath())) {
+        try {
+            const status = writeCodeBuddyConfig("yt-mcp", launcherCommand);
+            const suffix = status === "created" ? "created" : "updated";
+            console.log(`  ✅ MCP registered in CodeBuddy (${suffix} ${getCodeBuddyConfigPath()})`);
+            registered = true;
+        }
+        catch (err) {
+            console.log(`  ⚠️  CodeBuddy auto-register failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    let skillsInstalled = false;
     try {
         process.env.YT_MCP_INSTALL_OPENCLAW_SKILL = isOpenClawInstallLikelyInstalled(detectCli) ? "1" : "0";
         await runInstallSkills();
@@ -449,6 +465,8 @@ export async function runSetup() {
     console.log("  OpenClaw stdio CLI (recommended):");
     console.log(`  mcporter config add yt-mcp --command node --arg ${JSON.stringify(PATHS.launcherJs)} --arg serve`);
     console.log(`  OpenClaw uses ${PATHS.sharedAuthJson} for PAT/JWT, so env.YT_MCP_TOKEN is optional after setup.`);
+    console.log(`  WorkBuddy MCP config: ${getWorkBuddyConfigPath()}`);
+    console.log(`  CodeBuddy MCP config: ${getCodeBuddyConfigPath()}`);
     if (skillsInstalled) {
         console.log("  ✅ Installed bundled yt-mcp analysis skill for detected AI clients");
     }

package/dist/cli/setupCookies.d.ts

@@ -76,9 +76,6 @@ export declare function readCdpCookiesUntilSession(client: CdpCookieClient, deps
 export declare function tryImportBrowserCookies(chromium: SetupCookiesChromium, deps: SetupCookiesDeps): Promise<boolean>;
 export declare function readImportedBrowserCookies(candidate: BrowserProfileCandidate, chromium: SetupCookiesChromium, deps: SetupCookiesDeps): Promise<PlaywrightCookie[] | null>;
 export declare function runManualCookieSetup(chromium: SetupCookiesChromium, deps: SetupCookiesDeps): Promise<void>;
-/**
- * Interactive cookie setup — opens a visible browser for user to log in.
- */
-export declare function parseSetupCookiesArgs(argv: string[]): void;
+export declare function parseSetupCookiesArgs(argv: string[], warn?: (message: string) => void): void;
 export declare function runSetupCookies(overrides?: Partial<SetupCookiesDeps>): Promise<void>;
 export {};

package/dist/cli/setupCookies.js

@@ -412,9 +412,22 @@ export async function runManualCookieSetup(chromium, deps) {
 /**
  * Interactive cookie setup — opens a visible browser for user to log in.
  */
-export function parseSetupCookiesArgs(argv) {
+const LEGACY_SETUP_COOKIES_FLAGS = new Set(["--import-only", "--headed"]);
+export function parseSetupCookiesArgs(argv, warn = console.warn) {
+    const legacyFlags = [];
     for (const arg of argv) {
-        throw new Error(`Unknown option for setup-cookies: ${arg}. setup-cookies accepts no options.`);
+        if (LEGACY_SETUP_COOKIES_FLAGS.has(arg)) {
+            if (!legacyFlags.includes(arg)) {
+                legacyFlags.push(arg);
+            }
+            continue;
+        }
+        throw new Error(`Unknown option for setup-cookies: ${arg}. Supported legacy flags: --import-only, --headed.`);
+    }
+    if (legacyFlags.length > 0) {
+        warn(`[DEPRECATED] setup-cookies now runs a single guided flow. ` +
+            `Ignoring legacy flags: ${legacyFlags.join(", ")}. ` +
+            `Please run: yt-mcp setup-cookies`);
     }
 }
 export async function runSetupCookies(overrides = {}) {

package/dist/cli/uninstall.js

@@ -1,17 +1,10 @@
 import { execFileSync, spawn } from "node:child_process";
 import { existsSync, rmSync } from "node:fs";
 import { PATHS } from "../utils/config.js";
-import { getOpenClawConfigPath, removeOpenClawConfig } from "../utils/openClaw.js";
-import { getCodexInternalConfigPath, removeCodexInternalConfig, } from "../utils/codexInternal.js";
-function detectCli(name) {
-    try {
-        execFileSync(name, ["--version"], { stdio: "pipe" });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
+import { getWorkBuddyConfigPath, removeWorkBuddyConfig } from "../utils/workBuddy.js";
+import { getCodeBuddyConfigPath, removeCodeBuddyConfig } from "../utils/codeBuddy.js";
+import { getOpenClawConfigPath, getCodexInternalConfigPath, removeCodexInternalConfig, unregisterOpenClaw, detectCli, } from "@mkterswingman/5mghost-shared-client";
+import { unregisterCliCandidates } from "@mkterswingman/5mghost-shared-client/registration";
 function tryRemoveMcp(command, label) {
     try {
         execFileSync(command.file, command.args, { stdio: "pipe" });
@@ -64,13 +57,9 @@ function scheduleSelfUninstall() {
 export async function runUninstall() {
     console.log("\n🧹 yt-mcp uninstall\n");
     console.log("Removing MCP client registrations...");
-    for (const candidate of buildUninstallCliCandidates()) {
-        if (!detectCli(candidate.bin))
-            continue;
-        tryRemoveMcp(candidate.command, candidate.label);
-    }
-    const openClawStatus = removeOpenClawConfig("yt-mcp");
-    if (openClawStatus === "removed") {
+    unregisterCliCandidates({ serverName: "yt-mcp" });
+    const openClawResult = unregisterOpenClaw("yt-mcp");
+    if (openClawResult === "removed") {
         console.log(`  ✅ Removed MCP registration from OpenClaw (${getOpenClawConfigPath()})`);
     }
     else {
@@ -85,6 +74,20 @@ export async function runUninstall() {
             console.log("  ℹ️  Codex CLI (internal) did not have yt-mcp registered");
         }
     }
+    const workBuddyStatus = removeWorkBuddyConfig("yt-mcp");
+    if (workBuddyStatus === "removed") {
+        console.log(`  ✅ Removed MCP registration from WorkBuddy (${getWorkBuddyConfigPath()})`);
+    }
+    else {
+        console.log("  ℹ️  WorkBuddy did not have yt-mcp registered");
+    }
+    const codeBuddyStatus = removeCodeBuddyConfig("yt-mcp");
+    if (codeBuddyStatus === "removed") {
+        console.log(`  ✅ Removed MCP registration from CodeBuddy (${getCodeBuddyConfigPath()})`);
+    }
+    else {
+        console.log("  ℹ️  CodeBuddy did not have yt-mcp registered");
+    }
     if (existsSync(PATHS.configDir)) {
         // Why: ~/.yt-mcp contains launcher, token cache, cookies, and npm cache owned by this package.
         rmSync(PATHS.configDir, { recursive: true, force: true });

package/dist/contracts/youtubeToolContracts.d.ts

@@ -0,0 +1,17 @@
+export type YouTubeToolHttpMethod = "GET" | "POST";
+export interface YouTubeToolAliasContract {
+    name: string;
+    remove_after_version: string;
+    remove_after_date: string;
+    note: string;
+}
+export interface YouTubeToolContract {
+    id: string;
+    remote_tool_name: string;
+    mcp_primary_name: string;
+    mcp_aliases: YouTubeToolAliasContract[];
+    http_path: string;
+    http_method: YouTubeToolHttpMethod;
+}
+export declare const YOUTUBE_TOOL_CONTRACTS: YouTubeToolContract[];
+export declare function getYouTubeToolContractById(id: string): YouTubeToolContract;

package/dist/contracts/youtubeToolContracts.js

@@ -0,0 +1,189 @@
+// AUTO-GENERATED by scripts/sync-youtube-tool-contracts.mjs
+// Source of truth: contracts/youtube-tool-contracts.json
+// Do not edit manually.
+export const YOUTUBE_TOOL_CONTRACTS = [
+    {
+        "id": "search_videos",
+        "remote_tool_name": "search_videos",
+        "mcp_primary_name": "search_videos",
+        "mcp_aliases": [],
+        "http_path": "/api/search",
+        "http_method": "POST"
+    },
+    {
+        "id": "get_video_stats",
+        "remote_tool_name": "get_video_stats",
+        "mcp_primary_name": "get_video_stats",
+        "mcp_aliases": [
+            {
+                "name": "get_video_stats_bulk_sync",
+                "remove_after_version": "0.2.0",
+                "remove_after_date": "2026-12-31",
+                "note": "Legacy name kept for backward compatibility."
+            }
+        ],
+        "http_path": "/api/video-stats/bulk",
+        "http_method": "POST"
+    },
+    {
+        "id": "start_video_stats_job",
+        "remote_tool_name": "start_video_stats_job",
+        "mcp_primary_name": "start_video_stats_job",
+        "mcp_aliases": [],
+        "http_path": "/api/video-stats/job/start",
+        "http_method": "POST"
+    },
+    {
+        "id": "poll_video_stats_job",
+        "remote_tool_name": "poll_video_stats_job",
+        "mcp_primary_name": "poll_video_stats_job",
+        "mcp_aliases": [],
+        "http_path": "/api/video-stats/job/poll",
+        "http_method": "POST"
+    },
+    {
+        "id": "resume_video_stats_job",
+        "remote_tool_name": "resume_video_stats_job",
+        "mcp_primary_name": "resume_video_stats_job",
+        "mcp_aliases": [],
+        "http_path": "/api/video-stats/job/resume",
+        "http_method": "POST"
+    },
+    {
+        "id": "get_trending",
+        "remote_tool_name": "get_trending",
+        "mcp_primary_name": "get_trending",
+        "mcp_aliases": [
+            {
+                "name": "get_trending_videos",
+                "remove_after_version": "0.2.0",
+                "remove_after_date": "2026-12-31",
+                "note": "Legacy name kept for backward compatibility."
+            }
+        ],
+        "http_path": "/api/trending",
+        "http_method": "POST"
+    },
+    {
+        "id": "search_channels",
+        "remote_tool_name": "search_channels",
+        "mcp_primary_name": "search_channels",
+        "mcp_aliases": [],
+        "http_path": "/api/channel/search",
+        "http_method": "POST"
+    },
+    {
+        "id": "get_channel_stats",
+        "remote_tool_name": "get_channel_stats",
+        "mcp_primary_name": "get_channel_stats",
+        "mcp_aliases": [],
+        "http_path": "/api/channel/stats",
+        "http_method": "POST"
+    },
+    {
+        "id": "list_channel_uploads",
+        "remote_tool_name": "list_channel_uploads",
+        "mcp_primary_name": "list_channel_uploads",
+        "mcp_aliases": [],
+        "http_path": "/api/channel/uploads",
+        "http_method": "POST"
+    },
+    {
+        "id": "get_comments",
+        "remote_tool_name": "get_comments",
+        "mcp_primary_name": "get_comments",
+        "mcp_aliases": [
+            {
+                "name": "get_video_comments_sync",
+                "remove_after_version": "0.2.0",
+                "remove_after_date": "2026-12-31",
+                "note": "Legacy name kept for backward compatibility."
+            }
+        ],
+        "http_path": "/api/comments/sync",
+        "http_method": "POST"
+    },
+    {
+        "id": "start_comments_job",
+        "remote_tool_name": "start_comments_job",
+        "mcp_primary_name": "start_comments_job",
+        "mcp_aliases": [
+            {
+                "name": "start_comments_export_job",
+                "remove_after_version": "0.2.0",
+                "remove_after_date": "2026-12-31",
+                "note": "Legacy name kept for backward compatibility."
+            }
+        ],
+        "http_path": "/api/comments/start",
+        "http_method": "POST"
+    },
+    {
+        "id": "poll_comments_job",
+        "remote_tool_name": "poll_comments_job",
+        "mcp_primary_name": "poll_comments_job",
+        "mcp_aliases": [
+            {
+                "name": "poll_comments_export_job",
+                "remove_after_version": "0.2.0",
+                "remove_after_date": "2026-12-31",
+                "note": "Legacy name kept for backward compatibility."
+            }
+        ],
+        "http_path": "/api/comments/poll",
+        "http_method": "POST"
+    },
+    {
+        "id": "resume_comments_job",
+        "remote_tool_name": "resume_comments_job",
+        "mcp_primary_name": "resume_comments_job",
+        "mcp_aliases": [
+            {
+                "name": "resume_comments_export_job",
+                "remove_after_version": "0.2.0",
+                "remove_after_date": "2026-12-31",
+                "note": "Legacy name kept for backward compatibility."
+            }
+        ],
+        "http_path": "/api/comments/resume",
+        "http_method": "POST"
+    },
+    {
+        "id": "get_comment_replies",
+        "remote_tool_name": "get_comment_replies",
+        "mcp_primary_name": "get_comment_replies",
+        "mcp_aliases": [
+            {
+                "name": "get_comment_replies_sync",
+                "remove_after_version": "0.2.0",
+                "remove_after_date": "2026-12-31",
+                "note": "Legacy name kept for backward compatibility."
+            }
+        ],
+        "http_path": "/api/comments/replies",
+        "http_method": "POST"
+    },
+    {
+        "id": "get_quota_usage",
+        "remote_tool_name": "get_quota_usage",
+        "mcp_primary_name": "get_quota_usage",
+        "mcp_aliases": [],
+        "http_path": "/api/quota",
+        "http_method": "POST"
+    },
+    {
+        "id": "get_patch_notes",
+        "remote_tool_name": "get_patch_notes",
+        "mcp_primary_name": "get_patch_notes",
+        "mcp_aliases": [],
+        "http_path": "/api/patch-notes",
+        "http_method": "GET"
+    }
+];
+export function getYouTubeToolContractById(id) {
+    const match = YOUTUBE_TOOL_CONTRACTS.find((tool) => tool.id === id);
+    if (!match) {
+        throw new Error(`Unknown YouTube tool contract id: ${id}`);
+    }
+    return match;
+}

package/dist/server.d.ts

@@ -1,6 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { YtMcpConfig } from "./utils/config.js";
-import type { TokenManager } from "./auth/tokenManager.js";
+import type { TokenManager } from "@mkterswingman/5mghost-shared-client/auth";
 import { DownloadJobManager } from "./download/jobManager.js";
 import type { DownloadToolDeps } from "./tools/downloads.js";
 /**

package/dist/tools/downloads.d.ts

@@ -1,6 +1,6 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { YtMcpConfig } from "../utils/config.js";
-import type { TokenManager } from "../auth/tokenManager.js";
+import type { TokenManager } from "@mkterswingman/5mghost-shared-client/auth";
 import { downloadOneItem } from "../download/downloader.js";
 import type { DownloadJobManager } from "../download/jobManager.js";
 export interface DownloadToolDeps {

package/dist/tools/remote.d.ts

@@ -1,4 +1,4 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { YtMcpConfig } from "../utils/config.js";
-import type { TokenManager } from "../auth/tokenManager.js";
+import type { TokenManager } from "@mkterswingman/5mghost-shared-client/auth";
 export declare function registerRemoteTools(server: McpServer, config: YtMcpConfig, tokenManager: TokenManager): void;