workflow 5.0.0-beta.42 → 5.0.0-beta.44

package/docs/api-reference/workflow/get-workflow-metadata.mdx

@@ -30,7 +30,7 @@ async function testWorkflow() {
 }
 ```
 
-### Detecting Workflow Runtime
+### Detecting workflow runtime
 
 You can use `getWorkflowMetadata` to detect whether your code is running inside a workflow context. This is useful when building shared utilities that need to behave differently inside and outside of workflows.
 
@@ -64,7 +64,7 @@ function log(message: string) {
 }
 ```
 
-### Detecting Encryption
+### Detecting encryption
 
 The `features` object indicates which capabilities are active for the current run. Library authors can use `features.encryption` to control whether sensitive data is included in step return values, which are serialized to the event log:
 
@@ -90,7 +90,7 @@ async function fetchUserProfile(userId: string) {
 }
 ```
 
-## API Signature
+## API signature
 
 ### Parameters
 

package/docs/api-reference/workflow/get-writable.mdx

@@ -47,7 +47,7 @@ async function writeToStream(writable: WritableStream) {
 }
 ```
 
-## API Signature
+## API signature
 
 ### Parameters
 
@@ -69,7 +69,7 @@ export default getWritable;`}
 
 Returns a `WritableStream<W>` where `W` is the type of data you plan to write to the stream.
 
-## Good to Know
+## Good to know
 
 - **Workflow functions can only obtain the stream** - Call `getWritable()` in a workflow to get the stream reference, but you cannot call methods like `getWriter()`, `write()`, or `close()` directly in the workflow context.
 - **Step functions can interact with streams** - Steps can receive the stream as an argument or call `getWritable()` directly, and they can freely interact with it (write, close, etc.).
@@ -81,9 +81,9 @@ Returns a `WritableStream<W>` where `W` is the type of data you plan to write to
 
 ## Examples
 
-### Basic Text Streaming
+### Basic text streaming
 
-Here's a simple example streaming text data:
+This example streams text data:
 
 ```typescript lineNumbers
 import { sleep, getWritable } from "workflow";
@@ -118,7 +118,7 @@ async function stepCloseOutputStream(writable: WritableStream) {
 }
 ```
 
-### Calling `getWritable()` Inside Steps
+### Calling `getWritable()` inside steps
 
 You can also call `getWritable()` directly inside step functions without passing it as a parameter:
 
@@ -157,7 +157,7 @@ async function stepCloseOutputStreamInside() {
 }
 ```
 
-### Using Namespaced Streams in Steps
+### Using namespaced streams in steps
 
 You can also use namespaced streams when calling `getWritable()` from steps:
 
@@ -201,7 +201,7 @@ async function closeStreams() {
 }
 ```
 
-### Advanced Chat Streaming
+### Advanced chat streaming
 
 Here's a more complex example showing how you might stream AI chat responses:
 

package/docs/api-reference/workflow/index.mdx

@@ -52,7 +52,7 @@ Workflow SDK contains the following functions you can use inside your workflow f
     </Card>
 </Cards>
 
-## Error Classes
+## Error classes
 
 Workflow SDK includes error classes that can be thrown in a workflow or step to change the error exit strategy of a workflow.
 

package/docs/api-reference/workflow/retryable-error.mdx

@@ -31,7 +31,7 @@ async function retryStep() {
 The difference between `Error` and `RetryableError` may not be entirely obvious, since when both are thrown, they both retry. The difference is that `RetryableError` has an additional configurable `retryAfter` parameter.
 </Callout>
 
-## API Signature
+## API signature
 
 ### Parameters
 

package/docs/api-reference/workflow/set-attributes.mdx

@@ -25,7 +25,7 @@ export async function orderWorkflow(orderId: string) {
 }
 ```
 
-## API Signature
+## API signature
 
 ### Parameters
 
@@ -58,4 +58,4 @@ Validation errors throw [`FatalError`](/docs/api-reference/workflow/fatal-error)
 
 Calls from both workflow and step bodies append a native `attr_set` event, which the World materializes onto `run.attributes`. Workflow-originated events record a workflow writer; step-originated events record the originating step ID and attempt.
 
