@thenavidm/youtube-mcp-cli 2.0.0 → 3.0.0

package/README.md

@@ -1,4 +1,4 @@
-<img src="https://cdn.navid.media/connectors/youtube-icon.png" alt="YouTube" width="88">
+<img src="https://cdn.navid.me/connectors/youtube-icon.png" alt="YouTube" width="88">
 
 # YouTube MCP Server & CLI
 
@@ -18,7 +18,7 @@ does not return.
 
 Connect as many channels as you run, with one login each and no config file.
 
-Built and maintained by [Navid Moazzez](https://navid.me?utm_source=github&utm_medium=readme&utm_campaign=youtube-mcp-cli).
+Built and maintained by [Navid Moazzez](https://navid.me?utm_source=github&utm_medium=referral&utm_campaign=youtube-mcp-cli&utm_content=readme). Built on [Slipway](https://github.com/thenavidm/slipway), which turns one definition of each tool into the MCP server and the CLI.
 
 ```
 You: what does this video actually say about pricing?
@@ -59,7 +59,7 @@ errors are JSON on stderr whichever output you pick.
 receives for that tool, which is how you can check the two surfaces really are
 one thing.
 
-### MCP server, for AI agents
+### MCP server, for your AI app
 
 `youtube-mcp` is what Claude Code, Claude Desktop, Cursor and the rest launch.
 You never run it by hand:
@@ -70,6 +70,9 @@ claude mcp add youtube -- npx -y @thenavidm/youtube-mcp-cli@latest
 
 Then just ask: _"which of this channel's last 30 videos actually overperformed?"_
 
+Replying to a comment and deleting a video wait for your approval in the client,
+as [section 9](#9-writing-safely-) explains.
+
 Channels you connected with `youtube-cli login` on this machine are read
 automatically, so the command needs no credentials. Every other client is in
 [section 4](#4-connect-your-client-).
@@ -85,7 +88,24 @@ automatically, so the command needs no credentials. Every other client is in
 They are the same program reading the same tool definitions, so anything one
 can do, the other can.
 
-## Contents 📑
+## Features
+
+Every tool is both a command and an MCP tool, with the same name. The command
+is the tool name with dashes.
+
+| Capability | CLI command | MCP tool |
+|---|---|---|
+| Transcripts of any public video, no credentials | `youtube-cli get-transcript` / `get-transcripts` / `search-transcript` / `list-transcript-languages` | `get_transcript` / `get_transcripts` / `search_transcript` / `list_transcript_languages` |
+| Research any channel or video | `youtube-cli search-videos` / `get-channel` / `analyze-channel` / `get-video` | `search_videos` / `get_channel` / `analyze_channel` / `get_video` |
+| Your channels and their numbers | `youtube-cli list-accounts` / `get-my-channel` / `get-channel-analytics` / `list-my-videos` | `list_accounts` / `get_my_channel` / `get_channel_analytics` / `list_my_videos` |
+| Comments | `youtube-cli list-comments` / `reply-to-comment` | `list_comments` / `reply_to_comment` |
+| Edit or delete your videos | `youtube-cli update-video` / `delete-video` | `update_video` / `delete_video` |
+| Connect a channel or an API key | `youtube-cli login` / `logout` | not tools |
+| Check your setup | `youtube-cli doctor` | not a tool |
+
+All 16 are in [section 7](#7-tools-).
+
+## Contents
 
 | # | Section | What is in it |
 |---|---|---|
@@ -211,8 +231,9 @@ A browser opens, you pick the channel, and it is saved. **Run `youtube-cli
 login` once per channel.** Then `youtube-cli list-accounts` shows them all.
 [Section 10](#10-several-channels-) covers using several.
 
-You do not need Google to verify the app. Testing mode is the correct end state
-for a tool you run yourself.
+You do not need Google to verify the app, but do click **Publish app** under
+**Audience**. An app left in testing issues refresh tokens that expire after
+seven days, so login would stop working every week.
 
 ## 4. Connect your client 🔌
 
@@ -405,12 +426,12 @@ not: check the client before reconnecting anything.
 Both surfaces are the same program with the same 16 tools. The
 difference is when the model pays for them. Measured in Claude Code:
 
-| | MCP server | CLI |
+| Cost | MCP server | CLI |
 |---|---|---|
-| Every message, with every tool loaded | 5,000 tokens | nothing |
+| Every message, with every tool loaded | 4,500 tokens | nothing |
 | Every message, Claude Code's default | 490 tokens | nothing |
-| When YouTube comes up | nothing more, or the tools it picks | 2,300 tokens for `SKILL.md`, once |
-| 20 messages with YouTube in 1, every tool loaded | 100,000 tokens | 2,300 tokens |
+| When YouTube comes up | nothing more, or the tools it picks | 2,350 tokens for `SKILL.md`, once |
+| 20 messages with YouTube in 1, every tool loaded | 90,000 tokens | 2,350 tokens |
 
 Claude Code's [tool search](https://code.claude.com/docs/en/mcp#scale-with-mcp-tool-search)
 is on by default: it sends only the tool names and the server instructions,
@@ -423,12 +444,26 @@ To spend less, turn the server off when you are not using it, which in Claude
 Code is the `/mcp` panel. `YOUTUBE_READ_ONLY=1` takes the 3 write tools off the list, leaving 13.
 Or install the CLI and add the server on the days it earns its place.
 
-Measured on 2026-09-27 with Claude Code 2.1.257 on Claude Opus 5: one
+Measured on 2026-10-05 with Claude Code 2.1.286 on Claude Opus 5.5: one
 short prompt with and without the server connected, once with
 `ENABLE_TOOL_SEARCH=false` and once with the default, the difference read
 from the API's own usage figures. `SKILL.md` was measured the same way. Other
 apps and models count tokens a little differently.
 
+Against 2.0.0, measured the same day: every tool loaded costs 4,458 tokens
+instead of 4,984, tool search 489 instead of 493, and `SKILL.md` 93 more,
+because it now says how approval works over MCP and lists every exit code. In
+Codex 0.159.3 on gpt-6.1-sol, the same task, "find the command that scores a
+channel's recent videos against that channel's own median, and the flags it
+requires", read a median of 83,295 input tokens on 3.0.0 against 83,565 on
+2.0.0 over the CLI, five runs each: Codex now asks `which` instead of reading
+the full command list, and the general help is shorter. Over MCP, Codex prints
+the tool list with a script and answers from that printout, 6,133 tokens on
+3.0.0 against 6,126; the 7 more are the description of `confirm` on the two
+irreversible tools. The input totals, a median of 45,053 against 44,924, also
+carry the model's reasoning into its second request, which three of the five
+2.0.0 runs skipped; the two that kept it read 45,065 and 45,074.
+
 ## 7. Tools 🛠️
 
 Every tool is also a command: the tool name with dashes. `*` marks a write, `!`
@@ -499,21 +534,26 @@ Everything a script needs to branch on.
 | `--select a,b.c` | only the named fields of a JSON result, dotted paths descend |
 
 Results go to stdout. Errors go to stderr, always as JSON, so one parse handles
-both outcomes:
+both outcomes. `code` names the kind of failure, and `hint` and `details`, such
+as Google's own reason, come along when there is one:
 
 ```json
-{ "error": "No API key is configured. Run `youtube-cli login --api-key KEY` or set YOUTUBE_API_KEY for public data, or `youtube-cli login` for your own channels." }
+{
+  "error": "No API key is configured. Run `youtube-cli login --api-key KEY` or set YOUTUBE_API_KEY for public data, or `youtube-cli login` for your own channels.",
+  "code": "not_configured"
+}
 ```
 
 | Code | Means |
 |---|---|
 | `0` | it worked |
-| `2` | you typed it wrong, or a guarded write was refused for want of `--confirm` |
+| `1` | an unexpected error |
+| `2` | you typed it wrong, an unknown command, a write hidden by `YOUTUBE_READ_ONLY`, or a guarded write refused for want of `--confirm` |
 | `3` | not found |
 | `4` | authentication failed: reconnect the channel |
 | `5` | an API error upstream |
 | `7` | rate limited or out of quota: wait |
-| `10` | nothing configured: run `youtube-cli login` or `login --api-key` |
+| `10` | nothing configured: run `youtube-cli login` or `login --api-key`, or install yt-dlp for transcripts |
 
 So a script can tell a mistake it should fix from a failure it should retry:
 
@@ -533,19 +573,27 @@ Writes work by default, because managing a channel is the point.
 
 Two tools are guarded: `reply_to_comment`, because it is public the moment it
 lands and notifies someone, and `delete_video`, because YouTube removes a video
-immediately with no trash and no undo. Both refuse without `--confirm` in the
-terminal or `confirm: true` through MCP. The CLI goes through the same guard as
-the server, so the rules are identical.
+immediately with no trash and no undo. Both wait for your approval. The CLI goes
+through the same guard as the server, so the rules are identical.
+
+Over MCP a person approves each of the two where the client can ask: Claude Code
+(2.1.246 and later) shows its own prompt, and a client that can show forms asks
+with an approval form whose one box starts unticked. Each approval is signed,
+bound to that exact call and works once. Where a client can do neither, the
+model's `confirm: true` counts, and it should pass it only when you asked for
+that exact reply or delete. `YOUTUBE_CONFIRM=model` makes `confirm: true` enough
+everywhere, for an agent with no person to ask. In a terminal it is `--confirm`,
+which `--agent` never adds.
 
 `update_video` is not guarded. A title is one keystroke to put back, and asking
-to confirm reversible things teaches a model to confirm everything reflexively,
-which is worse protection than not asking.
+to approve reversible things teaches people and models to approve everything
+reflexively, which is worse protection than not asking.
 
 | Setting | Effect |
 |---|---|
 | `YOUTUBE_READ_ONLY=1` | Every write disappears from the tool list and the command list |
 | `YOUTUBE_ALLOW_DESTRUCTIVE=0` | `update_video` stays, the two irreversible tools are blocked |
-| `YOUTUBE_AUDIT_LOG=<path>` | One JSON line per attempted write, allowed and blocked alike |
+| `YOUTUBE_AUDIT_LOG=<path>` | One JSON line per attempted write, allowed and blocked alike, and who approved it |
 
 Comments, titles, descriptions and transcripts are written by other people. The
 tool descriptions and the shipped `SKILL.md` tell the model to treat them as
@@ -670,6 +718,11 @@ are in its output.
 | A command refuses and lists your channels | Two or more are connected. Pass `--account` |
 | Every write command has vanished | `YOUTUBE_READ_ONLY=1` is set |
 | Server missing in Claude Desktop | Use the absolute path to `npx`, check the JSON, and fully quit the app |
+| "will not run without --confirm" | Working as intended: a reply is public and a delete is permanent. See [section 9](#9-writing-safely-) |
+| `claude -p` will not reply or delete | Headless Claude Code refuses tools that need a person. Give that agent `YOUTUBE_CONFIRM=model` |
+| No approval form appears | The client cannot show forms, so the model's `confirm: true` counts, and only for an action you asked for |
+| YouTube asks yt-dlp to prove it is not a bot | Set `YOUTUBE_YTDLP_COOKIES` to a cookies.txt exported from a browser signed in to YouTube |
+| A piped request gets no answer | Stdin closed before the answer. The MCP stdio binding stops a server when its input ends; keep stdin open until you read the answer, or use the CLI |
 
 ## Environment variables
 
@@ -696,7 +749,8 @@ you ran `youtube-cli login`.
 |---|---|---|
 | `YOUTUBE_READ_ONLY` | `0` | `1` hides every write |
 | `YOUTUBE_ALLOW_DESTRUCTIVE` | `1` | `0` blocks the two irreversible tools |
-| `YOUTUBE_AUDIT_LOG` | none | Append-only log of every attempted write |
+| `YOUTUBE_AUDIT_LOG` | none | Append-only log of every attempted write, and who approved it |
+| `YOUTUBE_CONFIRM` | `human` | `model` lets `confirm: true` alone approve over MCP, for an agent with no person to ask |
 
 **Tuning**
 
@@ -705,11 +759,16 @@ you ran `youtube-cli login`.
 | `YOUTUBE_REQUEST_TIMEOUT_MS` | `30000` | Per-request deadline |
 | `YOUTUBE_TRANSCRIPT_LANG` | `en` | Default transcript language |
 | `YOUTUBE_YTDLP_PATH` | `yt-dlp` on PATH | Where yt-dlp is |
+| `YOUTUBE_YTDLP_COOKIES` | none | A cookies.txt from a browser signed in to YouTube, for when YouTube asks yt-dlp to prove it is not a bot |
 | `YOUTUBE_MCP_HOME` | `~/.youtube-mcp-cli` | Where `login` saves channels |
 | `YOUTUBE_OAUTH_PORT` | `8765` | The localhost port `login` listens on |
 | `YOUTUBE_HTTP_PORT` | `8787` | For `--http` |
 | `YOUTUBE_HTTP_HOST` | `127.0.0.1` | For `--http` |
-| `YOUTUBE_HTTP_TOKEN` | none | Bearer token required by `--http` |
+| `YOUTUBE_HTTP_TOKEN` | none | Bearer token for `--http`. Any address but localhost refuses to start without one |
+| `YOUTUBE_HTTP_ALLOWED_ORIGINS` | none | Comma-separated browser origins allowed to connect; a page from any other site is refused |
+| `YOUTUBE_SURFACE` | `full` | `search` lists three tools that find, describe and run the rest |
+| `YOUTUBE_TOOL_TIMEOUT_MS` | none | Give up on any tool after this long |
+| `YOUTUBE_DEBUG` | `0` | `1` prints debug lines on stderr |
 
 ## Versions
 
@@ -790,10 +849,11 @@ afternoon by hand.
 <details>
 <summary><b>Can it delete one of my videos by accident?</b></summary>
 
-It cannot delete anything without `--confirm` or `confirm: true`, which a model
-has to set deliberately after reading a description saying the action is
-permanent. If you want the possibility gone entirely, set `YOUTUBE_READ_ONLY=1`
-and every write disappears.
+It cannot delete anything without your approval: Claude Code shows its own
+prompt for each delete, a client that can show forms asks with one, and
+elsewhere the model has to pass `confirm: true` deliberately after reading a
+description saying the action is permanent. If you want the possibility gone
+entirely, set `YOUTUBE_READ_ONLY=1` and every write disappears.
 
 </details>
 
@@ -823,6 +883,16 @@ the app to stop that, or run `youtube-cli login` again when it happens.
 
 </details>
 
+<details>
+<summary><b>Can it reply to a comment without me asking?</b></summary>
+
+It replies when you ask it to. A reply is public the moment it lands and
+notifies the person you replied to, so each one waits for your approval in the
+client, as a delete does. `YOUTUBE_READ_ONLY=1` removes replying, editing and
+deleting from the list entirely.
+
+</details>
+
 <details>
 <summary><b>How do I disconnect it?</b></summary>
 
@@ -833,19 +903,19 @@ the Cloud project removes the API key and the OAuth client together.
 
 </details>
 
-## Questions 💬
+## Questions
 
 Run into a problem or have a question? [Open an issue](https://github.com/thenavidm/youtube-mcp-cli/issues) and I will help.
 
-## About the author 👋
+## About the author
 
-Navid Moazzez is a leading AI business strategist, and the host of the AI Creator Summit, watched by 100,000+ creators. He helps creators and founders master AI and build their own AI Operating System (AI OS) to automate their business and life. This YouTube MCP server is one piece of that system.
+Navid Moazzez is a leading AI business strategist, and the host of the AI Creator Summit, watched by 100,000+ creators. He helps creators and founders master AI and build their own AI Operating System (AI OS) to automate their business and life. He creates useful free tools, MCP servers and CLIs that creators and founders can use in their own workflows.
 
 **Links**
 
-- Personal website: [navid.me](https://navid.me?utm_source=github&utm_medium=readme&utm_campaign=youtube-mcp-cli)
-- Link in bio: [navid.bio](https://navid.bio?utm_source=github&utm_medium=readme&utm_campaign=youtube-mcp-cli)
-- Navid Media: [navid.media](https://navid.media?utm_source=github&utm_medium=readme&utm_campaign=youtube-mcp-cli)
+- Personal website: [navid.me](https://navid.me?utm_source=github&utm_medium=referral&utm_campaign=youtube-mcp-cli&utm_content=readme)
+- Link in bio: [navid.bio](https://navid.bio?utm_source=github&utm_medium=referral&utm_campaign=youtube-mcp-cli&utm_content=readme)
+- Navid Media: [navid.media](https://navid.media?utm_source=github&utm_medium=referral&utm_campaign=youtube-mcp-cli&utm_content=readme)
 - YouTube: [@thenavidm](https://youtube.com/@thenavidm?sub_confirmation=1) and [@thenavidai](https://youtube.com/@thenavidai?sub_confirmation=1)
 - X: [@thenavidm](https://x.com/thenavidm)
 - Instagram: [@thenavidm](https://instagram.com/thenavidm)
@@ -853,19 +923,19 @@ Navid Moazzez is a leading AI business strategist, and the host of the AI Creato
 
 If this is useful, star the repo and come say hi on [X](https://x.com/thenavidm).
 
-## Dependencies 📦
+## Dependencies
 
 | Library | License | What it does |
 |---|---|---|
-| [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) | MIT | The MCP server and transports |
+| [Slipway](https://github.com/thenavidm/slipway) | Apache-2.0 | The MCP server and the CLI from one definition of each tool, with the write guard |
+| [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) | Apache-2.0 | The MCP protocol and transports, through Slipway |
 | [zod](https://github.com/colinhacks/zod) | MIT | Tool argument schemas and validation |
-| [zod-to-json-schema](https://github.com/StefanTerdell/zod-to-json-schema) | ISC | Turns those schemas into what an MCP client receives |
 
 [yt-dlp](https://github.com/yt-dlp/yt-dlp) is an optional external command, used
 only to fetch caption tracks. It is not bundled and is never loaded into this
 process.
 
-## License ⚖️
+## License
 
 [MIT](./LICENSE). Free to use, modify, and share.
 
@@ -874,4 +944,4 @@ trademark of Google LLC.
 
 ---
 
-© 2026 [NM Media](https://navid.media?utm_source=github&utm_medium=readme&utm_campaign=youtube-mcp-cli). Made with ❤️ by [Navid Moazzez](https://navid.me?utm_source=github&utm_medium=readme&utm_campaign=youtube-mcp-cli).
+© 2026 [Navid Media](https://navid.media?utm_source=github&utm_medium=referral&utm_campaign=youtube-mcp-cli&utm_content=readme). Made with ❤️ by [Navid Moazzez](https://navid.me?utm_source=github&utm_medium=referral&utm_campaign=youtube-mcp-cli&utm_content=readme).

package/SKILL.md

@@ -52,7 +52,7 @@ The CLI describes itself, so nothing here needs to list 16 tools and go stale:
 ```bash
 youtube-cli                    # every command, one line each, writes marked
 youtube-cli <command> --help   # arguments, types, which are required
-youtube-cli schema <command>   # the exact JSON Schema an MCP client receives
+youtube-cli which <words>      # the command for a task, without the full list
 ```
 
 The command is the tool name with dashes: `list_comments` runs as
@@ -111,7 +111,8 @@ user.
 | Code | Meaning |
 |---|---|
 | 0 | Success |
-| 2 | Usage error, or a write refused for want of `--confirm` |
+| 1 | Unexpected error |
+| 2 | Usage error: wrong or missing arguments, an unknown command, a write hidden by `YOUTUBE_READ_ONLY=1`, or a write refused for want of `--confirm` |
 | 3 | Not found |
 | 4 | Authentication failed, reconnect the channel |
 | 5 | API error upstream |
@@ -132,7 +133,9 @@ specific thing.
 **`--confirm` is enforced, not advisory.** `reply-to-comment` is public the
 moment it lands and notifies the person. `delete-video` is final: no trash, and
 the views, comments and URL go with it. Both refuse without `--confirm`. Pass it
-when the user has actually asked, never to get past the refusal.
+when the user has actually asked, never to get past the refusal. Over MCP the
+person approves each in the client's own prompt or form; `confirm: true` counts
+only where the client cannot ask.
 
 `update-video` is not guarded, because a title is a keystroke to put back. Only
 the fields you pass change.

package/dist/app.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The YouTube app: everything Slipway needs to ship the MCP server and the CLI.
+ *
+ * This file only describes. It never starts anything, so `slipway check` and
+ * tests can import it; `index.ts` is what runs.
+ */
+import { type ToolContext } from "./tools/kit.js";
+export declare const VERSION: string;
+export declare const app: import("@thenavidm/slipway").App<ToolContext>;

package/dist/app.js

@@ -0,0 +1,70 @@
+/**
+ * The YouTube app: everything Slipway needs to ship the MCP server and the CLI.
+ *
+ * This file only describes. It never starts anything, so `slipway check` and
+ * tests can import it; `index.ts` is what runs.
+ */
+import { createRequire } from "node:module";
+import { slipway } from "@thenavidm/slipway";
+import { loadConfig } from "./config.js";
+import { doctor } from "./doctor.js";
+import { INSTRUCTIONS } from "./guide.js";
+import { ALL_TOOLS } from "./tools/index.js";
+import { makeContext } from "./tools/kit.js";
+const require = createRequire(import.meta.url);
+export const VERSION = require("../package.json").version;
+const signIn = async (_io, args) => {
+    const { login } = await import("./auth.js");
+    return login([...args]);
+};
+export const app = slipway({
+    name: "youtube",
+    title: "YouTube",
+    version: VERSION,
+    package: "@thenavidm/youtube-mcp-cli",
+    description: "YouTube transcripts for any public video, channel research, and your own channels' videos, comments and analytics",
+    instructions: INSTRUCTIONS,
+    // Transcripts need no credentials, so nothing here is required before the first call.
+    context: () => makeContext(loadConfig()),
+    secrets: ({ config }) => [config.apiKey, ...config.accounts.flatMap((account) => [account.refreshToken, account.accessToken])],
+    tools: ALL_TOOLS,
+    doctor,
+    // yt-dlp, the API key and every channel's token each fail differently, and only a request tells, so doctor makes one per source every time, as 2.0 did.
+    doctorNetwork: true,
+    login: {
+        usage: "login [--api-key KEY]",
+        help: "connect a channel, once per channel; --api-key saves a research key",
+        run: signIn,
+    },
+    commands: [
+        { name: "auth", usage: "auth [--api-key KEY]", help: "the same as login, by the name 1.x used", hidden: true, run: signIn },
+        {
+            name: "logout",
+            usage: "logout <channel> | logout --api-key",
+            help: "forget a saved channel, or the saved API key",
+            run: async (_io, args) => {
+                const { logout } = await import("./auth.js");
+                return logout([...args]);
+            },
+        },
+    ],
+    settings: [
+        { env: "YOUTUBE_API_KEY", description: "Public search and channel lookup, or `login --api-key`.", secret: true },
+        { env: "YOUTUBE_ACCOUNTS", description: "Several channels at once, as a JSON array.", secret: true },
+        { env: "YOUTUBE_REFRESH_TOKEN", description: "One channel.", secret: true },
+        { env: "YOUTUBE_ACCESS_TOKEN", description: "One channel, short-lived, for testing.", secret: true, tuning: true },
+        { env: "YOUTUBE_CHANNEL_NAME", description: "What to call that one channel. Defaults to default.", tuning: true },
+        { env: "YOUTUBE_CLIENT_ID", description: "Your OAuth client, which `login` needs." },
+        { env: "YOUTUBE_CLIENT_SECRET", description: "Its secret.", secret: true },
+        { env: "YOUTUBE_MCP_HOME", description: "Where `login` saves channels. Defaults to ~/.youtube-mcp-cli.", tuning: true },
+        { env: "YOUTUBE_TRANSCRIPT_LANG", description: "Default transcript language. Defaults to en.", tuning: true },
+        { env: "YOUTUBE_YTDLP_PATH", description: "Path to yt-dlp, if it is not on PATH.", tuning: true },
+        { env: "YOUTUBE_YTDLP_COOKIES", description: "A cookies.txt from a browser signed in to YouTube, for the bot check.", secret: true },
+        { env: "YOUTUBE_OAUTH_CLIENT_ID", description: "Another name for YOUTUBE_CLIENT_ID.", tuning: true },
+        { env: "YOUTUBE_OAUTH_CLIENT_SECRET", description: "Another name for YOUTUBE_CLIENT_SECRET.", secret: true, tuning: true },
+        { env: "YOUTUBE_OAUTH_PORT", description: "The localhost port `login` listens on. Defaults to 8765.", tuning: true },
+        { env: "YOUTUBE_REQUEST_TIMEOUT_MS", description: "Per-request deadline. Defaults to 30000.", tuning: true },
+    ],
+    links: { repository: "https://github.com/thenavidm/youtube-mcp-cli" },
+});
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

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

package/dist/config.js

@@ -12,6 +12,7 @@
  * by `youtube-cli login --api-key`. Transcripts need none of these.
  */
 import { loadStore } from "./accounts/store.js";
+import { NotConfiguredError, UsageError } from "@thenavidm/slipway";
 function bool(value, fallback) {
     if (value === undefined || value.trim() === "")
         return fallback;
@@ -56,11 +57,11 @@ function envAccounts() {
             parsed = JSON.parse(raw);
         }
         catch {
-            throw new Error("YOUTUBE_ACCOUNTS is not valid JSON. It should be an array like " +
+            throw new NotConfiguredError("YOUTUBE_ACCOUNTS is not valid JSON. It should be an array like " +
                 '[{"name":"Main","refresh_token":"1//..."}].');
         }
         if (!Array.isArray(parsed))
-            throw new Error("YOUTUBE_ACCOUNTS must be a JSON array.");
+            throw new NotConfiguredError("YOUTUBE_ACCOUNTS must be a JSON array.");
         return parsed.map((entry, i) => {
             const a = entry;
             const name = a.name ?? a.account_name ?? a.channel ?? `account-${i + 1}`;
@@ -118,12 +119,12 @@ export function resolveAccount(config, requested) {
         const match = accounts.find((a) => a.id === want || a.name.toLowerCase() === want) ??
             accounts.find((a) => a.name.toLowerCase().includes(want) || a.id.includes(want));
         if (!match) {
-            throw new Error(`No connected channel matches "${requested}". Connected: ${accounts.map((a) => a.name).join(", ")}. Call list_accounts to see them.`);
+            throw new UsageError(`No connected channel matches "${requested}". Connected: ${accounts.map((a) => a.name).join(", ")}. Call list_accounts to see them.`);
         }
         return match;
     }
     if (accounts.length > 1) {
-        throw new Error(`${accounts.length} channels are connected (${accounts.map((a) => a.name).join(", ")}). Pass account=<name or @handle> so this runs against the right one.`);
+        throw new UsageError(`${accounts.length} channels are connected (${accounts.map((a) => a.name).join(", ")}). Pass account=<name or @handle> so this runs against the right one.`);
     }
     return accounts[0];
 }

package/dist/config.js.map

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

package/dist/doctor.d.ts

@@ -1,7 +1,15 @@
 /**
- * `youtube-cli doctor`: say what is set up and what is not, in the order that
- * matters. Most setup problems here are a missing API in the Cloud project or
- * an OAuth client that does not match the token, and neither is obvious from
- * the error the API returns at call time.
+ * `youtube-cli doctor`: check each of the three things this server can reach,
+ * the way it would reach them.
+ *
+ * Transcripts need yt-dlp and nothing else, research needs an API key, and a
+ * connected channel needs a refresh token that still works. Each fails for a
+ * different reason with a different fix, so each is checked on its own, with a
+ * real request, as 2.0 did. Slipway runs this on every `doctor`, after its own
+ * checks.
  */
-export declare function doctor(): Promise<number>;
+import type { DoctorCheck } from "@thenavidm/slipway";
+import type { ToolContext } from "./tools/kit.js";
+export declare function doctor({ config }: ToolContext, options: {
+    network: boolean;
+}): Promise<DoctorCheck[]>;