@jackwener/opencli 1.5.5 → 1.5.7

package/dist/clis/notebooklm/source-guide.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/notebooklm/source-guide.js

@@ -0,0 +1,44 @@
+import { cli, Strategy } from '../../registry.js';
+import { EmptyResultError } from '../../errors.js';
+import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
+import { ensureNotebooklmNotebookBinding, findNotebooklmSourceRow, getNotebooklmPageState, getNotebooklmSourceGuideViaRpc, listNotebooklmSourcesFromPage, listNotebooklmSourcesViaRpc, requireNotebooklmSession, } from './utils.js';
+cli({
+    site: NOTEBOOKLM_SITE,
+    name: 'source-guide',
+    description: 'Get the guide summary and keywords for one source in the currently opened NotebookLM notebook',
+    domain: NOTEBOOKLM_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [
+        {
+            name: 'source',
+            positional: true,
+            required: true,
+            help: 'Source id or title from the current notebook',
+        },
+    ],
+    columns: ['source_id', 'notebook_id', 'title', 'type', 'summary', 'keywords', 'source'],
+    func: async (page, kwargs) => {
+        await ensureNotebooklmNotebookBinding(page);
+        await requireNotebooklmSession(page);
+        const state = await getNotebooklmPageState(page);
+        if (state.kind !== 'notebook') {
+            throw new EmptyResultError('opencli notebooklm source-guide', 'Open a specific NotebookLM notebook tab first, then retry.');
+        }
+        const rpcRows = await listNotebooklmSourcesViaRpc(page).catch(() => []);
+        const rows = rpcRows.length > 0 ? rpcRows : await listNotebooklmSourcesFromPage(page);
+        if (rows.length === 0) {
+            throw new EmptyResultError('opencli notebooklm source-guide', 'No NotebookLM sources were found on the current page.');
+        }
+        const query = typeof kwargs.source === 'string' ? kwargs.source : String(kwargs.source ?? '');
+        const matched = findNotebooklmSourceRow(rows, query);
+        if (!matched) {
+            throw new EmptyResultError('opencli notebooklm source-guide', `Source "${query}" was not found in the current notebook.`);
+        }
+        const guide = await getNotebooklmSourceGuideViaRpc(page, matched).catch(() => null);
+        if (guide)
+            return [guide];
+        throw new EmptyResultError('opencli notebooklm source-guide', `NotebookLM guide was not available for source "${matched.title}".`);
+    },
+});

package/dist/clis/notebooklm/source-guide.test.d.ts

@@ -0,0 +1 @@
+import './source-guide.js';

package/dist/clis/notebooklm/source-guide.test.js