-Native attributes require spec version 4 or later. Step-body storage errors throw from `setAttributes`; catch them inside the step if the write should be best-effort. Workflow-body writes are committed when the workflow suspends: transient storage errors are retried with the suspension, while a write the World rejects as invalid — such as exceeding the per-run attribute cap across multiple calls — fails the run with the validation error.
+Native attributes require spec version 4 or later. Step-body storage errors throw from `setAttributes`; catch them inside the step if the write should be best-effort. Workflow-body writes are committed when the workflow suspends: transient storage errors are retried with the suspension, while a write the World rejects as invalid (such as exceeding the per-run attribute cap across multiple calls) fails the run with the validation error.

package/docs/api-reference/workflow/sleep.mdx

@@ -26,7 +26,7 @@ async function testWorkflow() {
 }
 ```
 
-## API Signature
+## API signature
 
 ### Parameters
 
@@ -39,7 +39,7 @@ showSections={['parameters']}
 
 ## Examples
 
-### Sleeping With a Duration
+### Sleeping with a duration
 
 You can specify a duration for `sleep` to suspend the workflow for a fixed amount of time.
 
@@ -52,7 +52,7 @@ async function testWorkflow() {
 }
 ```
 
-### Sleeping Until an End Date
+### Sleeping until an end date
 
 You can specify a future `Date` object for `sleep` to suspend the workflow until a specific date.
 

package/docs/api-reference/workflow-ai/durable-agent.mdx

@@ -10,14 +10,14 @@ related:
 ---
 
 <Callout type="warn">
-`DurableAgent` is deprecated. Use AI SDK's [`WorkflowAgent`](https://ai-sdk.dev/v7/docs/agents/workflow-agent#workflowagent) for new durable agents — see the [migration guide](https://ai-sdk.dev/v7/docs/agents/workflow-agent#migrating-from-durableagent).
+`DurableAgent` is deprecated. Use AI SDK's [`WorkflowAgent`](https://ai-sdk.dev/v7/docs/agents/workflow-agent#workflowagent) for new durable agents. See the [migration guide](https://ai-sdk.dev/v7/docs/agents/workflow-agent#migrating-from-durableagent).
 </Callout>
 
 This reference is kept for existing applications that still import `DurableAgent` from `@workflow/ai/agent`. Do not use `DurableAgent` for new code.
 
 For current examples and implementation guidance, see AI SDK's [`WorkflowAgent`](https://ai-sdk.dev/v7/docs/agents/workflow-agent#workflowagent) docs. For legacy code, the API surface below documents the existing `DurableAgent` exports.
 
-## API Signature
+## API signature
 
 ### Class
 
@@ -125,7 +125,7 @@ import type { StreamTextOnAbortCallback } from "@workflow/ai/agent";
 export default StreamTextOnAbortCallback;`}
 />
 
-### Advanced Types
+### Advanced types
 
 #### ToolCallRepairFunction
 
@@ -157,30 +157,30 @@ import type { OutputSpecification } from "@workflow/ai/agent";
 export default OutputSpecification;`}
 />
 
-## Key Features
+## Key features
 
-- **Durable Execution**: Agents can be interrupted and resumed without losing state
-- **Flexible Tool Implementation**: Tools can be implemented as workflow steps for automatic retries, or as regular workflow-level logic
-- **Stream Processing**: Handles streaming responses and tool calls in a structured way
-- **Workflow Native**: Fully integrated with Workflow SDK for production-grade reliability
-- **AI SDK Parity**: Supports the same options as AI SDK's `streamText` including generation settings, callbacks, and structured output
+- **Durable execution**: Agents can be interrupted and resumed without losing state.
+- **Flexible tool implementation**: Tools can be implemented as workflow steps for automatic retries or as regular workflow-level logic.
+- **Stream processing**: Handles streaming responses and tool calls in a structured way.
+- **Workflow native**: Fully integrated with Workflow SDK for production reliability.
+- **AI SDK parity**: Supports the same options as AI SDK's `streamText`, including generation settings, callbacks, and structured output.
 
-## Good to Know
+## Good to know
 
