@zenalexa/unicli 0.207.1

package/dist/adapters/youtube/channel.js

@@ -0,0 +1,39 @@
+/**
+ * YouTube channel info — retrieve channel metadata by channel ID.
+ *
+ * Uses InnerTube "browse" endpoint with browseId set to the channel ID.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { innertubeFetch } from "./innertube.js";
+cli({
+    site: "youtube",
+    name: "channel",
+    description: "Get YouTube channel info",
+    domain: "www.youtube.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "channelId",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "YouTube channel ID (e.g. UCxxxxxx)",
+        },
+    ],
+    columns: ["name", "subscribers", "url"],
+    async func(_page, kwargs) {
+        const channelId = kwargs.channelId;
+        const data = (await innertubeFetch("browse", {
+            browseId: channelId,
+        }));
+        const meta = data.metadata?.channelMetadataRenderer ?? {};
+        const header = data.header?.c4TabbedHeaderRenderer ?? {};
+        return {
+            name: meta.title ?? "",
+            subscribers: header.subscriberCountText?.simpleText ?? "",
+            description: meta.description ?? "",
+            url: meta.channelUrl ?? `https://youtube.com/channel/${channelId}`,
+        };
+    },
+});
+//# sourceMappingURL=channel.js.map

package/dist/adapters/youtube/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../../src/adapters/youtube/channel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAiBhD,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,0BAA0B;IACvC,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,oCAAoC;SAClD;KACF;IACD,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM;QACtB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAmB,CAAC;QAE7C,MAAM,IAAI,GAAG,CAAC,MAAM,cAAc,CAAC,QAAQ,EAAE;YAC3C,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAoB,CAAC;QAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,uBAAuB,IAAI,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,sBAAsB,IAAI,EAAE,CAAC;QAEzD,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YACtB,WAAW,EAAE,MAAM,CAAC,mBAAmB,EAAE,UAAU,IAAI,EAAE;YACzD,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YACnC,GAAG,EAAE,IAAI,CAAC,UAAU,IAAI,+BAA+B,SAAS,EAAE;SACnE,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/adapters/youtube/comments.d.ts

@@ -0,0 +1,8 @@
+/**
+ * YouTube comments — retrieve top-level comments for a video.
+ *
+ * Uses InnerTube "next" endpoint which returns engagement panels
+ * including the comment section.
+ */
+export {};
+//# sourceMappingURL=comments.d.ts.map

package/dist/adapters/youtube/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/adapters/youtube/comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/adapters/youtube/comments.js

