​

Protocolo de Integração Inicial + Configuração

​

Componentes

• Mecanismo do assistente (sessão compartilhada + prompts + estado de integração inicial).
• A integração inicial via CLI usa o mesmo fluxo do assistente que os clientes de UI.
• O RPC do Gateway expõe endpoints do assistente + do esquema de configuração.
• A integração inicial no macOS usa o modelo de etapas do assistente.
• A Web UI renderiza formulários de configuração a partir de JSON Schema + dicas de UI.

​

RPC do Gateway

• wizard.start params: { mode?: "local"|"remote", workspace?: string }
• wizard.next params: { sessionId, answer?: { stepId, value? } }
• wizard.cancel params: { sessionId }
• wizard.status params: { sessionId }
• config.schema params: {}

• Assistente: { sessionId, done, step?, status?, error? }
• Esquema de configuração: { schema, uiHints, version, generatedAt }

​

Dicas de UI

• uiHints com chave por caminho; metadados opcionais (rótulo/ajuda/grupo/ordem/avançado/sensível/placeholder).
• Campos sensíveis são renderizados como entradas de senha; sem camada de redação.
• Nós de esquema não suportados recorrem ao editor JSON bruto.

​

Notas

• Este documento é o único lugar para acompanhar refatorações de protocolo para integração inicial/configuração.