[JoaoLuisQuirino]

Closes #123.

Ordem de subida (obrigatória)

Esta SDK sobe primeiro. Depois dela, o Infusion, o Meu Agente e, se seguir em uso, o Orbit atualizam. Só então o mitra-copilot#552 grava a linha NOTIFICATION e o mitra-sandbox#782 emite o frame notification. A 0.3.0 a 0.3.2 leriam essa linha como texto do agente.

O que muda

Pontos que o MP levantou no chat novo do agente (conversa d03cf06d, alpha). Tudo é aditivo no runtime.

• AgentToolEvent.title (opcional): o título que a box manda na ferramenta, ao vivo e no item tool do histórico. No subagente é o nome dele, que a linha TOOL_USE já tinha.
• Fim de trabalho em segundo plano: evento notification (AgentNotification: source, outcome, summary, detail?, mais itemId, sequence e turnId) e item notification no history, ao vivo (frame notification) e recarregado (linha NOTIFICATION, com kinds=all).
• README: send sem mode com turno rodando entra no turno em andamento (steer); a fila só com mode: "queue". Documentados também backgroundTasks, o turno em curso que a box reenvia depois do replay e o reason: "interrupted" na linha que o Stop fechou.
• Versão 0.3.3: package, lock, contracts/v0.3.3 e CHANGELOG.

Para quem usa TypeScript. AgentTimelineItem ganha a variante kind: "notification", com payload e sem text. Um app que trata os kinds conhecidos e lê item.text no else precisa tratar notification, como foi com approval na 0.3.0. É só em tempo de compilação; no runtime nada muda para quem não recebe a linha.

Sobre o loadHistory do openExisting sem tamanho: a primeira página segue em 50, como decidido na 0.3.1. O app usa loadOlder()/hasOlder para o resto.

Prova

• npm run check e npm test 730/730; typecheck, lint, format, check:exports, check:contracts, pack:check, build e smoke:package (com AgentNotification e o evento) verdes.
• Paridade da 0.2.13: title entra na lista de campos acrescentados.
• Dev (tarball deste branch): o subagente em segundo plano chega com tool.title "Rodar sleep em segundo plano" ao vivo e no histórico depois do F5 (task 3458f6f1). Prova do notification nos comentários.

🤖 Generated with Claude Code

[JoaoLuisQuirino]

/gandalf

[gandalf-the-grey-bot]

Review concluído no commit e1e2dea; nenhum achado de linha acionável nesta rodada.

[gandalf-the-grey-bot]

Gandalf, análise 1 · commit e1e2dead

Pega-rápido: O histórico já recebia o título da ferramenta, mas a transformação pública o descartava. O PR passa title opcionalmente ao SDK para que os apps não precisem reconstruir esse dado; isso responde à perda registrada na issue #123.

Insights: O problema é concreto e a solução aproveita o fluxo existente, sem duplicação ou expansão desnecessária. Não identifiquei impacto adicional relevante em segurança ou escala.

Forma da implementação: Aprovada. src/agentSession.ts repassa title como string nos eventos e no histórico, inclusive pelos caminhos compartilhados; os testes cobrem o evento e o histórico, e os manifestos mantêm as versões alinhadas.

Findings: Nenhum achado acionável. O CI do SHA terminou verde em todos os jobs (build, test, compatibility (22), compatibility (18) e pr-convention).

Confiança: Alta: issue, diff, testes focados e CI verde sustentam o comportamento revisado.

Decisão: Mergeável.

Aqui o meu check é obrigatório: depois de um push, comente /gandalf para eu revisar o commit novo e liberar o merge.

[gandalf-the-grey-bot]

Sem novos achados de linha; o commit continua igual ao da análise 1.

[gandalf-the-grey-bot]

Gandalf, análise 2 · commit e1e2dead

Desde a análise 1: o commit não mudou; não há pontos abertos nem achados novos.

Decisão: mergeável.

Aqui o meu check é obrigatório: depois de um push, comente /gandalf para eu revisar o commit novo e liberar o merge.

[JoaoLuisQuirino]

/gandalf

[gandalf-the-grey-bot]

Gandalf, análise 3 · commit b863e77

Desde a análise 2: o delta adiciona o evento e o item de histórico notification; nenhum ponto anterior estava aberto. Novo comentário: cobertura do tipo público no smoke ESM/CommonJS.

Decisão: mergeável. O CI do commit terminou verde; o minor é uma melhoria recomendada, não impede o merge.

Aqui o meu check é obrigatório: depois de um push, comente /gandalf para eu revisar o commit novo e liberar o merge.

[JoaoLuisQuirino]

/gandalf

[gandalf-the-grey-bot]

Revisão da análise 4 no commit 259a67f: nenhum achado de linha; o minor da análise 3 foi corrigido.

[gandalf-the-grey-bot]

Gandalf, análise 4 · commit 259a67f

Desde a análise 3: corrigida a cobertura do export AgentNotification nos smokes ESM/CommonJS (conversa); nenhum ponto segue aberto e não há achado novo. O CI do commit terminou verde.

Decisão: mergeável.

Aqui o meu check é obrigatório: depois de um push, comente /gandalf para eu revisar o commit novo e liberar o merge.

[JoaoLuisQuirino]

/gandalf

[JoaoLuisQuirino]

/gandalf

[gandalf-the-grey-bot]

Nenhum finding de linha nesta rodada.

[gandalf-the-grey-bot]

Gandalf, análise 5 · commit bf4a636

Desde a análise 4: o ponto minor foi corrigido e a conversa está resolvida (conversa); nenhum ponto permanece aberto e nada novo.

Decisão: mergeável.

Aqui o meu check é obrigatório: depois de um push, comente /gandalf para eu revisar o commit novo e liberar o merge.