Referência
Lookup rápido para contratos estáveis: eventos, endpoints, streaming, paginação e formatos de erro.
Use esta seção quando você já entende o modelo da plataforma e precisa confirmar nomes, campos ou comportamento de borda.
Eventos
Tipos do event log, eventos ingeríveis, eventos de stream e eventos de webhook.
API HTTP
Autenticação, escopo, paginação, erros e links para recursos.
Streaming
Formato SSE, retomada por seq e checkpoint de consumo.
Login em portal
As três saídas de browser_login, o orçamento de 2 minutos e a espera de captcha.
Navegação em portais
O ciclo de snapshot e ref, o que o agent enxerga e como ele reage a modal, erro e sessão expirada.
#Convenções globais
| Convenção | Contrato |
|---|---|
| Casing | Payloads HTTP usam camelCase. |
| IDs | IDs públicos têm prefixo, como agent_, agtv_, sess_, evt_, ms_, skill_, vault_. |
| Listas | Recursos usam { data, hasMore, nextCursor }. |
| Eventos | Histórico de session usa { data, hasMore, nextAfterSeq }. |
| Erros | Respostas de erro usam { error: { code, message, requestId } }. |
| Segredos | Valores sensíveis aparecem apenas em respostas de criação ou rotação. |
#Superfície atual do SDK
O SDK TypeScript (@noorden/sdk) cobre agents, sessions, streaming, event history, custom tools, type guards e paginação, além dos recursos administrativos: vaults, memory stores, skills, webhooks, environments, datasets, experiments, automations, deployments de canal, usage, API keys, knowledge bases e serverless tools.
A superfície da onda de agents gerenciados entrou na versão 0.3.0: agents.list({ status }), agents.restoreVersion(), agents.rotateMcpHeaders(), agentVersion em deployments e automations, defaults na config do agent, task de agent em experiments e usage.budgets() com escopo por agent.
Recursos ainda sem wrapper dedicado continuam acessíveis por HTTP direto.