Pull TypeScript OpenAI Agents code from the samples repo

[brianstrauch]

What does this PR do?

Replaces the 16 hand-maintained inline TypeScript blocks on the OpenAI Agents SDK integration page with snipsync blocks backed by the openai-agents samples. Nothing verified those blocks, so they could drift from the SDK without any check failing.

Notes to reviewers

The markers upstream are scoped to exactly what each block shows, so no block needs selectedLines and none renders a leading // ... elision.

Tracing setup stays inline because the sample wraps the exporter, tracer provider, and plugin options in a tracing-mode switch that would make the extracted examples incomplete. The install commands also stay inline because they have no sample source.

Two sections are restructured, because the samples show in one place what the page showed in two:

• MCP servers now registers both provider kinds in a single Worker snippet up front, and the stateless/stateful subsections cover only Workflow-side code.
• Temporal orchestration spans would have duplicated the OpenTelemetry excerpt verbatim, so it's now prose pointing at that excerpt.

Some prose shifted to match the samples' identifiers rather than the invented ones the page used — helloWorld instead of haikuAgentWorkflow, and a note that the sample Worker sets useLocalActivity: true.

Verification

Ran yarn snipsync against the merged samples source. All 17 IDs resolve, every excerpt dedents to column 0, and the committed OpenAI Agents snippets are unchanged.

yarn build passes and vale --config .vale-ci.ini reports 0 errors/warnings on the page (one pre-existing sentence-case suggestion on the "Create a Hello World Workflow" heading, untouched here).

yarn check-links shows no new failure classes for this page — the /glossary#activity fragment-redirects it reports are systemic, with ~3000 hits site-wide.

🤖 Generated with Claude Code

┆Attachments: EDU-6984 Pull TypeScript OpenAI Agents code from the samples repo

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
temporal-documentation	Ready	Preview	Aug 19, 2026 7:31pm

[github-actions]

📖 Docs PR preview links

• Develop
  • Typescript
    • Integrations
      • OpenAI Agents SDK integration

[Copilot]

Pull request overview

Replaces unverified inline TypeScript examples with Snipsync-managed excerpts from the samples repository.

Changes:

• Converts 16 examples to synchronized sample excerpts.
• Restructures MCP and tracing guidance around sample code.
• Aligns identifiers and Local Activity guidance with runnable samples.

---

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

Suppressed comments (2)

docs/develop/typescript/integrations/openai-agents.mdx:675

• This identifies only the Worker configuration, but these options must also be set on the Client plugin: its interceptor injects addTemporalSpans and useOtelInstrumentation into the Workflow-start header. With the Client setup above, Client and Workflow orchestration spans remain disabled. Configure both plugin instances with these options, and register the replay-safe tracer provider in every process where useOtelInstrumentation: true is constructed.

Set `addTemporalSpans: true` to emit `temporal:*` agent-SDK spans for orchestration operations such as Workflow starts,
Signals, Queries, Updates, Activities, child Workflows, Nexus Operations, and Continue-As-New. It sits alongside
`useOtelInstrumentation` in `interceptorOptions`, as shown in the Worker above.

docs/develop/typescript/integrations/openai-agents.mdx:142

• modelParams reach the Workflow only through the config header injected by the Client plugin. Because this Client instance omits modelParams, the useLocalActivity: true shown on the Worker does not take effect; model calls remain regular Activities, contrary to lines 125–126. Add modelParams: { useLocalActivity: true } to this Client plugin in the source sample and regenerate the snippet (or remove the Worker-side claim).

This issue also appears on line 673 of the same file.

  plugins: [new OpenAIAgentsPlugin({ modelProvider: new OpenAIProvider({ apiKey }) })],