youtube-knowledge-mcp 2.2.0 → 3.0.1

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/youtube-knowledge-mcp.svg)](https://www.npmjs.com/package/youtube-knowledge-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node.js](https://img.shields.io/badge/Node.js-22%2B-green.svg)](https://nodejs.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-22.13%2B-green.svg)](https://nodejs.org/)
 [![GitHub stars](https://img.shields.io/github/stars/teobouancheau/youtube-knowledge-mcp?style=social)](https://github.com/teobouancheau/youtube-knowledge-mcp)
 
 A Model Context Protocol (MCP) server that gives AI assistants the ability to search, analyze, and extract knowledge from YouTube videos. Works with Claude Desktop, Claude Code, Claude.ai, Cursor and any MCP-compatible client.
@@ -40,6 +40,19 @@ Supports both **local** (stdio) and **remote** (Streamable HTTP) transports.
 - **Read them back**, and **search across all of them** with full-text ranking
 - **Tag, retag and delete**
 
+**Extract exhaustively, and prove it** (local mode)
+
+- **Catalogue a whole channel** across every tab — videos, shorts, streams,
+  releases, podcasts — into a local SQLite store, resumably
+- **Harvest comments with their replies**, every field YouTube returns, and
+  search them locally with full-text ranking and real pagination
+- **A completeness receipt on every extraction**: `complete` is true only when
+  the server can _prove_ it holds everything in scope, so a partial harvest can
+  never be mistaken for a full history
+- **Ask what you actually have** with `get_coverage`, which never touches the
+  network — cheap enough to call before every claim
+- **Remove what you hold**, including one author's comments everywhere
+
 **Build a brain for a channel** (local mode)
 
 - **Read a whole channel** into a searchable corpus of timestamped passages, in
@@ -60,7 +73,8 @@ Supports both **local** (stdio) and **remote** (Streamable HTTP) transports.
 - WebVTT parsed by the W3C reference implementation, not a hand-written matcher
 - Typed, actionable errors — "no captions in en, try: fr, es, de" rather than a
   wall of yt-dlp stderr
-- Timeouts, retry with backoff, and a concurrency limit on every yt-dlp call
+- Timeouts, adaptive backoff and a concurrency limit on every yt-dlp call, with
+  cooldowns and a circuit breaker so a long harvest survives being throttled
 - `check_health` diagnoses missing or outdated yt-dlp and ffmpeg
 - Bearer auth, a loopback default bind, an allowlist on every URL and image host, and typed error codes on every failure
 - Structured output on every tool, plus MCP resources, prompts and completions
@@ -68,7 +82,7 @@ Supports both **local** (stdio) and **remote** (Streamable HTTP) transports.
 
 ## Prerequisites
 
-- Node.js 22+
+- Node.js 22.13+ — the version where `node:sqlite`, which the harvest store uses, is available without a flag
 - [yt-dlp](https://github.com/yt-dlp/yt-dlp#installation) — required by every tool.
   `brew install yt-dlp` (macOS) or `pip install -U yt-dlp`
 - [ffmpeg](https://ffmpeg.org/) — required for downloads, clip extraction and frame
@@ -221,9 +235,9 @@ a cold start. Any paid plan removes that.
 
 ## MCP Tools
 
-37 tools. The 15 read-only ones work over both transports; the 22 that touch
-your filesystem are registered only in local (stdio) mode, so a remote
-deployment cannot reach the host's disk.
+58 tools. The 19 read-only ones work over both transports; the 39 that touch
+your filesystem or run ffmpeg are registered only in local (stdio) mode, so a
+remote deployment cannot reach the host's disk or spawn processes on it.
 
 Every tool returns human-readable text **and** typed structured output, and
 reports failures as an actionable message — `[NO_CAPTIONS] No "en" captions are
@@ -231,19 +245,23 @@ available for this video. Call get_transcript again with one of: fr, es, de.`
 
 ### Discovery — remote + local
 
-| Tool                | Key parameters                         | Returns                                                                                   |
-| ------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------- |
-| `search_videos`     | `query`, `limit`                       | Matching videos with durations, channels and view counts                                  |
-| `search_channels`   | `query`, `limit`                       | Matching channels with subscriber counts                                                  |
-| `fetch_videos`      | `url`, `limit`                         | Videos in a playlist or channel, with thumbnail URLs                                      |
-| `get_video_info`    | `video`                                | Title, channel, duration, views, likes, description, tags                                 |
-| `get_channel_info`  | `channel`                              | Name, handle, subscriber count, description, avatar and banner                            |
-| `get_playlist_info` | `url`                                  | Title, channel, video count, last updated                                                 |
-| `get_chapters`      | `video`                                | Chapter titles with start/end times and deep links                                        |
-| `get_comments`      | `video`, `limit`                       | Top-level comments by popularity                                                          |
-| `list_formats`      | `video`                                | Available formats grouped by video+audio, video-only, audio-only                          |
-| `get_thumbnail`     | `video`, `channel`, `image`, `quality` | A video thumbnail, channel avatar or banner as an image, with its real size               |
-| `check_health`      | —                                      | yt-dlp and ffmpeg status, versions, staleness warnings, and which session options are set |
+| Tool                     | Key parameters                             | Returns                                                                                                                |
+| ------------------------ | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
+| `search_videos`          | `query`, `limit`                           | Matching videos with durations, channels and view counts                                                               |
+| `search_channels`        | `query`, `limit`                           | Matching channels with subscriber counts                                                                               |
+| `fetch_videos`           | `url`, `limit`, `cursor`                   | One page of a playlist or channel, with a cursor. `total` is present only when YouTube states one                      |
+| `get_video_info`         | `video`                                    | Title, channel, duration, views, likes, description, tags                                                              |
+| `get_channel_info`       | `channel`                                  | Name, handle, subscriber count, description, avatar, banner, verified badge and keywords                               |
+| `get_playlist_info`      | `url`                                      | Title, channel, video count, last updated                                                                              |
+| `get_video_details`      | `video`, `heatmap`, `refresh`              | Most-replayed moments with links, category, licence, language, age limit, music credits, frame size, caption inventory |
+| `list_captions`          | `video`                                    | Caption languages split into human-made and automatic, and the spoken language                                         |
+| `list_channel_playlists` | `channel`, `limit`                         | A channel's public playlists with titles and links                                                                     |
+| `get_sponsor_segments`   | `video`, `categories`                      | Community-marked sponsor, intro, outro and filler segments with links (SponsorBlock)                                   |
+| `get_chapters`           | `video`                                    | Chapter titles with start/end times and deep links                                                                     |
+| `get_comments`           | `video`, `limit`, `includeReplies`, `sort` | Comments with replies and a completeness receipt saying how many of the video's comments this is                       |
+| `list_formats`           | `video`                                    | Available formats grouped by video+audio, video-only, audio-only                                                       |
+| `get_thumbnail`          | `video`, `channel`, `image`, `quality`     | A video thumbnail, channel avatar or banner as an image, with its real size                                            |
+| `check_health`           | —                                          | yt-dlp and ffmpeg status, versions, staleness warnings, and which session options are set                              |
 
 ### Transcripts — remote + local
 
@@ -260,20 +278,57 @@ pieces instead of returning 100,000+ tokens at once.
 
 ### Extraction for editing — local only
 
-| Tool                 | Key parameters                                                             | Returns                      |
-| -------------------- | -------------------------------------------------------------------------- | ---------------------------- |
-| `extract_clip`       | `video`, `start`+`end` or `chapter`, `quality`, `preciseCuts`, `outputDir` | Path to the cut video        |
-| `extract_audio_clip` | `video`, `start`+`end` or `chapter`, `audioFormat`, `outputDir`            | Path to the audio file       |
-| `extract_clips`      | `video`, `ranges` (up to 20), `quality`, `preciseCuts`, `outputDir`        | One file per range           |
-| `extract_frame`      | `video`, `timestamp`, `format`, `outputDir`                                | Path to a PNG or JPG still   |
-| `export_subtitles`   | `video`, `format` (srt/vtt/txt), `language`, `outputDir`                   | Path to the subtitle file    |
-| `download_video`     | `video`, `quality`, `formatId`, `outputDir`                                | Path to the downloaded video |
+| Tool                 | Key parameters                                                             | Returns                                    |
+| -------------------- | -------------------------------------------------------------------------- | ------------------------------------------ |
+| `extract_clip`       | `video`, `start`+`end` or `chapter`, `quality`, `preciseCuts`, `outputDir` | Path to the cut video                      |
+| `extract_audio_clip` | `video`, `start`+`end` or `chapter`, `audioFormat`, `outputDir`            | Path to the audio file                     |
+| `extract_clips`      | `video`, `ranges` (up to 20), `quality`, `preciseCuts`, `outputDir`        | One file per range                         |
+| `extract_frame`      | `video`, `timestamp`, `format`, `outputDir`                                | A PNG or JPG still, saved and shown inline |
+| `extract_gif`        | `video`, `start`+`end` or `chapter`, `width`, `fps`, `outputDir`           | Path to a looping GIF, up to 15 s          |
+| `concat_clips`       | `clips` (2 to 20 paths), `name`, `outputDir`                               | Path to one video joining them, re-encoded |
+| `export_subtitles`   | `video`, `format` (srt/vtt/txt), `language`, `outputDir`                   | Path to the subtitle file                  |
+| `download_video`     | `video`, `quality`, `formatId`, `outputDir`                                | Path to the downloaded video               |
 
 Clips are cut with `--download-sections`, so only the byte range covering the
 window is fetched rather than the whole file. `preciseCuts` (default `true`)
 cuts exactly at the requested times; set it to `false` for a faster
 keyframe-aligned cut. All of these require ffmpeg.
 
+### Looking at a video — local only
+
+Everything above works from words. These work from pixels: each tool returns
+images the model can read, and writes nothing to disk. All of them require ffmpeg.
+
+| Tool                    | Key parameters                                            | Returns                                                         |
+| ----------------------- | --------------------------------------------------------- | --------------------------------------------------------------- |
+| `extract_frames`        | `video`, `timestamps` or `count`, `start`, `end`, `width` | Up to 12 frames as images, each labelled with its moment        |
+| `extract_contact_sheet` | `video`, `count` (up to 24), `start`, `end`, `columns`    | One image tiling the frames, with the timestamp of every cell   |
+| `detect_scenes`         | `video`, `start`, `end`, `threshold`                      | Timestamps where the video cuts, with links (up to 15 min/call) |
+
+Start with `extract_contact_sheet` to see what a video looks like, then
+`extract_frames` at the moments that matter, found with `search_transcript` or
+`detect_scenes`. Frames are shrunk to `width` and never enlarged.
+
+### Videos with no captions — local only
+
+| Tool               | Key parameters                 | Returns                                                    |
+| ------------------ | ------------------------------ | ---------------------------------------------------------- |
+| `transcribe_video` | `video`, `language`, `refresh` | A transcription made on this machine, kept for later reads |
+
+When `get_transcript` reports `NO_CAPTIONS`, `transcribe_video` downloads the
+audio and runs [whisper.cpp](https://github.com/ggml-org/whisper.cpp) over it.
+It is optional and nothing runs unless you call it. Install whisper.cpp so that
+`whisper-cli` is on your `PATH` (macOS: `brew install whisper.cpp`), download a
+ggml model such as `ggml-base.bin`, and set `YOUTUBE_MCP_WHISPER_MODEL` to its
+path. `check_health` reports whether both are in place.
+
+Always pass `language`: auto-detection on a small model took English speech for
+French. The result is kept beside the video's captions, never over them, and
+`get_transcript`, `search_transcript`, `export_subtitles` and the channel brains
+read it with `source: "local-asr"` so a machine's guess is never mistaken for
+YouTube's captions. Accuracy depends on the model you choose; names and rare
+words are the first to suffer.
+
 ### Knowledge library — local only
 
 | Tool                    | Key parameters                                                  | Returns                             |
@@ -286,16 +341,49 @@ keyframe-aligned cut. All of these require ffmpeg.
 | `delete_library_item`   | `videoId`, `contentType`                                        | What was deleted                    |
 | `rebuild_library_index` | —                                                               | Number of notes reindexed           |
 
+### Exhaustive harvest — local only
+
+Extraction that stores what it reads, and proves what it holds. Every tool here
+returns a **completeness receipt**: `complete` is true only when the server can
+prove it has everything in scope, and a consumer must not describe the data as a
+full history while it is false.
+
+| Tool                | Key parameters                                                         | Returns                                                                     |
+| ------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| `harvest_channel`   | `channel`, `maxVideos`                                                 | Every video across all tabs, catalogued, with a receipt                     |
+| `harvest_details`   | `channel`, `maxVideos`, `retryUnreadable`                              | The full record of each catalogued video, kept in the store, with a receipt |
+| `check_new_uploads` | `channel`, `lookback`                                                  | Videos the channel lists that the catalogue lacks; writes nothing           |
+| `harvest_comments`  | `video`, `maxComments`, `sort`, `maxRepliesPerThread`                  | Comments and replies stored locally, with a receipt                         |
+| `get_coverage`      | `scope`, `incompleteOnly`, `verify`, `limit`, `offset`                 | What the server can prove it holds, and what it cannot                      |
+| `query_comments`    | `video`, `channel`, `match`, `author`, `threadOf`, `order`, `limit`    | Full-text search over stored comments, with real pagination                 |
+| `query_videos`      | `channel`, `match`, `since`, `until`, `withComments`, `order`, `limit` | The catalogued videos, filtered and sorted                                  |
+| `prune_harvest`     | `channel`, `video`, `author`, `scope`, `confirm`, `vacuum`             | What was removed from the store                                             |
+| `export_data`       | `dataset`, `format`, `channel`, `video`, `limit`, `outputDir`          | JSON, CSV or Markdown file of harvested rows, with their receipts           |
+| `repair_store`      | `confirm`                                                              | Moves a damaged store aside and starts a fresh one                          |
+
+`get_coverage` never contacts YouTube, so it is cheap enough to call before
+making any claim about the data. Check `anyIncomplete` first.
+
+There is no cursor for comments: YouTube exposes none for a live read, so
+`harvest_comments` cannot page. To get more, run it again with a larger
+`maxComments` — rows are upserted on the comment id, so a re-run costs requests
+and never data.
+
+`prune_harvest` exists because the store holds personal data at scale: display
+names, channel ids and free-text opinions from people who never used this tool.
+The `author` filter is the per-person erasure path.
+
 ### Channel brains — local only
 
-| Tool                 | Key parameters                                                    | Returns                                          |
-| -------------------- | ----------------------------------------------------------------- | ------------------------------------------------ |
-| `build_brain`        | `channel`, `maxVideos`, `language`, `since`, `minDurationSeconds` | What was read, what was ruled out, and the stats |
-| `ask_brain`          | `channel`, `query`, `limit`, `offset`                             | Passages with timestamps and `?t=` links         |
-| `list_brains`        | —                                                                 | Every brain built locally                        |
-| `get_brain_info`     | `channel`, `includeVideos`                                        | Coverage, statistics and repeated phrases        |
-| `save_brain_profile` | `channel`, `content`                                              | Path to the saved profile                        |
-| `delete_brain`       | `channel`                                                         | What was removed                                 |
+| Tool                 | Key parameters                                                    | Returns                                                          |
+| -------------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------- |
+| `build_brain`        | `channel`, `maxVideos`, `language`, `since`, `minDurationSeconds` | What was read, what was ruled out, and the stats                 |
+| `ask_brain`          | `channel`, `query`, `limit`, `offset`                             | Passages with timestamps and `?t=` links                         |
+| `ask_brains`         | `query`, `channels`, `limit`                                      | The best passages across several brains, each naming its channel |
+| `list_brains`        | —                                                                 | Every brain built locally                                        |
+| `get_brain_info`     | `channel`, `includeVideos`                                        | Coverage, statistics and repeated phrases                        |
+| `save_brain_profile` | `channel`, `content`                                              | Path to the saved profile                                        |
+| `delete_brain`       | `channel`                                                         | What was removed                                                 |
 
 `build_brain` is the only one that touches the network. The rest resolve a
 channel from what is already on disk, so they work offline and cost nothing to
@@ -392,6 +480,8 @@ All optional.
 | `MCP_MAX_SESSIONS`                 | `1000`      | Reject new sessions past this many                                                                                                                           |
 | `YOUTUBE_MCP_MAX_CONCURRENCY`      | `3`         | Concurrent yt-dlp processes                                                                                                                                  |
 | `YOUTUBE_MCP_TRANSCRIPT_TTL_MS`    | 30 days     | Transcript cache lifetime                                                                                                                                    |
+| `YOUTUBE_MCP_STATS_TTL_MS`         | 1 day       | Per-video stats cache lifetime                                                                                                                               |
+| `YOUTUBE_MCP_WHISPER_MODEL`        | none        | Path to a whisper.cpp ggml model file. Enables `transcribe_video`; never downloaded for you                                                                  |
 | `YOUTUBE_MCP_COOKIES_FROM_BROWSER` | unset       | Browser whose cookies yt-dlp should read: `brave`, `chrome`, `chromium`, `edge`, `firefox`, `opera`, `safari`, `vivaldi` or `whale`. See Signed-in content   |
 | `YOUTUBE_MCP_COOKIES_FILE`         | unset       | A Netscape-format cookies file inside your home directory, as an alternative to a browser                                                                    |
 | `YOUTUBE_MCP_PROXY`                | unset       | An `http`, `https`, `socks4` or `socks5` proxy URL for yt-dlp                                                                                                |
@@ -549,7 +639,7 @@ npm run start:http # Run server (HTTP)
 npm run validate   # Typecheck + lint + format check + test
 ```
 
-CI runs the same gate on Node 22 and 24 for every push and pull request,
+CI runs the same gate on Node 22.22, 22 and 24 for every push and pull request,
 then boots the built server as a real MCP client to verify the manifest.
 
 ## Contributing

package/dist/brain-schemas.d.ts

@@ -228,6 +228,8 @@ export declare const brainManifestSchema: z.ZodObject<{
         description: z.ZodString;
         avatarUrl: z.ZodOptional<z.ZodString>;
         bannerUrl: z.ZodOptional<z.ZodString>;
+        isVerified: z.ZodOptional<z.ZodBoolean>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         description: string;
         name: string;
@@ -235,8 +237,10 @@ export declare const brainManifestSchema: z.ZodObject<{
         handle: string;
         subscriberCount: number;
         channelUrl: string;
+        tags?: string[] | undefined;
         avatarUrl?: string | undefined;
         bannerUrl?: string | undefined;
+        isVerified?: boolean | undefined;
     }, {
         description: string;
         name: string;
@@ -244,8 +248,10 @@ export declare const brainManifestSchema: z.ZodObject<{
         handle: string;
         subscriberCount: number;
         channelUrl: string;
+        tags?: string[] | undefined;
         avatarUrl?: string | undefined;
         bannerUrl?: string | undefined;
+        isVerified?: boolean | undefined;
     }>;
     /**
      * A brain is built from one caption language. Defaulted rather than required
@@ -351,8 +357,10 @@ export declare const brainManifestSchema: z.ZodObject<{
         handle: string;
         subscriberCount: number;
         channelUrl: string;
+        tags?: string[] | undefined;
         avatarUrl?: string | undefined;
         bannerUrl?: string | undefined;
+        isVerified?: boolean | undefined;
     };
     version: number;
     videos: Record<string, {
@@ -399,8 +407,10 @@ export declare const brainManifestSchema: z.ZodObject<{
         handle: string;
         subscriberCount: number;
         channelUrl: string;
+        tags?: string[] | undefined;
         avatarUrl?: string | undefined;
         bannerUrl?: string | undefined;
+        isVerified?: boolean | undefined;
     };
     version: number;
     videos: Record<string, unknown>;

package/dist/brain-schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brain-schemas.d.ts","sourceRoot":"","sources":["../src/brain-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;GAMG;AAEH,qDAAqD;AACrD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAchC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,uDAAuD;AACvD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAO3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG/B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;EAGpC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,4BAA4B;AAC5B,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAG9B;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMH,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,8BAA8B;AAC9B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY7B,CAAC"}
+{"version":3,"file":"brain-schemas.d.ts","sourceRoot":"","sources":["../src/brain-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;GAMG;AAEH,qDAAqD;AACrD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAchC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,uDAAuD;AACvD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAO3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG/B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;EAGpC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,4BAA4B;AAC5B,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAG9B;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMH,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,8BAA8B;AAC9B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY7B,CAAC"}

package/dist/harvest-schemas.d.ts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+/**
+ * The shapes a completeness receipt is made of.
+ *
+ * This server exists to extract everything YouTube will serve, and the failure
+ * mode that matters is not "we got 3%" — it is "we got 3% and reported 100%".
+ * A receipt travels with every extraction result so a consumer can never
+ * describe a sample as a full history by accident.
+ *
+ * The invariants that make `complete` mean something live in
+ * `utils/coverage.ts`, which is the only place allowed to build one.
+ */
+export declare const harvestScopeSchema: z.ZodEnum<["channel-catalog", "video-details", "video-comments"]>;
+export type HarvestScope = z.infer<typeof harvestScopeSchema>;
+export declare const completenessReasonSchema: z.ZodEnum<["COMPLETE", "CAP_REACHED", "BUDGET_SPENT", "RATE_LIMITED", "CANCELLED", "TIMEOUT", "SOURCE_REFUSED", "COMMENTS_DISABLED", "SOURCE_SILENT", "PARTIAL_ERROR", "NOT_ATTEMPTED"]>;
+export type CompletenessReason = z.infer<typeof completenessReasonSchema>;
+/**
+ * Where a total came from.
+ *
+ * `source-exhausted` is the one value that is not a number YouTube reported:
+ * it means the listing ended on its own, which is its own kind of proof.
+ */
+export declare const expectedSourceSchema: z.ZodEnum<["youtube:comment_count", "youtube:playlist_count", "source-exhausted", "store:catalog"]>;
+export type ExpectedSource = z.infer<typeof expectedSourceSchema>;
+export declare const coverageSchema: z.ZodObject<{
+    scope: z.ZodEnum<["channel-catalog", "video-details", "video-comments"]>;
+    targetId: z.ZodString;
+    complete: z.ZodBoolean;
+    reason: z.ZodEnum<["COMPLETE", "CAP_REACHED", "BUDGET_SPENT", "RATE_LIMITED", "CANCELLED", "TIMEOUT", "SOURCE_REFUSED", "COMMENTS_DISABLED", "SOURCE_SILENT", "PARTIAL_ERROR", "NOT_ATTEMPTED"]>;
+    have: z.ZodNumber;
+    expected: z.ZodOptional<z.ZodNumber>;
+    expectedSource: z.ZodOptional<z.ZodEnum<["youtube:comment_count", "youtube:playlist_count", "source-exhausted", "store:catalog"]>>;
+    ranToExhaustion: z.ZodOptional<z.ZodBoolean>;
+    source: z.ZodString;
+    harvestedAt: z.ZodString;
+    staleAfter: z.ZodOptional<z.ZodString>;
+    limitApplied: z.ZodOptional<z.ZodNumber>;
+    sortApplied: z.ZodOptional<z.ZodEnum<["top", "new"]>>;
+    resumeToken: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    have: number;
+    scope: "channel-catalog" | "video-details" | "video-comments";
+    targetId: string;
+    complete: boolean;
+    reason: "RATE_LIMITED" | "TIMEOUT" | "CANCELLED" | "COMPLETE" | "CAP_REACHED" | "BUDGET_SPENT" | "SOURCE_REFUSED" | "COMMENTS_DISABLED" | "SOURCE_SILENT" | "PARTIAL_ERROR" | "NOT_ATTEMPTED";
+    harvestedAt: string;
+    expected?: number | undefined;
+    note?: string | undefined;
+    ranToExhaustion?: boolean | undefined;
+    expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | "store:catalog" | undefined;
+    staleAfter?: string | undefined;
+    limitApplied?: number | undefined;
+    sortApplied?: "top" | "new" | undefined;
+    resumeToken?: string | undefined;
+}, {
+    source: string;
+    have: number;
+    scope: "channel-catalog" | "video-details" | "video-comments";
+    targetId: string;
+    complete: boolean;
+    reason: "RATE_LIMITED" | "TIMEOUT" | "CANCELLED" | "COMPLETE" | "CAP_REACHED" | "BUDGET_SPENT" | "SOURCE_REFUSED" | "COMMENTS_DISABLED" | "SOURCE_SILENT" | "PARTIAL_ERROR" | "NOT_ATTEMPTED";
+    harvestedAt: string;
+    expected?: number | undefined;
+    note?: string | undefined;
+    ranToExhaustion?: boolean | undefined;
+    expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | "store:catalog" | undefined;
+    staleAfter?: string | undefined;
+    limitApplied?: number | undefined;
+    sortApplied?: "top" | "new" | undefined;
+    resumeToken?: string | undefined;
+}>;
+export type Coverage = z.infer<typeof coverageSchema>;
+//# sourceMappingURL=harvest-schemas.d.ts.map

package/dist/harvest-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harvest-schemas.d.ts","sourceRoot":"","sources":["../src/harvest-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,kBAAkB,mEAO7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,wBAAwB,0LAqBnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,qGAS/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4EzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/harvest-schemas.js

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+/**
+ * The shapes a completeness receipt is made of.
+ *
+ * This server exists to extract everything YouTube will serve, and the failure
+ * mode that matters is not "we got 3%" — it is "we got 3% and reported 100%".
+ * A receipt travels with every extraction result so a consumer can never
+ * describe a sample as a full history by accident.
+ *
+ * The invariants that make `complete` mean something live in
+ * `utils/coverage.ts`, which is the only place allowed to build one.
+ */
+export const harvestScopeSchema = z.enum([
+    /** Which videos a channel has. */
+    'channel-catalog',
+    /** Full per-video metadata snapshots. */
+    'video-details',
+    /** Comments and replies for one video. */
+    'video-comments',
+]);
+export const completenessReasonSchema = z.enum([
+    /** Provably everything: the source stated a total and we hold it, or the source ran out. */
+    'COMPLETE',
+    /** The caller's own limit stopped it. */
+    'CAP_REACHED',
+    /** The wall-clock budget for this call ran out. */
+    'BUDGET_SPENT',
+    /** YouTube throttled this client. */
+    'RATE_LIMITED',
+    /** The MCP client aborted the request. */
+    'CANCELLED',
+    'TIMEOUT',
+    /** BOT_CHECK, LOGIN_REQUIRED, PRIVATE, AGE_GATED or MEMBERS_ONLY. */
+    'SOURCE_REFUSED',
+    /** Comments are turned off for this video, so zero is the true total. */
+    'COMMENTS_DISABLED',
+    /** The source states no total, so exhaustion is unprovable. */
+    'SOURCE_SILENT',
+    /** Some items failed; each cost only itself. */
+    'PARTIAL_ERROR',
+    'NOT_ATTEMPTED',
+]);
+/**
+ * Where a total came from.
+ *
+ * `source-exhausted` is the one value that is not a number YouTube reported:
+ * it means the listing ended on its own, which is its own kind of proof.
+ */
+export const expectedSourceSchema = z.enum([
+    'youtube:comment_count',
+    'youtube:playlist_count',
+    'source-exhausted',
+    /**
+     * The channel catalogue held in the store. Only ever the total of a catalogue whose own
+     * receipt is complete, so it is exactly as trustworthy as that receipt and no more.
+     */
+    'store:catalog',
+]);
+export const coverageSchema = z.object({
+    scope: harvestScopeSchema,
+    targetId: z.string().describe('Channel id for a catalog, video id for details or comments'),
+    complete: z
+        .boolean()
+        .describe('True ONLY when this server can prove it holds every item in scope. False means the ' +
+        'data is a SAMPLE. A consumer must not describe it as a full history while this is false.'),
+    reason: completenessReasonSchema.describe('Why complete is what it is. Always present, including when complete is true.'),
+    have: z
+        .number()
+        .int()
+        .nonnegative()
+        .describe('Items this store actually holds for this target, counted from the store.'),
+    expected: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe('The total the SOURCE states. Absent when the source states none — never inferred, ' +
+        'never copied from have. Absent with complete:false means "unknown how much is missing".'),
+    expectedSource: expectedSourceSchema
+        .optional()
+        .describe('Where expected came from. Absent if and only if expected is absent.'),
+    ranToExhaustion: z
+        .boolean()
+        .optional()
+        .describe("Whether the source's own iteration finished rather than being cut off. Necessary for " +
+        'completeness but not sufficient: a cap also ends iteration.'),
+    source: z.string().describe('The exact extraction path, including tool version and flags.'),
+    harvestedAt: z.string().describe('ISO-8601 of the last item written for this target'),
+    staleAfter: z
+        .string()
+        .optional()
+        .describe('ISO-8601 after which this should be re-checked. Comments accrue, so a complete ' +
+        'receipt goes stale without becoming wrong.'),
+    limitApplied: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('The cap the caller asked for. Present if and only if one was applied.'),
+    sortApplied: z
+        .enum(['top', 'new'])
+        .optional()
+        .describe('Ordering the source applied. A capped "top" harvest is a BIASED PREFIX of a stream, ' +
+        'not a random sample.'),
+    resumeToken: z
+        .string()
+        .optional()
+        .describe('Opaque. Pass to the same tool to continue. Absent if and only if complete.'),
+    note: z.string().optional(),
+});
+//# sourceMappingURL=harvest-schemas.js.map

package/dist/harvest-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harvest-schemas.js","sourceRoot":"","sources":["../src/harvest-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,kCAAkC;IAClC,iBAAiB;IACjB,yCAAyC;IACzC,eAAe;IACf,0CAA0C;IAC1C,gBAAgB;CACjB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC7C,4FAA4F;IAC5F,UAAU;IACV,yCAAyC;IACzC,aAAa;IACb,mDAAmD;IACnD,cAAc;IACd,qCAAqC;IACrC,cAAc;IACd,0CAA0C;IAC1C,WAAW;IACX,SAAS;IACT,qEAAqE;IACrE,gBAAgB;IAChB,yEAAyE;IACzE,mBAAmB;IACnB,+DAA+D;IAC/D,eAAe;IACf,gDAAgD;IAChD,eAAe;IACf,eAAe;CAChB,CAAC,CAAC;AAGH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC;IACzC,uBAAuB;IACvB,wBAAwB;IACxB,kBAAkB;IAClB;;;OAGG;IACH,eAAe;CAChB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,kBAAkB;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;IAE3F,QAAQ,EAAE,CAAC;SACR,OAAO,EAAE;SACT,QAAQ,CACP,qFAAqF;QACnF,0FAA0F,CAC7F;IAEH,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CACvC,8EAA8E,CAC/E;IAED,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,WAAW,EAAE;SACb,QAAQ,CAAC,0EAA0E,CAAC;IAEvF,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,WAAW,EAAE;SACb,QAAQ,EAAE;SACV,QAAQ,CACP,oFAAoF;QAClF,yFAAyF,CAC5F;IAEH,cAAc,EAAE,oBAAoB;SACjC,QAAQ,EAAE;SACV,QAAQ,CAAC,qEAAqE,CAAC;IAElF,eAAe,EAAE,CAAC;SACf,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,uFAAuF;QACrF,6DAA6D,CAChE;IAEH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IAE3F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IAErF,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iFAAiF;QAC/E,4CAA4C,CAC/C;IAEH,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,uEAAuE,CAAC;IAEpF,WAAW,EAAE,CAAC;SACX,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;SACpB,QAAQ,EAAE;SACV,QAAQ,CACP,sFAAsF;QACpF,sBAAsB,CACzB;IAEH,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4EAA4E,CAAC;IAEzF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC"}

package/dist/registry/brain-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brain-tools.d.ts","sourceRoot":"","sources":["../../src/registry/brain-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAwB7D,yMAAyM;AACzM,eAAO,MAAM,UAAU,EAAE,cAAc,EAsGtC,CAAC"}
+{"version":3,"file":"brain-tools.d.ts","sourceRoot":"","sources":["../../src/registry/brain-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAyB7D,yMAAyM;AACzM,eAAO,MAAM,UAAU,EAAE,cAAc,EAsHtC,CAAC"}

package/dist/registry/brain-tools.js

@@ -1,5 +1,6 @@
 import { defineTool } from './types.js';
 import { askBrainSchema, askBrainOutputSchema, askBrainHandler } from '../tools/ask-brain.js';
+import { askBrainsSchema, askBrainsOutputSchema, askBrainsHandler } from '../tools/ask-brains.js';
 import { listBrainsSchema, listBrainsOutputSchema, listBrainsHandler, getBrainInfoSchema, getBrainInfoOutputSchema, getBrainInfoHandler, } from '../tools/brain-info.js';
 import { buildBrainSchema, buildBrainOutputSchema, buildBrainHandler, } from '../tools/build-brain.js';
 import { saveBrainProfileSchema, saveBrainProfileOutputSchema, saveBrainProfileHandler, deleteBrainSchema, deleteBrainOutputSchema, deleteBrainHandler, } from '../tools/manage-brain.js';
@@ -39,6 +40,21 @@ export const brainTools = [
         },
         handler: askBrainHandler,
     }),
+    defineTool({
+        name: 'ask_brains',
+        mode: 'stdio',
+        title: 'Ask Several Channel Brains',
+        description: 'Put one question to several creators at once. Searches every brain built with build_brain, or the channels you name, and returns the best passages across them, each naming its channel with the timestamp and a link that opens the video there. Results are interleaved by rank because scores from different channels are not comparable.',
+        inputSchema: askBrainsSchema,
+        outputSchema: askBrainsOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        handler: askBrainsHandler,
+    }),
     defineTool({
         name: 'list_brains',
         mode: 'stdio',

package/dist/registry/brain-tools.js.map

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

package/dist/registry/channel-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-tools.d.ts","sourceRoot":"","sources":["../../src/registry/channel-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAiB7D,2CAA2C;AAC3C,eAAO,MAAM,YAAY,EAAE,cAAc,EAiDxC,CAAC"}
+{"version":3,"file":"channel-tools.d.ts","sourceRoot":"","sources":["../../src/registry/channel-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAsB7D,2CAA2C;AAC3C,eAAO,MAAM,YAAY,EAAE,cAAc,EAiExC,CAAC"}

package/dist/registry/channel-tools.js

@@ -2,6 +2,7 @@ import { defineTool } from './types.js';
 import { getChannelInfoSchema, getChannelInfoOutputSchema, getChannelInfoHandler, } from '../tools/get-channel-info.js';
 import { getPlaylistInfoSchema, getPlaylistInfoOutputSchema, getPlaylistInfoHandler, } from '../tools/get-playlist-info.js';
 import { searchChannelsSchema, searchChannelsOutputSchema, searchChannelsHandler, } from '../tools/search-channels.js';
+import { listChannelPlaylistsSchema, listChannelPlaylistsOutputSchema, listChannelPlaylistsHandler, } from '../tools/list-channel-playlists.js';
 /** Channels and playlists. Remote-safe. */
 export const channelTools = [
     defineTool({
@@ -49,5 +50,20 @@ export const channelTools = [
         },
         handler: getPlaylistInfoHandler,
     }),
+    defineTool({
+        name: 'list_channel_playlists',
+        mode: 'all',
+        title: 'List YouTube Channel Playlists',
+        description: 'List the public playlists a YouTube channel has published, with titles and links. Pass a playlist URL on to fetch_videos or digest_playlist to read what is in it.',
+        inputSchema: listChannelPlaylistsSchema,
+        outputSchema: listChannelPlaylistsOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: listChannelPlaylistsHandler,
+    }),
 ];
 //# sourceMappingURL=channel-tools.js.map

package/dist/registry/channel-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"channel-tools.js","sourceRoot":"","sources":["../../src/registry/channel-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,YAAY,CAAC;AAC7D,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAErC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,UAAU,CAAC;QACT,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,mHAAmH;QACrH,WAAW,EAAE,oBAAoB;QACjC,YAAY,EAAE,0BAA0B;QACxC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,qBAAqB;KAC/B,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,8HAA8H;QAChI,WAAW,EAAE,oBAAoB;QACjC,YAAY,EAAE,0BAA0B;QACxC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,qBAAqB;KAC/B,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,+GAA+G;QACjH,WAAW,EAAE,qBAAqB;QAClC,YAAY,EAAE,2BAA2B;QACzC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,sBAAsB;KAChC,CAAC;CACH,CAAC"}
+{"version":3,"file":"channel-tools.js","sourceRoot":"","sources":["../../src/registry/channel-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,YAAY,CAAC;AAC7D,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,0BAA0B,EAC1B,gCAAgC,EAChC,2BAA2B,GAC5B,MAAM,oCAAoC,CAAC;AAE5C,2CAA2C;AAC3C,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,UAAU,CAAC;QACT,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,mHAAmH;QACrH,WAAW,EAAE,oBAAoB;QACjC,YAAY,EAAE,0BAA0B;QACxC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,qBAAqB;KAC/B,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,8HAA8H;QAChI,WAAW,EAAE,oBAAoB;QACjC,YAAY,EAAE,0BAA0B;QACxC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,qBAAqB;KAC/B,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,+GAA+G;QACjH,WAAW,EAAE,qBAAqB;QAClC,YAAY,EAAE,2BAA2B;QACzC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,sBAAsB;KAChC,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,wBAAwB;QAC9B,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,gCAAgC;QACvC,WAAW,EACT,oKAAoK;QACtK,WAAW,EAAE,0BAA0B;QACvC,YAAY,EAAE,gCAAgC;QAC9C,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,2BAA2B;KACrC,CAAC;CACH,CAAC"}

package/dist/registry/harvest-tools.d.ts

@@ -0,0 +1,10 @@
+import { type ToolDefinition } from './types.js';
+/**
+ * Exhaustive extraction and the receipts that keep it honest.
+ *
+ * All stdio-only: they write to the local store, which a channel harvest
+ * measures in gigabytes, and no remote caller should be able to fill the
+ * operator's disk by naming a channel.
+ */
+export declare const harvestTools: ToolDefinition[];
+//# sourceMappingURL=harvest-tools.d.ts.map

package/dist/registry/harvest-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harvest-tools.d.ts","sourceRoot":"","sources":["../../src/registry/harvest-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAgC7D;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,cAAc,EAmGxC,CAAC"}