-- Tools can be implemented as workflow steps (using `"use step"` for automatic retries), or as regular workflow-level logic
-- Tools can use core library features like `sleep()` and Hooks within their `execute` functions
-- The agent processes tool calls iteratively until completion or `maxSteps` is reached
-- **Default `maxSteps` is unlimited** - set a value to limit the number of LLM calls
-- The `stream()` method returns `{ messages, steps, toolCalls, toolResults, experimental_output, uiMessages }` containing the full conversation history, step details, tool call details, optional structured output, and optionally accumulated UI messages
-- Use `collectUIMessages: true` to accumulate `UIMessage[]` during streaming, useful for persisting conversation state without re-reading the stream
-- The `prepareStep` callback runs before each step and can modify model, messages, generation settings, tool choice, and context
-- Generation settings (temperature, maxOutputTokens, etc.) can be set on the constructor and overridden per-stream call
-- Use `activeTools` to limit which tools are available for a specific stream call
-- The `onFinish` callback is called when all steps complete; `onAbort` is called if aborted
+- Tools can be implemented as workflow steps (using `"use step"` for automatic retries) or as regular workflow-level logic.
+- Tools can use core library features like `sleep()` and hooks within their `execute` functions.
+- The agent processes tool calls iteratively until completion or until `maxSteps` is reached.
+- **Default `maxSteps` is unlimited**: Set a value to limit the number of large language model (LLM) calls.
+- The `stream()` method returns `{ messages, steps, toolCalls, toolResults, experimental_output, uiMessages }` containing the full conversation history, step details, tool call details, optional structured output, and optionally accumulated user interface (UI) messages.
+- Use `collectUIMessages: true` to accumulate `UIMessage[]` during streaming, which is useful for persisting conversation state without re-reading the stream.
+- The `prepareStep` callback runs before each step and can modify the model, messages, generation settings, tool choice, and context.
+- Generation settings (`temperature`, `maxOutputTokens`, and others) can be set on the constructor and overridden per-stream call.
+- Use `activeTools` to limit which tools are available for a specific stream call.
+- The `onFinish` callback is called when all steps complete; `onAbort` is called if aborted.
 
 ## Examples
 
-### Basic Agent with Tools
+### Basic agent with tools
 
 ```typescript
 import { DurableAgent } from "@workflow/ai/agent";
@@ -222,7 +222,7 @@ async function weatherAgentWorkflow(userQuery: string) {
 }
 ```
 
-### Multiple Tools
+### Multiple tools
 
 ```typescript
 import { DurableAgent } from "@workflow/ai/agent";
@@ -271,7 +271,7 @@ async function multiToolAgentWorkflow(userQuery: string) {
 }
 ```
 
-### Multi-turn Conversation
+### Multi-turn conversation
 
 ```typescript
 import { DurableAgent } from "@workflow/ai/agent";
@@ -325,7 +325,7 @@ async function multiTurnAgentWorkflow() {
 }
 ```
 
-### Tools with Workflow Library Features
+### Tools with Workflow library features
 
 ```typescript
 import { DurableAgent } from "@workflow/ai/agent";
@@ -347,7 +347,7 @@ async function requestApproval({ message }: { message: string }) {
   // Note: No "use step" for this tool call either,
   // since hooks are awaited at the workflow level
 
-  // Utilize a Hook for Human-in-the-loop approval
+  // Use a Hook for Human-in-the-loop approval
   const hook = approvalHook.create({
     metadata: { message }
   });
@@ -392,7 +392,7 @@ async function agentWithLibraryFeaturesWorkflow(userRequest: string) {
 }
 ```
 
-### Dynamic Context with prepareStep
+### Dynamic context with prepareStep
 
 Use `prepareStep` to modify settings before each step in the agent loop:
 
@@ -436,7 +436,7 @@ async function agentWithPrepareStep(userMessage: string) {
 }
 ```
 
-### Message Injection with prepareStep
+### Message injection with prepareStep
 
 Inject messages from external sources (like hooks) before each LLM call:
 
@@ -486,7 +486,7 @@ async function agentWithMessageQueue(initialMessage: string) {
 }
 ```
 
-### Generation Settings
+### Generation settings
 
 Configure model generation parameters at the constructor or stream level:
 
