Skip to content

feat: batch TS updates including hooks updates, retries, multi-agent interrupts, timeouts on graphs, and small papercuts#837

Closed
notowen333 wants to merge 1 commit into
strands-agents:mainfrom
notowen333:docs/ts-batch-updates
Closed

feat: batch TS updates including hooks updates, retries, multi-agent interrupts, timeouts on graphs, and small papercuts#837
notowen333 wants to merge 1 commit into
strands-agents:mainfrom
notowen333:docs/ts-batch-updates

Conversation

@notowen333
Copy link
Copy Markdown
Contributor

Summary

Batch documentation update covering recent TypeScript SDK changes:

  • Multi-agent interrupts + InterruptEvent (sdk-typescript#1044): TS examples for BeforeNodeCallEvent interrupts in Swarm and Graph; InterruptEvent row + lifecycle node in hooks page.
  • Hook event mutability + AfterInvocationEvent.resume (sdk-typescript#957): TS examples for Tool Interception (selectedTool, toolUse rewrite), Result Modification (mutable result), and three Invocation resume scenarios (summarize-after-tools, iterative refinement, auto-approve interrupts).
  • DefaultModelRetryStrategy / ModelRetryStrategy / BackoffStrategy (sdk-typescript#888): Full TS support added to retry-strategies page, replacing the prior "not supported in TypeScript" placeholders. New Backoff Strategies subsection. Custom-subclass example uses DefaultModelRetryStrategy.isRetryable override.
  • Graph/Swarm/Bedrock timeouts (sdk-typescript#1008): timeout and nodeTimeout constructor params on Graph and Swarm; per-node timeout on AgentNode; new "TypeScript Request Timeout" subsection in Amazon Bedrock page documenting the 120s default and override mechanism.
  • Sliding window conversation manager (sdk-typescript#1018): Updated tool-result truncation bullet to reflect oldest-first ordering and per-content-type behavior (head/tail markers, typed placeholders).
  • Tool name normalization (sdk-typescript#1017): Documented the ^[a-zA-Z0-9_-]+$ 1–64 char constraint and INVALID_TOOL_NAME placeholder behavior in custom-tools page.
  • Small papercuts: em-dash sweep on interrupts page, "please refer to here" link cleanup, banned-phrase fixes, MCP Elicitation goal-led rewrite, interrupts_imports.ts extracted so TS imports render in the docs.

All TS API surface verified against the corresponding SDK source commits.

Test plan

  • npm run format:check passes
  • npm run typecheck:snippets shows zero errors in touched files (env requires npm run sdk:clone and SDK build first)
  • Visual review of the 8 affected pages in npm run dev:
    • /docs/user-guide/concepts/interrupts/
    • /docs/user-guide/concepts/agents/hooks/
    • /docs/user-guide/concepts/agents/conversation-management/
    • /docs/user-guide/concepts/agents/retry-strategies/
    • /docs/user-guide/concepts/tools/custom-tools/
    • /docs/user-guide/concepts/multi-agent/graph/
    • /docs/user-guide/concepts/multi-agent/swarm/
    • /docs/user-guide/concepts/model-providers/amazon-bedrock/

…interrupts, timeouts on graphs, and small papercuts
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.

1 participant