[JoaoLuisQuirino]

Closes #79

Release 0.3.1 com o @mitralab.io/sdk-core@0.3.1 (mitralab-dev/mitra-core-sdk#116). Inclui o conteúdo do #75.

• agentCredentials.providers(), listMessages({ before }), session.loadOlder()/hasOlder. Exporta AgentReadyProvider.
• messenger: templates de e-mail do app (EmailTemplate*) e remetente do app (EmailSender, EmailSenderInput, EmailSettings, EmailSettingsInput, EffectiveEmailSender).
• Do docs(functions): sessão de agente da 0.3.0 no README e reexport dos tipos novos do Core (#74) #75: reexporta AgentBackgroundTask, AgentSubagent, AgentSubagentStatus, AgentSubagentFrame, AgentMessageListOptions e a seção Sessão de agente no README.
• Corpus SDK-PARITY-001 fixado no 0.3.1, commit 49a778fd da main do core.
• providers e loadOlder precisam do Copilot com mitralab-dev/mitra-copilot#549.

Validação local: npm run check completo (9 arquivos e 142 testes, declarations, exports, contracts, smoke) e check:contracts:source, contra a 0.3.1 do registry.

🤖 Generated with Claude Code

[JoaoLuisQuirino]

/gandalf

[gandalf-the-grey-bot]

Gandalf, análise 1 · commit 1d0187a

Pega-rápido
O PR expõe no SDK de Functions recursos já existentes no Core para uso pelo agente Desenvolvedor do editor do Infusion, sem duplicar a implementação.

Insights

• Mérito: aprovado. O propósito declarado na issue Release 0.3.1 com o sdk-core 0.3.1 #79 corresponde à API adicionada e ao uso previsto pelo cliente.
• Pilares: o wrapper reutiliza o Core, mantém a configuração do app sob controle do SDK e não carrega o histórico automaticamente.

Forma e validação

• A atualização usa a versão exata do Core; os reexports, README e changelog acompanham o contrato público.
• CI no SHA 1d0187a: sucesso nos cinco jobs (pr-convention, build, compatibility (18), compatibility (22) e test), incluindo 142 testes.

Findings

• minor — scripts/check-declarations.mjs:15-16 protege só 2 dos 12 novos tipos de e-mail. Inclua os dez nomes ausentes em requiredNativeDeclarations; o smoke .mts/.cts também pode importar esses tipos para cobrir o pacote instalado.

Confiança: alta; comparei os exports com o Core e confirmei o CI verde no SHA auditado.

Ativação: as APIs são opt-in. Antes de um consumidor usar providers ou loadOlder num ambiente, confirme que o Copilot com #549 está implantado ali; merge dos PRs não prova deploy.

Decisão: mergeável. O CI do commit auditado está verde; o achado minor não segura o merge.

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]

Gandalf, análise 1 · commit 1d0187a

Pega-rápido

A issue #79 pede que a SDK de Functions exponha recursos já disponíveis no Core, para o agente administrar templates e remetentes de e-mail e usar as novas operações de agentes. Este PR atualiza o Core para 0.3.1, publica os tipos e métodos na superfície da SDK e atualiza os contratos e a documentação.

Insights

• Mérito: aprovado. Importar tipos diretamente do Core contornava parte da lacuna, mas não oferecia loadOlder() nem os novos métodos do messenger na versão que a SDK usava.
• A SDK continua delegando ao Core, sem duplicar a implementação. providers() e loadOlder() dependem das rotas do Copilot no PR #549, que está mergeado; confirme que a versão compatível já está implantada no ambiente antes de usar esses métodos.

Forma da implementação

Aprovada. A atualização alinha versão, lockfile, exports e documentação, mantendo a composição existente dos módulos.

Finding

• minor scripts/check-declarations.mjs:17: o guard não protege dez dos doze tipos novos de e-mail. Inclua os dez símbolos listados no comentário inline para que uma remoção acidental de reexport seja detectada.

CI e standards

No run do SHA revisado, pr-convention, build, test e compatibilidade Node 18/22 passaram; o job Node 22 reportou 142 testes aprovados. Os Standards #5 (HTTP) e #11 (Error Handling) foram considerados, sem desvio identificado.

Confiança: alta, porque issue, diff acumulado, contratos do Core/Copilot e CI deste SHA foram conferidos.

Decisão: mergeável. O ajuste minor é recomendado, mas não segura o merge. Antes de usar providers() ou loadOlder(), confirme a implantação do Copilot #549 no ambiente de destino.

Sugestão: completar a proteção dos dez tipos restantes do export de e-mail no guard existente.

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]

Nenhum achado novo neste delta. Os dois pontos anteriores foram corrigidos.

[gandalf-the-grey-bot]

Gandalf, análise 2 · commit 7cb0b86

Desde a análise 1: os 2 pontos anteriores foram corrigidos; nenhum achado novo. O CI do SHA revisado passou nos 5 jobs.

Condição de ativação: antes de usar providers() ou loadOlder(), confirme que o Copilot #549 está implantado no ambiente de destino.

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.