@@ -524,7 +524,7 @@ async function agentWithGenerationSettings() {
 }
 ```
 
-### Limiting Steps with maxSteps
+### Limiting steps with maxSteps
 
 By default, the agent loops until completion. Use `maxSteps` to limit the number of LLM calls:
 
@@ -575,7 +575,7 @@ async function multiStepAgent() {
 }
 ```
 
-### Callbacks for Monitoring
+### Callbacks for monitoring
 
 Use callbacks to monitor streaming progress, handle errors, and react to completion:
 
@@ -616,7 +616,7 @@ async function agentWithCallbacks() {
 }
 ```
 
-### Structured Output
+### Structured output
 
 Parse structured data from the LLM response using `Output.object`:
 
@@ -651,7 +651,7 @@ async function agentWithStructuredOutput() {
 }
 ```
 
-### Tool Choice Control
+### Tool choice control
 
 Control when and which tools the model can use:
 
@@ -714,7 +714,7 @@ async function agentWithToolChoice() {
 }
 ```
 
-### Passing Context to Tools
+### Passing context to tools
 
 Use `experimental_context` to pass shared context to tool executions:
 
@@ -758,7 +758,7 @@ async function agentWithContext(userId: string) {
 }
 ```
 
-### Collecting UI Messages
+### Collecting UI messages
 
 Use `collectUIMessages` to accumulate `UIMessage[]` during streaming. This is useful when you need to persist the conversation without re-reading the run's output stream:
 
