Pattern
INT·Jun 26
Tool Context: experimental_context
Inject request-scoped context (user identity, database handles, session) into ToolLoopAgent tools via experimental_context, so the model never supplies sensitive identity in tool inputs.
View Full Pattern on Desktop

Problems Solved
- Keep user identity out of model-controlled tool inputs
- Share a database or service handle across all tools
- Scope tool execution to the authenticated request
- Prevent prompt-injection from accessing other users' data
Use Cases
- Per-user account assistants
- Multi-tenant agent tools
- Injecting DB/session into isolated tool calls
- Secure identity scoping for agent tools
AI SDK APIs
ToolLoopAgentexperimental_contexttoolstepCountIsgateway
Tags
aiagentsexperimental-contexttool-contextsecurityauthtool-loop-agentai-sdkagent-api
Requirements
- Node.js
- 24+
- Memory
- 512MB
- Other
- OpenAI API key
Environment Variables
OPENAI_API_KEYGet key →
External Services
openai
Ready to use?
View the full interactive pattern with live preview and copy the source code.
View Pattern on DesktopRelated Patterns


Loop Control: stopWhen
Demonstrate ToolLoopAgent loop control with stopWhen. Covers stepCountIs, hasToolCall, combined conditions, and a custom StopCondition with step timeline visualization.
aiagents+7
View →


PrepareStep: Trim Message History
Demonstrate ToolLoopAgent prepareStep for trimming long message history. Pre-seeded 24-message conversation shows context compression on the first run with per-step trim telemetry.
aiagents+6
View →
End of Pattern



