electric-ax agents CLI reports "No entity types found" for freshly-registered types (default Electric-Principal has no visibility)

Aperta
  • Qualcosa non va?
#4,719 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
55/100
Tipo di issue
Bug
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
typescript
Ambito
authorization, cli

Direzione di ricerca

Inizia in packages/electric-ax, in getElectricCliEnv, e traccia il modo in cui gli agents leggono i comandi, inclusi gli agents types che costruiscono i propri principal headers. Riproduci le risposte vuote e popolate con i due valori Electric-Principal mostrati nell’Issue, quindi scegli e implementa il comportamento locale previsto oppure un output più chiaro e consapevole delle autorizzazioni. Il lavoro è completato quando un tipo appena registrato è individuabile tramite il comando walkthrough, oppure quando la CLI spiega chiaramente perché non è visibile.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Summary

After following the agents walkthrough and registering an entity type, electric-ax agents types prints No entity types found, even though the type is registered and visible in the dev UI. The same mismatch affects other agents read commands. The cause is that the CLI sends a default Electric-Principal that the server has no visibility grants for.

Steps to reproduce

  1. Follow the agents walkthrough so an assistant (or any) entity type is registered against a local server at http://localhost:4437.
  2. Confirm it registered — the dev UI at https://localhost:4438 lists it, and: 
    curl -s http://localhost:4437/_electric/entity-types | jq '.[].name'
# => "assistant", "principal"
  3. Run the CLI: 
    pnpx electric-ax@latest agents types
# => No entity types found

Expected

Immediately after registering a type and following the walkthrough, agents types lists it.

Actual

No entity types found, which reads as "registration failed" and sends you debugging the wrong thing.

Root cause

GET /_electric/entity-types is scoped by the Electric-Principal request header:

  • No header (plain curl) → returns everything (assistant, principal).
  • Electric-Principal: system:dev-local (what the dev UI uses) → returns the registered types.
  • Electric-Principal: user:<whoami>@<hostname> → returns [].

getElectricCliEnv defaults the principal to user:${ELECTRIC_AGENTS_IDENTITY} where the identity is ${os.userInfo().username}@${os.hostname()} (packages/electric-ax). That principal has no grants for the walkthrough-registered types, so the server correctly returns an empty list — and the CLI prints No entity types found.

Demonstration:

# empty (CLI default principal)
curl -s -H "Electric-Principal: user:$(whoami)@$(hostname)" \
  http://localhost:4437/_electric/entity-types | jq length            # => 0

# populated (dev UI principal)
curl -s -H "Electric-Principal: system:dev-local" \
  http://localhost:4437/_electric/entity-types | jq 'map(.name)'      # => ["assistant","principal"]

Workaround

ELECTRIC_AGENTS_PRINCIPAL=system:dev-local electric-ax agents types

Why this is confusing / suggested fixes

The inconsistency is that an unauthenticated request sees all types while the CLI's "authenticated" default sees none, and the walkthrough implies the plain agents types command lists what you just registered. Some options:

  • Have the local dev flow default the CLI to the same principal the dev server/UI uses (system:dev-local), or grant the default user:<identity> principal visibility of types it can spawn.
  • If empty-because-of-permissions is intended, distinguish it in the CLI output (e.g. No entity types visible to principal <p> with a hint about ELECTRIC_AGENTS_PRINCIPAL) instead of the flat No entity types found.
  • At minimum, document the principal scoping in the walkthrough next to the agents types step.

Environment

  • electric-ax CLI 0.2.23 (and @latest), agents server image 0.6.3, @electric-ax/agents-runtime 0.6.3.
  • macOS, local Docker dev stack (electric-ax agents start).
Lingua principale
TypeScript
Stelle
10.4k
Fork
399
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di electric-sql/electric

Tutte le issue di electric-sql/electric

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.