Skip to content

Conversation

@agents-git-bot
Copy link

@agents-git-bot agents-git-bot bot commented Nov 25, 2025

Summary

Documents the code context isolation guarantees and configuration changes after bug fix in sandbox-sdk.

Changes

  • Added note explaining that each code context is completely isolated with a dedicated executor process
  • Added isolation mention to the introduction paragraph
  • Expanded default context behavior note with specific benefits (predictable state, concurrent execution, resource cleanup)
  • Documented automatic scaling without artificial limits
  • Added example showing concurrent execution across multiple isolated contexts
  • Clarified single-execution-per-context constraint
  • Added executor pool configuration documentation including MIN_SIZE environment variables
  • Documented removal of MAX_SIZE pool limits (now scales organically)

Related

Context

PR #249 in sandbox-sdk fixed a critical bug where code contexts leaked state after multiple executions. Each context now gets a dedicated executor process from creation to deletion, ensuring complete isolation. The system also removes maximum pool size limits, allowing organic scaling. This documentation update makes users aware of these reliability guarantees and configuration options.

🤖 Generated with Claude Code

Add documentation explaining that each code context is completely
isolated with a dedicated executor process. Includes example showing
concurrent execution across multiple contexts.

Related to cloudflare/sandbox-sdk#249 which fixed state isolation bug.
@github-actions
Copy link
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/sandbox/ @whoiskatrin, @ghostwriternr, @cloudflare/pcx-technical-writing, @cloudflare/ai-agents

Adds documentation for improved code context isolation:
- Each context now gets a dedicated executor process (1:1 binding)
- Contexts prevent concurrent execution on the same context
- Complete state isolation between contexts guaranteed

Related to cloudflare/sandbox-sdk#249

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@agents-git-bot
Copy link
Author

Documentation Updates

Updated Code Interpreter API documentation to reflect the isolation improvements from cloudflare/sandbox-sdk#249:

Changes Made

  1. Added isolation guarantee in createCodeContext() documentation:

    • Each context now gets a dedicated executor process (1:1 binding)
    • Complete state isolation between contexts is guaranteed
    • Variables, imports, and functions never leak between contexts
  2. Added concurrency behavior in deleteCodeContext() section:

    • Documented that contexts prevent concurrent execution
    • Added example showing how to run code concurrently using multiple contexts
    • Clear guidance on when users need separate contexts

Files Modified

  • src/content/docs/sandbox/api/interpreter.mdx

These changes help users understand the improved reliability and isolation guarantees of the code interpreter feature.

🤖 Generated with Claude Code

github-actions bot and others added 2 commits November 25, 2025 22:01
- Add isolation mention to introduction
- Expand default context behavior note with specific benefits
- Document automatic scaling without artificial limits

Complements existing isolation documentation from PR #249.
Documents environment variables for code interpreter executor pool
configuration and removal of MAX_SIZE limits in version 0.3.4.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants