notebooklm
VerifiedInstall, authenticate, troubleshoot, and operate Gemini Notebook through the notebooklm-py CLI or typed async Python API. Use for notebook and source management, grounded chat and research, and artifact generation or download when the user mentions Gemini Notebook, notebooklm-py, the notebooklm CLI, or its Python API. Do not use for the generic Gemini API or unrelated content creation.
scripts/_live_auth_scenarios/storage_reload.py
View on GitHub"""Strict storage-only mid-session recovery (#2161).
Proves the Layer-2 *storage reload* rung is the one that recovers a client whose
live cookie jar was emptied mid-session: every external rung (refresh command,
headless re-auth, master token) is replaced with a poisoned stub, so the cell
fails loudly instead of quietly passing on a different rung.
The orchestrator additionally deletes ``master_token.json`` from the disposable
profile and blanks ``NOTEBOOKLM_REFRESH_BROWSER`` / ``NOTEBOOKLM_REFRESH_CMD`` /
``NOTEBOOKLM_REFRESH_CMD_MIDSESSION`` before launching this module.
Result contract: ``{"before", "after", "reload_calls", "live_cookies"}``.
"""
from __future__ import annotations
from typing import Any
from notebooklm import NotebookLMClient
from notebooklm._web.transport import session_auth as auth_session
from ._contract import ScenarioError, ScenarioResult, require, run_scenario
#: Disposable profile the orchestrator copies the source credentials into.
PROFILE = "mid-session-storage"
async def scenario() -> ScenarioResult:
"""Recover an emptied live jar from disk and prove no other rung ran."""
reload_calls = 0
original_reload = getattr(auth_session, "try_storage_cookie_reload", None)
if original_reload is None:
# The rung this cell exists to prove is gone; fail on the missing seam
# rather than on the "rung was not exercised" symptom further down.
raise ScenarioError("storage reload helper unavailable")
async def tracked_reload(*args: Any, **kwargs: Any) -> bool:
nonlocal reload_calls
reload_calls += 1
return await original_reload(*args, **kwargs)
async def forbidden(*args: object, **kwargs: object) -> bool:
raise AssertionError("external recovery rung reached")
auth_session.try_storage_cookie_reload = tracked_reload
auth_session._try_refresh_cmd_reauth = forbidden
auth_session._try_headless_reauth = forbidden
auth_session._try_master_token_reauth = forbidden
async with NotebookLMClient.from_storage(profile=PROFILE) as c:
before = await c.notebooks.list()
before_ids = tuple(sorted(item.id for item in before))
live = c._require_web_runtime().kernel.get_http_client().cookies
live.clear()
after = await c.notebooks.list()
after_ids = tuple(sorted(item.id for item in after))
require(reload_calls > 0, "storage reload rung was not exercised")
require(len(live) > 0, "storage reload did not restore the live jar")
require(before_ids == after_ids, "notebook identity changed after recovery")
return {
"before": len(before),
"after": len(after),
"reload_calls": reload_calls,
"live_cookies": len(live),
}
def main() -> None:
"""Entry point for ``python -m scripts._live_auth_scenarios.storage_reload``."""
run_scenario(scenario)
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |