Conexões
Todo provedor mostra duas coisas: um chip nomeando de onde vieram os números dele, e, abaixo, um estado tirado de um vocabulário único que o produto inteiro compartilha. Esta página nomeia cada estado dele, diz claramente o que Import only significa, e diz o que muda quando uma conexão ao vivo passa a existir.
O chip num provedor hoje
Um parser existir não é uma conexão, então nenhum cartão no painel é rotulado como conectado com base num só. Todo provedor, em vez disso, carrega um chip nomeando como os números dele realmente chegaram a este dispositivo. Existem três, hoje.
| chip | provedores | significado |
|---|---|---|
Local CLI | Claude | Uma ferramenta nesta máquina escreve o payload, e o OpenLimiter lê o que ela escreveu. |
Import only | OpenRouter, Codex, Antigravity, OpenCode | O formato do payload é interpretado. Nada aqui entra numa conta ou busca isso, então você fornece o documento. |
Manual | Entradas manuais | Números que você mesmo mantém. Nada é lido de uma conta. |
O vocabulário completo de conexão
Abaixo dos três chips há um vocabulário maior: treze estados nomeados, um módulo no pacote core em que o produto inteiro é construído, cada um com uma frase simples em vez de uma linha de log. Ele existe para que o estado de uma conexão seja um valor que toda superfície lê da mesma forma, nunca uma frase que cada uma é livre para inventar por conta própria.
| estado | significado |
|---|---|
NOT_CONFIGURED | Não conectado. |
DETECTED | Encontrado nesta máquina, mas ainda não coletando. |
NEEDS_AUTH | Esperando uma credencial. |
READY_TO_ENABLE | Pronto para começar a coletar. |
CONNECTING | Conectando. |
CONNECTED | Conectado e coletando. |
DEGRADED | O provedor está recusando leituras por enquanto. |
STALE | A última leitura é mais antiga do que deveria. |
AUTH_EXPIRED | A credencial guardada parou de funcionar. |
IMPORT_ONLY | Só lê o que você importa. Nada é coletado automaticamente. |
MANUAL | Mostra o plano que você mesmo digitou. |
UNSUPPORTED | Ainda não existe uma fonte automática segura para este produto. |
ERROR | Esta conexão falhou e precisa de uma olhada. |
IMPORT_ONLY,MANUALeUNSUPPORTEDsão declarados em vez de tentados, por design: o produto os afirma diretamente, e nada que aconteça depois, uma resposta, uma falha, um tempo esgotado, pode promover um deles aCONNECTEDsilenciosamente. Só o próprio OpenLimiter afirmando o contrário tira uma conexão de um deles.- O resto nomeia um ciclo de vida pelo qual um leitor ao vivo faria uma conexão passar: encontrado mas ainda não coletando, esperando uma credencial, conectando, conectado, e, quando algo dá errado, degradado, desatualizado, expirado, ou precisando de uma olhada.
O que esta página não está afirmando
Não que os treze estejam na tela. O que o painel realmente renderiza hoje é o vocabulário mais simples, de três chips, acima, construído para uma versão em que nada faz uma leitura de rede. Os treze estados são reais e testados no pacote core em que este produto é construído, e nomeiam o ciclo de vida geral que qualquer conexão segue quando um leitor ao vivo passa a existir. Nenhuma superfície renderiza essas palavras ainda, porque nada hoje faz a coisa que colocaria uma conexão num deles: sem leitor, sem requisição, nada para falhar, expirar, ou precisar de uma credencial.
O que muda quando uma conexão ao vivo é lançada
Nada nesta página é uma data ou uma promessa. Quando um provedor ganha um leitor de verdade, a descrição honesta dele deixa de ser um chip fixo e passa a ser qualquer um dos treze estados acima que realmente se encaixe naquele momento: detectado, esperando uma credencial, conectando, conectado, ou, quando algo dá errado, degradado, desatualizado, ou precisando de uma olhada. Esse é o motivo de nomear o vocabulário inteiro agora, antes de qualquer parte dele ser alcançável, para que a frase que uma pessoa lê não mude no dia em que o estado por baixo dela começar a se mover.
Nenhum provedor tem esse leitor hoje. Veja o roadmap para o que está planejado e o que não está, e provedores suportados para o que cada connector consegue realmente fazer agora.