feat(ai): add operator-shared central Codex connection with per-user opt-in

Introduce an operator-level ChatGPT-subscription (Codex) credential that the
operator connects once and shares server-wide, plus a per-user switch to route
AI egress through it.

- Schema (migration 0235): three encrypted columns on AppSettings for the
  operator's central Codex access/refresh tokens and the ChatGPT-Account-ID
  claim, plus expiry/connected-at/status; a per-user useCentralCodex flag
  (default false). Register the new encrypted columns in the rotation registry
  and script.
- Resolution: add the admin-codex chain type; append it to a user's resolved
  chain only when they opted in AND the operator connected it. Tokens refresh
  server-side against the singleton row (CAS-style), same primitives as the
  per-user Codex path.
- Budget: bill an admin-codex primary against the operator cost cap, not the
  user plan — it drains the operator's account.
- Consent: admin-codex is server-managed external egress, gated by the existing
  consent machinery (self-snapshot and document surfaces alike). No existing
  consent path is weakened.
- Document order: rank admin-codex with the subscription tier (last), so the
  document class stays local-first.
- UI: admin device-code connect/disconnect card (cookie-only admin routes) with
  honest copy on account pooling, shared rate limits, and training-by-default;
  a per-user opt-in switch shown only once the operator has connected it, off by
  default, behind a one-time honesty confirm.
- i18n across all six locales; unit tests for the chain type, budget cap,
  consent gate, vision capability, and document order; a mocked e2e for both
  the admin connect surface and the per-user switch.

The central credential's tokens are encrypted at rest and never returned to a
non-admin API; the opt-in only takes effect once the operator has connected the
shared account.
This commit is contained in:
Marc-André Bombeck committed 2026-07-10 00:10:56 +02:00
1 parent fa42c8bc0b
commit d7e616eaa8
35 files changed
+1553 -26

No files matched your search

@@ -60,6 +60,19 @@ describe("reorderChainForDocumentClass", () => {
expect(order([entry("codex"), entry("local")])).toEqual(["local", "codex"]);
});
it("demotes the shared central codex (admin-codex) to the subscription tier (rank 3)", () => {
// Same train-by-default subscription tier as `codex` — behind local, BYOK,
// and the operator's no-train admin key.
expect(
order([
entry("admin-codex"),
entry("local"),
entry("openai"),
entry("admin-openai"),
]),
).toEqual(["local", "openai", "admin-openai", "admin-codex"]);
});
it("is stable within a rank tier (preserves user order for BYOK keys)", () => {
expect(order([entry("anthropic"), entry("openai")])).toEqual([
"anthropic",
@@ -85,6 +98,7 @@ describe("documentEgressClass", () => {
expect(documentEgressClass("openai")).toBe("external");
expect(documentEgressClass("anthropic")).toBe("external");
expect(documentEgressClass("admin-openai")).toBe("external");
expect(documentEgressClass("admin-codex")).toBe("external");
});
});
+4 -2
View File
@@ -41,8 +41,9 @@ import type {
* Preference rank for a provider when the payload is a DOCUMENT. Lower wins.
* Local keeps the document on the machine (rank 0); BYOK no-train API keys are
* next (rank 1); the operator's shared no-train key follows (rank 2); the
* ChatGPT-subscription OAuth path (`codex`) is LAST (rank 3) because it trains
* on consumer content by default and cannot be verified opted-out from here.
* ChatGPT-subscription OAuth paths are LAST (rank 3) — the user's own `codex`
* AND the operator's shared `admin-codex`, both train on consumer content by
* default and cannot be verified opted-out from here.
*/
function documentProviderRank(providerType: string): number {
switch (providerType) {
@@ -55,6 +56,7 @@ function documentProviderRank(providerType: string): number {
case "admin-openai":
return 2;
case "codex":
case "admin-codex":
return 3;
default:
return 2;