@@ -0,0 +1,62 @@
+/**
+ * YouTube comments — retrieve top-level comments for a video.
+ *
+ * Uses InnerTube "next" endpoint which returns engagement panels
+ * including the comment section.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { innertubeFetch } from "./innertube.js";
+function extractComments(data) {
+    const endpoints = data.onResponseReceivedEndpoints ?? [];
+    const results = [];
+    for (const ep of endpoints) {
+        const items = ep.reloadContinuationItemsCommand?.continuationItems ??
+            ep.appendContinuationItemsAction?.continuationItems ??
+            [];
+        for (const section of items) {
+            const contents = section.itemSectionRenderer?.contents ?? [];
+            for (const thread of contents) {
+                const c = thread.commentThreadRenderer?.comment?.commentRenderer;
+                if (!c)
+                    continue;
+                results.push({
+                    author: c.authorText?.simpleText ?? "",
+                    text: c.contentText?.runs?.map((r) => r.text).join("") ?? "",
+                    likes: c.voteCount?.simpleText ?? "0",
+                    replies: c.replyCount ?? 0,
+                });
+            }
+        }
+    }
+    return results;
+}
+cli({
+    site: "youtube",
+    name: "comments",
+    description: "Get YouTube video comments",
+    domain: "www.youtube.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "videoId",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "YouTube video ID",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 20,
+            description: "Max comments to return",
+        },
+    ],
+    columns: ["author", "text", "likes", "replies"],
+    async func(_page, kwargs) {
+        const videoId = kwargs.videoId;
+        const limit = kwargs.limit ?? 20;
+        const data = (await innertubeFetch("next", { videoId }));
+        return extractComments(data).slice(0, limit);
+    },
+});
+//# sourceMappingURL=comments.js.map

package/dist/adapters/youtube/comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../../src/adapters/youtube/comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAkChD,SAAS,eAAe,CAAC,IAAkB;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,2BAA2B,IAAI,EAAE,CAAC;IACzD,MAAM,OAAO,GAAmC,EAAE,CAAC;IAEnD,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,KAAK,GACT,EAAE,CAAC,8BAA8B,EAAE,iBAAiB;YACpD,EAAE,CAAC,6BAA6B,EAAE,iBAAiB;YACnD,EAAE,CAAC;QAEL,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,EAAE,QAAQ,IAAI,EAAE,CAAC;YAC7D,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,qBAAqB,EAAE,OAAO,EAAE,eAAe,CAAC;gBACjE,IAAI,CAAC,CAAC;oBAAE,SAAS;gBACjB,OAAO,CAAC,IAAI,CAAC;oBACX,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,UAAU,IAAI,EAAE;oBACtC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE;oBAC5D,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,UAAU,IAAI,GAAG;oBACrC,OAAO,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC;iBAC3B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,4BAA4B;IACzC,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,kBAAkB;SAChC;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,wBAAwB;SACtC;KACF;IACD,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM;QACtB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAiB,CAAC;QACzC,MAAM,KAAK,GAAI,MAAM,CAAC,KAAgB,IAAI,EAAE,CAAC;QAE7C,MAAM,IAAI,GAAG,CAAC,MAAM,cAAc,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAiB,CAAC;QAEzE,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC,CAAC"}

package/dist/adapters/youtube/innertube.d.ts

@@ -0,0 +1,8 @@
+/**
+ * YouTube InnerTube client — low-level API wrapper for YouTube's internal API.
+ *
+ * InnerTube is YouTube's internal RPC layer. Public endpoints don't require
+ * authentication for most read operations (search, player, browse, next).
+ */
+export declare function innertubeFetch(endpoint: string, body: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=innertube.d.ts.map

package/dist/adapters/youtube/innertube.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"innertube.d.ts","sourceRoot":"","sources":["../../../src/adapters/youtube/innertube.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAelB"}

package/dist/adapters/youtube/innertube.js

@@ -0,0 +1,32 @@
+/**
+ * YouTube InnerTube client — low-level API wrapper for YouTube's internal API.
+ *
+ * InnerTube is YouTube's internal RPC layer. Public endpoints don't require
+ * authentication for most read operations (search, player, browse, next).
+ */
+import { USER_AGENT } from "../../constants.js";
+const INNERTUBE_API_KEY = "AIzaSyAO_FJ2SlqU8Q4STEHLGCilw_Y9_11qcW8";
+const INNERTUBE_CLIENT = {
+    clientName: "WEB",
+    clientVersion: "2.20240101.00.00",
+    hl: "en",
+    gl: "US",
+};
+export async function innertubeFetch(endpoint, body) {
+    const url = `https://www.youtube.com/youtubei/v1/${endpoint}?key=${INNERTUBE_API_KEY}&prettyPrint=false`;
+    const resp = await fetch(url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "User-Agent": USER_AGENT,
+        },
+        body: JSON.stringify({
+            context: { client: INNERTUBE_CLIENT },
+            ...body,
+        }),
+    });
+    if (!resp.ok)
+        throw new Error(`YouTube API error: ${resp.status}`);
+    return resp.json();
+}
+//# sourceMappingURL=innertube.js.map

package/dist/adapters/youtube/innertube.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"innertube.js","sourceRoot":"","sources":["../../../src/adapters/youtube/innertube.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,iBAAiB,GAAG,yCAAyC,CAAC;AACpE,MAAM,gBAAgB,GAAG;IACvB,UAAU,EAAE,KAAK;IACjB,aAAa,EAAE,kBAAkB;IACjC,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;CACT,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgB,EAChB,IAA6B;IAE7B,MAAM,GAAG,GAAG,uCAAuC,QAAQ,QAAQ,iBAAiB,oBAAoB,CAAC;IACzG,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC5B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,YAAY,EAAE,UAAU;SACzB;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,OAAO,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE;YACrC,GAAG,IAAI;SACR,CAAC;KACH,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;AACrB,CAAC"}

package/dist/adapters/youtube/search.d.ts

@@ -0,0 +1,7 @@
+/**
+ * YouTube search — find videos by query.
+ *
+ * Uses InnerTube "search" endpoint with EgIQAQ%3D%3D param (video filter).
+ */
+export {};
+//# sourceMappingURL=search.d.ts.map

package/dist/adapters/youtube/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/adapters/youtube/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/adapters/youtube/search.js

@@ -0,0 +1,58 @@
+/**
+ * YouTube search — find videos by query.
+ *
+ * Uses InnerTube "search" endpoint with EgIQAQ%3D%3D param (video filter).
+ */
+import { cli, Strategy } from "../../registry.js";
+import { innertubeFetch } from "./innertube.js";
+function extractVideos(data) {
+    const sections = data.contents?.twoColumnSearchResultsRenderer?.primaryContents
+        ?.sectionListRenderer?.contents ?? [];
+    const items = sections[0]?.itemSectionRenderer?.contents ?? [];
+    return items
+        .filter((item) => item.videoRenderer?.videoId)
+        .map((item) => {
+        const v = item.videoRenderer;
+        const videoId = v.videoId ?? "";
+        return {
+            title: v.title?.runs?.map((r) => r.text).join("") ?? "",
+            channel: v.ownerText?.runs?.[0]?.text ?? "",
+            views: v.viewCountText?.simpleText ?? "",
+            videoId,
+            url: `https://youtube.com/watch?v=${videoId}`,
+        };
+    });
+}
+cli({
+    site: "youtube",
+    name: "search",
+    description: "Search YouTube videos",
+    domain: "www.youtube.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "query",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Search query",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 10,
+            description: "Max results to return",
+        },
+    ],
+    columns: ["title", "channel", "views", "videoId"],
+    async func(_page, kwargs) {
+        const query = kwargs.query;
+        const limit = kwargs.limit ?? 10;
+        const data = (await innertubeFetch("search", {
+            query,
+            params: "EgIQAQ%3D%3D", // video filter
+        }));
+        return extractVideos(data).slice(0, limit);
+    },
+});
+//# sourceMappingURL=search.js.map

package/dist/adapters/youtube/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/adapters/youtube/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA2BhD,SAAS,aAAa,CAAC,IAAoB;IACzC,MAAM,QAAQ,GACZ,IAAI,CAAC,QAAQ,EAAE,8BAA8B,EAAE,eAAe;QAC5D,EAAE,mBAAmB,EAAE,QAAQ,IAAI,EAAE,CAAC;IAE1C,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,QAAQ,IAAI,EAAE,CAAC;IAE/D,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC;SAC7C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,CAAC,GAAG,IAAI,CAAC,aAAc,CAAC;QAC9B,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;QAChC,OAAO;YACL,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE;YACvD,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE;YAC3C,KAAK,EAAE,CAAC,CAAC,aAAa,EAAE,UAAU,IAAI,EAAE;YACxC,OAAO;YACP,GAAG,EAAE,+BAA+B,OAAO,EAAE;SAC9C,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,uBAAuB;IACpC,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,cAAc;SAC5B;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,uBAAuB;SACrC;KACF;IACD,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM;QACtB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAe,CAAC;QACrC,MAAM,KAAK,GAAI,MAAM,CAAC,KAAgB,IAAI,EAAE,CAAC;QAE7C,MAAM,IAAI,GAAG,CAAC,MAAM,cAAc,CAAC,QAAQ,EAAE;YAC3C,KAAK;YACL,MAAM,EAAE,cAAc,EAAE,eAAe;SACxC,CAAC,CAAmB,CAAC;QAEtB,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;CACF,CAAC,CAAC"}

package/dist/adapters/youtube/transcript.d.ts

@@ -0,0 +1,10 @@
+/**
+ * YouTube transcript — retrieve video subtitles/captions.
+ *
+ * Strategy:
+ *   1. Use InnerTube "player" endpoint to get caption track URLs
+ *   2. Fetch the timedtext XML from the caption URL
+ *   3. Parse XML segments into { start, duration, text } entries
+ */
+export {};
+//# sourceMappingURL=transcript.d.ts.map

package/dist/adapters/youtube/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../src/adapters/youtube/transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/adapters/youtube/transcript.js

@@ -0,0 +1,87 @@
+/**
+ * YouTube transcript — retrieve video subtitles/captions.
+ *
+ * Strategy:
+ *   1. Use InnerTube "player" endpoint to get caption track URLs
+ *   2. Fetch the timedtext XML from the caption URL
+ *   3. Parse XML segments into { start, duration, text } entries
+ */
+import { USER_AGENT } from "../../constants.js";
+import { cli, Strategy } from "../../registry.js";
+import { innertubeFetch } from "./innertube.js";
+/** Parse timedtext XML into transcript segments */
+function parseTimedTextXml(xml) {
+    const segments = [];
+    const regex = /<text\s+start="([^"]*)"(?:\s+dur="([^"]*)")?[^>]*>([\s\S]*?)<\/text>/g;
+    let match;
+    while ((match = regex.exec(xml)) !== null) {
+        const text = (match[3] ?? "")
+            .replace(/&amp;/g, "&")
+            .replace(/&lt;/g, "<")
+            .replace(/&gt;/g, ">")
+            .replace(/&quot;/g, '"')
+            .replace(/&#39;/g, "'")
+            .replace(/<[^>]+>/g, "") // strip inline tags like <font>
+            .trim();
+        if (text) {
+            segments.push({
+                start: match[1] ?? "0",
+                duration: match[2] ?? "0",
+                text,
+            });
+        }
+    }
+    return segments;
+}
+cli({
+    site: "youtube",
+    name: "transcript",
+    description: "Get YouTube video transcript/subtitles",
+    domain: "www.youtube.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "videoId",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "YouTube video ID",
+        },
+        {
+            name: "lang",
+            type: "str",
+            default: "en",
+            description: "Language code (e.g. en, zh, ja)",
+        },
+    ],
+    columns: ["start", "duration", "text"],
+    async func(_page, kwargs) {
+        const videoId = kwargs.videoId;
+        const lang = kwargs.lang ?? "en";
+        // Step 1: Get caption tracks from player endpoint
+        const playerData = (await innertubeFetch("player", {
+            videoId,
+        }));
+        const tracks = playerData.captions?.playerCaptionsTracklistRenderer?.captionTracks ?? [];
+        if (tracks.length === 0) {
+            throw new Error(`No captions available for video ${videoId}`);
+        }
+        // Step 2: Find matching language track, fall back to first available
+        const track = tracks.find((t) => t.languageCode === lang) ?? tracks[0];
+        const captionUrl = track.baseUrl;
+        if (!captionUrl) {
+            throw new Error("Caption track has no URL");
+        }
+        // Step 3: Fetch timedtext XML
+        const resp = await fetch(captionUrl, {
+            headers: { "User-Agent": USER_AGENT },
+        });
+        if (!resp.ok) {
+            throw new Error(`Failed to fetch captions: ${resp.status}`);
+        }
+        const xml = await resp.text();
+        // Step 4: Parse and return segments
+        return parseTimedTextXml(xml);
+    },
+});
+//# sourceMappingURL=transcript.js.map

package/dist/adapters/youtube/transcript.js.map

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

package/dist/adapters/youtube/video.d.ts

@@ -0,0 +1,8 @@
+/**
+ * YouTube video info — retrieve metadata for a single video.
+ *
+ * Uses InnerTube "player" endpoint for rich metadata (title, description,
+ * view count, likes, duration, publish date).
+ */
+export {};
+//# sourceMappingURL=video.d.ts.map

package/dist/adapters/youtube/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../../../src/adapters/youtube/video.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/adapters/youtube/video.js

@@ -0,0 +1,44 @@
+/**
+ * YouTube video info — retrieve metadata for a single video.
+ *
+ * Uses InnerTube "player" endpoint for rich metadata (title, description,
+ * view count, likes, duration, publish date).
+ */
+import { cli, Strategy } from "../../registry.js";
+import { innertubeFetch } from "./innertube.js";
+cli({
+    site: "youtube",
+    name: "video",
+    description: "Get YouTube video info",
+    domain: "www.youtube.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "videoId",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "YouTube video ID",
+        },
+    ],
+    columns: ["title", "author", "views", "duration", "publishDate"],
+    async func(_page, kwargs) {
+        const videoId = kwargs.videoId;
+        const data = (await innertubeFetch("player", {
+            videoId,
+        }));
+        const details = data.videoDetails ?? {};
+        const micro = data.microformat?.playerMicroformatRenderer ?? {};
+        return {
+            title: details.title ?? "",
+            author: details.author ?? "",
+            description: details.shortDescription ?? "",
+            views: details.viewCount ?? "",
+            likes: micro.likes ?? null,
+            duration: details.lengthSeconds ?? "",
+            publishDate: micro.publishDate ?? "",
+            url: `https://youtube.com/watch?v=${videoId}`,
+        };
+    },
+});
+//# sourceMappingURL=video.js.map

