Skip to content

Add Strands Agents integration guide for TypeScript#4645

Open
brianstrauch wants to merge 6 commits into
mainfrom
ts-strands-agents-integration
Open

Add Strands Agents integration guide for TypeScript#4645
brianstrauch wants to merge 6 commits into
mainfrom
ts-strands-agents-integration

Conversation

@brianstrauch

@brianstrauch brianstrauch commented Jun 2, 2026

Copy link
Copy Markdown
Member

Summary

  • Adds a TypeScript integration guide at docs/develop/typescript/integrations/strands-agents.mdx, mirroring the Python guide (#4607).
  • Links it from the integrations index table and the sidebar.
  • Reworks the /develop/typescript landing page to a single Integrations section listing all four TypeScript integrations (Braintrust, Mastra, Strands Agents, Vercel AI SDK), mirroring the Python landing page.

Code in the guide comes from the TypeScript Strands plugin (sdk-typescript#2091) and samples (samples-typescript#472). Each snippet uses <!--SNIPSTART typescript-strands-… --> tags backed by snipsync markers added in samples-typescript#472.

Important

Merge the snipsync markers in samples-typescript#472 to main before/with this PR — docs CI runs snipsync against main, and the new typescript-strands-* labels won't resolve until they're there. The committed MDX already contains the synced snippet content, so it renders regardless.

Test plan

  • yarn start and confirm the new page renders, with working links from /develop/typescript and /develop/typescript/integrations.
  • Confirm the page shows up in the TypeScript sidebar under Integrations.

🤖 Generated with Claude Code

┆Attachments: EDU-6460 Add Strands Agents integration guide for TypeScript

brianstrauch and others added 2 commits June 2, 2026 13:54
Adds a TypeScript Strands Agents integration guide at
docs/develop/typescript/integrations/strands-agents.mdx, mirroring the Python
guide. Links it from the integrations index, the sidebar, and the
/develop/typescript landing page.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Mirrors the Python landing page: replaces the Vercel-only section with a
single Integrations section linking to all four TypeScript integrations
(Braintrust, Mastra, Strands Agents, Vercel AI SDK).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@brianstrauch brianstrauch requested a review from a team as a code owner June 2, 2026 20:58
@vercel

vercel Bot commented Jun 2, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment Jul 2, 2026 10:24pm

Request Review

@github-actions

github-actions Bot commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

@lennessyy lennessyy self-assigned this Jun 2, 2026
# Conflicts:
#	docs/develop/typescript/integrations/index.mdx
#	sidebars.js
@lennessyy lennessyy enabled auto-merge (squash) July 2, 2026 22:09
Comment thread docs/develop/typescript/index.mdx Outdated
- [Vercel AI SDK integration](/develop/typescript/integrations/ai-sdk)
- [OpenAI Agents SDK Integration](/develop/typescript/integrations/openai-agents)

## Temporal TypeScript Technical Resources

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.

📝 [vale] reported by reviewdog 🐶
[Temporal.Headings] 'Temporal TypeScript Technical Resources' should use sentence-style capitalization.

- Strands Agents
- TypeScript SDK
- Temporal SDKs
description: Run Strands Agents AI workflows with durable execution using the Temporal TypeScript SDK and Strands plugin.

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.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Workflows' instead of 'workflows' when referring to a Temporal term.

- Strands Agents
- TypeScript SDK
- Temporal SDKs
description: Run Strands Agents AI workflows with durable execution using the Temporal TypeScript SDK and Strands plugin.

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.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Durable Execution' instead of 'durable execution' when referring to a Temporal term.

### Run a Strands agent with Durable Execution

The following example runs a Strands agent inside a Temporal Workflow. Model calls execute as Temporal Activities, which
means they get automatic retries, timeouts, and durable execution. If the Worker process crashes mid-conversation,

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.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Durable Execution' instead of 'durable execution' when referring to a Temporal term.

`activityOptions` sets the maximum time each model call Activity can run:

<!--SNIPSTART typescript-strands-hello-world-workflow -->
[strands-agents/src/workflows/hello-world.ts](https://github.com/temporalio/samples-typescript/blob/main/strands-agents/src/workflows/hello-world.ts)

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.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Workflows' instead of 'workflows' when referring to a Temporal term.


### Handle long-running chat sessions

A chat-style Workflow accumulates message history with every turn. Over a long session, the Workflow's event history can

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.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Event History' instead of 'event history' when referring to a Temporal term.

carrying `agent.messages` as input:

<!--SNIPSTART typescript-strands-continue-as-new-workflow -->
[strands-agents/src/workflows/continue-as-new.ts](https://github.com/temporalio/samples-typescript/blob/main/strands-agents/src/workflows/continue-as-new.ts)

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.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Workflows' instead of 'workflows' when referring to a Temporal term.

carrying `agent.messages` as input:

<!--SNIPSTART typescript-strands-continue-as-new-workflow -->
[strands-agents/src/workflows/continue-as-new.ts](https://github.com/temporalio/samples-typescript/blob/main/strands-agents/src/workflows/continue-as-new.ts)

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.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Continue-As-New' instead of 'continue-as-new' when referring to a Temporal term.

```
<!--SNIPEND-->

### Add tracing with OpenTelemetry

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.

📝 [vale] reported by reviewdog 🐶
[Temporal.Headings] 'Add tracing with OpenTelemetry' should use sentence-style capitalization.


### Snapshots are not supported

`TemporalAgent.takeSnapshot()` and `TemporalAgent.loadSnapshot()` throw. Temporal's event history already persists

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.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Event History' instead of 'event history' when referring to a Temporal term.

Fixes casing on Temporal terms (Durable Execution, Retry Policy, Task
Queue, Timer, Activity, Failure Converter, Data Converter, Event
History) and the technical-resources heading. Adds MCP and
OpenTelemetry as Headings exceptions since they were valid proper
nouns mid-heading, not miscapitalized text. Drops 'audit logging' from
the required-term substitution list.
The strands-agents sidebar entry was missing a trailing comma,
causing a ParseError when Docusaurus loaded sidebars.js.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do-not-merge What it says on the label

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants