youtube-knowledge-mcp 1.1.1 → 2.0.0

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

@@ -1,15 +1,47 @@
 import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 export declare const fetchVideosSchema: {
     url: z.ZodString;
     limit: z.ZodDefault<z.ZodNumber>;
 };
-export declare function fetchVideosHandler({ url, limit }: {
+export declare const fetchVideosOutputSchema: {
+    total: z.ZodNumber;
+    count: z.ZodNumber;
+    offset: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    nextOffset: z.ZodOptional<z.ZodNumber>;
+    source: z.ZodString;
+    videos: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        durationSeconds: z.ZodNumber;
+        durationFormatted: z.ZodString;
+        url: z.ZodString;
+        channel: z.ZodOptional<z.ZodString>;
+        viewCount: z.ZodOptional<z.ZodNumber>;
+        uploadDate: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        title: string;
+        id: string;
+        durationFormatted: string;
+        durationSeconds: number;
+        channel?: string | undefined;
+        uploadDate?: string | undefined;
+        viewCount?: number | undefined;
+    }, {
+        url: string;
+        title: string;
+        id: string;
+        durationFormatted: string;
+        durationSeconds: number;
+        channel?: string | undefined;
+        uploadDate?: string | undefined;
+        viewCount?: number | undefined;
+    }>, "many">;
+};
+export declare function fetchVideosHandler({ url, limit, }: {
     url: string;
     limit: number;
-}): Promise<{
-    content: [{
-        type: "text";
-        text: string;
-    }];
-}>;
+}): Promise<CallToolResult>;
 //# sourceMappingURL=fetch-videos.d.ts.map

package/dist/tools/fetch-videos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-videos.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,iBAAiB;;;CAY7B,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;;;;;GAatF"}
+{"version":3,"file":"fetch-videos.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,iBAAiB;;;CAY7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAInC,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,EACvC,GAAG,EACH,KAAK,GACN,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,cAAc,CAAC,CAwB1B"}

package/dist/tools/fetch-videos.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { listVideos } from '../utils/youtube.js';
-import { textContent } from '../utils/format.js';
+import { pageInfo, toolResult } from '../utils/format.js';
+import { paginationShape, videoSummarySchema } from '../schemas.js';
 export const fetchVideosSchema = {
     url: z
         .string()
@@ -12,7 +13,12 @@ export const fetchVideosSchema = {
         .default(20)
         .describe('Maximum number of videos to return (1-100, default: 20)'),
 };
-export async function fetchVideosHandler({ url, limit }) {
+export const fetchVideosOutputSchema = {
+    source: z.string(),
+    videos: z.array(videoSummarySchema),
+    ...paginationShape,
+};
+export async function fetchVideosHandler({ url, limit, }) {
     const videos = await listVideos(url, limit);
     const lines = [`✓ Found ${videos.length} video${videos.length !== 1 ? 's' : ''}`, ''];
     videos.forEach((v, i) => {
@@ -21,6 +27,17 @@ export async function fetchVideosHandler({ url, limit }) {
         lines.push(`   ${v.url}`);
         lines.push('');
     });
-    return textContent(lines.join('\n'));
+    return toolResult(lines.join('\n'), {
+        source: url,
+        videos: videos.map((v) => ({
+            id: v.id,
+            title: v.title,
+            durationSeconds: v.duration,
+            durationFormatted: v.durationFormatted,
+            url: v.url,
+            uploadDate: v.uploadDate,
+        })),
+        ...pageInfo(videos.length, videos.length),
+    });
 }
 //# sourceMappingURL=fetch-videos.js.map

package/dist/tools/fetch-videos.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-videos.js","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACP,+FAA+F,CAChG;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAkC;IACrF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAE5C,MAAM,KAAK,GAAa,CAAC,WAAW,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAEhG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,iBAAiB,MAAM,CAAC,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"fetch-videos.js","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGpE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACP,+FAA+F,CAChG;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IACnC,GAAG,eAAe;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,GAAG,EACH,KAAK,GAIN;IACC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAE5C,MAAM,KAAK,GAAa,CAAC,WAAW,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAEhG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,iBAAiB,MAAM,CAAC,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAClC,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,eAAe,EAAE,CAAC,CAAC,QAAQ;YAC3B,iBAAiB,EAAE,CAAC,CAAC,iBAAiB;YACtC,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,UAAU,EAAE,CAAC,CAAC,UAAU;SACzB,CAAC,CAAC;QACH,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/get-channel-info.d.ts

@@ -1,13 +1,17 @@
 import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 export declare const getChannelInfoSchema: {
     channel: z.ZodString;
 };
-export declare function getChannelInfoHandler({ channel }: {
+export declare const getChannelInfoOutputSchema: {
+    name: z.ZodString;
+    channelId: z.ZodString;
+    handle: z.ZodString;
+    subscriberCount: z.ZodNumber;
+    channelUrl: z.ZodString;
+    description: z.ZodString;
+};
+export declare function getChannelInfoHandler({ channel, }: {
     channel: string;
-}): Promise<{
-    content: [{
-        type: "text";
-        text: string;
-    }];
-}>;
+}): Promise<CallToolResult>;
 //# sourceMappingURL=get-channel-info.d.ts.map

package/dist/tools/get-channel-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-channel-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,oBAAoB;;CAEhC,CAAC;AAEF,wBAAsB,qBAAqB,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE;;;;;GAgB3E"}
+{"version":3,"file":"get-channel-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,oBAAoB;;CAEhC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;CAA0B,CAAC;AAElE,wBAAsB,qBAAqB,CAAC,EAC1C,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CAgB1B"}

package/dist/tools/get-channel-info.js

@@ -1,10 +1,12 @@
 import { z } from 'zod';
 import { getChannelInfo } from '../utils/youtube.js';
-import { formatCount, textContent } from '../utils/format.js';
+import { formatCount, toolResult } from '../utils/format.js';
+import { channelInfoSchema } from '../schemas.js';
 export const getChannelInfoSchema = {
     channel: z.string().describe('YouTube channel URL, handle (e.g., @Fireship), or channel name'),
 };
-export async function getChannelInfoHandler({ channel }) {
+export const getChannelInfoOutputSchema = channelInfoSchema.shape;
+export async function getChannelInfoHandler({ channel, }) {
     const info = await getChannelInfo(channel);
     const lines = [
         info.name,
@@ -16,6 +18,6 @@ export async function getChannelInfoHandler({ channel }) {
         lines.push('');
         lines.push(info.description);
     }
-    return textContent(lines.join('\n'));
+    return toolResult(lines.join('\n'), { ...info });
 }
 //# sourceMappingURL=get-channel-info.js.map

package/dist/tools/get-channel-info.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-channel-info.js","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;CAC/F,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAAE,OAAO,EAAuB;IAC1E,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAa;QACtB,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC9B,GAAG,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc;QAClD,IAAI,CAAC,UAAU;KAChB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"get-channel-info.js","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;CAC/F,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAAC,KAAK,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAC1C,OAAO,GAGR;IACC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAa;QACtB,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC9B,GAAG,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc;QAClD,IAAI,CAAC,UAAU;KAChB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/tools/get-chapters.d.ts

@@ -1,13 +1,35 @@
 import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 export declare const getChaptersSchema: {
     video: z.ZodString;
 };
+export declare const getChaptersOutputSchema: {
+    videoId: z.ZodString;
+    chapters: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        startSeconds: z.ZodNumber;
+        startFormatted: z.ZodString;
+        endSeconds: z.ZodNumber;
+        endFormatted: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        title: string;
+        startSeconds: number;
+        startFormatted: string;
+        endSeconds: number;
+        endFormatted: string;
+    }, {
+        url: string;
+        title: string;
+        startSeconds: number;
+        startFormatted: string;
+        endSeconds: number;
+        endFormatted: string;
+    }>, "many">;
+    count: z.ZodNumber;
+};
 export declare function getChaptersHandler({ video }: {
     video: string;
-}): Promise<{
-    content: [{
-        type: "text";
-        text: string;
-    }];
-}>;
+}): Promise<CallToolResult>;
 //# sourceMappingURL=get-chapters.d.ts.map

package/dist/tools/get-chapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-chapters.d.ts","sourceRoot":"","sources":["../../src/tools/get-chapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,iBAAiB;;CAE7B,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE;;;;;GAcpE"}
+{"version":3,"file":"get-chapters.d.ts","sourceRoot":"","sources":["../../src/tools/get-chapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,iBAAiB;;CAE7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;CAInC,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CA4B9F"}

package/dist/tools/get-chapters.js

@@ -1,18 +1,38 @@
 import { z } from 'zod';
-import { getChapters } from '../utils/youtube.js';
-import { textContent } from '../utils/format.js';
+import { toolResult } from '../utils/format.js';
+import { chapterSchema } from '../schemas.js';
+import { deepLink } from '../utils/transcript.js';
+import { extractVideoId, getChapters } from '../utils/youtube.js';
 export const getChaptersSchema = {
     video: z.string().describe('YouTube video ID (e.g., dQw4w9WgXcQ) or full URL'),
 };
+export const getChaptersOutputSchema = {
+    videoId: z.string(),
+    chapters: z.array(chapterSchema),
+    count: z.number().int(),
+};
 export async function getChaptersHandler({ video }) {
     const chapters = await getChapters(video);
+    const videoId = extractVideoId(video);
+    const structured = {
+        videoId,
+        chapters: chapters.map((ch) => ({
+            title: ch.title,
+            startSeconds: ch.startTime,
+            startFormatted: ch.startTimeFormatted,
+            endSeconds: ch.endTime,
+            endFormatted: ch.endTimeFormatted,
+            url: deepLink(videoId, ch.startTime),
+        })),
+        count: chapters.length,
+    };
     if (chapters.length === 0) {
-        return textContent('No chapters found for this video.');
+        return toolResult('No chapters found for this video.', structured);
     }
     const lines = [`${chapters.length} chapters`, ''];
     chapters.forEach((ch, i) => {
         lines.push(`${i + 1}. [${ch.startTimeFormatted} - ${ch.endTimeFormatted}] ${ch.title}`);
     });
-    return textContent(lines.join('\n'));
+    return toolResult(lines.join('\n'), structured);
 }
 //# sourceMappingURL=get-chapters.js.map

package/dist/tools/get-chapters.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-chapters.js","sourceRoot":"","sources":["../../src/tools/get-chapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CAC/E,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EAAE,KAAK,EAAqB;IACnE,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;IAE1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,WAAW,CAAC,mCAAmC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,GAAG,QAAQ,CAAC,MAAM,WAAW,EAAE,EAAE,CAAC,CAAC;IAE5D,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;QACzB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,kBAAkB,MAAM,EAAE,CAAC,gBAAgB,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"get-chapters.js","sourceRoot":"","sources":["../../src/tools/get-chapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CAC/E,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CACxB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EAAE,KAAK,EAAqB;IACnE,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAEtC,MAAM,UAAU,GAAG;QACjB,OAAO;QACP,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC9B,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,YAAY,EAAE,EAAE,CAAC,SAAS;YAC1B,cAAc,EAAE,EAAE,CAAC,kBAAkB;YACrC,UAAU,EAAE,EAAE,CAAC,OAAO;YACtB,YAAY,EAAE,EAAE,CAAC,gBAAgB;YACjC,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC;SACrC,CAAC,CAAC;QACH,KAAK,EAAE,QAAQ,CAAC,MAAM;KACvB,CAAC;IAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC,mCAAmC,EAAE,UAAU,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,GAAG,QAAQ,CAAC,MAAM,WAAW,EAAE,EAAE,CAAC,CAAC;IAE5D,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;QACzB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,kBAAkB,MAAM,EAAE,CAAC,gBAAgB,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC"}

package/dist/tools/get-comments.d.ts

@@ -1,15 +1,34 @@
 import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 export declare const getCommentsSchema: {
     video: z.ZodString;
     limit: z.ZodDefault<z.ZodNumber>;
 };
-export declare function getCommentsHandler({ video, limit }: {
+export declare const getCommentsOutputSchema: {
+    total: z.ZodNumber;
+    count: z.ZodNumber;
+    offset: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    nextOffset: z.ZodOptional<z.ZodNumber>;
+    comments: z.ZodArray<z.ZodObject<{
+        author: z.ZodString;
+        text: z.ZodString;
+        likeCount: z.ZodNumber;
+        isPinned: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        likeCount: number;
+        author: string;
+        isPinned: boolean;
+    }, {
+        text: string;
+        likeCount: number;
+        author: string;
+        isPinned: boolean;
+    }>, "many">;
+};
+export declare function getCommentsHandler({ video, limit, }: {
     video: string;
     limit: number;
-}): Promise<{
-    content: [{
-        type: "text";
-        text: string;
-    }];
-}>;
+}): Promise<CallToolResult>;
 //# sourceMappingURL=get-comments.d.ts.map

package/dist/tools/get-comments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-comments.d.ts","sourceRoot":"","sources":["../../src/tools/get-comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,iBAAiB;;;CAQ7B,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;;;;;GAkB1F"}
+{"version":3,"file":"get-comments.d.ts","sourceRoot":"","sources":["../../src/tools/get-comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,iBAAiB;;;CAQ7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;CAGnC,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,EACvC,KAAK,EACL,KAAK,GACN,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,cAAc,CAAC,CAmB1B"}

package/dist/tools/get-comments.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { getComments } from '../utils/youtube.js';
-import { textContent } from '../utils/format.js';
+import { pageInfo, toolResult } from '../utils/format.js';
+import { commentSchema, paginationShape } from '../schemas.js';
 export const getCommentsSchema = {
     video: z.string().describe('YouTube video ID (e.g., dQw4w9WgXcQ) or full URL'),
     limit: z
@@ -10,10 +11,15 @@ export const getCommentsSchema = {
         .default(20)
         .describe('Maximum number of top-level comments to return (1-50, default: 20)'),
 };
-export async function getCommentsHandler({ video, limit }) {
+export const getCommentsOutputSchema = {
+    comments: z.array(commentSchema),
+    ...paginationShape,
+};
+export async function getCommentsHandler({ video, limit, }) {
     const comments = await getComments(video, limit);
+    const structured = { comments, ...pageInfo(comments.length, comments.length) };
     if (comments.length === 0) {
-        return textContent('No comments found for this video.');
+        return toolResult('No comments found for this video.', structured);
     }
     const lines = [`${comments.length} top comments`, ''];
     comments.forEach((c, i) => {
@@ -23,6 +29,6 @@ export async function getCommentsHandler({ video, limit }) {
         lines.push(`   ${c.text}`);
         lines.push('');
     });
-    return textContent(lines.join('\n'));
+    return toolResult(lines.join('\n'), structured);
 }
 //# sourceMappingURL=get-comments.js.map

package/dist/tools/get-comments.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-comments.js","sourceRoot":"","sources":["../../src/tools/get-comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC9E,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,oEAAoE,CAAC;CAClF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAoC;IACzF,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAEjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,WAAW,CAAC,mCAAmC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,GAAG,QAAQ,CAAC,MAAM,eAAe,EAAE,EAAE,CAAC,CAAC;IAEhE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"get-comments.js","sourceRoot":"","sources":["../../src/tools/get-comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAG/D,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC9E,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,oEAAoE,CAAC;CAClF,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;IAChC,GAAG,eAAe;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,KAAK,EACL,KAAK,GAIN;IACC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;IAE/E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC,mCAAmC,EAAE,UAAU,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,GAAG,QAAQ,CAAC,MAAM,eAAe,EAAE,EAAE,CAAC,CAAC;IAEhE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC"}

package/dist/tools/get-playlist-info.d.ts

@@ -1,13 +1,20 @@
 import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 export declare const getPlaylistInfoSchema: {
     url: z.ZodString;
 };
+export declare const getPlaylistInfoOutputSchema: {
+    id: z.ZodString;
+    title: z.ZodString;
+    channel: z.ZodString;
+    handle: z.ZodString;
+    channelUrl: z.ZodString;
+    videoCount: z.ZodNumber;
+    lastModified: z.ZodString;
+    url: z.ZodString;
+    description: z.ZodString;
+};
 export declare function getPlaylistInfoHandler({ url }: {
     url: string;
-}): Promise<{
-    content: [{
-        type: "text";
-        text: string;
-    }];
-}>;
+}): Promise<CallToolResult>;
 //# sourceMappingURL=get-playlist-info.d.ts.map

package/dist/tools/get-playlist-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-playlist-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-playlist-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,qBAAqB;;CAMjC,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE;;;;;GAkBpE"}
+{"version":3,"file":"get-playlist-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-playlist-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,qBAAqB;;CAMjC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;CAA2B,CAAC;AAEpE,wBAAsB,sBAAsB,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAkB9F"}

package/dist/tools/get-playlist-info.js

@@ -1,11 +1,13 @@
 import { z } from 'zod';
 import { getPlaylistInfo } from '../utils/youtube.js';
-import { formatCount, textContent } from '../utils/format.js';
+import { formatCount, toolResult } from '../utils/format.js';
+import { playlistInfoSchema } from '../schemas.js';
 export const getPlaylistInfoSchema = {
     url: z
         .string()
         .describe('YouTube playlist URL (e.g., https://www.youtube.com/playlist?list=PLlrATfBNZ98dudnM48yfGUldqGD0S4FFb)'),
 };
+export const getPlaylistInfoOutputSchema = playlistInfoSchema.shape;
 export async function getPlaylistInfoHandler({ url }) {
     const info = await getPlaylistInfo(url);
     const lines = [
@@ -20,6 +22,6 @@ export async function getPlaylistInfoHandler({ url }) {
         lines.push('');
         lines.push(info.description);
     }
-    return textContent(lines.join('\n'));
+    return toolResult(lines.join('\n'), { ...info });
 }
 //# sourceMappingURL=get-playlist-info.js.map

package/dist/tools/get-playlist-info.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-playlist-info.js","sourceRoot":"","sources":["../../src/tools/get-playlist-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACP,uGAAuG,CACxG;CACJ,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EAAE,GAAG,EAAmB;IACnE,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAExC,MAAM,KAAK,GAAa;QACtB,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE;QACjF,EAAE;QACF,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS;QACxC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;QAC7D,IAAI,CAAC,GAAG;KACT,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"get-playlist-info.js","sourceRoot":"","sources":["../../src/tools/get-playlist-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACP,uGAAuG,CACxG;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,kBAAkB,CAAC,KAAK,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EAAE,GAAG,EAAmB;IACnE,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAExC,MAAM,KAAK,GAAa;QACtB,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE;QACjF,EAAE;QACF,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS;QACxC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;QAC7D,IAAI,CAAC,GAAG;KACT,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}

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

@@ -1,15 +1,50 @@
 import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 export declare const getTranscriptSchema: {
     video: z.ZodString;
     language: z.ZodDefault<z.ZodString>;
+    format: z.ZodDefault<z.ZodEnum<["text", "timestamped", "segments"]>>;
+    startTime: z.ZodOptional<z.ZodString>;
+    endTime: z.ZodOptional<z.ZodString>;
+    chapter: z.ZodOptional<z.ZodString>;
+    maxChars: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    refresh: z.ZodDefault<z.ZodBoolean>;
 };
-export declare function getTranscriptHandler({ video, language, }: {
+export declare const getTranscriptOutputSchema: {
+    videoId: z.ZodString;
+    language: z.ZodString;
+    text: z.ZodString;
+    segments: z.ZodArray<z.ZodObject<{
+        startSeconds: z.ZodNumber;
+        endSeconds: z.ZodNumber;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        startSeconds: number;
+        endSeconds: number;
+    }, {
+        text: string;
+        startSeconds: number;
+        endSeconds: number;
+    }>, "many">;
+    wordCount: z.ZodNumber;
+    chapter: z.ZodOptional<z.ZodString>;
+    truncated: z.ZodBoolean;
+    nextOffset: z.ZodOptional<z.ZodNumber>;
+    totalChars: z.ZodNumber;
+    cached: z.ZodBoolean;
+};
+export interface GetTranscriptArgs {
     video: string;
     language: string;
-}): Promise<{
-    content: [{
-        type: "text";
-        text: string;
-    }];
-}>;
+    format: 'text' | 'timestamped' | 'segments';
+    startTime?: string;
+    endTime?: string;
+    chapter?: string;
+    maxChars?: number;
+    offset: number;
+    refresh: boolean;
+}
+export declare function getTranscriptHandler(args: GetTranscriptArgs): Promise<CallToolResult>;
 //# sourceMappingURL=get-transcript.d.ts.map

package/dist/tools/get-transcript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-transcript.d.ts","sourceRoot":"","sources":["../../src/tools/get-transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,mBAAmB;;;CAQ/B,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,EACzC,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;;;;;GAaA"}
+{"version":3,"file":"get-transcript.d.ts","sourceRoot":"","sources":["../../src/tools/get-transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,mBAAmB;;;;;;;;;;CA+C/B,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;CAWrC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,UAAU,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAuCD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwF3F"}