[campoy]

What does this PR do?

Updates the TypeScript OpenAI Agents SDK integration page for temporalio/ai-integrations#270, which removes the integration's agentAsTool and makes the OpenAI Agents SDK's own agent.asTool() work in Workflows.

• Agents as tools now use agent.asTool(). The page drops agentAsTool, its options table and the NestedAgentInterruption error.
• The notes on nested runs now say what they get from the parent run: its context, runConfig.model for agents that set no model, runConfig.modelSettings, and the runner's model Activity options. They also say that a nested approval pauses the parent run and that a nested run's failure goes back to the model as the tool's output.
• Breaking: run TypeScript OpenAI Agents as written: agent.asTool() works, runConfig.model no longer overrides an agent's own model, agentAsTool is deprecated ai-integrations#270 also stops cloning agents, so the page now says:
  • runConfig.model applies to agents that set no model of their own, as in the SDK;
  • agent.on(...) lifecycle hooks are supported;
  • asTool() tools must be created in Workflow code, and the nested setups the runner rejects are listed, with the matching error types.

Notes to reviewers

Draft until temporalio/ai-integrations#270 is merged and released. When it is, this page can name the release.

Checked on a build of temporalio/ai-integrations#270, on a local dev server with a scripted model:

• A nested agent's instructions function and its inline tool got the run's context.
• A nested model call that failed after its retries went back to the parent model as An error occurred while running the tool. Please try again. Error: ActivityFailure: Activity task failed, and the run completed.
• A nested tool that needed approval paused the parent run with that call in result.interruptions. Approving it and resuming finished the run.
• The run's model and model settings, and the runner's Activity options, reached nested runs. The runConfig.model rule, hooks, the rejected nested setups and the summary agent are covered by Breaking: run TypeScript OpenAI Agents as written: agent.asTool() works, runConfig.model no longer overrides an agent's own model, agentAsTool is deprecated ai-integrations#270's Worker tests.

That runConfig.sandbox is passed on to nested runs comes from the OpenAI Agents SDK's code. It wasn't run here.

The agent patterns sample moves to agent.asTool() in temporalio/samples-typescript#534.

Vale didn't run locally. The page isn't Prettier-clean on main, so only the changed paragraphs are rewrapped.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
temporal-documentation	Ready	Preview	Oct 29, 2026 7:35am UTC

[github-actions]

📖 Docs PR preview links

• Develop
  • Typescript
    • Integrations
      • OpenAI Agents SDK integration