StreamControls (parar, tentar de novo, erro e limites)

Aberta
#1,206 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
3/5
Tempo estimado
1-2 dias
Facilidade para iniciantes
55/100
Tipo de issue
Funcionalidade
Clareza
Razoavelmente clara
Status de atividade
Ativa
Stack de tecnologia
typescript

Direção de pesquisa

Start in packages/ui/src/lib: git grep -il "StreamControl" returns nothing, so both components are new; read an existing component such as MessageBubble or Popover to copy the library's props and export conventions. The AC reference paths sit in a private repo and cannot be opened, so the acceptance criteria are the spec. Done means StreamControls and ChatError exported from the package with tests for the four checks: one user question after retry, 409 mapped to run_in_progress, a single role="alert" with focus on the retry button, and the error sound throttled per id.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

area:a11y area:components enhancement

Versão: @codeatlasdev/ui 4.6.0 · código lido em main (950628f2) · classe: lacuna (migração do AC)

Problema

O AC depende deste comportamento hoje e a lib não o oferece. Sem ele, a migração perde qualidade no desktop, no mobile ou no PWA.

O que a lib já oferece (para não duplicar) e o que falta

Conferido com git grep -il "StreamControl" origin/main -- packages/ui/src/lib (950628f2): nenhum resultado. Peças reaproveitáveis que existem: MessageBubble, VirtualList, ConversationItem, CodeSnippet (./code), CopyButton, Chip/ChipRow, Popover, Sheet, Spinner, toast.

Referência no AC

Caminhos do repo AC (repo privado, só caminho):

packages/ui/src/components/chat/chat-composer.tsx:293-297 (botão Parar); apps/seller/src/hooks/copilot/use-copilot-thread.ts:160-166 (retry); apps/seller/src/components/copilot/chat-messages.tsx:10-26 (ERROR_COPY por regex sobre error.message), :23-24 (fallback "Algo deu errado"), e os dois Callout de "A resposta não foi concluída" e "Erro ao gerar resposta"; apps/seller/src/components/copilot/copilot-provider.tsx:60-66 (som de erro a cada erro).

Defeitos do AC (leitura do código, não executado): - use-copilot-thread.ts:164: retry chama sendMessage({ text }), que acrescenta uma nova mensagem do usuário. A falha anterior fica no histórico: a conversa passa a ter a pergunta duas vezes e o servidor guarda as duas.

  • ERROR_COPY não cobre o 409 de seller-chat.ts:72-74 ("Resposta em andamento nesta conversa."): cai em "Algo deu errado".
  • Não há limite de uso, quota nem aviso de tokens. O 429 tem texto, mas o que o servidor de fato devolve não é verificado.
  • Não há "regenerar" para uma resposta específica: só repete a última pergunta.

Proposta

<StreamControls status onstop onretry onregenerate> e <ChatError code message onretry> que recebe um código (run_in_progress, rate_limited, network, timeout, unknown), não texto livre. onretry remove a falha anterior antes de reenviar, ou reenvia com messageId.

Critério de aceite (testável)

  • Após erro e "Tentar de novo", a conversa tem uma única pergunta do usuário (contagem igual antes e depois).
  • 409 mostra "Já há uma resposta em andamento nesta conversa." (código run_in_progress).
  • Erro é anunciado uma vez (role="alert") e o foco vai ao botão de tentar de novo.
  • Som de erro toca no máximo uma vez por falha (throttle por id).

Mãe: #1089

Linguagem predominante
TypeScript
Estrelas
6
Forks
3
Merge médio
5h 21min
PRs com merge (30d)
378

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de codeatlasdev/ui

Todas as issues de codeatlasdev/ui

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.