youtube-knowledge-mcp 2.0.2 → 2.1.0

package/dist/tools/library.d.ts

@@ -22,21 +22,21 @@ export declare const getLibraryItemOutputSchema: {
         hasSummary: z.ZodBoolean;
         hasSkill: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        url: string;
         title: string;
-        videoId: string;
+        url: string;
         channel: string;
         tags: string[];
+        videoId: string;
         dateSaved: string;
         hasTranscript: boolean;
         hasSummary: boolean;
         hasSkill: boolean;
     }, {
-        url: string;
         title: string;
-        videoId: string;
+        url: string;
         channel: string;
         tags: string[];
+        videoId: string;
         dateSaved: string;
         hasTranscript: boolean;
         hasSummary: boolean;
@@ -52,6 +52,7 @@ export declare function getLibraryItemHandler({ videoId, contentType, }: {
 export declare const searchLibrarySchema: {
     query: z.ZodString;
     limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
 };
 export declare const searchLibraryOutputSchema: {
     total: z.ZodNumber;
@@ -68,21 +69,22 @@ export declare const searchLibraryOutputSchema: {
         excerpt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         title: string;
-        videoId: string;
         kind: string;
+        videoId: string;
         score: number;
         excerpt: string;
     }, {
         title: string;
-        videoId: string;
         kind: string;
+        videoId: string;
         score: number;
         excerpt: string;
     }>, "many">;
 };
-export declare function searchLibraryHandler({ query, limit, }: {
+export declare function searchLibraryHandler({ query, limit, offset, }: {
     query: string;
     limit: number;
+    offset: number;
 }): Promise<CallToolResult>;
 export declare const deleteLibraryItemSchema: {
     videoId: z.ZodString;

package/dist/tools/library.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/tools/library.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;;;;GAKG;AAIH,eAAO,MAAM,oBAAoB;;;CAMhC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAItC,CAAC;AAEF,wBAAsB,qBAAqB,CAAC,EAC1C,OAAO,EACP,WAAW,GACZ,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CACnC,GAAG,OAAO,CAAC,cAAc,CAAC,CAoB1B;AAID,eAAO,MAAM,mBAAmB;;;CAM/B,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;CAIrC,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,EACzC,KAAK,EACL,KAAK,GACN,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,cAAc,CAAC,CA6B1B;AAID,eAAO,MAAM,uBAAuB;;;CAMnC,CAAC;AAEF,eAAO,MAAM,6BAA6B;;;CAGzC,CAAC;AAEF,wBAAsB,wBAAwB,CAAC,EAC7C,OAAO,EACP,WAAW,GACZ,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CACnC,GAAG,OAAO,CAAC,cAAc,CAAC,CAG1B;AAID,eAAO,MAAM,uBAAuB;;;;;CAQnC,CAAC;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;;;CAA8B,CAAC;AAEzE,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CAQ1B;AAID,eAAO,MAAM,yBAAyB,IAAK,CAAC;AAE5C,eAAO,MAAM,+BAA+B;;CAAkC,CAAC;AAE/E,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,cAAc,CAAC,CAG1E"}
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/tools/library.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;;;;GAKG;AAIH,eAAO,MAAM,oBAAoB;;;CAMhC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAItC,CAAC;AAEF,wBAAsB,qBAAqB,CAAC,EAC1C,OAAO,EACP,WAAW,GACZ,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CACnC,GAAG,OAAO,CAAC,cAAc,CAAC,CAoB1B;AAID,eAAO,MAAM,mBAAmB;;;;CAY/B,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;CAIrC,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,EACzC,KAAK,EACL,KAAK,EACL,MAAM,GACP,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,cAAc,CAAC,CA6B1B;AAID,eAAO,MAAM,uBAAuB;;;CAMnC,CAAC;AAEF,eAAO,MAAM,6BAA6B;;;CAGzC,CAAC;AAEF,wBAAsB,wBAAwB,CAAC,EAC7C,OAAO,EACP,WAAW,GACZ,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CACnC,GAAG,OAAO,CAAC,cAAc,CAAC,CAG1B;AAID,eAAO,MAAM,uBAAuB;;;;;CAQnC,CAAC;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;;;CAA8B,CAAC;AAEzE,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CAQ1B;AAID,eAAO,MAAM,yBAAyB,IAAK,CAAC;AAE5C,eAAO,MAAM,+BAA+B;;CAAkC,CAAC;AAE/E,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,cAAc,CAAC,CAG1E"}

package/dist/tools/library.js

@@ -48,18 +48,24 @@ export const searchLibrarySchema = {
         .min(1)
         .describe('Words or phrase to search for across saved summaries and skills'),
     limit: z.number().int().min(1).max(50).default(10).describe('Maximum results. Default: 10'),
+    offset: z
+        .number()
+        .int()
+        .min(0)
+        .default(0)
+        .describe('Skip this many of the ranked results, for paging. Default: 0'),
 };
 export const searchLibraryOutputSchema = {
     query: z.string(),
     hits: z.array(librarySearchHitSchema),
     ...paginationShape,
 };
-export async function searchLibraryHandler({ query, limit, }) {
-    const hits = await searchLibrary(query, limit);
+export async function searchLibraryHandler({ query, limit, offset, }) {
+    const { hits, total } = await searchLibrary(query, limit, offset);
     const structured = {
         query,
         hits: hits.map(({ id: _id, ...hit }) => hit),
-        ...pageInfo(hits.length, hits.length),
+        ...pageInfo(total, hits.length, offset),
     };
     if (hits.length === 0) {
         return toolResult([
@@ -68,7 +74,7 @@ export async function searchLibraryHandler({ query, limit, }) {
             'Try different words, or call list_library to see everything saved.',
         ].join('\n'), structured);
     }
-    const lines = [`${hits.length} result${hits.length === 1 ? '' : 's'}`, ''];
+    const lines = [`${hits.length} of ${total} result${total === 1 ? '' : 's'}`, ''];
     for (const hit of hits) {
         lines.push(`${hit.title} (${hit.kind})`);
         lines.push(`  ${hit.excerpt}`);

package/dist/tools/library.js.map

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

package/dist/tools/list-library.d.ts

@@ -20,21 +20,21 @@ export declare const listLibraryOutputSchema: {
         hasSummary: z.ZodBoolean;
         hasSkill: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        url: string;
         title: string;
-        videoId: string;
+        url: string;
         channel: string;
         tags: string[];
+        videoId: string;
         dateSaved: string;
         hasTranscript: boolean;
         hasSummary: boolean;
         hasSkill: boolean;
     }, {
-        url: string;
         title: string;
-        videoId: string;
+        url: string;
         channel: string;
         tags: string[];
+        videoId: string;
         dateSaved: string;
         hasTranscript: boolean;
         hasSummary: boolean;

package/dist/tools/manage-brain.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * The two things that change a brain without reading YouTube: keeping the
+ * written account of a creator, and throwing the whole brain away.
+ */
+export declare const saveBrainProfileSchema: {
+    channel: z.ZodString;
+    content: z.ZodString;
+};
+export declare const saveBrainProfileOutputSchema: {
+    channelId: z.ZodString;
+    name: z.ZodString;
+    path: z.ZodString;
+    characters: z.ZodNumber;
+};
+/**
+ * Store the written account of a creator.
+ *
+ * The server cannot write this: it has no language model, and a profile is a
+ * reading of the corpus rather than a measurement of it. What it can do is keep
+ * the reading beside the passages it came from, and refuse to invent one.
+ */
+export declare function saveBrainProfileHandler({ channel, content, }: {
+    channel: string;
+    content: string;
+}): Promise<CallToolResult>;
+export declare const deleteBrainSchema: {
+    channel: z.ZodString;
+};
+export declare const deleteBrainOutputSchema: {
+    channelId: z.ZodString;
+    name: z.ZodString;
+    deleted: z.ZodBoolean;
+};
+export declare function deleteBrainHandler({ channel, }: {
+    channel: string;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=manage-brain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manage-brain.d.ts","sourceRoot":"","sources":["../../src/tools/manage-brain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAKzE;;;GAGG;AAIH,eAAO,MAAM,sBAAsB;;;CAQlC,CAAC;AAEF,eAAO,MAAM,4BAA4B;;;;;CAKxC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAAC,EAC5C,OAAO,EACP,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CAU1B;AAID,eAAO,MAAM,iBAAiB;;CAE7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;CAInC,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,EACvC,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CAW1B"}

package/dist/tools/manage-brain.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { resolveBrain } from '../utils/brain-lookup.js';
+import { deleteBrain, writeProfile } from '../utils/brain-storage.js';
+import { fileResult, toolResult } from '../utils/format.js';
+/**
+ * The two things that change a brain without reading YouTube: keeping the
+ * written account of a creator, and throwing the whole brain away.
+ */
+// -- save_brain_profile --------------------------------------------------
+export const saveBrainProfileSchema = {
+    channel: z.string().describe('Channel URL, @handle, name, or channel id of an existing brain'),
+    content: z
+        .string()
+        .min(1)
+        .describe('The profile, as markdown. Ground every claim in passages from ask_brain and cite them with [MM:SS] and a link, so a reader can check it against the video.'),
+};
+export const saveBrainProfileOutputSchema = {
+    channelId: z.string(),
+    name: z.string(),
+    path: z.string(),
+    characters: z.number().int(),
+};
+/**
+ * Store the written account of a creator.
+ *
+ * The server cannot write this: it has no language model, and a profile is a
+ * reading of the corpus rather than a measurement of it. What it can do is keep
+ * the reading beside the passages it came from, and refuse to invent one.
+ */
+export async function saveBrainProfileHandler({ channel, content, }) {
+    const manifest = await resolveBrain(channel);
+    const { channelId, name } = manifest.channel;
+    const path = await writeProfile(channelId, content);
+    return fileResult(`Saved a profile for ${name} (${content.length.toLocaleString()} characters).`, { channelId, name, path, characters: content.length }, { path, name: `${name} profile`, mimeType: 'text/markdown' });
+}
+// -- delete_brain --------------------------------------------------------
+export const deleteBrainSchema = {
+    channel: z.string().describe('Channel URL, @handle, name, or channel id of an existing brain'),
+};
+export const deleteBrainOutputSchema = {
+    channelId: z.string(),
+    name: z.string(),
+    deleted: z.boolean(),
+};
+export async function deleteBrainHandler({ channel, }) {
+    const manifest = await resolveBrain(channel);
+    const { channelId, name } = manifest.channel;
+    const deleted = await deleteBrain(channelId);
+    // `resolveBrain` already proved the brain was there, so there is no "nothing
+    // to delete" case to report — only the removal, and what survives it.
+    return toolResult(`Deleted the brain for ${name}. The transcripts it was built from are still cached, so rebuilding it is much faster than the first build was.`, { channelId, name, deleted });
+}
+//# sourceMappingURL=manage-brain.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manage-brain.js","sourceRoot":"","sources":["../../src/tools/manage-brain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;GAGG;AAEH,2EAA2E;AAE3E,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;IAC9F,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,4JAA4J,CAC7J;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CAC7B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,EAC5C,OAAO,EACP,OAAO,GAIR;IACC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEpD,OAAO,UAAU,CACf,uBAAuB,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,eAAe,EAC9E,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,EACrD,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,CAC7D,CAAC;AACJ,CAAC;AAED,2EAA2E;AAE3E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;CAC/F,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,OAAO,GAGR;IACC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;IAE7C,6EAA6E;IAC7E,sEAAsE;IACtE,OAAO,UAAU,CACf,yBAAyB,IAAI,iHAAiH,EAC9I,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAC7B,CAAC;AACJ,CAAC"}

package/dist/tools/search-channels.d.ts

@@ -21,17 +21,17 @@ export declare const searchChannelsOutputSchema: {
     }, "strip", z.ZodTypeAny, {
         description: string;
         name: string;
-        handle: string;
-        channelUrl: string;
         channelId: string;
+        handle: string;
         subscriberCount: number;
+        channelUrl: string;
     }, {
         description: string;
         name: string;
-        handle: string;
-        channelUrl: string;
         channelId: string;
+        handle: string;
         subscriberCount: number;
+        channelUrl: string;
     }>, "many">;
 };
 export declare function searchChannelsHandler({ query, limit, }: {

package/dist/tools/search-transcript.d.ts

@@ -20,14 +20,14 @@ export declare const searchTranscriptOutputSchema: {
         url: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         url: string;
-        text: string;
         startSeconds: number;
         startFormatted: string;
+        text: string;
     }, {
         url: string;
-        text: string;
         startSeconds: number;
         startFormatted: string;
+        text: string;
     }>, "many">;
     matchCount: z.ZodNumber;
     segmentsSearched: z.ZodNumber;

package/dist/tools/search-videos.d.ts

@@ -21,23 +21,23 @@ export declare const searchVideosOutputSchema: {
         viewCount: z.ZodOptional<z.ZodNumber>;
         uploadDate: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        url: string;
-        title: string;
         id: string;
-        durationFormatted: string;
+        title: string;
         durationSeconds: number;
+        durationFormatted: string;
+        url: string;
         channel?: string | undefined;
-        uploadDate?: string | undefined;
         viewCount?: number | undefined;
+        uploadDate?: string | undefined;
     }, {
-        url: string;
-        title: string;
         id: string;
-        durationFormatted: string;
+        title: string;
         durationSeconds: number;
+        durationFormatted: string;
+        url: string;
         channel?: string | undefined;
-        uploadDate?: string | undefined;
         viewCount?: number | undefined;
+        uploadDate?: string | undefined;
     }>, "many">;
 };
 export declare function searchVideosHandler({ query, limit, }: {

package/dist/utils/brain-build.d.ts

@@ -0,0 +1,40 @@
+import type { BrainManifest } from '../brain-schemas.js';
+import { type VideoFilters } from './brain-ingest.js';
+import type { ChannelInfo, VideoListItem } from './youtube.js';
+/**
+ * Reading a channel into a brain.
+ *
+ * The shape of this is dictated by how long it takes. Several hundred videos is
+ * several hundred yt-dlp invocations, so a build is something that gets
+ * interrupted: cancelled by the client, throttled by YouTube, or killed along
+ * with the editor it was started from. Every choice below follows from that —
+ * per-video state rather than one "built" flag, checkpoints rather than a
+ * single write at the end, and a failed video costing only itself.
+ *
+ * Which is also why there is no separate refresh: a second build sees what it
+ * already has, skips it, and reads whatever is new.
+ */
+/** Frequent enough that little work is lost, rare enough not to dominate. */
+export declare const CHECKPOINT_EVERY_VIDEOS = 10;
+/** Past this many throttled videos in a row, YouTube means it. */
+export declare const RATE_LIMIT_TOLERANCE = 3;
+export interface BuildBrainOptions extends VideoFilters {
+    channel: ChannelInfo;
+    videos: VideoListItem[];
+    existing: BrainManifest | undefined;
+    /** Caption language to read. A brain is built from one language at a time. */
+    language: string;
+}
+export interface BuildBrainResult {
+    manifest: BrainManifest;
+    /** Videos the filters kept, whether or not this call had to read them. */
+    considered: number;
+    /** Videos read during this call, as opposed to carried over from an earlier one. */
+    processed: number;
+    skipped: number;
+    excluded: number;
+    stoppedEarly: boolean;
+    stopReason?: string;
+}
+export declare function buildBrain(options: BuildBrainOptions): Promise<BuildBrainResult>;
+//# sourceMappingURL=brain-build.d.ts.map

package/dist/utils/brain-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-build.d.ts","sourceRoot":"","sources":["../../src/utils/brain-build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,aAAa,EAAmB,MAAM,qBAAqB,CAAC;AAEtF,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE/D;;;;;;;;;;;;GAYG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAc1C,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,aAAa,CAAC;IACxB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4EtF"}

package/dist/utils/brain-build.js

@@ -0,0 +1,211 @@
+import { readChunks, writeChunks } from './brain-index.js';
+import { excluded, ingestVideo, isExcluded, pendingState, } from './brain-ingest.js';
+import { computeStats } from './brain-stats.js';
+import { BRAIN_MANIFEST_VERSION, writeManifest } from './brain-storage.js';
+import { reportProgress, throwIfAborted } from './context.js';
+import { concurrencyState } from './ytdlp.js';
+/**
+ * Reading a channel into a brain.
+ *
+ * The shape of this is dictated by how long it takes. Several hundred videos is
+ * several hundred yt-dlp invocations, so a build is something that gets
+ * interrupted: cancelled by the client, throttled by YouTube, or killed along
+ * with the editor it was started from. Every choice below follows from that —
+ * per-video state rather than one "built" flag, checkpoints rather than a
+ * single write at the end, and a failed video costing only itself.
+ *
+ * Which is also why there is no separate refresh: a second build sees what it
+ * already has, skips it, and reads whatever is new.
+ */
+/** Frequent enough that little work is lost, rare enough not to dominate. */
+export const CHECKPOINT_EVERY_VIDEOS = 10;
+/**
+ * How many videos to read at once: whatever the yt-dlp limiter is actually set
+ * to, which `YOUTUBE_MCP_MAX_CONCURRENCY` can change.
+ *
+ * Read rather than copied. A second number that merely happened to match would
+ * stop matching the moment someone tuned the first, and would then either queue
+ * work behind a limit it could not see or batch below one it was allowed.
+ */
+function buildConcurrency() {
+    return concurrencyState().limit;
+}
+/** Past this many throttled videos in a row, YouTube means it. */
+export const RATE_LIMIT_TOLERANCE = 3;
+export async function buildBrain(options) {
+    const { channel, videos, existing, language, since, minDurationSeconds } = options;
+    const filters = { minDurationSeconds, ...(since === undefined ? {} : { since }) };
+    const createdAt = existing?.createdAt ?? new Date().toISOString();
+    const chunksByVideo = groupByVideo(await readChunks(channel.channelId));
+    const states = reconciled(existing, videos, chunksByVideo, filters);
+    const outstanding = videos.filter((video) => isOutstanding(states.get(video.id)));
+    /**
+     * `phrases` is the difference between a checkpoint and the end of a build:
+     * the phrase pass reads the whole corpus and takes seconds at the sizes a
+     * brain can reach, so it runs once, when there is a finished corpus to run it
+     * over. A checkpoint records what has been read, which is all it is for.
+     */
+    const save = async (phrases) => {
+        const passages = flatten(states, chunksByVideo);
+        const manifest = toManifest(channel, states, passages, createdAt, language, phrases);
+        await writeChunks(channel.channelId, passages);
+        await writeManifest(manifest);
+        return manifest;
+    };
+    let attempted = 0;
+    let processed = 0;
+    let consecutiveThrottles = 0;
+    let stopReason;
+    try {
+        await inBatches(outstanding, buildConcurrency(), async (video) => {
+            if (stopReason !== undefined)
+                return;
+            throwIfAborted();
+            const { state, chunks } = await ingestVideo(video, countChunks(chunksByVideo), {
+                language,
+                ...filters,
+            });
+            states.set(video.id, state);
+            if (chunks.length > 0)
+                chunksByVideo.set(video.id, chunks);
+            else
+                chunksByVideo.delete(video.id);
+            attempted++;
+            // A video the filters ruled out was looked at, not read.
+            if (state.state !== 'excluded')
+                processed++;
+            consecutiveThrottles = state.error === 'RATE_LIMITED' ? consecutiveThrottles + 1 : 0;
+            if (consecutiveThrottles >= RATE_LIMIT_TOLERANCE) {
+                stopReason = 'YouTube is rate limiting this client.';
+            }
+            reportProgress(attempted, outstanding.length, `Read ${attempted} of ${outstanding.length}`);
+            if (attempted % CHECKPOINT_EVERY_VIDEOS === 0)
+                await save(false);
+        });
+    }
+    catch (error) {
+        // A cancelled build must not throw away the videos read since the last
+        // checkpoint. Saving first is what makes "interrupt it and call it again"
+        // true rather than nearly true — and it is a checkpoint, not a finished
+        // corpus, so it does not pay for the phrase pass either.
+        await save(false);
+        throw error;
+    }
+    const manifest = await save(true);
+    const excludedCount = videos.filter((video) => states.get(video.id)?.state === 'excluded').length;
+    return {
+        manifest,
+        considered: videos.length - excludedCount,
+        processed,
+        skipped: videos.length - excludedCount - processed,
+        excluded: excludedCount,
+        stoppedEarly: stopReason !== undefined,
+        ...(stopReason === undefined ? {} : { stopReason }),
+    };
+}
+/**
+ * Per-video state, reconciled against the passages on disk and re-tested
+ * against the filters in force right now.
+ *
+ * Two corrections happen here, both for the same reason: what the manifest says
+ * was true when it was written, and neither the corpus nor the caller's filters
+ * are obliged to have stayed the same.
+ *
+ * The manifest and the passage file are two documents, and only one can be
+ * written first. A crash between them, a half-restored backup, or a
+ * `chunks.json` truncated by a full disk all end the same way — the manifest
+ * says a video was read and there is nothing to show for it. Left alone that
+ * brain is stranded for good: every build skips the video as already done while
+ * every search returns nothing. So the passages win, and a video the corpus
+ * cannot account for goes back to pending.
+ *
+ * A filter is re-applied rather than remembered. Narrowing one excludes videos
+ * already read; widening one brings excluded videos back. Both are decided from
+ * the dates and lengths already recorded, so changing your mind costs nothing
+ * until there is something new to fetch.
+ */
+function reconciled(existing, videos, chunksByVideo, filters) {
+    const states = new Map();
+    for (const [videoId, recorded] of Object.entries(existing?.videos ?? {})) {
+        const lost = recorded.state === 'indexed' && (chunksByVideo.get(videoId)?.length ?? 0) === 0;
+        const state = lost
+            ? { ...recorded, state: 'pending', chunkCount: 0, wordCount: 0 }
+            : recorded;
+        states.set(videoId, refiltered(state, filters));
+    }
+    for (const video of videos) {
+        // The listing's own length is real data, so a filter that can be decided
+        // from it is decided here — before spending a request to learn what the
+        // listing already said.
+        if (!states.has(video.id))
+            states.set(video.id, refiltered(pendingState(video), filters));
+    }
+    return states;
+}
+/**
+ * `undefined` — the filters cannot be decided from what is recorded — leaves the
+ * state alone, so the video is read and the question answered from the metadata
+ * that read fetches.
+ */
+function refiltered(state, filters) {
+    const ruledOut = isExcluded(state, filters);
+    if (ruledOut === true)
+        return excluded(state);
+    if (ruledOut === false && state.state === 'excluded') {
+        return { ...state, state: 'pending' };
+    }
+    return state;
+}
+/** Anything not already read: never attempted, or attempted and failed. */
+function isOutstanding(state) {
+    return state === undefined || state.state === 'pending' || state.state === 'failed';
+}
+function groupByVideo(chunks) {
+    const grouped = new Map();
+    for (const chunk of chunks) {
+        grouped.set(chunk.videoId, [...(grouped.get(chunk.videoId) ?? []), chunk]);
+    }
+    return grouped;
+}
+function countChunks(chunksByVideo) {
+    let total = 0;
+    for (const chunks of chunksByVideo.values())
+        total += chunks.length;
+    return total;
+}
+/**
+ * The corpus: every passage of every video the brain holds, in manifest order so
+ * the file changes as little as possible between builds.
+ *
+ * A video the filters exclude contributes nothing, which is what makes the
+ * filters mean something. Leaving its passages in would let `ask_brain` quote a
+ * video that `get_brain_info` says is not part of this brain, and no wording
+ * makes that defensible.
+ */
+function flatten(states, chunksByVideo) {
+    return [...states.entries()].flatMap(([videoId, state]) => state.state === 'excluded' ? [] : (chunksByVideo.get(videoId) ?? []));
+}
+function toManifest(channel, states, passages, createdAt, language, phrases) {
+    return {
+        version: BRAIN_MANIFEST_VERSION,
+        channel,
+        language,
+        createdAt,
+        updatedAt: new Date().toISOString(),
+        videos: Object.fromEntries(states),
+        stats: computeStats([...states.values()], passages, { phrases }),
+    };
+}
+/**
+ * Run `work` over the items, `size` at a time.
+ *
+ * Deliberately not a rolling window: a batch boundary is a natural place for
+ * the checkpoint and the cancellation check, and the limiter inside yt-dlp is
+ * what actually paces the network.
+ */
+async function inBatches(items, size, work) {
+    for (let start = 0; start < items.length; start += size) {
+        await Promise.all(items.slice(start, start + size).map(work));
+    }
+}
+//# sourceMappingURL=brain-build.js.map

package/dist/utils/brain-build.js.map

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

package/dist/utils/brain-chunks.d.ts

@@ -0,0 +1,33 @@
+import type { BrainChunk } from '../brain-schemas.js';
+import { type TranscriptSegment } from './transcript.js';
+import type { Chapter } from './youtube.js';
+/**
+ * Transcripts cut into retrievable passages.
+ *
+ * A brain is searched, not read: a whole transcript is too long to rank
+ * usefully and far too long to return, while a single caption cue is too short
+ * to carry a thought. A passage of a few sentences is what BM25 scores well and
+ * what a reader can check against the video in one click.
+ *
+ * Chunks do not overlap. Overlap is worth its cost with embeddings, where a
+ * concept split across a boundary can be missed entirely; BM25 matches terms,
+ * and a duplicated passage would only mean two results saying the same thing.
+ */
+/** Where a passage stops being short enough to keep growing. */
+export declare const CHUNK_TARGET_CHARS = 800;
+/**
+ * Where it stops regardless. Speech without a pause for this long is rare, and
+ * an unbroken passage is worse than one broken in an awkward place.
+ */
+export declare const CHUNK_MAX_CHARS = 1200;
+/** A pause this long is a sentence or a thought ending. */
+export declare const CHUNK_BREAK_GAP_SECONDS = 2;
+export interface ChunkTranscriptOptions {
+    videoId: string;
+    title: string;
+    segments: TranscriptSegment[];
+    /** Chapter starts are always passage boundaries: a new chapter is a new subject. */
+    chapters?: Chapter[];
+}
+export declare function chunkTranscript(options: ChunkTranscriptOptions): BrainChunk[];
+//# sourceMappingURL=brain-chunks.d.ts.map

package/dist/utils/brain-chunks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-chunks.d.ts","sourceRoot":"","sources":["../../src/utils/brain-chunks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;;;;;;GAWG;AAEH,gEAAgE;AAChE,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;;;GAGG;AACH,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,2DAA2D;AAC3D,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,UAAU,EAAE,CAwC7E"}