@@ -0,0 +1,104 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { mockListNotebooklmSourcesViaRpc, mockListNotebooklmSourcesFromPage, mockGetNotebooklmSourceGuideViaRpc, mockGetNotebooklmPageState, mockRequireNotebooklmSession, } = vi.hoisted(() => ({
+    mockListNotebooklmSourcesViaRpc: vi.fn(),
+    mockListNotebooklmSourcesFromPage: vi.fn(),
+    mockGetNotebooklmSourceGuideViaRpc: vi.fn(),
+    mockGetNotebooklmPageState: vi.fn(),
+    mockRequireNotebooklmSession: vi.fn(),
+}));
+vi.mock('./utils.js', async () => {
+    const actual = await vi.importActual('./utils.js');
+    return {
+        ...actual,
+        listNotebooklmSourcesViaRpc: mockListNotebooklmSourcesViaRpc,
+        listNotebooklmSourcesFromPage: mockListNotebooklmSourcesFromPage,
+        getNotebooklmSourceGuideViaRpc: mockGetNotebooklmSourceGuideViaRpc,
+        getNotebooklmPageState: mockGetNotebooklmPageState,
+        requireNotebooklmSession: mockRequireNotebooklmSession,
+    };
+});
+import { getRegistry } from '../../registry.js';
+import './source-guide.js';
+describe('notebooklm source-guide', () => {
+    const command = getRegistry().get('notebooklm/source-guide');
+    beforeEach(() => {
+        mockListNotebooklmSourcesViaRpc.mockReset();
+        mockListNotebooklmSourcesFromPage.mockReset();
+        mockGetNotebooklmSourceGuideViaRpc.mockReset();
+        mockGetNotebooklmPageState.mockReset();
+        mockRequireNotebooklmSession.mockReset();
+        mockRequireNotebooklmSession.mockResolvedValue(undefined);
+        mockGetNotebooklmPageState.mockResolvedValue({
+            url: 'https://notebooklm.google.com/notebook/nb-demo',
+            title: 'Browser Automation',
+            hostname: 'notebooklm.google.com',
+            kind: 'notebook',
+            notebookId: 'nb-demo',
+            loginRequired: false,
+            notebookCount: 1,
+        });
+    });
+    it('returns source guide for a source matched from rpc source rows', async () => {
+        mockListNotebooklmSourcesViaRpc.mockResolvedValue([
+            {
+                id: 'src-yt',
+                notebook_id: 'nb-demo',
+                title: 'Video Source',
+                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                source: 'rpc',
+                type: 'youtube',
+                type_code: 9,
+            },
+        ]);
+        mockGetNotebooklmSourceGuideViaRpc.mockResolvedValue({
+            source_id: 'src-yt',
+            notebook_id: 'nb-demo',
+            title: 'Video Source',
+            type: 'youtube',
+            summary: 'Guide summary.',
+            keywords: ['AI', 'agents'],
+            source: 'rpc',
+        });
+        const result = await command.func({}, { source: 'src-yt' });
+        expect(result).toEqual([
+            {
+                source_id: 'src-yt',
+                notebook_id: 'nb-demo',
+                title: 'Video Source',
+                type: 'youtube',
+                summary: 'Guide summary.',
+                keywords: ['AI', 'agents'],
+                source: 'rpc',
+            },
+        ]);
+    });
+    it('matches by title from dom rows when rpc source list is unavailable', async () => {
+        mockListNotebooklmSourcesViaRpc.mockResolvedValue([]);
+        mockListNotebooklmSourcesFromPage.mockResolvedValue([
+            {
+                id: 'src-1',
+                notebook_id: 'nb-demo',
+                title: 'Example Source',
+                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                source: 'current-page',
+            },
+        ]);
+        mockGetNotebooklmSourceGuideViaRpc.mockResolvedValue({
+            source_id: 'src-1',
+            notebook_id: 'nb-demo',
+            title: 'Example Source',
+            type: null,
+            summary: 'Guide summary.',
+            keywords: ['topic'],
+            source: 'rpc',
+        });
+        const result = await command.func({}, { source: 'example source' });
+        expect(result).toEqual([
+            expect.objectContaining({
+                source_id: 'src-1',
+                title: 'Example Source',
+                summary: 'Guide summary.',
+            }),
+        ]);
+    });
+});

package/dist/clis/notebooklm/source-list.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/notebooklm/source-list.js

@@ -0,0 +1,30 @@
+import { cli, Strategy } from '../../registry.js';
+import { EmptyResultError } from '../../errors.js';
+import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
+import { ensureNotebooklmNotebookBinding, getNotebooklmPageState, listNotebooklmSourcesFromPage, listNotebooklmSourcesViaRpc, requireNotebooklmSession, } from './utils.js';
+cli({
+    site: NOTEBOOKLM_SITE,
+    name: 'source-list',
+    description: 'List sources for the currently opened NotebookLM notebook',
+    domain: NOTEBOOKLM_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [],
+    columns: ['title', 'id', 'type', 'size', 'created_at', 'updated_at', 'url', 'source'],
+    func: async (page) => {
+        await ensureNotebooklmNotebookBinding(page);
+        await requireNotebooklmSession(page);
+        const state = await getNotebooklmPageState(page);
+        if (state.kind !== 'notebook') {
+            throw new EmptyResultError('opencli notebooklm source-list', 'Open a specific NotebookLM notebook tab first, then retry.');
+        }
+        const rpcRows = await listNotebooklmSourcesViaRpc(page).catch(() => []);
+        if (rpcRows.length > 0)
+            return rpcRows;
+        const domRows = await listNotebooklmSourcesFromPage(page);
+        if (domRows.length > 0)
+            return domRows;
+        throw new EmptyResultError('opencli notebooklm source-list', 'No NotebookLM sources were found on the current page.');
+    },
+});

