sourceloop 0.1.1

package/dist/core/ingest/ingest-source.js.map

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

package/dist/core/notebooklm/adapter.d.ts

@@ -0,0 +1,17 @@
+import type { NotebookBinding } from "../../schemas/notebook.js";
+import type { PlannedQuestion, CitationReference } from "../../schemas/run.js";
+export type NotebookRunnerAnswer = {
+    answer: string;
+    citations: CitationReference[];
+    answerSource: "notebooklm";
+};
+export type NotebookRunnerExecutionMetadata = {
+    executionMode?: "attached_chrome" | "fixture";
+    attachedChromeTargetId?: string;
+};
+export interface NotebookRunnerAdapter {
+    readonly kind: "browser-agent" | "fixture";
+    prepareRun?(binding: NotebookBinding): Promise<NotebookRunnerExecutionMetadata | void>;
+    askQuestion(binding: NotebookBinding, question: PlannedQuestion): Promise<NotebookRunnerAnswer>;
+    dispose?(): Promise<void>;
+}

package/dist/core/notebooklm/adapter.js

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

package/dist/core/notebooklm/adapter.js.map

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

package/dist/core/notebooklm/auth.d.ts

@@ -0,0 +1,30 @@
+export type NotebookAuthProfileStatus = {
+    profile: string;
+    authenticated: boolean;
+    stateFilePath: string;
+    profileDirPath: string;
+    stateAgeHours?: number;
+};
+export type SetupNotebookAuthInput = {
+    profile?: string;
+    cwd?: string;
+    timeoutMinutes?: number;
+};
+export declare function setupNotebookAuth(input: SetupNotebookAuthInput): Promise<NotebookAuthProfileStatus>;
+export declare function clearNotebookAuth(input: {
+    profile?: string;
+    cwd?: string;
+}): Promise<NotebookAuthProfileStatus>;
+export declare function getNotebookAuthStatus(input: {
+    cwd?: string;
+    rootDir?: string;
+    profile?: string;
+}): Promise<NotebookAuthProfileStatus>;
+export declare function readNotebookStorageState(rootDir: string, profile: string): Promise<string>;
+export declare function getNotebookAuthPaths(rootDir: string, profile: string): {
+    profile: string;
+    profileRootPath: string;
+    profileDirPath: string;
+    stateFilePath: string;
+    authInfoPath: string;
+};

package/dist/core/notebooklm/auth.js

