Fast-Craft
diff --git a/‎CHANGELOG.md‎
Lines changed: 14 additions & 0 deletions b/‎CHANGELOG.md‎
Lines changed: 14 additions & 0 deletions
diff --git a/‎CLAUDE.md‎
Lines changed: 4 additions & 1 deletion b/‎CLAUDE.md‎
Lines changed: 4 additions & 1 deletion
diff --git a/‎docs/cli-reference.md‎
Lines changed: 3 additions & 0 deletions b/‎docs/cli-reference.md‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎docs/python-api.md‎
Lines changed: 68 additions & 3 deletions b/‎docs/python-api.md‎
Lines changed: 68 additions & 3 deletions
diff --git a/‎src/notebooklm/__init__.py‎
Lines changed: 4 additions & 0 deletions b/‎src/notebooklm/__init__.py‎
Lines changed: 4 additions & 0 deletions
@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+- **Source fulltext extraction** - Retrieve the complete indexed text content of any source
+  - New `client.sources.get_fulltext(notebook_id, source_id)` Python API
+  - New `source fulltext <source_id>` CLI command with `--json` and `-o` output options
+  - Returns `SourceFulltext` dataclass with content, title, URL, and character count
+- **Chat citation references** - Get detailed source references for chat answers
+  - `AskResult.references` field contains list of `ChatReference` objects
+  - Each reference includes `source_id`, `cited_text`, `start_char`, `end_char`, `chunk_id`
+  - Use `notebooklm ask "question" --json` to see references in CLI output
+- **Source status helper** - New `source_status_to_str()` function for consistent status display
+
+### Changed
+- **Pre-commit checks** - Added mypy type checking to required pre-commit workflow
+
 ## [0.1.4] - 2026-01-11
 
 ### Added
 
@@ -45,13 +45,16 @@ ruff format src/ tests/
 # Check for linting issues
 ruff check src/ tests/
 
+# Type checking with mypy
+mypy src/notebooklm --ignore-missing-imports
+
 # Run tests
 pytest
 ```
 
 Or use this one-liner:
 ```bash
-ruff format src/ tests/ && ruff check src/ tests/ && pytest
+ruff format src/ tests/ && ruff check src/ tests/ && mypy src/notebooklm --ignore-missing-imports && pytest
 ```
 
 ## Architecture
 
@@ -61,6 +61,7 @@ See [Configuration](configuration.md) for details on environment variables and C
 |---------|-------------|---------|
 | `ask <question>` | Ask a question | `notebooklm ask "What is this about?"` |
 | `ask -s <id>` | Ask using specific sources | `notebooklm ask "Summarize" -s src1 -s src2` |
+| `ask --json` | Get answer with source references | `notebooklm ask "Explain X" --json` |
 | `configure` | Set persona/mode | `notebooklm configure --mode learning-guide` |
 | `history` | View/clear history | `notebooklm history --clear` |
 
@@ -73,6 +74,8 @@ See [Configuration](configuration.md) for details on environment variables and C
 | `add-drive <id> <title>` | Drive file ID | - | `source add-drive abc123 "Doc"` |
 | `add-research <query>` | Search query | `--mode [fast|deep]`, `--from [web|drive]`, `--import-all`, `--no-wait` | `source add-research "AI" --mode deep --no-wait` |
 | `get <id>` | Source ID | - | `source get src123` |
+| `fulltext <id>` | Source ID | `--json`, `-o FILE` | `source fulltext src123 -o content.txt` |
+| `guide <id>` | Source ID | `--json` | `source guide src123` |
 | `rename <id> <title>` | Source ID, new title | - | `source rename src123 "New Name"` |
 | `refresh <id>` | Source ID | - | `source refresh src123` |
 | `delete <id>` | Source ID | - | `source delete src123` |
 
@@ -209,6 +209,8 @@ await client.notebooks.share(nb.id, settings={"public": True})
 |--------|------------|---------|-------------|
 | `list(notebook_id)` | `notebook_id: str` | `list[Source]` | List sources |
 | `get(notebook_id, source_id)` | `str, str` | `Source` | Get source details |
+| `get_fulltext(notebook_id, source_id)` | `str, str` | `SourceFulltext` | Get full indexed text content |
+| `get_guide(notebook_id, source_id)` | `str, str` | `dict` | Get AI-generated summary and keywords |
 | `add_url(notebook_id, url)` | `str, str` | `Source` | Add URL source |
 | `add_youtube(notebook_id, url)` | `str, str` | `Source` | Add YouTube video |
 | `add_text(notebook_id, title, content)` | `str, str, str` | `Source` | Add text content |
@@ -233,6 +235,15 @@ for src in sources:
 
 await client.sources.rename(nb_id, src.id, "Better Title")
 await client.sources.refresh(nb_id, src.id)  # Re-fetch URL content
+
+# Get full indexed content (what NotebookLM uses for answers)
+fulltext = await client.sources.get_fulltext(nb_id, src.id)
+print(f"Content ({fulltext.char_count} chars): {fulltext.content[:500]}...")
+
+# Get AI-generated summary and keywords
+guide = await client.sources.get_guide(nb_id, src.id)
+print(f"Summary: {guide['summary']}")
+print(f"Keywords: {guide['keywords']}")
 ```
 
 ---
