cfb-stats-mcp 0.1.0

package/dist/tools/read-transcript.test.js

@@ -0,0 +1,94 @@
+import { vi, describe, it, expect, beforeEach } from "vitest";
+vi.mock("node:fs", () => ({
+    readFileSync: vi.fn(),
+}));
+vi.mock("../logger.js", () => ({
+    logger: {
+        debug: vi.fn(),
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+    },
+}));
+import { readTranscript } from "./read-transcript.js";
+import { readFileSync } from "node:fs";
+const mockReadFileSync = vi.mocked(readFileSync);
+const VALID_TRANSCRIPT = {
+    version: "1.0",
+    language: "en",
+    segments: [
+        {
+            start: 0.0,
+            end: 5.0,
+            text: "Hello world",
+            words: [
+                { word: "Hello", start: 0.0, end: 0.5, score: 0.95, speaker: "SPEAKER_00" },
+                { word: "world", start: 0.6, end: 1.0, score: 0.98, speaker: "SPEAKER_00" },
+            ],
+            speaker: "SPEAKER_00",
+        },
+    ],
+    chapters: [],
+    metadata: null,
+};
+describe("readTranscript", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("reads and returns a valid transcript JSON", () => {
+        mockReadFileSync.mockReturnValue(JSON.stringify(VALID_TRANSCRIPT));
+        const result = readTranscript("/path/to/transcript.json");
+        expect(result).toEqual(VALID_TRANSCRIPT);
+        expect(mockReadFileSync).toHaveBeenCalledWith("/path/to/transcript.json", "utf-8");
+    });
+    it("throws if file not found", () => {
+        mockReadFileSync.mockImplementation(() => {
+            throw Object.assign(new Error("ENOENT"), { code: "ENOENT" });
+        });
+        expect(() => readTranscript("/missing/file.json")).toThrow(/not found/i);
+    });
+    it("throws if version is not 1.0", () => {
+        mockReadFileSync.mockReturnValue(JSON.stringify({ ...VALID_TRANSCRIPT, version: "2.0" }));
+        expect(() => readTranscript("/path/to/transcript.json")).toThrow(/version/i);
+    });
+    it("throws if JSON is invalid", () => {
+        mockReadFileSync.mockReturnValue("not json {{{");
+        expect(() => readTranscript("/path/to/transcript.json")).toThrow();
+    });
+    it("returns clip_candidates when present in transcript JSON", () => {
+        const clipCandidates = [
+            {
+                title: "Jalen Milroe scramble",
+                start: 45.0,
+                end: 90.0,
+                excerpt: "Watch how Milroe reads the linebacker...",
+                reasoning: "Shows tactical awareness",
+                status: "pending",
+            },
+            {
+                title: "Defensive stunt package",
+                start: 200.0,
+                end: 260.0,
+                excerpt: "The twist game on third down...",
+                reasoning: "High-energy play",
+                status: "approved",
+            },
+        ];
+        const transcriptWithClips = {
+            ...VALID_TRANSCRIPT,
+            clip_candidates: clipCandidates,
+        };
+        mockReadFileSync.mockReturnValue(JSON.stringify(transcriptWithClips));
+        const result = readTranscript("/path/to/transcript.json");
+        expect(result.clip_candidates).toBeDefined();
+        expect(result.clip_candidates).toHaveLength(2);
+        expect(result.clip_candidates[0].title).toBe("Jalen Milroe scramble");
+        expect(result.clip_candidates[0].start).toBe(45.0);
+        expect(result.clip_candidates[0].end).toBe(90.0);
+        expect(result.clip_candidates[0].excerpt).toBe("Watch how Milroe reads the linebacker...");
+        expect(result.clip_candidates[0].reasoning).toBe("Shows tactical awareness");
+        expect(result.clip_candidates[0].status).toBe("pending");
+        expect(result.clip_candidates[1].status).toBe("approved");
+    });
+});
+//# sourceMappingURL=read-transcript.test.js.map

package/dist/tools/read-transcript.test.js.map

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

package/dist/tools/season-advanced.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSeasonAdvancedTool(server: McpServer): void;
+//# sourceMappingURL=season-advanced.d.ts.map

package/dist/tools/season-advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"season-advanced.d.ts","sourceRoot":"","sources":["../../src/tools/season-advanced.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmDzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiHlE"}

package/dist/tools/season-advanced.js

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import { getAdjustedTeamSeasonStats, getAdvancedSeasonStats, getPredictedPointsAddedByTeam, } from "cfbd";
+import { cachedFetch } from "../cfbd-client.js";
+import { formatSeasonAdvanced } from "../formatters/season-advanced-formatter.js";
+import { logger } from "../logger.js";
+// See games.ts for why `as any` is needed on inputSchema.
+const inputSchema = {
+    team: z
+        .string()
+        .describe("Team school name (e.g. 'Alabama', 'Ohio State')"),
+    year: z
+        .number()
+        .optional()
+        .describe("Season year (e.g. 2024) — defaults to current season"),
+    startWeek: z
+        .number()
+        .optional()
+        .describe("Start week for filtering (e.g. 5). Note: only raw PPA/success rate/havoc data is filtered — EPA and PPA-by-down are always full season."),
+    endWeek: z
+        .number()
+        .optional()
+        .describe("End week for filtering (e.g. 10). Note: only raw PPA/success rate/havoc data is filtered — EPA and PPA-by-down are always full season."),
+    includeGarbageTime: z
+        .boolean()
+        .optional()
+        .describe("Include garbage time plays (default: false, garbage time excluded)"),
+};
+export function registerSeasonAdvancedTool(server) {
+    server.registerTool("cfbd_season_advanced", {
+        title: "Advanced Season Analytics",
+        description: "Get season-wide advanced analytics for a team: EPA (opponent-adjusted efficiency), PPA (raw predicted points), success rate, havoc, explosiveness, rushing detail, and PPA by down. Garbage time excluded by default. Week range filters raw stats only — EPA and PPA-by-down are always full season.",
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        inputSchema: inputSchema,
+    }, async (args) => {
+        const year = args.year ?? new Date().getFullYear();
+        // Garbage time polarity mapping (CONTEXT.md decision #3)
+        const excludeGarbageTime = args.includeGarbageTime === true ? false : true;
+        const hasWeekRange = args.startWeek != null || args.endWeek != null;
+        try {
+            const [adjustedAll, advancedAll, ppaAll] = await Promise.all([
+                // Source 1: EPA — NO week range, NO garbage time param
+                cachedFetch("getAdjustedTeamSeasonStats", { year, team: args.team }, () => getAdjustedTeamSeasonStats({
+                    query: { year, team: args.team },
+                })),
+                // Source 2: Raw PPA/success/havoc — supports week range AND garbage time
+                cachedFetch("getAdvancedSeasonStats", {
+                    year,
+                    team: args.team,
+                    excludeGarbageTime,
+                    startWeek: args.startWeek,
+                    endWeek: args.endWeek,
+                }, () => getAdvancedSeasonStats({
+                    query: {
+                        year,
+                        team: args.team,
+                        excludeGarbageTime,
+                        startWeek: args.startWeek,
+                        endWeek: args.endWeek,
+                    },
+                })),
+                // Source 3: PPA by down — NO week range, supports garbage time
+                cachedFetch("getPredictedPointsAddedByTeam", { year, team: args.team, excludeGarbageTime }, () => getPredictedPointsAddedByTeam({
+                    query: {
+                        year,
+                        team: args.team,
+                        excludeGarbageTime,
+                    },
+                })),
+            ]);
+            const teamLower = args.team.toLowerCase();
+            const adjusted = adjustedAll.find((r) => r.team.toLowerCase() === teamLower);
+            const advanced = advancedAll.find((r) => r.team.toLowerCase() === teamLower);
+            const ppa = ppaAll.find((r) => r.team.toLowerCase() === teamLower);
+            const formatted = formatSeasonAdvanced(adjusted, advanced, ppa, args.team, year, hasWeekRange);
+            logger.info("cfbd_season_advanced tool invoked", {
+                team: args.team,
+                year,
+                startWeek: args.startWeek,
+                endWeek: args.endWeek,
+                includeGarbageTime: args.includeGarbageTime,
+                hasAdjusted: !!adjusted,
+                hasAdvanced: !!advanced,
+                hasPpa: !!ppa,
+            });
+            return {
+                content: [{ type: "text", text: formatted }],
+            };
+        }
+        catch (error) {
+            const message = `Failed to fetch advanced season stats: ${error instanceof Error ? error.message : String(error)}`;
+            logger.error("cfbd_season_advanced tool error", {
+                team: args.team,
+                year,
+                error: message,
+            });
+            return {
+                content: [{ type: "text", text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=season-advanced.js.map

package/dist/tools/season-advanced.js.map

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

package/dist/tools/season-records.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSeasonRecordsTool(server: McpServer): void;
+//# sourceMappingURL=season-records.d.ts.map

package/dist/tools/season-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"season-records.d.ts","sourceRoot":"","sources":["../../src/tools/season-records.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2BzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8CjE"}

package/dist/tools/season-records.js

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import { getRecords } from "cfbd";
+import { cachedFetch } from "../cfbd-client.js";
+import { formatSeasonRecords } from "../formatters/season-records-formatter.js";
+import { logger } from "../logger.js";
+// See games.ts for why `as any` is needed on inputSchema.
+const inputSchema = {
+    team: z
+        .string()
+        .describe("Team school name (e.g. 'Alabama', 'Ohio State', 'Texas A&M')"),
+    year: z
+        .number()
+        .optional()
+        .describe("Season year (e.g. 2024) — defaults to current season if omitted"),
+};
+export function registerSeasonRecordsTool(server) {
+    server.registerTool("cfbd_records", {
+        title: "Season Records",
+        description: "Get a team's season record with overall, conference, home/away, and postseason splits plus expected wins. Use once per team per season — returns all record breakdowns in a single call.",
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        inputSchema: inputSchema,
+    }, async (args) => {
+        const year = args.year ?? new Date().getFullYear();
+        const params = { year, team: args.team };
+        try {
+            const records = await cachedFetch("getRecords", params, () => getRecords({ query: params }));
+            const formatted = formatSeasonRecords(records, args.team);
+            logger.info("cfbd_records tool invoked", {
+                team: args.team,
+                year,
+                recordCount: records.length,
+            });
+            return {
+                content: [{ type: "text", text: formatted }],
+            };
+        }
+        catch (error) {
+            const message = `Failed to fetch season records: ${error instanceof Error ? error.message : String(error)}`;
+            logger.error("cfbd_records tool error", {
+                team: args.team,
+                year,
+                error: message,
+            });
+            return {
+                content: [{ type: "text", text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=season-records.js.map

package/dist/tools/season-records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"season-records.js","sourceRoot":"","sources":["../../src/tools/season-records.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAoB,MAAM,MAAM,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,0DAA0D;AAC1D,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CACP,8DAA8D,CAC/D;IACH,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iEAAiE,CAClE;CACJ,CAAC;AAOF,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,0LAA0L;QAC5L,8DAA8D;QAC9D,WAAW,EAAE,WAAkB;KAChC,EACD,KAAK,EAAE,IAAwB,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,WAAW,CAC/B,YAAY,EACZ,MAAM,EACN,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CACpC,CAAC;YAEF,MAAM,SAAS,GAAG,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;gBACvC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI;gBACJ,WAAW,EAAE,OAAO,CAAC,MAAM;aAC5B,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;aACtD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5G,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE;gBACtC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI;gBACJ,KAAK,EAAE,OAAO;aACf,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/season-stats.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSeasonStatsTool(server: McpServer): void;
+//# sourceMappingURL=season-stats.d.ts.map

package/dist/tools/season-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"season-stats.d.ts","sourceRoot":"","sources":["../../src/tools/season-stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqCzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmE/D"}

package/dist/tools/season-stats.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import { getTeamStats } from "cfbd";
+import { cachedFetch } from "../cfbd-client.js";
+import { formatSeasonStats } from "../formatters/season-stats-formatter.js";
+import { logger } from "../logger.js";
+// See games.ts for why `as any` is needed on inputSchema.
+const inputSchema = {
+    team: z
+        .string()
+        .describe("Team school name (e.g. 'Alabama', 'Ohio State')"),
+    year: z
+        .number()
+        .optional()
+        .describe("Season year (e.g. 2024) — defaults to current season"),
+    startWeek: z
+        .number()
+        .optional()
+        .describe("Start week for filtering (e.g. 5) — omit for full season"),
+    endWeek: z
+        .number()
+        .optional()
+        .describe("End week for filtering (e.g. 10) — omit for full season"),
+};
+export function registerSeasonStatsTool(server) {
+    server.registerTool("cfbd_season_stats", {
+        title: "Season Statistics",
+        description: "Get season-wide traditional stat aggregates (yards, turnovers, 3rd down, completions, etc.) for a team. Returns totals/averages organized by category. Use startWeek/endWeek to filter to a specific week range for trend analysis.",
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        inputSchema: inputSchema,
+    }, async (args) => {
+        const year = args.year ?? new Date().getFullYear();
+        const params = {
+            year,
+            team: args.team,
+        };
+        if (args.startWeek != null)
+            params.startWeek = args.startWeek;
+        if (args.endWeek != null)
+            params.endWeek = args.endWeek;
+        try {
+            const stats = await cachedFetch("getTeamStats", params, () => getTeamStats({
+                query: {
+                    year,
+                    team: args.team,
+                    startWeek: args.startWeek,
+                    endWeek: args.endWeek,
+                },
+            }));
+            const formatted = formatSeasonStats(stats, args.team, year, args.startWeek, args.endWeek);
+            logger.info("cfbd_season_stats tool invoked", {
+                team: args.team,
+                year,
+                startWeek: args.startWeek,
+                endWeek: args.endWeek,
+                statCount: stats.length,
+            });
+            return {
+                content: [{ type: "text", text: formatted }],
+            };
+        }
+        catch (error) {
+            const message = `Failed to fetch season stats: ${error instanceof Error ? error.message : String(error)}`;
+            logger.error("cfbd_season_stats tool error", {
+                team: args.team,
+                year,
+                error: message,
+            });
+            return {
+                content: [{ type: "text", text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=season-stats.js.map

package/dist/tools/season-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"season-stats.js","sourceRoot":"","sources":["../../src/tools/season-stats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAiB,MAAM,MAAM,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,0DAA0D;AAC1D,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;IACnE,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,0DAA0D,CAC3D;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yDAAyD,CAC1D;CACJ,CAAC;AASF,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,qOAAqO;QACvO,8DAA8D;QAC9D,WAAW,EAAE,WAAkB;KAChC,EACD,KAAK,EAAE,IAAsB,EAAE,EAAE;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,MAAM,GAA4B;YACtC,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;QACF,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI;YAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAC9D,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI;YAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAExD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAC7B,cAAc,EACd,MAAM,EACN,GAAG,EAAE,CACH,YAAY,CAAC;gBACX,KAAK,EAAE;oBACL,IAAI;oBACJ,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;iBACtB;aACF,CAAC,CACL,CAAC;YAEF,MAAM,SAAS,GAAG,iBAAiB,CACjC,KAAK,EACL,IAAI,CAAC,IAAI,EACT,IAAI,EACJ,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,OAAO,CACb,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE;gBAC5C,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI;gBACJ,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,KAAK,CAAC,MAAM;aACxB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;aACtD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,iCAAiC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1G,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE;gBAC3C,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI;gBACJ,KAAK,EAAE,OAAO;aACf,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/status.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerStatusTool(server: McpServer): void;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqB1D"}

package/dist/tools/status.js

@@ -0,0 +1,19 @@
+import { checkCfbdStatus } from "../cfbd-client.js";
+import { logger } from "../logger.js";
+export function registerStatusTool(server) {
+    server.registerTool("cfbd_status", {
+        title: "CFBD Status",
+        description: "Check CFBD API connectivity and authentication status",
+    }, async () => {
+        const result = await checkCfbdStatus();
+        logger.info("cfbd_status tool invoked", {
+            ok: result.ok,
+            message: result.message,
+        });
+        return {
+            content: [{ type: "text", text: result.message }],
+            isError: !result.ok,
+        };
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/tools/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,uDAAuD;KAC1D,EACD,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;YACtC,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YAC1D,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE;SACpB,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,36 @@
+export interface Word {
+    word: string;
+    start: number | null;
+    end: number | null;
+    score: number | null;
+    speaker: string | null;
+}
+export interface Segment {
+    start: number;
+    end: number;
+    text: string;
+    words: Word[];
+    speaker: string | null;
+}
+export interface Chapter {
+    title: string;
+    start: number;
+    end: number;
+}
+export interface ClipCandidate {
+    title: string;
+    start: number;
+    end: number;
+    excerpt: string;
+    reasoning: string;
+    status?: string;
+}
+export interface Transcript {
+    version: string;
+    language: string;
+    segments: Segment[];
+    chapters: Chapter[];
+    clip_candidates?: ClipCandidate[];
+    metadata: Record<string, unknown> | null;
+}
+//# sourceMappingURL=transcript-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-types.d.ts","sourceRoot":"","sources":["../../src/tools/transcript-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C"}

package/dist/tools/transcript-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transcript-types.js.map

package/dist/tools/transcript-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-types.js","sourceRoot":"","sources":["../../src/tools/transcript-types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,40 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface ChapterInput {
+    title: string;
+    start: number;
+    end: number;
+}
+/**
+ * Validate chapters against YouTube format constraints.
+ * - First chapter must start at 0:00 (within 0.5s tolerance for segment alignment)
+ * - Minimum 3 chapters required
+ * - Each chapter must be at least 10 seconds long
+ * - Chapters must be in ascending order by start time
+ */
+export declare function validateChapters(chapters: ChapterInput[]): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Format seconds as YouTube chapter timestamp.
+ * Short form (M:SS): "0:00", "1:23", "45:30"
+ * Long form (H:MM:SS): "0:00:00", "1:02:15"
+ */
+export declare function formatChapterTimestamp(seconds: number, isLongForm: boolean): string;
+/**
+ * Format chapters as YouTube chapter list.
+ * Auto-detects long form if any chapter.end exceeds 3600 seconds.
+ * Output: "0:00 Title\n1:23 Next Topic\n..."
+ */
+export declare function formatYouTubeChapters(chapters: ChapterInput[]): string;
+/**
+ * Validate chapters, persist to transcript JSON, and return YouTube-formatted output.
+ * Reads the existing transcript, replaces only the chapters field, writes back.
+ */
+export declare function writeChapters(transcriptPath: string, chapters: ChapterInput[]): {
+    success: boolean;
+    message: string;
+    youtubeChapters?: string;
+};
+export declare function registerWriteChaptersTool(server: McpServer): void;
+//# sourceMappingURL=write-chapters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-chapters.d.ts","sourceRoot":"","sources":["../../src/tools/write-chapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EAAE,GACvB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAgCtC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,OAAO,GAClB,MAAM,CAYR;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CAMtE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,YAAY,EAAE,GACvB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAiCjE;AAiBD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0CjE"}

package/dist/tools/write-chapters.js

@@ -0,0 +1,143 @@
+import { z } from "zod";
+import { readFileSync, writeFileSync } from "node:fs";
+import { logger } from "../logger.js";
+/**
+ * Validate chapters against YouTube format constraints.
+ * - First chapter must start at 0:00 (within 0.5s tolerance for segment alignment)
+ * - Minimum 3 chapters required
+ * - Each chapter must be at least 10 seconds long
+ * - Chapters must be in ascending order by start time
+ */
+export function validateChapters(chapters) {
+    const errors = [];
+    if (chapters.length < 3) {
+        errors.push("Minimum 3 chapters required for YouTube chapters");
+    }
+    if (chapters.length > 0 && chapters[0].start > 0.5) {
+        errors.push("First chapter must start at 0:00 (within 0.5s tolerance)");
+    }
+    for (let i = 0; i < chapters.length; i++) {
+        const chapter = chapters[i];
+        const duration = chapter.end - chapter.start;
+        if (duration < 10) {
+            errors.push(`Chapter "${chapter.title}" is ${duration.toFixed(1)}s — minimum 10 seconds required`);
+        }
+    }
+    for (let i = 1; i < chapters.length; i++) {
+        if (chapters[i].start < chapters[i - 1].start) {
+            errors.push(`Chapters must be in ascending order: "${chapters[i].title}" (${chapters[i].start}s) comes after "${chapters[i - 1].title}" (${chapters[i - 1].start}s)`);
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Format seconds as YouTube chapter timestamp.
+ * Short form (M:SS): "0:00", "1:23", "45:30"
+ * Long form (H:MM:SS): "0:00:00", "1:02:15"
+ */
+export function formatChapterTimestamp(seconds, isLongForm) {
+    const totalSecs = Math.floor(seconds);
+    const s = totalSecs % 60;
+    const totalMins = Math.floor(totalSecs / 60);
+    if (isLongForm) {
+        const m = totalMins % 60;
+        const h = Math.floor(totalMins / 60);
+        return `${h}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`;
+    }
+    return `${totalMins}:${String(s).padStart(2, "0")}`;
+}
+/**
+ * Format chapters as YouTube chapter list.
+ * Auto-detects long form if any chapter.end exceeds 3600 seconds.
+ * Output: "0:00 Title\n1:23 Next Topic\n..."
+ */
+export function formatYouTubeChapters(chapters) {
+    const isLongForm = chapters.some((ch) => ch.end > 3600);
+    return chapters
+        .map((ch) => `${formatChapterTimestamp(ch.start, isLongForm)} ${ch.title}`)
+        .join("\n");
+}
+/**
+ * Validate chapters, persist to transcript JSON, and return YouTube-formatted output.
+ * Reads the existing transcript, replaces only the chapters field, writes back.
+ */
+export function writeChapters(transcriptPath, chapters) {
+    const validation = validateChapters(chapters);
+    if (!validation.valid) {
+        return {
+            success: false,
+            message: `Chapter validation failed:\n${validation.errors.join("\n")}`,
+        };
+    }
+    try {
+        const raw = readFileSync(transcriptPath, "utf-8");
+        const transcript = JSON.parse(raw);
+        transcript.chapters = chapters.map((ch) => ({
+            title: ch.title,
+            start: ch.start,
+            end: ch.end,
+        }));
+        writeFileSync(transcriptPath, JSON.stringify(transcript, null, 2), "utf-8");
+        const youtubeChapters = formatYouTubeChapters(chapters);
+        return {
+            success: true,
+            message: `Wrote ${chapters.length} chapters to ${transcriptPath}`,
+            youtubeChapters,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `Failed to write chapters: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+const inputSchema = {
+    transcript_path: z
+        .string()
+        .describe("Path to the transcript JSON file"),
+    chapters: z
+        .array(z.object({
+        title: z.string().describe("Chapter title"),
+        start: z.number().describe("Start time in seconds"),
+        end: z.number().describe("End time in seconds"),
+    }))
+        .describe("Array of chapter objects with title, start, and end times"),
+};
+export function registerWriteChaptersTool(server) {
+    server.registerTool("write_chapters", {
+        title: "Write Chapters",
+        description: "Validates YouTube chapter format constraints and writes chapters to the transcript JSON. " +
+            "Returns YouTube-formatted chapter list for pasting into video description.",
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        inputSchema: inputSchema,
+    }, (args) => {
+        try {
+            const result = writeChapters(args.transcript_path, args.chapters);
+            logger.info("write_chapters tool invoked", {
+                transcript_path: args.transcript_path,
+                chapter_count: args.chapters.length,
+                success: result.success,
+            });
+            if (!result.success) {
+                return {
+                    content: [{ type: "text", text: result.message }],
+                    isError: true,
+                };
+            }
+            const text = `${result.message}\n\nYouTube Chapters:\n${result.youtubeChapters}`;
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            const message = `Failed to write chapters: ${error instanceof Error ? error.message : String(error)}`;
+            logger.error("write_chapters tool error", { error: message });
+            return {
+                content: [{ type: "text", text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=write-chapters.js.map