@@ -0,0 +1,105 @@
+import { access, mkdir, rm, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { chromium } from "playwright";
+import { loadWorkspace } from "../workspace/load-workspace.js";
+import { NOTEBOOKLM_DEFAULT_URL } from "./config.js";
+export async function setupNotebookAuth(input) {
+    const workspace = await loadWorkspace(input.cwd);
+    const profile = input.profile ?? "default";
+    const paths = getNotebookAuthPaths(workspace.rootDir, profile);
+    await mkdir(paths.profileDirPath, { recursive: true });
+    const context = await chromium.launchPersistentContext(paths.profileDirPath, {
+        channel: "chrome",
+        headless: false,
+        viewport: null,
+        ignoreDefaultArgs: ["--enable-automation"]
+    });
+    try {
+        const page = await openNotebookPage(context, NOTEBOOKLM_DEFAULT_URL);
+        await page.waitForURL(/^https:\/\/notebooklm\.google\.com\//, {
+            timeout: (input.timeoutMinutes ?? 10) * 60 * 1000
+        });
+        await context.storageState({ path: paths.stateFilePath });
+        await writeFile(paths.authInfoPath, JSON.stringify({ authenticatedAt: new Date().toISOString() }, null, 2) + "\n");
+        return getNotebookAuthStatus({ rootDir: workspace.rootDir, profile });
+    }
+    finally {
+        await context.close();
+    }
+}
+async function openNotebookPage(context, url) {
+    let page = await context.newPage();
+    try {
+        await page.goto(url, { waitUntil: "domcontentloaded" });
+        return page;
+    }
+    catch (error) {
+        await page.close().catch(() => undefined);
+        if (!(error instanceof Error) || !error.message.includes("ERR_INVALID_ARGUMENT")) {
+            throw error;
+        }
+        page = await context.newPage();
+        await page.goto(url, { waitUntil: "domcontentloaded" });
+        return page;
+    }
+}
+export async function clearNotebookAuth(input) {
+    const workspace = await loadWorkspace(input.cwd);
+    const profile = input.profile ?? "default";
+    const paths = getNotebookAuthPaths(workspace.rootDir, profile);
+    await rm(paths.profileRootPath, { recursive: true, force: true });
+    return {
+        profile,
+        authenticated: false,
+        stateFilePath: paths.stateFilePath,
+        profileDirPath: paths.profileDirPath
+    };
+}
+export async function getNotebookAuthStatus(input) {
+    const rootDir = input.rootDir ?? (await loadWorkspace(input.cwd)).rootDir;
+    const profile = input.profile ?? "default";
+    const paths = getNotebookAuthPaths(rootDir, profile);
+    const exists = await fileExists(paths.stateFilePath);
+    if (!exists) {
+        return {
+            profile,
+            authenticated: false,
+            stateFilePath: paths.stateFilePath,
+            profileDirPath: paths.profileDirPath
+        };
+    }
+    const stateStat = await stat(paths.stateFilePath);
+    return {
+        profile,
+        authenticated: true,
+        stateFilePath: paths.stateFilePath,
+        profileDirPath: paths.profileDirPath,
+        stateAgeHours: (Date.now() - stateStat.mtimeMs) / 1000 / 60 / 60
+    };
+}
+export async function readNotebookStorageState(rootDir, profile) {
+    const paths = getNotebookAuthPaths(rootDir, profile);
+    await access(paths.stateFilePath);
+    return paths.stateFilePath;
+}
+export function getNotebookAuthPaths(rootDir, profile) {
+    const profileSlug = profile.trim() || "default";
+    const baseDir = path.join(rootDir, ".sourceloop", "notebooklm", profileSlug);
+    return {
+        profile,
+        profileRootPath: baseDir,
+        profileDirPath: path.join(baseDir, "profile"),
+        stateFilePath: path.join(baseDir, "state.json"),
+        authInfoPath: path.join(baseDir, "auth-info.json")
+    };
+}
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/core/notebooklm/auth.js.map

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

package/dist/core/notebooklm/browser-agent-adapter.d.ts

@@ -0,0 +1,21 @@
+import type { ChromeAttachTarget } from "../../schemas/attach.js";
+import type { NotebookBinding } from "../../schemas/notebook.js";
+import type { PlannedQuestion } from "../../schemas/run.js";
+import type { NotebookRunnerAdapter, NotebookRunnerAnswer } from "./adapter.js";
+import { type NotebookBrowserSessionFactory } from "./browser-agent.js";
+export declare class BrowserAgentNotebookRunnerAdapter implements NotebookRunnerAdapter {
+    private readonly options;
+    readonly kind: "browser-agent";
+    private session;
+    constructor(options: {
+        attachTarget: ChromeAttachTarget;
+        showBrowser?: boolean;
+        sessionFactory?: NotebookBrowserSessionFactory;
+    });
+    prepareRun(binding: NotebookBinding): Promise<{
+        executionMode: "attached_chrome";
+        attachedChromeTargetId: string;
+    }>;
+    askQuestion(binding: NotebookBinding, question: PlannedQuestion): Promise<NotebookRunnerAnswer>;
+    dispose(): Promise<void>;
+}

package/dist/core/notebooklm/browser-agent-adapter.js

