Skip to content

Document released standalone AI integration packages - #5513

Merged
Duncanma merged 9 commits into
mainfrom
brian/java-spring-ai-standalone-package
Oct 26, 2026
Merged

Duncanma merged 9 commits into
mainfrom
brian/java-spring-ai-standalone-package

Conversation

@brianstrauch

@brianstrauch brianstrauch commented Oct 16, 2026 •

Copy link
Copy Markdown
Member

What does this PR do?

Update AI integration guides to use the released standalone packages maintained in temporalio/ai-integrations:

  • Java: use io.temporal:spring-ai, document migration from the previous package, immutable options, provider retries, and replay incompatibility. Use version properties in Maven and Gradle, and link to maintained compatibility requirements. Refresh the Java snippets from the migrated samples.
  • Python: update installation commands, import paths, MCP extras, and related links for the standalone Deep Agents, Google ADK, Google GenAI, LangGraph, LangSmith, and Strands Agents packages. Link to package metadata for supported Python and dependency versions.
  • TypeScript: use @temporalio/vercel-ai-sdk and @temporalio/google-adk, including their Workflow and testing entry points. Link to package requirements, update renamed sample paths and replay migration guidance, and use current MCP and structured-output APIs. Remove the Vercel preview notice and mark Google ADK as Public Preview.
  • Go: retain the merged go.temporal.io/googleadk installation and import paths, and clarify that the module is versioned separately from the Go SDK.

Notes to reviewers

Keep this PR in draft until these sample migrations merge:

The snippets have been refreshed from those PR heads, with source links targeting main. After all three merge, refresh Snipsync against the sample repositories' main branches and recheck this PR. The TypeScript PR also supplies the renamed sample directories linked here.

All referenced packages are published. The Go sample migration is already merged: temporalio/samples-go#561. No additional package release is required.

Validation

  • yarn build passes, including the font preload check.
  • CI-scoped Vale passes for all 13 changed pages.
  • TypeScript sample check: 8 hand-written samples checked against published packages; no findings.
  • Python sample check: 28 hand-written samples checked against published packages; no findings.
  • Snipsync markers are paired, and all 71 snippets on the integration pages have matching source markers in the sample snapshots (6 Java, 7 Go, 53 Python, 5 TypeScript).
  • git diff --check passes.

@vercel

vercel Bot commented Oct 16, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
temporal-documentation Ready Ready Preview Oct 26, 2026 5:52pm UTC

Request Review

@github-actions

github-actions Bot commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

@brianstrauch brianstrauch changed the title Document standalone Spring AI package and Spring AI 2 migration Document released standalone AI integration packages Oct 19, 2026
@github-actions

github-actions Bot commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

Snipsync coverage

SDK code lines in docs/ that come from Snipsync: 25.4% → 25.4% (±0.0 pts), 9,761 of 38,480 lines.

Section Snipsync lines Inline lines Snipsync % Change
develop/typescript 1,948 → 1,925 2,026 49.0% → 48.7% −0.3 pts
All sections

All languages: 22.2% (10,292 of 46,409 lines).

Section Snipsync lines Inline lines Snipsync %
design-patterns 26 7,808 0.3%
develop/python 1,747 2,971 37.0%
guides 34 4,494 0.8%
develop/go 4,285 80 98.2%
develop/java 1,061 3,108 25.4%
develop/typescript 1,925 2,026 48.7%
develop/dotnet 35 2,071 1.7%
develop/rust 0 1,257 0.0%
develop/php 30 1,144 2.6%
develop/ruby 21 1,145 1.8%
develop 484 604 44.5%
production-deployment 54 805 6.3%
encyclopedia 0 837 0.0%
develop/worker-performance 48 177 21.3%
cloud 0 127 0.0%
references 0 48 0.0%
best-practices 11 17 39.3%
Language Snipsync lines Inline lines Snipsync %
Python 1,890 9,051 17.3%
Go 4,425 3,181 58.2%
Java 1,146 5,652 16.9%
TypeScript 2,092 4,484 31.8%
C# 110 2,533 4.2%
Ruby 68 1,326 4.9%
Rust 0 1,324 0.0%
PHP 30 1,168 2.5%
Snipsync origin Lines
temporalio/documentation-sdk-code-examples 4,028
temporalio/samples-typescript 1,776
temporalio/samples-python 1,729
temporalio/samples-java 942
temporalio/features 699
temporalio/samples-go 384
temporalio/sdk-typescript 119
unattributed 35
temporalio/samples-php 30
temporalio/reference-app-orders-go 11
temporalio/samples-dotnet 8

Compared with eb7722f. Counts non-blank lines in fenced code blocks tagged with an SDK language. Hand-written code isn't compiled anywhere; code Snipsync pulls from a sample repository is built in that repository's CI. See UTILITIES.md.

Duncanma added a commit that referenced this pull request Oct 21, 2026
Restore the five Python integration pages to their state on main. Running
Snipsync for the Go migration also pulled samples-python#384, which moves
the Deep Agents, Google ADK, Google GenAI, and Strands Agents samples to
the standalone packages (for example, temporalio.contrib.deepagents ->
temporalio.deepagents).

Shipping those imports here would leave each page's install steps pointing
at the old extras (pip install "temporalio[deepagents]"), so readers who
follow the page would hit an ImportError. Draft PR #5513 updates the
install instructions, prose, and snippets together for these pages, so the
refresh belongs there. The openrouter.mdx change was trailing blank lines
from the same Snipsync run.
flippedcoder added a commit that referenced this pull request Oct 21, 2026
* feat(go): updated workflows > messages to use snipsync