package/dist/clis/notebooklm/status.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/notebooklm/status.js

@@ -0,0 +1,31 @@
+import { cli, Strategy } from '../../registry.js';
+import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_HOME_URL, NOTEBOOKLM_SITE } from './shared.js';
+import { ensureNotebooklmNotebookBinding, getNotebooklmPageState } from './utils.js';
+cli({
+    site: NOTEBOOKLM_SITE,
+    name: 'status',
+    description: 'Check NotebookLM page availability and login state in the current Chrome session',
+    domain: NOTEBOOKLM_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [],
+    columns: ['status', 'login', 'page', 'url', 'title', 'notebooks'],
+    func: async (page) => {
+        await ensureNotebooklmNotebookBinding(page);
+        const currentUrl = await page.getCurrentUrl?.().catch(() => null);
+        if (!currentUrl || !currentUrl.includes(NOTEBOOKLM_DOMAIN)) {
+            await page.goto(NOTEBOOKLM_HOME_URL);
+            await page.wait(2);
+        }
+        const state = await getNotebooklmPageState(page);
+        return [{
+                status: state.hostname === NOTEBOOKLM_DOMAIN ? 'Connected' : 'Unavailable',
+                login: state.loginRequired ? 'Required' : 'OK',
+                page: state.kind,
+                url: state.url,
+                title: state.title,
+                notebooks: state.notebookCount,
+            }];
+    },
+});

package/dist/clis/notebooklm/summary.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/notebooklm/summary.js

@@ -0,0 +1,30 @@
+import { cli, Strategy } from '../../registry.js';
+import { EmptyResultError } from '../../errors.js';
+import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
+import { ensureNotebooklmNotebookBinding, getNotebooklmPageState, getNotebooklmSummaryViaRpc, readNotebooklmSummaryFromPage, requireNotebooklmSession, } from './utils.js';
+cli({
+    site: NOTEBOOKLM_SITE,
+    name: 'summary',
+    description: 'Get the summary block from the currently opened NotebookLM notebook',
+    domain: NOTEBOOKLM_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [],
+    columns: ['title', 'summary', 'source', 'url'],
+    func: async (page) => {
+        await ensureNotebooklmNotebookBinding(page);
+        await requireNotebooklmSession(page);
+        const state = await getNotebooklmPageState(page);
+        if (state.kind !== 'notebook') {
+            throw new EmptyResultError('opencli notebooklm summary', 'Open a specific NotebookLM notebook tab first, then retry.');
+        }
+        const domSummary = await readNotebooklmSummaryFromPage(page);
+        if (domSummary)
+            return [domSummary];
+        const rpcSummary = await getNotebooklmSummaryViaRpc(page).catch(() => null);
+        if (rpcSummary)
+            return [rpcSummary];
+        throw new EmptyResultError('opencli notebooklm summary', 'NotebookLM summary was not found on the current page.');
+    },
+});

package/dist/clis/notebooklm/summary.test.d.ts

@@ -0,0 +1 @@
+import './summary.js';

package/dist/clis/notebooklm/summary.test.js