@@ -0,0 +1,37 @@
+import { defaultNotebookBrowserSessionFactory } from "./browser-agent.js";
+export class BrowserAgentNotebookRunnerAdapter {
+    options;
+    kind = "browser-agent";
+    session;
+    constructor(options) {
+        this.options = options;
+    }
+    async prepareRun(binding) {
+        const sessionFactory = this.options.sessionFactory ?? defaultNotebookBrowserSessionFactory;
+        this.session = await sessionFactory.createSession({
+            target: this.options.attachTarget,
+            ...(this.options.showBrowser !== undefined ? { showBrowser: this.options.showBrowser } : {})
+        });
+        await this.session.preflight(binding.notebookUrl);
+        return {
+            executionMode: "attached_chrome",
+            attachedChromeTargetId: this.options.attachTarget.id
+        };
+    }
+    async askQuestion(binding, question) {
+        if (!this.session) {
+            throw new Error("Browser-agent adapter has no attached NotebookLM session. Call prepareRun() first.");
+        }
+        const response = await this.session.askQuestion(question);
+        return {
+            answer: response.answer,
+            citations: response.citations,
+            answerSource: "notebooklm"
+        };
+    }
+    async dispose() {
+        await this.session?.close();
+        this.session = undefined;
+    }
+}
+//# sourceMappingURL=browser-agent-adapter.js.map

package/dist/core/notebooklm/browser-agent-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-agent-adapter.js","sourceRoot":"","sources":["../../../src/core/notebooklm/browser-agent-adapter.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,oCAAoC,EAGrC,MAAM,oBAAoB,CAAC;AAE5B,MAAM,OAAO,iCAAiC;IAKzB;IAJV,IAAI,GAAG,eAAwB,CAAC;IACjC,OAAO,CAAqC;IAEpD,YACmB,OAIhB;QAJgB,YAAO,GAAP,OAAO,CAIvB;IACA,CAAC;IAEJ,KAAK,CAAC,UAAU,CAAC,OAAwB;QACvC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,oCAAoC,CAAC;QAC3F,IAAI,CAAC,OAAO,GAAG,MAAM,cAAc,CAAC,aAAa,CAAC;YAChD,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY;YACjC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7F,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAElD,OAAO;YACL,aAAa,EAAE,iBAA0B;YACzC,sBAAsB,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE;SACrD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAwB,EAAE,QAAyB;QACnE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,oFAAoF,CAAC,CAAC;QACxG,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAE1D,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,YAAY,EAAE,YAAY;SAC3B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC3B,CAAC;CACF"}

package/dist/core/notebooklm/browser-agent.d.ts

