v0.4.7

Key Changes

Hosted container tool + Skills

This release includes the hosted shell runtime tool along with its native skills support. Developers now can pass a container-based shell runtime with skills this way:

import { Agent } from '@openai/agents';

const agent = new Agent({
  name: 'Container Shell Agent',
  model: 'gpt-5.2',
  instructions: 'Use the available container to answer user requests.',
  tools: [
    shellTool({
      environment: {
        type: 'container_auto',
        skills: [{type: 'skill_reference', skillId: "skill_698bbe879adc81918725cbc69dcae7960bc5613dadaed377", version: "1"}],
      },
    }),
  ],
});

Check the following examples for more details:

• https://github.com/openai/openai-agents-js/blob/main/examples/tools/container-shell-inline-skill.ts
• https://github.com/openai/openai-agents-js/blob/main/examples/tools/container-shell-skill-ref.ts

References:

• Hosted shell: https://developers.openai.com/api/docs/guides/tools-shell#hosted-runtime-details
• Skills API: https://developers.openai.com/api/docs/guides/tools-skills
• Skills Cookbook: https://developers.openai.com/cookbook/examples/skills_in_api

What's Changed

• feat: support shell tool environment + skills by @seratch in #950
• fix(agents-extensions): #945 map AI SDK cacheRead usage to cached_tokens by @seratch in #946
• fix(agents-openai): omit named tool_choice when prompt supplies tools by @seratch in #951
• fix(agents-core): preserve legacy ShellTool typing and strict shell pending statuses by @seratch in #952

Documents & Other Changes

• docs: clarify Codex run-context threading guidance and examples by @seratch in #942
• docs: update translated document pages by @github-actions[bot] in #943
• chore: upgrade pnpm to 10.29.2 by @seratch in #948
• chore: update versions by @github-actions[bot] in #947

Full Changelog: v0.4.6...v0.4.7