@@ -0,0 +1,78 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { mockReadNotebooklmSummaryFromPage, mockGetNotebooklmSummaryViaRpc, mockGetNotebooklmPageState, mockRequireNotebooklmSession, } = vi.hoisted(() => ({
+    mockReadNotebooklmSummaryFromPage: vi.fn(),
+    mockGetNotebooklmSummaryViaRpc: vi.fn(),
+    mockGetNotebooklmPageState: vi.fn(),
+    mockRequireNotebooklmSession: vi.fn(),
+}));
+vi.mock('./utils.js', async () => {
+    const actual = await vi.importActual('./utils.js');
+    return {
+        ...actual,
+        readNotebooklmSummaryFromPage: mockReadNotebooklmSummaryFromPage,
+        getNotebooklmSummaryViaRpc: mockGetNotebooklmSummaryViaRpc,
+        getNotebooklmPageState: mockGetNotebooklmPageState,
+        requireNotebooklmSession: mockRequireNotebooklmSession,
+    };
+});
+import { getRegistry } from '../../registry.js';
+import './summary.js';
+describe('notebooklm summary', () => {
+    const command = getRegistry().get('notebooklm/summary');
+    beforeEach(() => {
+        mockReadNotebooklmSummaryFromPage.mockReset();
+        mockGetNotebooklmSummaryViaRpc.mockReset();
+        mockGetNotebooklmPageState.mockReset();
+        mockRequireNotebooklmSession.mockReset();
+        mockRequireNotebooklmSession.mockResolvedValue(undefined);
+        mockGetNotebooklmPageState.mockResolvedValue({
+            url: 'https://notebooklm.google.com/notebook/nb-demo',
+            title: 'Browser Automation',
+            hostname: 'notebooklm.google.com',
+            kind: 'notebook',
+            notebookId: 'nb-demo',
+            loginRequired: false,
+            notebookCount: 1,
+        });
+    });
+    it('returns the current notebook summary from the visible page first', async () => {
+        mockReadNotebooklmSummaryFromPage.mockResolvedValue({
+            notebook_id: 'nb-demo',
+            title: 'Browser Automation',
+            summary: 'A concise notebook summary.',
+            url: 'https://notebooklm.google.com/notebook/nb-demo',
+            source: 'summary-dom',
+        });
+        const result = await command.func({}, {});
+        expect(result).toEqual([
+            {
+                notebook_id: 'nb-demo',
+                title: 'Browser Automation',
+                summary: 'A concise notebook summary.',
+                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                source: 'summary-dom',
+            },
+        ]);
+        expect(mockGetNotebooklmSummaryViaRpc).not.toHaveBeenCalled();
+    });
+    it('falls back to rpc summary extraction when no visible summary block is found', async () => {
+        mockReadNotebooklmSummaryFromPage.mockResolvedValue(null);
+        mockGetNotebooklmSummaryViaRpc.mockResolvedValue({
+            notebook_id: 'nb-demo',
+            title: 'Browser Automation',
+            summary: 'Summary recovered from rpc.',
+            url: 'https://notebooklm.google.com/notebook/nb-demo',
+            source: 'rpc',
+        });
+        const result = await command.func({}, {});
+        expect(result).toEqual([
+            {
+                notebook_id: 'nb-demo',
+                title: 'Browser Automation',
+                summary: 'Summary recovered from rpc.',
+                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                source: 'rpc',
+            },
+        ]);
+    });
+});

package/dist/clis/notebooklm/utils.d.ts