@@ -0,0 +1,121 @@
+import type { ChromeAttachTarget } from "../../schemas/attach.js";
+import type { ManagedNotebookImportStatus } from "../../schemas/managed-notebook.js";
+import type { CitationReference, PlannedQuestion } from "../../schemas/run.js";
+export type NotebookLMCitationOverflowCandidate = {
+    overflowId: string;
+    text?: string | null;
+    ariaLabel?: string | null;
+    title?: string | null;
+    className?: string | null;
+    dataTestId?: string | null;
+    selector?: string | null;
+    citationAdjacent?: boolean;
+};
+export declare function isLikelyCitationOverflowControl(candidate: {
+    text?: string | null;
+    ariaLabel?: string | null;
+    title?: string | null;
+    className?: string | null;
+    dataTestId?: string | null;
+    selector?: string | null;
+}): boolean;
+export declare function shouldExpandCitationOverflowControl(candidate: NotebookLMCitationOverflowCandidate): boolean;
+export declare function isLikelyNotebookLMCitationMarker(candidate: {
+    text?: string | null;
+    ariaLabel?: string | null;
+    dialogLabel?: string | null;
+    triggerDescription?: string | null;
+}): boolean;
+export declare function hasNotebookLMCitationSnippet(note?: string | null): boolean;
+export type ChromeAttachValidationCode = "chrome_unreachable" | "notebooklm_sign_in_required" | "notebooklm_preflight_failed";
+export declare class ChromeAttachValidationError extends Error {
+    readonly code: ChromeAttachValidationCode;
+    constructor(code: ChromeAttachValidationCode, message: string);
+}
+export type ManagedNotebookBrowserCreateResult = {
+    notebookUrl: string;
+};
+export type ManagedNotebookBrowserImportInput = ({
+    notebookUrl?: string;
+} & ({
+    importKind: "file_upload";
+    title: string;
+    sourceUri: string;
+    filePath: string;
+} | {
+    importKind: "youtube_url" | "web_url";
+    title: string;
+    sourceUri: string;
+    url: string;
+}));
+export type ManagedNotebookBrowserImportResult = {
+    status: ManagedNotebookImportStatus;
+    failureReason?: string;
+};
+export type NotebookLMImportSuccessCandidate = {
+    signature: string;
+    text: string;
+};
+export interface NotebookBrowserSession {
+    preflight(notebookUrl?: string): Promise<void>;
+    askQuestion(question: PlannedQuestion): Promise<{
+        answer: string;
+        citations: CitationReference[];
+    }>;
+    captureLatestAnswer(): Promise<{
+        answer: string;
+        citations: CitationReference[];
+    }>;
+    createNotebook(title: string): Promise<ManagedNotebookBrowserCreateResult>;
+    importSource(input: ManagedNotebookBrowserImportInput): Promise<ManagedNotebookBrowserImportResult>;
+    close(): Promise<void>;
+}
+export interface NotebookBrowserSessionFactory {
+    createSession(input: {
+        target: ChromeAttachTarget;
+        showBrowser?: boolean;
+        reuseExistingNotebookPage?: boolean;
+    }): Promise<NotebookBrowserSession>;
+}
+export declare function disposeNotebookBrowserSessionResources(input: {
+    closePage: () => Promise<unknown>;
+    closeBrowserConnection: () => Promise<unknown>;
+    ownsBrowserProcess: boolean;
+    killSpawnedProcess?: () => Promise<void> | void;
+}): Promise<void>;
+export declare function validateChromeAttachTarget(input: {
+    target: ChromeAttachTarget;
+    notebookUrl?: string;
+    showBrowser?: boolean;
+    sessionFactory?: NotebookBrowserSessionFactory;
+}): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    code: ChromeAttachValidationCode;
+    message: string;
+}>;
+export declare const defaultNotebookBrowserSessionFactory: NotebookBrowserSessionFactory;
+export declare function isNotebookPageMatch(currentUrl: string, notebookUrl: string): boolean;
+export declare function canonicalizeNotebookUrl(url: string): string;
+export declare function extractNotebookResourceId(url: string): string | undefined;
+export declare function ensureNotebookTargetMatch(currentUrl: string, notebookUrl: string): void;
+export declare function resolveChromeExecutablePath(customPath?: string): Promise<string>;
+export declare function allocateFreePort(): Promise<number>;
+export declare function waitForRemoteDebuggingEndpoint(endpoint: string, timeoutMs: number): Promise<void>;
+export declare function shouldTreatCitationMetadataAsSettled(input: {
+    signature: string;
+    latestSignature: string;
+    stableCount: number;
+    emptyStableCount: number;
+}): {
+    stableCount: number;
+    emptyStableCount: number;
+    settled: boolean;
+};
+export declare function countRichNotebookLMCitations(citations: CitationReference[]): number;
+export declare function shouldRetryNotebookLMCitationCapture(citations: CitationReference[]): boolean;
+export declare function parseNotebookSourceCount(text: string): number | undefined;
+export declare function didImportIncreaseVisibleSourceCount(baselineSourceCount: number | undefined, currentSourceCount: number | undefined): boolean;
+export declare function getManagedImportSuccessNeedles(input: ManagedNotebookBrowserImportInput): string[];
+export declare function didImportProduceNewMatchingCandidate(baselineCandidates: NotebookLMImportSuccessCandidate[], currentCandidates: NotebookLMImportSuccessCandidate[], input: ManagedNotebookBrowserImportInput): boolean;