Resumo
O SDK Python do Codex 0.154.0 aceita mensagens externas durante a execução e acrescenta opções para consultar o histórico ao retomar ou derivar uma sessão de chat. A atualização exige ajustes nas integrações que acessam metadados de hooks e notificações tipadas, além de conferir como cada consumidor acompanha os eventos de um turno.
Novidades
- Codex python-v0.154.0 — Mensagens externas:
ExternalMessagefunciona nas chamadas síncronas e assíncronas derun()eturn(). O conteúdo pode iniciar um turno ou entrar num turno regular ativo com autoridade de ferramenta, sem conceder autorização do usuário. - Codex python-v0.154.0 — Esforço de raciocínio: o SDK aceita os valores
maxeultra. - Codex python-v0.154.0 — Histórico e execução:
include_turnscontrola o histórico retornado na retomada ou no fork,turn_service_tierconfigura um turno novo esourceidentifica a procedência da mensagem. A seleção de histórico altera a resposta recebida pelo consumidor, sem modificar o contexto do modelo.
Melhorias
- Codex python-v0.154.0 — Protocolo: os modelos gerados e as notificações acompanham o protocolo atualizado. Os padrões anteriores permanecem quando as novas opções são omitidas.
Correções
- Codex python-v0.154.0 — Eventos de conclusão: o SDK preserva eventos que chegam antes da resposta de início do turno.
Breaking changes
- Codex python-v0.154.0 — Metadados de hooks:
HookMetadataencapsula o handler em.root. Integrações que usamhook.commandprecisam acessarhook.root.commande conferirhook.root.handler_typepara ler campos específicos. - Codex python-v0.154.0 — Notificações tipadas: payloads reconhecidos expõem campos nomeados. Consumidores que leem
.paramsprecisam migrar esses acessos, preservando o tratamento deUnknownNotificationpara conteúdo desconhecido ou inválido. - Codex python-v0.154.0 — Acompanhamento de turnos: handles construídos manualmente ou conectados depois do início recebem eventos somente a partir da conexão. Integrações que dependem da reprodução das saídas anteriores precisam consultar
thread.read(include_turns=True). Uma conexão após a conclusão pode gerarTransportClosedError.
Ponto de Atenção
- Codex python-v0.154.0 — Estabilidade: esta é uma publicação estável do SDK Python, com migrações documentadas.
- Codex python-v0.154.0 — Compatibilidade: a instalação exige Python 3.10 ou posterior e inclui
openai-codex-cli-bin==0.154.0. Umcodex_binpersonalizado precisa usar CLI 0.151.0 ou posterior para mensagens externas e novas opções de histórico ou turno. - Codex python-v0.154.0 — Teste sugerido: envie uma
ExternalMessagedurante um turno ativo e acompanhe dois consumidores. Depois, conecte um handle após o início, compare os eventos com o histórico salvo e confira os acessos migrados a hooks e notificações.
Notas da versão
- Codex python-v0.154.0 — Instalação:
pip install --upgrade openai-codex==0.154.0instala esta versão do SDK. - Codex python-v0.154.0 — Publicação oficial: consulte o release do SDK Python, publicado em 10 de setembro de 2026.