Skip to content

docs: cover new praisonai-sandbox C13 standalone package#2102

Open
praisonai-triage-agent[bot] wants to merge 1 commit into
mainfrom
claude/issue-2101-20260717-0831
Open

docs: cover new praisonai-sandbox C13 standalone package#2102
praisonai-triage-agent[bot] wants to merge 1 commit into
mainfrom
claude/issue-2101-20260717-0831

Conversation

@praisonai-triage-agent

@praisonai-triage-agent praisonai-triage-agent Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Fixes #2101

Summary

Documents the newly-extracted praisonai-sandbox standalone Tier-2 package (upstream PR MervinPraison/PraisonAI#3129), which moves the sandbox backends (Docker, subprocess, Sandlock, SSH, Modal, E2B, Daytona) out of the praisonai wrapper.

New pages

  • docs/features/praisonai-sandbox-package.mdx — primary landing page: hero mermaid, agent-centric Quick Start (sandbox=TrueSandboxConfig → standalone praisonai_sandbox imports), install matrix, "do I need it directly?" decision mermaid, SandboxManager flow, console-script note, backward-compat shims.
  • docs/sdk/praisonai-sandbox/index.mdx — SDK overview: install matrix + public API surface.

Updated pages

  • docs/features/sandbox.mdx<Note> about the new package + "New import path" subsection; install/import lines now show praisonai-sandbox[...] extras and the praisonai_sandbox path (shims kept and labeled). SSH updated from paramikoasyncssh.
  • docs/features/sandbox-backends.mdx — install table gets a via standalone column; registry/backend imports point at praisonai_sandbox with shim notes; plugin discovery note; new Related card.
  • docs/installation.mdxpraisonai-sandbox added to transitive-install notes, decision + dependency mermaids, and a new card.
  • docs/cli/sandbox.mdx — callout for the new praisonai-sandbox console script (hint-only stub today).
  • docs/features/sandboxed-agent.mdx — one-line note that execution now routes through praisonai_sandbox.
  • docs.json — new Features + SDK entries.

Verification

  • All install lines / class names verified against upstream src/praisonai-sandbox/pyproject.toml, praisonai_sandbox/__init__.py, and __main__.py.
  • Every remaining from praisonai.sandbox import … is explicitly labeled as a backward-compat shim (except the auto-generated reference file, left untouched per AGENTS.md).
  • docs.json validated with python -m json.tool.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Added comprehensive documentation for the standalone praisonai-sandbox package, including installation options, supported backends, configuration, and usage examples.
    • Added new navigation entries for sandbox package and SDK documentation.
    • Updated sandbox guides with recommended imports, installation commands, backend discovery details, and backward-compatible legacy imports.
    • Clarified sandbox-only installation options and package dependencies.
    • Documented the standalone console script and its relationship to the existing CLI and Python API.

@MervinPraison

Copy link
Copy Markdown
Owner

@coderabbitai review

@MervinPraison

Copy link
Copy Markdown
Owner

/review

@MervinPraison

Copy link
Copy Markdown
Owner

@gemini review this PR

@qodo-code-review

Copy link
Copy Markdown

Qodo reviews are paused for this user.

Troubleshooting steps vary by plan Learn more →

On a Teams plan?
Reviews resume once this user has a paid seat and their Git account is linked in Qodo.
Link Git account →

Using GitHub Enterprise Server, GitLab Self-Managed, or Bitbucket Data Center?
These require an Enterprise plan - Contact us
Contact us →

@coderabbitai

coderabbitai Bot commented Jul 17, 2026

Copy link
Copy Markdown
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@MervinPraison MervinPraison added pipeline/awaiting-merge-gate FINAL done; waiting for merge gate / CI pipeline/blocked:ci Blocked: CI not green on HEAD pipeline/blocked:manual-review Blocked: requires manual review and removed pipeline/blocked:ci Blocked: CI not green on HEAD labels Jul 17, 2026
@coderabbitai

coderabbitai Bot commented Jul 17, 2026

Copy link
Copy Markdown

Review Change Stack

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 0c797732-40c6-453b-9188-b64f9786ab32

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

Changes

Standalone sandbox documentation

Layer / File(s) Summary
Package guide and navigation
docs/features/praisonai-sandbox-package.mdx, docs.json
Adds package documentation for usage, installation, backend routing, compatibility shims, console behavior, and related links, then registers the feature page.
SDK package reference
docs/sdk/praisonai-sandbox/index.mdx, docs.json
Adds SDK documentation for installation extras, public backend APIs, console behavior, compatibility, and related pages, then registers the SDK route.
Sandbox imports and backend guidance
docs/features/sandbox.mdx, docs/features/sandbox-backends.mdx, docs/features/sandboxed-agent.mdx, docs/cli/sandbox.mdx
Updates backend imports, standalone installation commands, plugin discovery references, CLI notes, and sandboxed-agent integration details.
Installation and dependency documentation
docs/installation.mdx
Adds a sandbox-only installation option and updates dependency diagrams and transitive-installation notes.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Suggested reviewers: mervinpraison

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main change: documenting the new praisonai-sandbox standalone package.
Linked Issues check ✅ Passed The PR adds the package docs page, SDK page, docs.json routes, and updates related docs for standalone installs and legacy shims as requested.
Out of Scope Changes check ✅ Passed The changes stay within documentation and navigation updates for praisonai-sandbox; no unrelated scope was introduced.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/issue-2101-20260717-0831

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces comprehensive documentation for the new standalone praisonai-sandbox package, which extracts sandbox backends (such as Docker, subprocess, Sandlock, SSH, Modal, and E2B) from the main praisonai wrapper to allow for a minimal footprint. The changes include adding new documentation pages, updating installation guides, and recommending the new praisonai_sandbox import path. The reviewer's feedback correctly identifies several instances where classes like SandboxConfig and ResourceLimits are imported from the internal praisonaiagents.sandbox submodule, recommending instead that they be imported directly from the main praisonaiagents package for consistency and simplicity.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment on lines +84 to +85
from praisonai_sandbox import DockerSandbox
from praisonaiagents.sandbox import SandboxConfig

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For consistency and simplicity, it is recommended to import SandboxConfig directly from praisonaiagents rather than from the internal praisonaiagents.sandbox module. This aligns with the standard usage shown elsewhere in the documentation.

from praisonai_sandbox import DockerSandbox
from praisonaiagents import SandboxConfig

Comment on lines +153 to +154
from praisonai_sandbox import DockerSandbox
from praisonaiagents.sandbox import SandboxConfig

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For consistency and simplicity, it is recommended to import SandboxConfig directly from praisonaiagents rather than from the internal praisonaiagents.sandbox module. This aligns with the standard usage shown elsewhere in the documentation.

from praisonai_sandbox import DockerSandbox
from praisonaiagents import SandboxConfig

Comment on lines +38 to +39
from praisonai_sandbox import DockerSandbox
from praisonaiagents.sandbox import SandboxConfig

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For consistency and simplicity, it is recommended to import SandboxConfig directly from praisonaiagents rather than from the internal praisonaiagents.sandbox module. This aligns with the standard usage shown elsewhere in the documentation.

    from praisonai_sandbox import DockerSandbox
    from praisonaiagents import SandboxConfig

Comment on lines +449 to +451
from praisonaiagents.sandbox import ResourceLimits
# New (recommended); shim: from praisonai.sandbox import SubprocessSandbox
from praisonai_sandbox import SubprocessSandbox

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For consistency and simplicity, it is recommended to import ResourceLimits directly from praisonaiagents rather than from the internal praisonaiagents.sandbox module. This aligns with the standard usage shown elsewhere in the documentation.

from praisonaiagents import ResourceLimits
# New (recommended); shim: from praisonai.sandbox import SubprocessSandbox
from praisonai_sandbox import SubprocessSandbox

@MervinPraison MervinPraison added pipeline/blocked:ci Blocked: CI not green on HEAD claude-conflict-pending and removed pipeline/blocked:ci Blocked: CI not green on HEAD labels Jul 17, 2026
@MervinPraison

Copy link
Copy Markdown
Owner

Automated merge-conflict rebase started (in-band Claude). Rebasing onto latest main, resolving conflicts, force-pushing with --force-with-lease.

@MervinPraison MervinPraison added pipeline/blocked:conflict Blocked: merge conflict or rebase pending and removed claude-conflict-pending labels Jul 17, 2026
@MervinPraison
MervinPraison force-pushed the claude/issue-2101-20260717-0831 branch from 56a747d to 339483a Compare July 17, 2026 10:35
@MervinPraison

Copy link
Copy Markdown
Owner

Rebase complete

Branch claude/issue-2101-20260717-0831 has been rebased onto origin/main (e8c2afa).

Files resolved

File Resolution
docs/features/sandbox-backends.mdx Conflict resolved — merged both sides: kept HEAD's "Preferred install / Also works (legacy shim)" column structure (standalone-first), added PR's note linking to the praisonai-sandbox Package page
docs.json Auto-merged cleanly — no manual intervention needed

Verification

  • docs.json is valid JSON
  • All 67 sandbox-related Mintlify nav paths resolve to existing .mdx files
  • No conflict markers remain in any file
  • No files modified under docs/concepts/

@MervinPraison

Copy link
Copy Markdown
Owner

Automated merge-conflict rebase started (in-band Claude). Rebasing onto latest main, resolving conflicts, force-pushing with --force-with-lease.

@MervinPraison

Copy link
Copy Markdown
Owner

Rebase complete

Rebased claude/issue-2101-20260717-0831 onto origin/main (65e913d). All conflicts resolved.

Files resolved

Verification

  • docs.json is valid JSON
  • All nav paths confirmed present: docs/features/praisonai-sandbox-package, docs/features/sandbox-backends, docs/cli/sandbox, docs/sdk/praisonai-sandbox/index
  • No files modified in docs/concepts/

@MervinPraison MervinPraison added pipeline/blocked:ci Blocked: CI not green on HEAD claude-conflict-pending and removed pipeline/blocked:conflict Blocked: merge conflict or rebase pending pipeline/blocked:ci Blocked: CI not green on HEAD labels Jul 17, 2026
@MervinPraison

Copy link
Copy Markdown
Owner

Automated merge-conflict rebase started (in-band Claude). Rebasing onto latest main, resolving conflicts, force-pushing with --force-with-lease.

@MervinPraison MervinPraison added pipeline/blocked:conflict Blocked: merge conflict or rebase pending and removed claude-conflict-pending labels Jul 20, 2026
@MervinPraison
MervinPraison force-pushed the claude/issue-2101-20260717-0831 branch from a8c3bf9 to bc1b0ff Compare July 20, 2026 15:01
@MervinPraison

Copy link
Copy Markdown
Owner

Rebase complete ✅

Rebased claude/issue-2101-20260717-0831 onto origin/main and resolved all conflicts.

Files resolved

File Resolution
docs/features/praisonai-sandbox-package.mdx Merged both sides: kept PR's new sections (lazy-loading, backward compatibility, SandboxManager flow, console script) and incorporated main's "Validating your install" section (E2E runner, check table, timeout env var)
docs.json Auto-merged cleanly — no manual intervention needed; nav entries for docs/features/praisonai-sandbox-package and docs/sdk/praisonai-sandbox/index confirmed present and valid

Verification

  • docs.json passes JSON validation ✅
  • Mintlify paths docs/features/praisonai-sandbox-package.mdx and docs/sdk/praisonai-sandbox/index.mdx exist ✅
  • No conflict markers remaining ✅
  • Force-pushed to claude/issue-2101-20260717-0831 (a8c3bf99bc1b0ff9) ✅

@MervinPraison MervinPraison added pipeline/blocked:ci Blocked: CI not green on HEAD pipeline/blocked:conflict Blocked: merge conflict or rebase pending claude-conflict-pending and removed pipeline/blocked:conflict Blocked: merge conflict or rebase pending pipeline/blocked:ci Blocked: CI not green on HEAD labels Jul 20, 2026
@MervinPraison

Copy link
Copy Markdown
Owner

Automated merge-conflict rebase started (in-band Claude). Rebasing onto latest main, resolving conflicts, force-pushing with --force-with-lease.

Co-authored-by: Mervin Praison <MervinPraison@users.noreply.github.com>
@MervinPraison
MervinPraison force-pushed the claude/issue-2101-20260717-0831 branch from bc1b0ff to 2a25981 Compare July 20, 2026 16:29
@MervinPraison

Copy link
Copy Markdown
Owner

Rebase complete ✅

Resolved merge conflict on claude/issue-2101-20260717-0831 and force-pushed (bc1b0ff92a259819).

Files resolved:

  • docs/features/praisonai-sandbox-package.mdx — merged main's new "Platform support" section (Windows/Linux/macOS table + warning) with this PR's additional sections (lazy-load note, Backward Compatibility, How It Fits with SandboxManager, Console Script)

Verification:

  • docs.json is valid JSON ✅
  • Both Mintlify paths referenced in docs.json exist: docs/features/praisonai-sandbox-package and docs/sdk/praisonai-sandbox/index
  • No conflict markers remain ✅

@MervinPraison MervinPraison added pipeline/blocked:ci Blocked: CI not green on HEAD and removed pipeline/blocked:conflict Blocked: merge conflict or rebase pending pipeline/blocked:ci Blocked: CI not green on HEAD labels Jul 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

pipeline/awaiting-merge-gate FINAL done; waiting for merge gate / CI pipeline/blocked:manual-review Blocked: requires manual review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: cover new praisonai-sandbox C13 standalone package (PraisonAI#3129)

1 participant