@@ -0,0 +1,37 @@
+import type { IPage } from '../../types.js';
+import { type NotebooklmHistoryRow, type NotebooklmNotebookDetailRow, type NotebooklmNoteDetailRow, type NotebooklmNoteRow, type NotebooklmPageKind, type NotebooklmPageState, type NotebooklmRow, type NotebooklmSourceFulltextRow, type NotebooklmSourceGuideRow, type NotebooklmSourceRow, type NotebooklmSummaryRow } from './shared.js';
+export { buildNotebooklmRpcBody, extractNotebooklmRpcResult, fetchNotebooklmInPage, getNotebooklmPageAuth, parseNotebooklmChunkedResponse, stripNotebooklmAntiXssi, } from './rpc.js';
+export declare function parseNotebooklmIdFromUrl(url: string): string;
+export declare function classifyNotebooklmPage(url: string): NotebooklmPageKind;
+export declare function normalizeNotebooklmTitle(value: unknown, fallback?: string): string;
+type NotebooklmRawNoteRow = {
+    title?: string | null;
+    text?: string | null;
+};
+export declare function parseNotebooklmHistoryThreadIdsResult(result: unknown): string[];
+export declare function extractNotebooklmHistoryPreview(result: unknown): string | null;
+export declare function parseNotebooklmNoteListRawRows(rows: NotebooklmRawNoteRow[], notebookId: string, url: string): NotebooklmNoteRow[];
+export declare function parseNotebooklmListResult(result: unknown): NotebooklmRow[];
+export declare function parseNotebooklmNotebookDetailResult(result: unknown): NotebooklmNotebookDetailRow | null;
+export declare function parseNotebooklmSourceListResult(result: unknown): NotebooklmSourceRow[];
+export declare function parseNotebooklmSourceGuideResult(result: unknown, source: Pick<NotebooklmSourceRow, 'id' | 'notebook_id' | 'title' | 'type'>): NotebooklmSourceGuideRow | null;
+export declare function parseNotebooklmSourceFulltextResult(result: unknown, notebookId: string, fallbackUrl: string): NotebooklmSourceFulltextRow | null;
+export declare function findNotebooklmSourceRow(rows: NotebooklmSourceRow[], query: string): NotebooklmSourceRow | null;
+export declare function findNotebooklmNoteRow(rows: NotebooklmNoteRow[], query: string): NotebooklmNoteRow | null;
+export declare function listNotebooklmViaRpc(page: IPage): Promise<NotebooklmRow[]>;
+export declare function getNotebooklmDetailViaRpc(page: IPage): Promise<NotebooklmNotebookDetailRow | null>;
+export declare function listNotebooklmSourcesViaRpc(page: IPage): Promise<NotebooklmSourceRow[]>;
+export declare function listNotebooklmHistoryViaRpc(page: IPage): Promise<NotebooklmHistoryRow[]>;
+export declare function listNotebooklmNotesFromPage(page: IPage): Promise<NotebooklmNoteRow[]>;
+export declare function readNotebooklmSummaryFromPage(page: IPage): Promise<NotebooklmSummaryRow | null>;
+export declare function getNotebooklmSummaryViaRpc(page: IPage): Promise<NotebooklmSummaryRow | null>;
+export declare function getNotebooklmSourceFulltextViaRpc(page: IPage, sourceId: string): Promise<NotebooklmSourceFulltextRow | null>;
+export declare function getNotebooklmSourceGuideViaRpc(page: IPage, source: Pick<NotebooklmSourceRow, 'id' | 'notebook_id' | 'title' | 'type'>): Promise<NotebooklmSourceGuideRow | null>;
+export declare function readNotebooklmVisibleNoteFromPage(page: IPage): Promise<NotebooklmNoteDetailRow | null>;
+export declare function ensureNotebooklmHome(page: IPage): Promise<void>;
+export declare function ensureNotebooklmNotebookBinding(page: IPage): Promise<boolean>;
+export declare function getNotebooklmPageState(page: IPage): Promise<NotebooklmPageState>;
+export declare function readCurrentNotebooklm(page: IPage): Promise<NotebooklmRow | null>;
+export declare function listNotebooklmLinks(page: IPage): Promise<NotebooklmRow[]>;
+export declare function listNotebooklmSourcesFromPage(page: IPage): Promise<NotebooklmSourceRow[]>;
+export declare function requireNotebooklmSession(page: IPage): Promise<NotebooklmPageState>;