* feat(go): updated workflows > schedules to use snipsync

* feat(go): updated workflows > timers to use snipsync

* feat(go): updated workflows > selectors to use snipsync

* feat(go): updated workflows > side-effects to use snipsync

* feat(go): updated workflows > dynamic-workflow to use snipsync

* feat(go): updated workflows > versioning to use snipsync

* feat(go): updated workflows > workflow-streams to use snipsync

* feat(go): updated workers > run-process to use snipsync

* feat(go): updated workers > sessions to use snipsync

* feat(go): updated workers > interceptors to use snipsync

* feat(go): updated workers > aws-lambda to use snipsync

* feat(go): updated workers > cloud-run to use snipsync

* feat(go): updated client > temporal-client to use snipsync

* feat(go): updated client > namespaces to use snipsync

* feat(go): updated nexus > feature guide to use snipsync

* feat(go): updated nexus > standalone to use snipsync

* feat(go): updated platform > enrich-ui to use snipsync

* feat(go): updated platform > observability to use snipsync

* feat(go): updated best practices > context propagation to use snipsync

* feat(go): updated best practices > error handling to use snipsync

* feat(go): updated best practices > debugging to use snipsync

* feat(go): updated best practices > testing to use snipsync

* feat(go): updated best practices > data handling > conversion to use snipsync

* feat(go): updated best practices > data handling > encryption to use snipsync

* feat(go): updated best practices > data handling > external storage to use snipsync

* nit(snipsync): added other files that updated from snipsync

* feat(components): updated CodeSnippet to accept snipsync blocks as content

* feat(go): updated nexus > quickstart to use snipsync

* docs: fix WorkflowRun method name and ListNamespaces API name

- Go temporal-client: WorkflowRun exposes GetID(), not GetWorkflowID().
  The synced start-workflow snippet on the same page calls GetID().
- Java namespaces: rename ListNamespace to ListNamespaces to match the
  WorkflowService RPC and the corrected Go page.

* docs(python): hold integration snippet refresh for #5513

Restore the five Python integration pages to their state on main. Running
Snipsync for the Go migration also pulled samples-python#384, which moves
the Deep Agents, Google ADK, Google GenAI, and Strands Agents samples to
the standalone packages (for example, temporalio.contrib.deepagents ->
temporalio.deepagents).

Shipping those imports here would leave each page's install steps pointing
at the old extras (pip install "temporalio[deepagents]"), so readers who
follow the page would hit an ImportError. Draft PR #5513 updates the
install instructions, prose, and snippets together for these pages, so the
refresh belongs there. The openrouter.mdx change was trailing blank lines
from the same Snipsync run.

---------

Co-authored-by: Duncan Mackenzie <duncan.mackenzie@temporal.io>
@brianstrauch
brianstrauch marked this pull request as ready for review October 26, 2026 17:06
@brianstrauch
brianstrauch requested a review from a team as a code owner October 26, 2026 17:06
Copilot AI balanced review requested due to automatic review settings October 26, 2026 17:06

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

Java sample PR #810 and TypeScript sample PR #532 remain unmerged, leaving the required main-branch Snipsync refresh and final recheck pending.

No open issues 🎉

What changed in this PR

Updates Temporal’s AI integration documentation to use released standalone packages maintained in temporalio/ai-integrations.

Changes:

  • Updates installation commands, imports, compatibility references, and sample links.
  • Adds Java and TypeScript Google ADK migration guidance, including replay limitations.
  • Refreshes API examples and release-stage notices, and clarifies independent package versioning.
File Description
docs/​guides/​durable-agent-on-agentcore.mdx Links TemporalAgent to the Strands integration guide.
docs/​develop/​typescript/​integrations/​google-adk-agents.mdx Updates package paths, migration guidance, and Public Preview status.
docs/​develop/​typescript/​integrations/​ai-sdk.mdx Adopts the standalone package and current MCP and structured-output APIs.
docs/​develop/​python/​integrations/​strands-agents.mdx Updates installation, imports, and compatibility references.
docs/​develop/​python/​integrations/​langsmith.mdx Uses the standalone LangSmith package and imports.
docs/​develop/​python/​integrations/​langgraph.mdx Updates package imports and runtime guidance.
docs/​develop/​python/​integrations/​index.mdx Introduces standalone AI integration packages.
docs/​develop/​python/​integrations/​google-genai.mdx Updates package installation, imports, and MCP extras.
docs/​develop/​python/​integrations/​google-adk.mdx Updates package installation, helper paths, and MCP extras.
docs/​develop/​python/​integrations/​deepagents.mdx Updates package imports, requirements, and tracing links.
docs/​develop/​plugins-guide.mdx Points LangGraph readers to the standalone integration.
docs/​develop/​java/​integrations/​spring-ai.mdx Updates dependencies, migration guidance, snippets, and provider retries.
docs/​develop/​go/​integrations/​google-adk.mdx Clarifies independent module versioning.

Review effort: Balanced

@Duncanma
Duncanma merged commit 62b8cb2 into main Oct 26, 2026
20 checks passed
@Duncanma
Duncanma deleted the brian/java-spring-ai-standalone-package branch October 26, 2026 17:54

This branch was successfully deployed

1 active deployment
Preview — 167c08c0 Deployed Oct 26, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants