notebooklm-api-client 0.1.276 → 0.1.277
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CLAUDE.md +28 -0
- package/package.json +1 -1
package/CLAUDE.md
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# CLAUDE.md — `notebooklm-api-client`
|
|
2
|
+
|
|
3
|
+
**Read [`skills/ask-notebooklm-client`](../../skills/ask-notebooklm-client/SKILL.md)
|
|
4
|
+
first.**
|
|
5
|
+
|
|
6
|
+
A NotebookLM API client: a Cloudflare **Worker** in front of an **on-demand
|
|
7
|
+
Python container** that drives NotebookLM. Published.
|
|
8
|
+
|
|
9
|
+
## Two runtimes, one package
|
|
10
|
+
|
|
11
|
+
The Worker is the front door; the container is a sleeping Python service that
|
|
12
|
+
wakes on demand. Consequences:
|
|
13
|
+
|
|
14
|
+
- **Cold starts are the normal case.** The first request after a sleep is slow.
|
|
15
|
+
Timeouts and retries have to assume it; don't tune them against a warm
|
|
16
|
+
container.
|
|
17
|
+
- Waking a container costs money. Don't wake one speculatively, and don't hold
|
|
18
|
+
one awake with keepalives that aren't needed.
|
|
19
|
+
- Worker-side code has Workers constraints (no Node builtins, no filesystem);
|
|
20
|
+
container-side code does not. Know which half you are editing.
|
|
21
|
+
|
|
22
|
+
## Rules
|
|
23
|
+
|
|
24
|
+
- It drives an **unofficial surface** of someone else's product. It will break
|
|
25
|
+
when NotebookLM changes; fail diagnosably and don't retry aggressively into a
|
|
26
|
+
changed API.
|
|
27
|
+
- Credentials belong in Worker secrets and container environment, never in
|
|
28
|
+
source.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "notebooklm-api-client",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.277",
|
|
4
4
|
"description": "NotebookLM API via Cloudflare Containers — on-demand Python sandbox that sleeps when idle",
|
|
5
5
|
"author": "vtempest <grokthiscontact@gmail.com>",
|
|
6
6
|
"license": "rights.institute/PROSPER",
|