@@ -800,7 +800,7 @@ async function saveConversation(messages: UIMessage[]) {
 The `uiMessages` property is only available when `collectUIMessages` is set to `true`. When disabled, `uiMessages` is `undefined`.
 </Callout>
 
-### Machine-Readable Tool Results
+### Machine-readable tool results
 
 `stream()` returns tool call information you can inspect programmatically. Compare `toolCalls` with `toolResults` to find unresolved tool calls that need client-side handling:
 
@@ -857,7 +857,7 @@ async function agentWithToolInspection(userMessage: string) {
 `toolCalls` and `toolResults` reflect the *last step* of the agent loop. Tools without an `execute` function will appear in `toolCalls` but not in `toolResults`, which is how you detect calls that need client-side handling.
 </Callout>
 
-### Aborting Long-Running Streams
+### Aborting long-running streams
 
 Use `timeout` to abort a stream automatically after a fixed duration:
 
@@ -885,10 +885,10 @@ async function agentWithTimeout(userMessage: string) {
 }
 ```
 
-## See Also
+## See also
 
-- [Building Durable AI Agents](/docs/ai) - Complete guide to creating durable agents
-- [Queueing User Messages](/docs/ai/message-queueing) - Using prepareStep for message injection
-- [WorkflowChatTransport](/docs/api-reference/workflow-ai/workflow-chat-transport) - Transport layer for AI SDK streams
-- [Workflows and Steps](/docs/foundations/workflows-and-steps) - Understanding workflow fundamentals
-- [AI SDK Loop Control](https://ai-sdk.dev/docs/agents/loop-control) - AI SDK's agent loop control patterns
+- [Building Durable AI Agents](/docs/ai): Complete guide to creating durable agents
+- [Queueing User Messages](/docs/ai/message-queueing): Using `prepareStep` for message injection
+- [WorkflowChatTransport](/docs/api-reference/workflow-ai/workflow-chat-transport): Transport layer for AI SDK streams
+- [Workflows and Steps](/docs/foundations/workflows-and-steps): Understanding workflow fundamentals
+- [AI SDK Loop Control](https://ai-sdk.dev/docs/agents/loop-control): AI SDK's agent loop control patterns

package/docs/api-reference/workflow-ai/index.mdx

@@ -7,15 +7,15 @@ related:
   - /docs/ai
 ---
 
-Helpers for integrating AI SDK for building AI-powered workflows.
+The `@workflow/ai` package provides helpers for integrating AI SDK into AI-powered workflows.
 
 ## Classes
 
 <Cards>
     <Card title="DurableAgent" href="/docs/api-reference/workflow-ai/durable-agent">
-      Deprecated — use AI SDK's [`WorkflowAgent`](https://ai-sdk.dev/v7/docs/agents/workflow-agent#workflowagent). Reference kept for existing `@workflow/ai/agent` imports.
+      Deprecated: use AI SDK's [`WorkflowAgent`](https://ai-sdk.dev/v7/docs/agents/workflow-agent#workflowagent). Reference kept for existing `@workflow/ai/agent` imports.
     </Card>
     <Card title="WorkflowChatTransport" href="/docs/api-reference/workflow-ai/workflow-chat-transport">
-      Deprecated — use AI SDK's [`WorkflowChatTransport`](https://ai-sdk.dev/v7/docs/agents/workflow-agent#resumable-streaming-with-workflowchattransport) from `@ai-sdk/workflow`. Reference kept for existing `@workflow/ai` imports.
+      Deprecated: use AI SDK's [`WorkflowChatTransport`](https://ai-sdk.dev/v7/docs/agents/workflow-agent#resumable-streaming-with-workflowchattransport) from `@ai-sdk/workflow`. Reference kept for existing `@workflow/ai` imports.
     </Card>
 </Cards>

package/docs/api-reference/workflow-ai/workflow-chat-transport.mdx

@@ -10,10 +10,10 @@ related:
 ---
 
 <Callout type="warn">
-`WorkflowChatTransport` from `@workflow/ai` is deprecated. AI SDK ships a 1:1 port — use [`WorkflowChatTransport` from `@ai-sdk/workflow`](https://ai-sdk.dev/v7/docs/agents/workflow-agent#resumable-streaming-with-workflowchattransport) instead. This reference is kept for existing applications that still import it from `@workflow/ai`.
+`WorkflowChatTransport` from `@workflow/ai` is deprecated. AI SDK ships a 1:1 port, so use [`WorkflowChatTransport` from `@ai-sdk/workflow`](https://ai-sdk.dev/v7/docs/agents/workflow-agent#resumable-streaming-with-workflowchattransport) instead. This reference is kept for existing applications that still import it from `@workflow/ai`.
 </Callout>
 
-A chat transport implementation for the AI SDK that provides reliable message streaming with automatic reconnection to interrupted streams. This transport is a drop-in replacement for the default AI SDK transport, enabling seamless recovery from network issues, page refreshes, or Vercel Function timeouts.
+`WorkflowChatTransport` is an AI SDK chat transport that automatically reconnects to interrupted streams. It replaces the default AI SDK transport and recovers from network issues, page refreshes, or Vercel Functions timeouts.
 
 <Callout>
 `WorkflowChatTransport` implements the [`ChatTransport`](https://ai-sdk.dev/docs/ai-sdk-ui/transport) interface from the AI SDK and is designed to work with workflow-based chat applications. It requires endpoints that return the `x-workflow-run-id` header to enable stream resumption.
@@ -38,7 +38,7 @@ export default function Chat() {
 }
 ```
 
-## API Signature
+## API signature
 
 ### Class
 
@@ -56,27 +56,27 @@ import type { WorkflowChatTransportOptions } from "@workflow/ai";
 export default WorkflowChatTransportOptions;`}
 />
 
-## Key Features
+## Key features
 
-- **Automatic Reconnection**: Automatically recovers from interrupted streams with configurable retry limits
-- **Workflow Integration**: Seamlessly works with workflow-based endpoints that provide the `x-workflow-run-id` header
-- **Customizable Requests**: Allows intercepting and modifying requests via `prepareSendMessagesRequest` and `prepareReconnectToStreamRequest`
-- **Stream Callbacks**: Provides hooks for tracking chat lifecycle via `onChatSendMessage` and `onChatEnd`
-- **Custom Fetch**: Supports custom fetch implementations for advanced use cases
+- **Automatic reconnection**: Recovers from interrupted streams with configurable retry limits.
+- **Workflow integration**: Works with workflow-based endpoints that provide the `x-workflow-run-id` header.
+- **Customizable requests**: Allows intercepting and modifying requests through `prepareSendMessagesRequest` and `prepareReconnectToStreamRequest`.
+- **Stream callbacks**: Provides hooks for tracking the chat lifecycle through `onChatSendMessage` and `onChatEnd`.
+- **Custom fetch**: Supports custom fetch implementations for advanced use cases.
 
-## Good to Know
+## Good to know
 
-- The transport expects chat endpoints to return the `x-workflow-run-id` header in the response to enable stream resumption
-- By default, the transport posts to `/api/chat` and reconnects via `/api/chat/{runId}/stream`
-- The `onChatSendMessage` callback receives the full response object, allowing you to extract and store the workflow run ID for session resumption
-- Stream interruptions are automatically detected when a "finish" chunk is not received in the initial response
-- The `maxConsecutiveErrors` option controls how many reconnection attempts are made before giving up (default: 3)
-- `initialStartIndex` (constructor option) sets the default chunk position for the **first** reconnection attempt (e.g. after a page refresh). Subsequent retries within the same reconnection loop always resume from the last received chunk. Negative values (e.g. `-20`) read from the end of the stream, which is useful for showing only recent output without replaying the full conversation. `startIndex` (per-call option on `reconnectToStream`) overrides `initialStartIndex` for a single reconnection
-- When using a negative `initialStartIndex`, the reconnection endpoint must return the `x-workflow-stream-tail-index` response header (via `readable.getTailIndex()`). The transport reads this header to compute absolute chunk positions for retries. Without it, startIndex is assumed to be 0, replaying the entire stream
+- The transport expects chat endpoints to return the `x-workflow-run-id` header in the response to enable stream resumption.
+- By default, the transport posts to `/api/chat` and reconnects through `/api/chat/{runId}/stream`.
+- The `onChatSendMessage` callback receives the full response object, allowing you to extract and store the workflow run ID for session resumption.
+- Stream interruptions are automatically detected when a `finish` chunk is not received in the initial response.
+- The `maxConsecutiveErrors` option controls how many reconnection attempts are made before giving up (default: 3).
+- `initialStartIndex` (constructor option) sets the default chunk position for the **first** reconnection attempt (for example, after a page refresh). Subsequent retries within the same reconnection loop always resume from the last received chunk. Negative values (for example, `-20`) read from the end of the stream, which is useful for showing only recent output without replaying the full conversation. `startIndex` (per-call option on `reconnectToStream`) overrides `initialStartIndex` for a single reconnection.
+- When using a negative `initialStartIndex`, the reconnection endpoint must return the `x-workflow-stream-tail-index` response header (through `readable.getTailIndex()`). The transport reads this header to compute absolute chunk positions for retries. Without it, `startIndex` is assumed to be `0`, replaying the entire stream.
 
 ## Examples
 
-### Basic Chat Setup
+### Basic chat setup
 
 ```typescript
 "use client";
@@ -119,7 +119,7 @@ export default function BasicChat() {
 }
 ```
 
-### With Session Persistence and Resumption
+### With session persistence and resumption
 
 ```typescript
 "use client";
@@ -187,7 +187,7 @@ export default function ChatWithResumption() {
 }
 ```
 
-### With Custom Request Configuration
+### With custom request configuration
 
 ```typescript
 "use client";
@@ -256,11 +256,11 @@ export default function ChatWithCustomConfig() {
 
 ## Mid-part resumes
 
-A workflow stream is a flat sequence of chunks, but the AI SDK's UI protocol groups chunks into logical parts: a `text-start` opens a text part that subsequent `text-delta`s extend and a `text-end` closes, and the same shape applies to `reasoning-*` and `tool-input-*`. The AI SDK client enforces that grammar — a `reasoning-delta` whose `reasoning-start` was never seen throws and breaks the chat.
+A workflow stream is a flat sequence of chunks, but the AI SDK's user interface (UI) protocol groups chunks into logical parts: a `text-start` opens a text part that subsequent `text-delta`s extend and a `text-end` closes, and the same shape applies to `reasoning-*` and `tool-input-*`. The AI SDK client enforces that grammar: a `reasoning-delta` whose `reasoning-start` was never seen throws and breaks the chat.
 
-A non-zero `startIndex` (in particular a negative `initialStartIndex`) resolves to a chunk offset with no awareness of those part boundaries, so it can land in the middle of an open part. When that happens, `WorkflowChatTransport` will **drop chunks that reference a part it didn't see a start for** and log a one-time warning. The chat keeps working, but any partial part overlapping the resume cursor is discarded. Tool calls are an exception: `tool-input-available` / `tool-input-error` chunks are self-contained (they carry the full input), so a tool call is recovered as soon as one of those chunks appears in the resumed window — only its streamed input deltas are lost.
+A non-zero `startIndex` (in particular a negative `initialStartIndex`) resolves to a chunk offset with no awareness of those part boundaries, so it can land in the middle of an open part. When that happens, `WorkflowChatTransport` will **drop chunks that reference a part it didn't see a start for** and log a one-time warning. The chat keeps working, but any partial part overlapping the resume cursor is discarded. Tool calls are an exception: `tool-input-available` / `tool-input-error` chunks are self-contained (they carry the full input), so a tool call is recovered as soon as one of those chunks appears in the resumed window. Only its streamed input deltas are lost.
 
-To preserve those partial parts, rewind to a step boundary on the server before returning the readable. `start-step` / `finish-step` chunks are the natural seams — no UI part is ever open across them. Sketch:
+To preserve those partial parts, rewind to a step boundary on the server before returning the readable. `start-step` / `finish-step` chunks are the natural seams: no UI part is ever open across them. Sketch:
 
 {/*@skip-typecheck: incomplete code sample*/}
 
@@ -293,9 +293,9 @@ return createUIMessageStreamResponse({
 });
 ```
 
-## See Also
+## See also
 
-- [`WorkflowAgent`](https://ai-sdk.dev/v7/docs/agents/workflow-agent#workflowagent) - Building durable, resumable AI agents (replaces `DurableAgent`)
-- [AI SDK `useChat` Documentation](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat) - Using `useChat` with custom transports
-- [Workflows and Steps](/docs/foundations/workflows-and-steps) - Understanding workflow fundamentals
-- ["flight-booking-app" Example](https://github.com/vercel/workflow-examples/tree/main/flight-booking-app) - An example application which uses `WorkflowChatTransport`
+- [`WorkflowAgent`](https://ai-sdk.dev/v7/docs/agents/workflow-agent#workflowagent): Build durable, resumable AI agents (replaces `DurableAgent`)
+- [AI SDK `useChat` documentation](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat): Use `useChat` with custom transports
+- [Workflows and Steps](/docs/foundations/workflows-and-steps): Understand workflow fundamentals
+- [`flight-booking-app` example](https://github.com/vercel/workflow-examples/tree/main/flight-booking-app): View an example application that uses `WorkflowChatTransport`

package/docs/api-reference/workflow-api/get-hook-by-token.mdx

@@ -18,7 +18,7 @@ When `experimental_minRetention` is set, this function continues to return the H
 </Callout>
 
 <Callout type="info">
-Looking up a deterministic hook token is useful in hook-based idempotency flows, but it is only an advisory check. If no hook exists yet, another request can still start the same workflow before your `start()` call registers its hook. Use the lookup to avoid obvious duplicate starts, and handle the race inside the workflow by checking `await hook.getConflict()` before duplicate-sensitive work — on a conflict it resolves with the run that owns the token, so the duplicate can route the caller to the active owner. If duplicates must be rejected before a workflow body runs, keep a durable request record until native atomic start-and-hook registration exists. See [Run idempotency](/docs/foundations/idempotency#run-idempotency).
+Looking up a deterministic hook token is useful in hook-based idempotency flows, but it is only an advisory check. If no hook exists yet, another request can still start the same workflow before your `start()` call registers its hook. Use the lookup to avoid obvious duplicate starts, and handle the race inside the workflow by checking `await hook.getConflict()` before duplicate-sensitive work. On a conflict it resolves with the run that owns the token, so the duplicate can route the caller to the active owner. If duplicates must be rejected before a workflow body runs, keep a durable request record until native atomic start-and-hook registration exists. See [Run idempotency](/docs/foundations/idempotency#run-idempotency).
 </Callout>
 
 ```typescript lineNumbers
@@ -31,7 +31,7 @@ export async function POST(request: Request) {
 }
 ```
 
-## API Signature
+## API signature
 
 ### Parameters
 
@@ -55,7 +55,7 @@ showSections={["returns"]}
 
 ## Examples
 
-### Basic Hook Lookup
+### Basic hook lookup
 
 Retrieve hook information before resuming:
 
@@ -85,7 +85,7 @@ export async function POST(request: Request) {
 }
 ```
 
-### Validating Hook Before Resume
+### Validating hook before resume
 
 Use `getHookByToken` to validate hook ownership or metadata before resuming:
 
@@ -115,7 +115,7 @@ export async function POST(request: Request) {
 }
 ```
 
-### Checking Hook Environment
+### Checking hook environment
 
 Verify the hook belongs to the expected environment:
 
@@ -144,7 +144,7 @@ export async function POST(request: Request) {
 }
 ```
 
-### Logging Hook Information
+### Logging hook information
 
 Log hook details for debugging or auditing:
 
@@ -181,9 +181,9 @@ export async function POST(request: Request) {
 }
 ```
 
-## Related Functions
+## Related functions
 
-- [`resumeHook()`](/docs/api-reference/workflow-api/resume-hook) - Resume a hook with a payload.
-- [`createHook()`](/docs/api-reference/workflow/create-hook) - Create a hook in a workflow.
-- [`defineHook()`](/docs/api-reference/workflow/define-hook) - Type-safe hook helper.
-- [Idempotency](/docs/foundations/idempotency) - Deduplicate step side effects and workflow starts.
+- [`resumeHook()`](/docs/api-reference/workflow-api/resume-hook): Resume a hook with a payload.
+- [`createHook()`](/docs/api-reference/workflow/create-hook): Create a hook in a workflow.
+- [`defineHook()`](/docs/api-reference/workflow/define-hook): Type-safe hook helper.
+- [Idempotency](/docs/foundations/idempotency): Deduplicate step side effects and workflow starts.

package/docs/api-reference/workflow-api/get-run.mdx

@@ -9,7 +9,7 @@ related:
   - /docs/foundations/idempotency
 ---
 
-Retrieves the workflow run metadata and status information for a given run ID. This function provides immediate access to workflow run details without waiting for completion, making it ideal for status checking and monitoring.
+Retrieves workflow run metadata and status information for a given run ID. This function provides immediate access to workflow run details without waiting for completion.
 
 Use this function when you need to check workflow status, get timing information, or access workflow metadata without blocking on workflow completion.
 
@@ -23,7 +23,7 @@ import { getRun } from "workflow/api";
 const run = getRun("my-run-id");
 ```
 
-## API Signature
+## API signature
 
 ### Parameters
 
@@ -47,7 +47,7 @@ showSections={["returns"]}
 
 #### WorkflowReadableStream
 
-`run.getReadable()` returns a `WorkflowReadableStream` — a standard `ReadableStream` extended with a `getTailIndex()` helper:
+`run.getReadable()` returns a `WorkflowReadableStream`, a standard `ReadableStream` extended with a `getTailIndex()` helper:
 
 <TSDoc
 definition={`
@@ -83,7 +83,7 @@ export default StopSleepResult;`}
 
 ## Examples
 
-### Check if a Run Exists
+### Check if a run exists
 
 Use the `exists` getter to check whether a workflow run exists without throwing when the run is not found:
 
@@ -112,7 +112,7 @@ export async function GET(req: Request) {
 }
 ```
 
-### Basic Status Check
+### Basic status check
 
 Check the current status of a workflow run:
 
@@ -141,7 +141,7 @@ export async function GET(req: Request) {
 }
 ```
 
-### Wake Up a Sleeping Workflow
+### Wake up a sleeping workflow
 
 Interrupt pending `sleep()` calls to resume a workflow early. This is useful for testing workflows or building custom UIs that let users skip wait periods:
 
@@ -170,7 +170,7 @@ const { stoppedCount } = await run.wakeUp({
 });
 ```
 
-### Cancel a Run
+### Cancel a run
 
 Cancel a workflow run. You can pass an optional free-text `cancelReason` (up to 512 characters) that is recorded on the run's cancellation event and shown in the run detail view:
 
@@ -187,8 +187,8 @@ export async function POST(req: Request) {
 }
 ```
 
-The options object is optional — `await run.cancel()` cancels the run without recording a reason.
+The options object is optional: `await run.cancel()` cancels the run without recording a reason.
 
-## Related Functions
+## Related functions
 
-- [`start()`](/docs/api-reference/workflow-api/start) - Start a new workflow and get its run ID.
+- [`start()`](/docs/api-reference/workflow-api/start): Start a new workflow and get its run ID.