@kairos/studio-sdk

Validação End-to-End (Inclua + Platform local)

Pré-requisitos

• Platform local rodando:

  cd ../KairOS-Platform
  supabase start
  supabase db reset
  supabase functions serve ingerir --no-verify-jwt

• API key criada:

  cd ../kairos-studio-sdk
  pnpm run integration:seed
  # anote idInquilino e apiKey do stdout

• Inclua com SDK vendored (já feito via Task 17) + .env.local preenchido:

  # Em incluavt/supabase/.env.local, substituir:
  STUDIO_API_KEY=kp_live_<<apikey-da-seed>>

Execução

1. Subir Inclua local:

   cd ../incluavt
   supabase start
   supabase functions serve nee-chat --no-verify-jwt --env-file supabase/.env.local

2. Disparar uma chamada (nee-chat é chat; payload tem messages + student_context):

   curl -N http://127.0.0.1:54321/functions/v1/nee-chat \
     -H "Content-Type: application/json" \
     -d '{
       "messages": [{"role": "user", "content": "Sugira 3 estratégias para um aluno com TDAH."}],
       "nee_types": ["TDAH"],
       "student_context": {
         "name": "Teste",
         "grade": "5º ano",
         "nee_types": ["TDAH"]
       },
       "tenant": { "redeId": "<<ID_INQUILINO_DA_SEED>>" }
     }'

   Esperado: stream de chunks SSE do Claude chegando progressivamente no terminal.

3. Após o stream fechar (2-5 segundos), inspecionar o Platform:

   psql postgresql://postgres:[email protected]:54322/postgres \
     -c "SELECT id_agente, modelo_llm, custo_tokens, duracao_ms, severidade
         FROM evento_execucao
         ORDER BY criado_em DESC LIMIT 1;"

   Esperado:

       id_agente  |       modelo_llm       | custo_tokens | duracao_ms | severidade
   ---------------+------------------------+---------------+------------+------------
    nee-chat      | anthropic/claude-sonnet-4 |          ~500 |      ~3000 | info

Critério de sucesso

• Stream SSE visível no terminal do curl (UX preservada).
• Um registro em evento_execucao com id_agente='nee-chat', custo_tokens > 0, duracao_ms > 0, severidade='info'.
• Diff de latência vs. Inclua sem SDK: < 20ms medido em 5 execuções.

Troubleshooting

• Stream chega mas 0 rows no Platform: provavelmente o Platform não está rodando ou STUDIO_ENDPOINT aponta pra URL errada. Verifique supabase status em ambos os repos e confirme o endpoint em .env.local.
• 401 do Platform: API key em .env.local não bate com o que foi gerado pela seed. Re-rode pnpm run integration:seed e copie o valor novo pro .env.local.
• evento_execucao tem registro mas custo_tokens = 0: OpenRouter não emitiu o chunk de usage. Verifique que stream_options: { include_usage: true } está na request (olhe o dados JSON do registro — deve ter errorCode: 'NO_USAGE_IN_STREAM' se ausente).
• Latência > 100ms adicional: pode significar que EdgeRuntime.waitUntil não está sendo usado (o emit ficou síncrono). Olhe logs do supabase functions serve nee-chat pra ver se há erro/warning do SDK.