Add a sandbox sample and snipsync markers for the docs guide

The Python OpenAI Agents SDK integration guide on docs.temporal.io
currently sends readers to the SDK contrib README. Give it code to pull
from here instead.

Adds openai_agents/sandbox, covering SandboxAgent through the plugin. It
uses UnixLocalSandboxClient, so it runs with only OPENAI_API_KEY and no
sandbox account — at the cost of giving the agent a shell on the worker
host, which the README calls out. Note the class lives in
agents.sandbox.sandboxes.unix_local, not the
agents.extensions.sandbox.unix_local path the contrib README shows.

Adds snipsync markers to the samples that guide walks through, scoped to
exactly the code it shows so no block needs selectedLines. Markers around
indented code sit at that code's indent level, keeping snipsync's dedent
working (see #346).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: brianstrauch

openai_agents/README.md

@@ -39,4 +39,5 @@ Each directory contains a complete example with its own README for detailed inst
 - **[Customer Service](./customer_service/README.md)** - Interactive customer service agent with escalation capabilities, demonstrating conversational workflows.
 - **[Reasoning Content](./reasoning_content/README.md)** - Example of how to retrieve the thought process of reasoning models.
 - **[Financial Research Agent](./financial_research_agent/README.md)** - Multi-agent financial research system with planner, search, analyst, writer, and verifier agents collaborating.
+- **[Sandbox](./sandbox/README.md)** - `SandboxAgent` with a shell and filesystem, where every sandbox operation runs as a Temporal activity. **Pre-release.**
 - **[Streaming](./streaming/README.md)** - `Runner.run_streamed` with buffered token streaming to external subscribers via `temporalio.contrib.workflow_streams`. **Experimental.**

openai_agents/agent_patterns/workflows/agents_as_tools_workflow.py

@@ -8,6 +8,7 @@
 """
 
 
+# @@@SNIPSTART python-openai-agents-agent-as-tool-workflow
 def orchestrator_agent() -> Agent:
     spanish_agent = Agent(
         name="spanish_agent",
@@ -52,6 +53,9 @@ def orchestrator_agent() -> Agent:
     return orchestrator_agent
 
 
+# @@@SNIPEND
+
+
 def synthesizer_agent() -> Agent:
     return Agent(
         name="synthesizer_agent",

openai_agents/basic/activities/get_weather_activity.py

@@ -1,3 +1,4 @@
+# @@@SNIPSTART python-openai-agents-weather-activity
 from dataclasses import dataclass
 
 from temporalio import activity
@@ -16,3 +17,6 @@ async def get_weather(city: str) -> Weather:
     Get the weather for a given city.
     """
     return Weather(city=city, temperature_range="14-20C", conditions="Sunny with wind.")
+
+
+# @@@SNIPEND

openai_agents/basic/run_hello_world_workflow.py

@@ -8,6 +8,7 @@
 
 async def main():
     # Create client connected to server at the given address
+    # @@@SNIPSTART python-openai-agents-hello-world-client
     client = await Client.connect(
         "localhost:7233",
         plugins=[
@@ -23,6 +24,7 @@ async def main():
         task_queue="openai-agents-basic-task-queue",
     )
     print(f"Result: {result}")
+    # @@@SNIPEND
 
 
 if __name__ == "__main__":

openai_agents/basic/run_worker.py

@@ -34,6 +34,7 @@
 
 async def main():
     # Create client connected to server at the given address
+    # @@@SNIPSTART python-openai-agents-hello-world-worker
     client = await Client.connect(
         "localhost:7233",
         plugins=[
@@ -44,6 +45,7 @@ async def main():
             ),
         ],
     )
+    # @@@SNIPEND
 
     worker = Worker(
         client,

openai_agents/basic/workflows/hello_world_workflow.py

@@ -1,3 +1,4 @@
+# @@@SNIPSTART python-openai-agents-hello-world-workflow
 from agents import Agent, Runner
 from temporalio import workflow
 
@@ -13,3 +14,6 @@ async def run(self, prompt: str) -> str:
 
         result = await Runner.run(agent, input=prompt)
         return result.final_output
+
+
+# @@@SNIPEND

openai_agents/basic/workflows/tools_workflow.py

@@ -9,6 +9,7 @@
 from openai_agents.basic.activities.get_weather_activity import get_weather
 
 
+# @@@SNIPSTART python-openai-agents-activity-tool-workflow
 @workflow.defn
 class ToolsWorkflow:
     @workflow.run
@@ -25,3 +26,6 @@ async def run(self, question: str) -> str:
 
         result = await Runner.run(agent, input=question)
         return result.final_output
+
+
+# @@@SNIPEND

openai_agents/customer_service/workflows/customer_service_workflow.py

@@ -56,6 +56,7 @@ def __init__(
             customer_service_state.input_items if customer_service_state else []
         )
 
+    # @@@SNIPSTART python-openai-agents-continue-as-new-workflow
     @workflow.run
     async def run(
         self, customer_service_state: CustomerServiceWorkflowState | None = None
@@ -73,6 +74,8 @@ async def run(
             )
         )
 
+    # @@@SNIPEND
+
     @workflow.query
     def get_chat_history(self) -> list[str]:
         return self.printed_history

openai_agents/hosted_mcp/workflows/approval_mcp_workflow.py

@@ -10,6 +10,7 @@
 from temporalio import workflow
 
 
+# @@@SNIPSTART python-openai-agents-hosted-mcp-approval-workflow
 def approval_callback(request: MCPToolApprovalRequest) -> MCPToolApprovalFunctionResult:
     """Simple approval callback that logs the request and approves by default.
 
@@ -23,6 +24,9 @@ def approval_callback(request: MCPToolApprovalRequest) -> MCPToolApprovalFunctio
     return result
 
 
+# @@@SNIPEND
+
+
 @workflow.defn
 class ApprovalMCPWorkflow:
     @workflow.run

openai_agents/hosted_mcp/workflows/simple_mcp_workflow.py

@@ -4,6 +4,7 @@
 from temporalio import workflow
 
 
+# @@@SNIPSTART python-openai-agents-hosted-mcp-workflow
 @workflow.defn
 class SimpleMCPWorkflow:
     @workflow.run
@@ -26,3 +27,6 @@ async def run(
 
         result = await Runner.run(agent, question)
         return result.final_output
+
+
+# @@@SNIPEND