@@ -444,6 +455,10 @@ async def ask(
 result = await client.chat.ask(nb_id, "What are the main themes?")
 print(result.answer)
 
+# Access source references (cited in answer as [1], [2], etc.)
+for ref in result.references:
+    print(f"Citation {ref.citation_number}: Source {ref.source_id}")
+
 # Ask using only specific sources
 result = await client.chat.ask(
     nb_id,
@@ -620,9 +635,59 @@ class Artifact:
 ```python
 @dataclass
 class AskResult:
-    answer: str
-    conversation_id: str
-    sources_used: list[str]
+    answer: str                        # The answer text with inline citations [1], [2], etc.
+    conversation_id: str               # ID for follow-up questions
+    turn_number: int                   # Turn number in conversation
+    is_follow_up: bool                 # Whether this was a follow-up question
+    references: list[ChatReference]    # Source references cited in the answer
+    raw_response: str                  # First 1000 chars of raw API response
+
+@dataclass
+class ChatReference:
+    source_id: str                     # UUID of the source
+    citation_number: int | None        # Citation number in answer (1, 2, etc.)
+    cited_text: str | None             # Actual text passage being cited
+    start_char: int | None             # Start position in source content
+    end_char: int | None               # End position in source content
+    chunk_id: str | None               # Internal chunk ID (for debugging)
+```
+
+**Important:** The `cited_text` field often contains only a snippet or section header, not the full quoted passage. The `start_char`/`end_char` positions reference NotebookLM's internal chunked index, which does not directly correspond to positions in the raw fulltext returned by `get_fulltext()`.
+
+Use `SourceFulltext.find_citation_context()` to locate citations in the fulltext:
+
+```python
+fulltext = await client.sources.get_fulltext(notebook_id, ref.source_id)
+matches = fulltext.find_citation_context(ref.cited_text)  # Returns list[(context, position)]
+
+if matches:
+    context, pos = matches[0]  # First match
+    if len(matches) > 1:
+        print(f"Warning: {len(matches)} matches found, using first")
+else:
+    context = None  # Not found - may occur if source was modified
+```
+
+**Tip:** Cache `fulltext` when processing multiple citations from the same source to avoid repeated API calls.
+
+### SourceFulltext
+
+```python
+@dataclass
+class SourceFulltext:
+    source_id: str                     # UUID of the source
+    title: str                         # Source title
+    content: str                       # Full indexed text content
+    source_type: int | None            # Source type code
+    url: str | None                    # Original URL (if applicable)
+    char_count: int                    # Character count
+
+    def find_citation_context(
+        self,
+        cited_text: str,
+        context_chars: int = 200,
+    ) -> list[tuple[str, int]]:
+        """Search for citation text, return list of (context, position) tuples."""
 ```
 
 ---
 
@@ -37,6 +37,7 @@
     AudioLength,
     ChatGoal,
     ChatMode,
+    ChatReference,
     ChatResponseLength,
     ConversationTurn,
     DriveMimeType,
@@ -56,6 +57,7 @@
     Source,
     # Exceptions
     SourceError,
+    SourceFulltext,
     SourceNotFoundError,
     SourceProcessingError,
     SourceStatus,
@@ -79,11 +81,13 @@
     "NotebookDescription",
     "SuggestedTopic",
     "Source",
+    "SourceFulltext",
     "Artifact",
     "GenerationStatus",
     "ReportSuggestion",
     "Note",
     "ConversationTurn",
+    "ChatReference",
     "AskResult",
     "ChatMode",
     # Exceptions