@henryqw/pi-multi-codex 3.1.3 → 3.1.4
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 +18 -12
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# `@henryqw/pi-multi-codex`
|
|
2
2
|
|
|
3
|
-
Add multiple ChatGPT Codex OAuth accounts
|
|
3
|
+
Add multiple ChatGPT Codex OAuth accounts. Start Pi work on the eligible account slot with the most remaining quota. The extension switches away from active five-hour quota blocks and can retry an HTTP 429 on another eligible account slot.
|
|
4
4
|
|
|
5
5
|
|
|
6
6
|
|
|
@@ -23,7 +23,9 @@ This package requires Pi 1.1.0 or later in the 1.x series.
|
|
|
23
23
|
|
|
24
24
|
## Use
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
Run `/login`. Authenticate `OpenAI Codex (legacy)` for account slot 1. Run `/codex-add`.
|
|
27
|
+
|
|
28
|
+
Run `/login` again. Select the new `OpenAI Codex #<n>` provider. Restart Pi or update model scope. Then run `/codex-status`. The status lists the new account slot with cached quota when available. It shows `unavailable` until the first successful usage snapshot.
|
|
27
29
|
|
|
28
30
|
| Surface | Type | Purpose |
|
|
29
31
|
| --- | --- | --- |
|
|
@@ -37,16 +39,16 @@ The footer and `/codex-status` show the five-hour reset countdown for Free, Go,
|
|
|
37
39
|
|
|
38
40
|
## Flow
|
|
39
41
|
|
|
40
|
-
- Before the first agent start, only fresh usage snapshots
|
|
42
|
+
- Before the first agent start, ranking uses only fresh usage snapshots. The account slot with the most remaining quota wins.
|
|
41
43
|
- An explicit model selection always wins for the next agent start.
|
|
42
|
-
- Before later agent starts, a known active five-hour quota block switches to the eligible
|
|
43
|
-
- After HTTP 429, failover can use authenticated, registered, scope-allowed
|
|
44
|
-
- Failover skips known active five-hour quota blocks. It ranks fresh known quota first
|
|
44
|
+
- Before later agent starts, the extension checks for a known active five-hour quota block. If it finds one, it switches to the eligible account slot with a fresh usage snapshot and the most remaining quota.
|
|
45
|
+
- After HTTP 429, failover can use authenticated, registered, scope-allowed account slots that it has not tried. These slots can have stale or missing quota.
|
|
46
|
+
- Failover skips known active five-hour quota blocks. It ranks fresh known quota first. Then it ranks the remaining slots by slot number.
|
|
45
47
|
- Routing preserves the model ID.
|
|
46
|
-
- Only physical Codex models are slots.
|
|
47
|
-
- During one agent run, each eligible slot
|
|
48
|
-
- Automatic retry stops when
|
|
49
|
-
- The footer shows the fresh quota or five-hour quota block of the active slot.
|
|
48
|
+
- Only physical Codex models are account slots. The extension never routes a virtual model under `openai-codex`, such as `openai-codex/auto`, to an account slot. It shows no quota status for a virtual model.
|
|
49
|
+
- During one agent run, the extension tries each eligible account slot at most one time after HTTP 429 responses.
|
|
50
|
+
- Automatic retry stops when the extension has tried all eligible account slots.
|
|
51
|
+
- The footer shows the fresh quota or five-hour quota block of the active account slot.
|
|
50
52
|
|
|
51
53
|
## Config
|
|
52
54
|
|
|
@@ -56,7 +58,11 @@ Package-owned: `~/.pi/agent/config/pi-multi-codex/config.json`
|
|
|
56
58
|
| --- | --- | --- | --- |
|
|
57
59
|
| `autoSwitchOn429` | Switches to another eligible slot after an HTTP 429. | Boolean. | `true` |
|
|
58
60
|
|
|
59
|
-
Edit this file yourself. The extension does not create or write it.
|
|
61
|
+
Edit this file yourself. The extension does not create or write it. If the file is missing, the extension uses the default `true`. Config changes take effect at the next session start. Set `autoSwitchOn429` to `false` to disable automatic switching.
|
|
62
|
+
|
|
63
|
+
At session start, the extension warns about unknown keys, malformed JSON, or values that are not booleans. The warning includes the file path. The extension ignores unknown keys.
|
|
64
|
+
|
|
65
|
+
Automatic switching stays off for the session if `autoSwitchOn429` is not a boolean or has incorrect spelling, such as `autoswitchOn429`. Switching also stays off for malformed JSON, invalid UTF-8, files larger than 64 KiB, read errors, or a non-object root. The extension keeps the file unchanged. Fix the file. Then start a new session to recover.
|
|
60
66
|
|
|
61
67
|
## State and storage
|
|
62
68
|
|
|
@@ -64,6 +70,6 @@ The extension keeps a generated, credential-free quota cache at `~/.pi/agent/con
|
|
|
64
70
|
|
|
65
71
|
## Limits and recovery
|
|
66
72
|
|
|
67
|
-
The extension reads `auth.json` to identify account slots
|
|
73
|
+
The extension reads `auth.json` to identify account slots. It does not directly edit credentials. It asks Pi's auth resolver for a token to check quota. Pi can then refresh expired OAuth credentials and update its auth store.
|
|
68
74
|
|
|
69
75
|
Scoped sessions can switch only to exact scoped aliases.
|