pi-cloudflare 0.2.1 → 0.2.2
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/README.md +12 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -25,6 +25,8 @@ Requires pi with package support, Node 20.19+ (or 22.12+), and network
|
|
|
25
25
|
access. No browser, wrangler CLI, or API token needed to install; the docs
|
|
26
26
|
tools work immediately after install.
|
|
27
27
|
|
|
28
|
+
|
|
29
|
+
|
|
28
30
|
## Install
|
|
29
31
|
|
|
30
32
|
```bash
|
|
@@ -63,6 +65,16 @@ In `~/.pi/agent/settings.json`:
|
|
|
63
65
|
}
|
|
64
66
|
```
|
|
65
67
|
|
|
68
|
+
## Troubleshooting
|
|
69
|
+
|
|
70
|
+
| Symptom | Likely cause | Fix |
|
|
71
|
+
| -------------------------------------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
|
|
72
|
+
| `Browser connection failed` on session start | A server is down or its token expired | The extension skips it with a warning and continues; rerun `pi-cloudflare-setup --only <server>` for the failing one |
|
|
73
|
+
| OAuth tab never opens | Headless environment or blocked popup | Copy the printed URL into any browser; tokens land in `~/.pi/cloudflare-tokens.json` either way |
|
|
74
|
+
| `401` from one server only | That server's refresh token was revoked | `npx -p pi-cloudflare pi-cloudflare-setup --only <server>` |
|
|
75
|
+
| Tools missing for a server | Disabled via `servers: { <id>: false }` | Re-enable in settings; tools register on next session start |
|
|
76
|
+
| Rate-limited API calls | Too many write calls in a loop | Back off and batch; prefer one `cf_api_execute` with a precise query over paginated scans |
|
|
77
|
+
|
|
66
78
|
## Development
|
|
67
79
|
|
|
68
80
|
```bash
|
package/package.json
CHANGED