package/dist/adapters/youtube/video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../../../src/adapters/youtube/video.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAkBhD,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,wBAAwB;IACrC,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,kBAAkB;SAChC;KACF;IACD,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM;QACtB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAiB,CAAC;QAEzC,MAAM,IAAI,GAAG,CAAC,MAAM,cAAc,CAAC,QAAQ,EAAE;YAC3C,OAAO;SACR,CAAC,CAAmB,CAAC;QAEtB,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,yBAAyB,IAAI,EAAE,CAAC;QAEhE,OAAO;YACL,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;YAC5B,WAAW,EAAE,OAAO,CAAC,gBAAgB,IAAI,EAAE;YAC3C,KAAK,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;YAC9B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;YAC1B,QAAQ,EAAE,OAAO,CAAC,aAAa,IAAI,EAAE;YACrC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;YACpC,GAAG,EAAE,+BAA+B,OAAO,EAAE;SAC9C,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/browser/bridge.d.ts

@@ -0,0 +1,63 @@
+/**
+ * BrowserBridge — high-level API for CLI commands to get a browser page
+ * via the daemon. Auto-spawns the daemon if not running.
+ *
+ * DaemonPage — IPage implementation that routes all operations through
+ * HTTP to the daemon, which forwards them to the Chrome Extension.
+ */
+import type { IPage, SnapshotOptions, ScreenshotOptions, NetworkRequest } from "../types.js";
+export declare class BrowserBridge {
+    private _page;
+    private _state;
+    connect(opts?: {
+        timeout?: number;
+        workspace?: string;
+    }): Promise<IPage>;
+    close(): Promise<void>;
+    private ensureDaemon;
+}
+export declare class DaemonPage implements IPage {
+    private readonly workspace;
+    constructor(workspace: string);
+    private cmdOpts;
+    goto(url: string, options?: {
+        settleMs?: number;
+        waitUntil?: string;
+    }): Promise<void>;
+    evaluate(script: string): Promise<unknown>;
+    wait(seconds: number): Promise<void>;
+    waitForSelector(selector: string, timeout?: number): Promise<void>;
+    waitFor(condition: number | string, timeout?: number): Promise<void>;
+    click(selector: string): Promise<void>;
+    type(selector: string, text: string): Promise<void>;
+    press(key: string, modifiers?: string[]): Promise<void>;
+    insertText(text: string): Promise<void>;
+    scroll(direction: "down" | "up" | "bottom" | "top"): Promise<void>;
+    autoScroll(opts?: {
+        maxScrolls?: number;
+        delay?: number;
+    }): Promise<void>;
+    nativeClick(x: number, y: number): Promise<void>;
+    nativeKeyPress(key: string, modifiers?: string[]): Promise<void>;
+    setFileInput(selector: string, files: string[]): Promise<void>;
+    cookies(): Promise<Record<string, string>>;
+    title(): Promise<string>;
+    url(): Promise<string>;
+    snapshot(opts?: SnapshotOptions): Promise<string>;
+    screenshot(opts?: ScreenshotOptions): Promise<Buffer>;
+    startNetworkCapture(pattern?: string): Promise<void>;
+    readNetworkCapture(): Promise<Array<{
+        url: string;
+        method: string;
+        status: number;
+        contentType: string;
+        size: number;
+        responseBody?: string;
+    }>>;
+    networkRequests(): Promise<NetworkRequest[]>;
+    addInitScript(source: string): Promise<void>;
+    sendCDP(method: string, params?: Record<string, unknown>, sessionId?: string): Promise<unknown>;
+    close(): Promise<void>;
+    closeWindow(): Promise<void>;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/browser/bridge.d.ts.map

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