notebooklm-api 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,42 @@
+# Changelog
+
+## 0.2.0 (2026-03-20)
+
+Fork of `notebooklm@0.1.1` by kaelen with extensive bug fixes and new features.
+
+### Bug Fixes
+
+- **Source status parsing**: Sources always showed "processing" even when ready. The GET_NOTEBOOK response wraps status in `[null, statusCode]` array — added array traversal to extract the actual code.
+- **Source list RPC method**: Changed from `hizoJc` (GET_SOURCE_FULLTEXT) to `rLM1Ne` (GET_NOTEBOOK) which actually returns sources.
+- **Source ID parsing**: GET_NOTEBOOK wraps source IDs as `["uuid"]` arrays — added unwrapping logic in `parseSourceItem`.
+- **Source list traversal**: `parseSourceList` now correctly finds sources at the right nesting level in the GET_NOTEBOOK response.
+- **addText RPC params**: Fixed parameter format from flat `[notebookId, title, content]` to correct nested array structure per Google's batchexecute protocol.
+- **addUrl RPC params**: Fixed parameter format for both regular URLs and YouTube URLs.
+- **Source delete params**: Fixed to use triple-nested sourceId `[[[sourceId]]]`.
+- **Generation status codes**: Fixed mapping — was `0=Pending, 1=InProgress, 2=Completed, 3=Error`, should be `1=Processing, 2=Pending, 3=Completed`.
+- **Artifact status parsing**: Status is at `item[4]` in the LIST_ARTIFACTS response, not `item[3]`.
+- **Artifact listing**: Added required `source-path=/notebook/{id}` URL parameter to `rpcCall` — without it, LIST_ARTIFACTS returns null.
+- **getStatus method**: Replaced fake `GET_GENERATION_STATUS` RPC (doesn't exist) with LIST_ARTIFACTS + find by ID.
+- **CREATE_ARTIFACT method ID**: Changed from `xpWGLf` to `R7cb6c`.
+- **generateReport**: Complete rewrite — fetches source IDs from notebook and builds correct nested params with source ID references.
+- **downloadReport**: Now reads `artifact.content` from LIST_ARTIFACTS response instead of returning empty string.
+
+### New Features
+
+- **Slide deck generation**: Added `generateSlideDeck()` API method and `notebooklm generate slide-deck` CLI command with `--prompt`, `--format` (detailed/presenter), and `--length` (default/short) options.
+- **Artifact download**: Added `notebooklm generate download <notebookId> <artifactId> <outputPath>` CLI command for downloading artifact content to files.
+- **rpcCall source-path**: Added optional `sourcePath` parameter to `rpcCall` for methods that require notebook context.
+
+### RPC Method Reference
+
+Correct method IDs (verified against [teng-lin/notebooklm-py](https://github.com/teng-lin/notebooklm-py)):
+
+| Method | ID | Notes |
+|--------|-----|-------|
+| GET_NOTEBOOK | `rLM1Ne` | Returns notebook + sources |
+| ADD_SOURCE | `izAoDd` | URL, text, YouTube |
+| DELETE_SOURCE | `tGMBJ` | Triple-nested source ID |
+| LIST_ARTIFACTS | `gArtLc` | Requires source-path |
+| CREATE_ARTIFACT | `R7cb6c` | All artifact types |
+| DELETE_ARTIFACT | `V5N4be` | |
+| EXPORT_ARTIFACT | `Krh3pd` | To Docs/Sheets |

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eric
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,113 @@
+# notebooklm-client
+
+Unofficial TypeScript/JavaScript client and CLI for the Google NotebookLM API.
+
+Fork of [`notebooklm`](https://www.npmjs.com/package/notebooklm) with extensive bug fixes (15+ RPC fixes) and new features (slide deck generation, artifact downloads). See [CHANGELOG.md](./CHANGELOG.md) for details.
+
+## Install
+
+```bash
+npm install -g notebooklm-client
+```
+
+## Authentication
+
+```bash
+notebooklm login
+```
+
+Opens a browser to authenticate with your Google account. Credentials are stored locally in `~/.notebooklm/`.
+
+## CLI Usage
+
+### Notebooks
+
+```bash
+notebooklm create "My Research"           # Create notebook
+notebooklm list                           # List all notebooks
+```
+
+### Sources
+
+```bash
+notebooklm source add-text <notebookId> -t "Title" -c "Content"
+notebooklm source add-url <notebookId> <url>
+notebooklm source list <notebookId>
+notebooklm source delete <notebookId> <sourceId>
+```
+
+### Generate Content
+
+```bash
+# Reports
+notebooklm generate report <notebookId> -p "Custom prompt" -w
+
+# Slide decks
+notebooklm generate slide-deck <notebookId> -p "Instructions" -f presenter -w
+
+# Audio/video overviews
+notebooklm generate audio <notebookId> -w
+notebooklm generate video <notebookId> -w
+
+# Check status
+notebooklm generate status <notebookId> <artifactId>
+
+# Download content
+notebooklm generate download <notebookId> <artifactId> output.md
+```
+
+### Research
+
+```bash
+notebooklm research fast <notebookId> "research query"
+notebooklm research deep <notebookId> "research query"
+```
+
+## Programmatic Usage
+
+```typescript
+import { NotebookLMClient } from 'notebooklm-client';
+
+const client = await NotebookLMClient.fromStorage();
+
+// Create notebook and add sources
+const notebook = await client.notebooks.create('Research');
+await client.sources.addText(notebook.id, 'Title', 'Content...');
+
+// Generate report
+const status = await client.artifacts.generateReport(notebook.id, {
+  customPrompt: 'Analyze the key findings...'
+});
+
+// Wait and download
+await client.artifacts.waitForGeneration(notebook.id, status.artifactId);
+const content = await client.artifacts.downloadReport(notebook.id, status.artifactId);
+
+// Generate slide deck
+const slides = await client.artifacts.generateSlideDeck(notebook.id, {
+  instructions: 'Create executive briefing...',
+  format: 'presenter',
+  length: 'default'
+});
+```
+
+## What's Fixed (vs `notebooklm@0.1.1`)
+
+- Source status always showing "processing" even when ready
+- Sources listing using wrong RPC method
+- `addText` / `addUrl` using wrong parameter formats
+- Artifact status codes mapped incorrectly
+- Artifact polling using nonexistent RPC method
+- Report generation using wrong method ID and params
+- Report download returning empty string
+- Missing `source-path` URL parameter on artifact calls
+
+## What's New
+
+- `generate slide-deck` command (ArtifactType 8)
+- `generate download` command for saving artifacts to files
+- Artifact content extraction from LIST_ARTIFACTS response
+
+## License
+
+MIT

package/dist/api/artifacts.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Artifacts API Module
+ *
+ * Handles AI-generated content like audio, video, reports, quizzes, etc.
+ */
+import { ClientCore } from '../core.ts';
+import { StudioContentType } from '../rpc/types.ts';
+import type { Artifact, GenerationStatus, AudioOptions, VideoOptions, ReportOptions, QuizOptions, FlashcardOptions, MindMapOptions } from '../types.ts';
+/**
+ * API client for artifact operations.
+ */
+export declare class ArtifactsAPI {
+    private core;
+    constructor(core: ClientCore);
+    /**
+     * Lists all artifacts in a notebook.
+     *
+     * @param notebookId - The notebook ID
+     * @param type - Optional filter by content type
+     * @returns List of artifacts
+     */
+    list(notebookId: string, type?: StudioContentType): Promise<Artifact[]>;
+    /**
+     * Gets a specific artifact by ID.
+     *
+     * @param notebookId - The notebook ID
+     * @param artifactId - The artifact ID
+     * @returns Artifact details
+     */
+    get(notebookId: string, artifactId: string): Promise<Artifact | null>;
+    /**
+     * Deletes an artifact.
+     *
+     * @param notebookId - The notebook ID
+     * @param artifactId - The artifact ID
+     */
+    delete(notebookId: string, artifactId: string): Promise<void>;
+    /**
+     * Renames an artifact.
+     *
+     * @param notebookId - The notebook ID
+     * @param artifactId - The artifact ID
+     * @param newTitle - The new title
+     */
+    rename(notebookId: string, artifactId: string, newTitle: string): Promise<void>;
+    /**
+     * Generates an audio overview (podcast).
+     *
+     * @param notebookId - The notebook ID
+     * @param options - Generation options
+     * @returns Generation status
+     */
+    generateAudio(notebookId: string, options?: AudioOptions): Promise<GenerationStatus>;
+    /**
+     * Generates a video overview.
+     *
+     * @param notebookId - The notebook ID
+     * @param options - Generation options
+     * @returns Generation status
+     */
+    generateVideo(notebookId: string, options?: VideoOptions): Promise<GenerationStatus>;
+    /**
+     * Generates a report.
+     *
+     * @param notebookId - The notebook ID
+     * @param options - Generation options
+     * @returns Generation status
+     */
+    generateReport(notebookId: string, options?: ReportOptions): Promise<GenerationStatus>;
+    /**
+     * Generates a quiz.
+     *
+     * @param notebookId - The notebook ID
+     * @param options - Generation options
+     * @returns Generation status
+     */
+    generateQuiz(notebookId: string, options?: QuizOptions): Promise<GenerationStatus>;
+    /**
+     * Generates flashcards.
+     *
+     * @param notebookId - The notebook ID
+     * @param options - Generation options
+     * @returns Generation status
+     */
+    generateFlashcards(notebookId: string, options?: FlashcardOptions): Promise<GenerationStatus>;
+    /**
+     * Generates a mind map.
+     *
+     * @param notebookId - The notebook ID
+     * @param options - Generation options
+     * @returns Generation status
+     */
+    generateMindMap(notebookId: string, options?: MindMapOptions): Promise<GenerationStatus>;
+    /**
+     * Gets the current generation status for an artifact.
+     *
+     * @param notebookId - The notebook ID
+     * @param artifactId - The artifact ID
+     * @returns Current status
+     */
+    getStatus(notebookId: string, artifactId: string): Promise<GenerationStatus>;
+    /**
+     * Waits for generation to complete.
+     *
+     * @param notebookId - The notebook ID
+     * @param artifactId - The artifact ID
+     * @param options - Polling options
+     * @returns Final generation status
+     */
+    waitForGeneration(notebookId: string, artifactId: string, options?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+    }): Promise<GenerationStatus>;
+    /**
+     * Downloads an audio artifact.
+     *
+     * @param notebookId - The notebook ID
+     * @param artifactId - The artifact ID
+     * @returns Audio content as Uint8Array
+     */
+    downloadAudio(notebookId: string, artifactId: string): Promise<Uint8Array>;
+    /**
+     * Downloads a video artifact.
+     *
+     * @param notebookId - The notebook ID
+     * @param artifactId - The artifact ID
+     * @returns Video content as Uint8Array
+     */
+    downloadVideo(notebookId: string, artifactId: string): Promise<Uint8Array>;
+    /**
+     * Downloads a report as markdown.
+     *
+     * @param notebookId - The notebook ID
+     * @param artifactId - The artifact ID
+     * @returns Report content as string
+     */
+    downloadReport(notebookId: string, artifactId: string): Promise<string>;
+    /**
+     * Exports a report to Google Docs.
+     *
+     * @param notebookId - The notebook ID
+     * @param artifactId - The artifact ID
+     * @returns Google Docs URL
+     */
+    exportToDocs(notebookId: string, artifactId: string): Promise<string>;
+    /**
+     * Exports a data table to Google Sheets.
+     *
+     * @param notebookId - The notebook ID
+     * @param artifactId - The artifact ID
+     * @returns Google Sheets URL
+     */
+    exportToSheets(notebookId: string, artifactId: string): Promise<string>;
+}
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/api/artifacts.d.ts.map

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

package/dist/api/chat.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Chat API Module
+ *
+ * Handles conversational interactions with notebooks.
+ */
+import { ClientCore } from '../core.ts';
+import { ChatMode } from '../rpc/types.ts';
+import type { AskResult, ConversationTurn, ChatConfig } from '../types.ts';
+/**
+ * API client for chat operations.
+ */
+export declare class ChatAPI {
+    private core;
+    constructor(core: ClientCore);
+    /**
+     * Asks a question to a notebook.
+     *
+     * @param notebookId - The notebook ID
+     * @param question - The question to ask
+     * @param options - Optional parameters
+     * @returns The answer with references
+     */
+    ask(notebookId: string, question: string, options?: {
+        conversationId?: string;
+        sourceIds?: string[];
+    }): Promise<AskResult>;
+    /**
+     * Gets conversation history from the API.
+     *
+     * @param notebookId - The notebook ID
+     * @param conversationId - The conversation ID
+     * @returns List of conversation turns
+     */
+    getHistory(notebookId: string, conversationId: string): Promise<ConversationTurn[]>;
+    /**
+     * Gets locally cached conversation turns.
+     *
+     * @param conversationId - The conversation ID
+     * @returns Cached turns
+     */
+    getCachedTurns(conversationId: string): ConversationTurn[];
+    /**
+     * Clears the conversation cache.
+     *
+     * @param conversationId - Optional specific conversation to clear
+     */
+    clearCache(conversationId?: string): void;
+    /**
+     * Configures chat persona and response settings.
+     *
+     * @param notebookId - The notebook ID
+     * @param config - Configuration options
+     */
+    configure(notebookId: string, config: ChatConfig): Promise<void>;
+    /**
+     * Applies a predefined chat mode.
+     *
+     * @param notebookId - The notebook ID
+     * @param mode - The chat mode to apply
+     */
+    setMode(notebookId: string, mode: ChatMode): Promise<void>;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/api/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/api/chat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAa,QAAQ,EAAkC,MAAM,iBAAiB,CAAC;AAEtF,OAAO,KAAK,EACV,SAAS,EAET,gBAAgB,EAChB,UAAU,EACX,MAAM,aAAa,CAAC;AAKrB;;GAEG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;OAOG;IACG,GAAG,CACP,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QACP,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,GACL,OAAO,CAAC,SAAS,CAAC;IA8CrB;;;;;;OAMG;IACG,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAW9B;;;;;OAKG;IACH,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAI1D;;;;OAIG;IACH,UAAU,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAIzC;;;;;OAKG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtE;;;;;OAKG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAQjE"}

package/dist/api/notebooks.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Notebooks API Module
+ *
+ * Handles notebook management operations.
+ */
+import { ClientCore } from '../core.ts';
+import type { Notebook, NotebookDescription } from '../types.ts';
+/**
+ * API client for notebook operations.
+ */
+export declare class NotebooksAPI {
+    private core;
+    constructor(core: ClientCore);
+    /**
+     * Lists all notebooks for the authenticated user.
+     */
+    list(): Promise<Notebook[]>;
+    /**
+     * Creates a new notebook.
+     *
+     * @param title - The title for the new notebook
+     * @returns The created notebook
+     */
+    create(title: string): Promise<Notebook>;
+    /**
+     * Gets detailed information about a notebook.
+     *
+     * @param notebookId - The notebook ID
+     * @returns Notebook details
+     */
+    get(notebookId: string): Promise<Notebook>;
+    /**
+     * Deletes a notebook.
+     *
+     * @param notebookId - The notebook ID to delete
+     */
+    delete(notebookId: string): Promise<void>;
+    /**
+     * Renames a notebook.
+     *
+     * @param notebookId - The notebook ID
+     * @param newTitle - The new title
+     */
+    rename(notebookId: string, newTitle: string): Promise<void>;
+    /**
+     * Gets the raw summary text for a notebook.
+     *
+     * @param notebookId - The notebook ID
+     * @returns Raw summary string
+     */
+    getSummary(notebookId: string): Promise<string>;
+    /**
+     * Gets the AI-generated description and suggested topics for a notebook.
+     *
+     * @param notebookId - The notebook ID
+     * @returns NotebookDescription with summary and topics
+     */
+    getDescription(notebookId: string): Promise<NotebookDescription>;
+    /**
+     * Gets the raw API response for a notebook.
+     * Useful for debugging or accessing data not in the typed interface.
+     *
+     * @param notebookId - The notebook ID
+     * @returns Raw response data
+     */
+    getRaw(notebookId: string): Promise<unknown>;
+    /**
+     * Shares or unshares a notebook.
+     *
+     * @param notebookId - The notebook ID
+     * @param isPublic - Whether to make public
+     * @param artifactId - Optional specific artifact to share
+     */
+    share(notebookId: string, isPublic: boolean, artifactId?: string): Promise<void>;
+    /**
+     * Gets the share URL for a notebook.
+     * This is a non-destructive operation that doesn't change sharing settings.
+     *
+     * @param notebookId - The notebook ID
+     * @param artifactId - Optional specific artifact
+     * @returns The share URL
+     */
+    getShareUrl(notebookId: string, artifactId?: string): Promise<string>;
+    /**
+     * Removes a notebook from the recent list.
+     *
+     * @param notebookId - The notebook ID
+     */
+    removeFromRecent(notebookId: string): Promise<void>;
+}
+//# sourceMappingURL=notebooks.d.ts.map

package/dist/api/notebooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebooks.d.ts","sourceRoot":"","sources":["../../src/api/notebooks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAkB,MAAM,aAAa,CAAC;AAKjF;;GAEG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IASjC;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAS9C;;;;;OAKG;IACG,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQhD;;;;OAIG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C;;;;;OAKG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjE;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYrD;;;;;OAKG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAUtE;;;;;;OAMG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD;;;;;;OAMG;IACG,KAAK,CACT,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,OAAO,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;;;;OAOG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY3E;;;;OAIG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK1D"}

package/dist/api/notes.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Notes API Module
+ *
+ * Handles user-created notes within notebooks.
+ */
+import { ClientCore } from '../core.ts';
+import type { Note } from '../types.ts';
+/**
+ * API client for note operations.
+ */
+export declare class NotesAPI {
+    private core;
+    constructor(core: ClientCore);
+    /**
+     * Lists all notes in a notebook.
+     *
+     * @param notebookId - The notebook ID
+     * @returns List of notes
+     */
+    list(notebookId: string): Promise<Note[]>;
+    /**
+     * Creates a new note.
+     *
+     * @param notebookId - The notebook ID
+     * @param title - Note title
+     * @param content - Note content
+     * @returns The created note
+     */
+    create(notebookId: string, title: string, content: string): Promise<Note>;
+    /**
+     * Updates an existing note.
+     *
+     * @param notebookId - The notebook ID
+     * @param noteId - The note ID
+     * @param title - New title
+     * @param content - New content
+     * @returns The updated note
+     */
+    update(notebookId: string, noteId: string, title: string, content: string): Promise<Note>;
+    /**
+     * Deletes a note.
+     *
+     * @param notebookId - The notebook ID
+     * @param noteId - The note ID
+     */
+    delete(notebookId: string, noteId: string): Promise<void>;
+    /**
+     * Gets a specific note by ID.
+     *
+     * @param notebookId - The notebook ID
+     * @param noteId - The note ID
+     * @returns The note or null if not found
+     */
+    get(notebookId: string, noteId: string): Promise<Note | null>;
+}
+//# sourceMappingURL=notes.d.ts.map

package/dist/api/notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.d.ts","sourceRoot":"","sources":["../../src/api/notes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAKxC;;GAEG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;OAKG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAS/C;;;;;;;OAOG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;;;;;OAQG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAahB;;;;;OAKG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D;;;;;;OAMG;IACG,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;CAIpE"}

package/dist/api/research.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Research API Module
+ *
+ * Handles web and Drive research functionality.
+ */
+import { ClientCore } from '../core.ts';
+import type { ResearchTask, ResearchResult, ResearchSource } from '../types.ts';
+/**
+ * API client for research operations.
+ */
+export declare class ResearchAPI {
+    private core;
+    constructor(core: ClientCore);
+    /**
+     * Starts a research session.
+     *
+     * @param notebookId - The notebook ID
+     * @param query - The research query
+     * @param options - Research options
+     * @returns Research task info
+     */
+    start(notebookId: string, query: string, options?: {
+        source?: 'web' | 'drive';
+        mode?: 'fast' | 'deep';
+    }): Promise<ResearchTask>;
+    /**
+     * Polls for research progress and results.
+     *
+     * @param notebookId - The notebook ID
+     * @param taskId - The task ID from start()
+     * @returns Current research status and results
+     */
+    poll(notebookId: string, taskId: string): Promise<ResearchResult>;
+    /**
+     * Imports discovered sources into the notebook.
+     *
+     * @param notebookId - The notebook ID
+     * @param sources - Sources to import (from poll results)
+     * @returns Imported source IDs
+     */
+    importSources(notebookId: string, sources: ResearchSource[]): Promise<string[]>;
+    /**
+     * Runs a complete research workflow.
+     *
+     * Starts research, polls until complete, and optionally imports sources.
+     *
+     * @param notebookId - The notebook ID
+     * @param query - The research query
+     * @param options - Research options
+     * @returns Final research results
+     */
+    research(notebookId: string, query: string, options?: {
+        source?: 'web' | 'drive';
+        mode?: 'fast' | 'deep';
+        autoImport?: boolean;
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+    }): Promise<{
+        result: ResearchResult;
+        importedSourceIds?: string[];
+    }>;
+}
+//# sourceMappingURL=research.d.ts.map

package/dist/api/research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../src/api/research.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIxC,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKhF;;GAEG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;OAOG;IACG,KAAK,CACT,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KACnB,GACL,OAAO,CAAC,YAAY,CAAC;IA6BxB;;;;;;OAMG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAWvE;;;;;;OAMG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EAAE,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC;IAoBpB;;;;;;;;;OASG;IACG,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;KACpB,GACL,OAAO,CAAC;QACT,MAAM,EAAE,cAAc,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;CAqCH"}