Files
Donald Pinckney 559ec2842b Add TypeScript OpenTelemetry integration docs (#245)
* Add TypeScript OpenTelemetry integration docs

Split out from the OpenTelemetry plugins topic (PR #243) so the TypeScript
material can be finalized separately. Adds the TS OTel integration
reference, the Distributed Tracing section in TS observability, and the
TS row in the integrations catalog.

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

* fix: align python with ts skill

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: Patrik Beqo <patbeqo@gmail.com>
Co-authored-by: Patrik Beqo <patrik.beqo@temporal.io>
2026-08-20 11:29:32 -04:00

5.1 KiB

Third-Party Integrations Catalog

Temporal ships and supports a growing set of integrations with third-party frameworks and SDKs — typically as plugins, contrib modules, or starter libraries. This file is the catalog. Each integration has a dedicated reference under references/{language}/integrations/.

How to use this catalog

  1. Find the row matching the framework, SDK, or library the user is working with.
  2. Confirm the language column matches what the user is building in.
  3. Read the linked reference file for setup, APIs, and pitfalls.
  4. Cross-check the Related column — for AI/LLM integrations, also read references/core/ai-patterns.md and the language's ai-patterns.md; for Spring-based integrations, read references/java/integrations/spring-boot.md first.

Catalog

Integration Language(s) What it does Reference Related
Spring Boot (temporal-spring-boot-starter) Java Auto-configuration of WorkflowClient, worker factories, workflow/activity bean registration, lifecycle, testing references/java/integrations/spring-boot.md references/java/java.md
Spring AI (temporal-spring-ai) Java Durable Spring AI agents: chat-model calls run as Activities; tools dispatched per type (Activity stub, Nexus stub, @SideEffectTool, plain); vector stores, embeddings, and MCP clients auto-registered references/java/integrations/spring-ai.md references/java/integrations/spring-boot.md, references/core/ai-patterns.md
OpenAI Agents SDK (temporalio.contrib.openai_agents) Python Durable OpenAI Agents SDK agents: model calls run as Activities via OpenAIAgentsPlugin; tools are Activities (activity_as_tool) or workflow-resident @function_tools; stateless/stateful MCP, sandbox backends, streaming, and OpenTelemetry export are supported references/python/integrations/openai-agents-sdk.md references/python/ai-patterns.md, references/core/ai-patterns.md
LangSmith tracing (temporalio.contrib.langsmith) Python Experimental Temporal Plugin that propagates LangSmith trace context across Worker boundaries; lets @traceable run inside Workflows and Activities references/python/integrations/langsmith.md references/python/ai-patterns.md, references/core/ai-patterns.md
LangGraph (temporalio.contrib.langgraph, Pre-release) Python Runs LangGraph Graph-API and Functional-API code as Temporal Workflows - nodes/tasks can execute as either in-workflow or as Activities references/python/integrations/langgraph.md references/python/ai-patterns.md, references/core/ai-patterns.md
Google ADK (temporalio[google-adk]) Python Durable Google ADK agents: model calls run through TemporalModel-wrapped Activities, tools via activity_tool, MCP toolsets via TemporalMcpToolSet references/python/integrations/google-adk.md references/python/ai-patterns.md, references/core/ai-patterns.md
Pydantic AI (pydantic-ai[temporal]) Python Durable agents through the TemporalDurability capability, with model requests, tool calls, and MCP communication executed as Temporal Activities references/python/integrations/pydantic-ai.md references/python/ai-patterns.md, references/core/ai-patterns.md
OpenTelemetry (temporalio[opentelemetry]) Python Distributed tracing for Temporal apps with OpenTelemetry references/python/integrations/opentelemetry.md references/python/observability.md
OpenTelemetry (@temporalio/interceptors-opentelemetry) TypeScript Distributed tracing for Temporal apps with OpenTelemetry references/typescript/integrations/opentelemetry.md references/typescript/observability.md
Braintrust (braintrust[temporal], Public Preview) Python LLM observability + prompt management: BraintrustPlugin traces every Workflow/Activity, wrap_openai captures LLM calls, start_span adds custom context, load_prompt fetches Braintrust-managed prompts references/python/integrations/braintrust.md references/python/ai-patterns.md, references/core/ai-patterns.md
Braintrust (@braintrust/temporal) TypeScript LLM observability: BraintrustTemporalPlugin registers on Client + Worker to trace Workflow/Activity spans; canonical guide hosted by Braintrust references/typescript/integrations/braintrust.md references/core/ai-patterns.md
Mastra (@mastra/temporal, Public Preview) TypeScript Build-time transform of Mastra createWorkflow/createStep definitions into Temporal Workflows and Activities; MastraPlugin auto-registers Activities on the Worker references/typescript/integrations/mastra.md references/typescript/typescript.md, references/core/ai-patterns.md
Vercel AI SDK (@temporalio/ai-sdk, Public Preview) TypeScript Durable Vercel AI SDK agents: AiSdkPlugin wraps generateText and other AI SDK calls as Activities; temporalProvider.languageModel() provides the workflow-safe model; tools dispatch via proxyActivities; stateless MCP servers register through mcpClientFactories and are used in-workflow via TemporalMCPClient references/typescript/integrations/vercel-ai-sdk.md references/core/ai-patterns.md