Merge branch 'main' into docs/spring-ai-integration

Author: donald-pinckney

docs/develop/plugins-guide.mdx

@@ -976,6 +976,9 @@ worker = Temporalio::Worker.new(
   </SdkTabs.Ruby>
 </SdkTabs>
 
-Check for duplicate side effects or other types of failures.
+Inside this replay regime, you should test for duplicate side effects or other types of failures. When testing for duplicate side effects, it may not be sufficient to simply have a counter that increments once per effect, as activities may be retried. Instead, consider these patterns:
+
+- count `ActivityTaskScheduled` events of the expected activity type in workflow history (one per intended call, independent of retries), 
+- or accumulate activity IDs in a concurrency-safe set and assert on its size (different scheduled activities get different IDs; retries of the same scheduled activity share one).
 
 It's harder to test against side effects to global variables, so this practice is best avoided entirely.

docs/develop/python/index.mdx

@@ -40,6 +40,8 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 - [Message passing](/develop/python/workflows/message-passing)
 - [Schedules](/develop/python/workflows/schedules)
 - [Timers](/develop/python/workflows/timers)
+- [Versioning](/develop/python/workflows/versioning)
+- [Workflow Streams](/develop/python/workflows/workflow-streams)
 
 ## [Activities](/develop/python/activities)
 

docs/develop/python/integrations/index.mdx

@@ -24,7 +24,6 @@ The following integrations are available between the Temporal Python SDK and thi
 | ----------------- | --------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
 | Braintrust        | Observability   | [braintrust.dev](https://braintrust.dev/docs)                      | [Guide](./braintrust.mdx)                                                                              |
 | Google ADK        | Agent framework | [adk.dev](https://adk.dev/)                                        | [Guide](https://adk.dev/integrations/temporal/)                                                        |
-| Mastra            | Agent framework | [mastra.ai](https://mastra.ai/docs)                                | [Guide](https://mastra.ai/guides/deployment/temporal)                                                  |
 | OpenAI Agents SDK | Agent framework | [openai.github.io](https://openai.github.io/openai-agents-python/) | [Guide](https://github.com/temporalio/sdk-python/blob/main/temporalio/contrib/openai_agents/README.md) |
 | Pydantic AI       | Agent framework | [ai.pydantic.dev](https://ai.pydantic.dev/)                        | [Guide](https://ai.pydantic.dev/durable_execution/temporal/)                                           |
 | Tenuo             | Governance      | [tenuo.ai](https://tenuo.ai/docs)                                  | [Guide](https://tenuo.ai/temporal)                                                                     |

docs/develop/python/workflows/index.mdx

@@ -26,3 +26,4 @@ import * as Components from '@site/src/components';
 - [Schedules](/develop/python/workflows/schedules)
 - [Timers](/develop/python/workflows/timers)
 - [Versioning](/develop/python/workflows/versioning)
+- [Workflow Streams](/develop/python/workflows/workflow-streams)

docs/develop/python/workflows/workflow-streams.mdx

@@ -20,3 +20,4 @@ The following AI framework and tooling integrations are available for the Tempor
 | ---------------- | --------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------ |
 | AI SDK by Vercel | Agent framework | [ai-sdk.dev](https://ai-sdk.dev/docs/introduction) | [Guide](/develop/typescript/integrations/ai-sdk)                                           |
 | Braintrust       | Observability   | [braintrust.dev](https://braintrust.dev/docs)      | [Guide](https://www.braintrust.dev/docs/integrations/sdk-integrations/temporal#typescript) |
+| Mastra           | Agent framework | [mastra.ai](https://mastra.ai/docs)                | [Guide](https://mastra.ai/guides/deployment/temporal)                                      |

docs/develop/typescript/integrations/index.mdx

@@ -477,6 +477,7 @@ module.exports = {
                 'develop/python/workflows/schedules',
                 'develop/python/workflows/timers',
                 'develop/python/workflows/versioning',
+                'develop/python/workflows/workflow-streams',
               ]
             },
             {

sidebars.js

@@ -0,0 +1 @@
+{"all_stable_ip_ranges":["3.229.203.187/32","32.195.242.129/32","34.208.249.29/32","34.211.38.49/32","34.227.237.139/32","35.170.146.46/32","44.207.172.91/32","44.214.48.214/32","44.237.88.255/32","52.6.153.180/32","52.204.167.77/32","54.84.220.125/32","54.152.76.20/32","54.185.213.9/32","54.187.32.70/32","54.201.80.128/32","98.91.139.193/32","100.23.17.212/32","100.51.115.64/32","136.115.61.78/32","136.117.224.20/32","184.32.170.131/32"],"clouds":{"aws":{"regions":{"us-east-1":{"stable_ip_ranges":["3.229.203.187/32","32.195.242.129/32","34.227.237.139/32","35.170.146.46/32","44.207.172.91/32","44.214.48.214/32","52.6.153.180/32","52.204.167.77/32","54.84.220.125/32","54.152.76.20/32","98.91.139.193/32","100.51.115.64/32"]},"us-west-2":{"stable_ip_ranges":["34.208.249.29/32","34.211.38.49/32","44.237.88.255/32","54.185.213.9/32","54.187.32.70/32","54.201.80.128/32","100.23.17.212/32","184.32.170.131/32"]}}},"gcp":{"regions":{"us-central1":{"stable_ip_ranges":["136.115.61.78/32"]},"us-west1":{"stable_ip_ranges":["136.117.224.20/32"]}}}}}