[v2.5] Review revised Daytona CLI version and update as necessary

[frankbria]

Recently, Daytona revised their CLI functionality. A run through of Daytona sandbox creation, monitoring, etc. should be performed against the revised CLI documentation: Daytona CLI Documentation to determine if anything needs to be updated or adjusted.

Here is a link to the specific CLI changes that have recently been made.

[traycerai]

Plan

Observations

The parallel-cc project currently has E2B sandbox integration (v1.0) fully implemented, but Daytona support is only planned for v1.5 and exists solely in planning documents. The recent Daytona CLI enhancements (V0.135.0, January 2026) introduced new top-level sandbox commands (sandbox ssh, sandbox exec), a preview-url command, and refined the distinction between sandboxes and workspaces. The existing SANDBOX_INTEGRATION_PLAN.md contains outdated Daytona SDK API examples that don't match the actual @daytonaio/sdk TypeScript SDK interface.

Approach

Since Daytona integration is planned but not implemented, the task focuses on updating planning documentation to reflect the revised CLI functionality. The approach involves reviewing the latest Daytona CLI documentation, comparing it against the current SANDBOX_INTEGRATION_PLAN.md specifications, and updating the plan to align with the actual Daytona SDK API and new CLI features. The E2B implementation in file:src/e2b/sandbox-manager.ts serves as the architectural reference for how a Daytona provider should be structured.

Implementation Plan

1. Update Daytona Provider Specification in SANDBOX_INTEGRATION_PLAN.md

Location: file:SANDBOX_INTEGRATION_PLAN.md (lines 356-405)

Update the Daytona provider implementation example to reflect the actual SDK API:

• Replace the outdated SDK initialization pattern with the correct Daytona class from @daytonaio/sdk
• Update the create() method to use the actual SDK method daytona.create() with correct parameters (language, envVars, etc.)
• Replace sandbox.process.exec() with the correct method sandbox.process.executeCommand()
• Add new CLI command references: sandbox ssh, sandbox exec, preview-url
• Update configuration flags to match the latest daytona sandbox create options (lines 86-124):
  • Add --class (small, medium, large)
  • Add --context for build context
  • Add --dockerfile for custom snapshots
  • Add --network-allow-list and --network-block-all for network controls
  • Add --public flag
  • Add --snapshot option
  • Add --volume mounting support

2. Update Daytona Configuration Model

Location: file:SANDBOX_INTEGRATION_PLAN.md (lines 112-120)

Revise the Daytona environment variables and configuration to include:

• Add DAYTONA_SANDBOX_CLASS for sandbox sizing (small/medium/large)
• Add DAYTONA_NETWORK_BLOCK_ALL for network isolation
• Add DAYTONA_SNAPSHOT for custom snapshot selection
• Update the configuration file example (lines 177-181) to include new options:
  • sandboxClass: Sandbox size tier
  • networkBlockAll: Network isolation toggle
  • snapshot: Custom snapshot identifier
  • volumeMounts: Array of volume mount configurations

3. Document New Daytona CLI Commands

Location: file:SANDBOX_INTEGRATION_PLAN.md (lines 128-150)

Add new CLI flag documentation for Daytona-specific options:

• --daytona-class <size>: Sandbox class (small, medium, large)
• --daytona-snapshot <id>: Use specific snapshot
• --daytona-network-block: Block all network access
• --daytona-public: Make sandbox publicly accessible
• --daytona-volume <mount>: Volume mount specification

Document the new top-level commands in the CLI Commands section (lines 608-636):

# New Daytona-specific commands
parallel-cc sandbox-ssh --session-id <id>        # SSH into Daytona sandbox
parallel-cc sandbox-exec --session-id <id> <cmd> # Execute command in sandbox
parallel-cc sandbox-preview-url --session-id <id> # Generate preview URL

4. Update Provider Comparison Table

Location: file:SANDBOX_INTEGRATION_PLAN.md (lines 932-943)

Update the Daytona row in the provider comparison table:

• Change "Startup time" from "90ms" to "Sub-90ms (verified V0.135.0)"
• Add note about new sandbox ssh and sandbox exec commands
• Update "Best for" to include "Preview URLs, network-isolated environments"
• Add reference to sandbox classes (small/medium/large)

5. Update TypeScript Interface Definitions

Location: file:SANDBOX_INTEGRATION_PLAN.md (lines 361-397)

Revise the TypeScript implementation example to match the actual SDK:

// Correct SDK initialization (no apiKey/apiUrl in constructor)
const daytona = new Daytona(); // Uses env vars by default

// Correct create method signature
const sandbox = await daytona.create({
  language: 'typescript', // Not 'javascript'
  envVars: { ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY },
  // Add new options
  class: 'medium',
  networkBlockAll: true,
  snapshot: 'custom-snapshot-id'
});

// Correct command execution
await sandbox.process.executeCommand('npm install -g @anthropic-ai/claude-code');

6. Add Daytona-Specific Security Considerations

Location: file:SANDBOX_INTEGRATION_PLAN.md (lines 733-741)

Add new risk assessment for Daytona's network isolation features:

Risk	Severity	Mitigation
Network isolation bypass	Low	Use --network-block-all flag; validate allowlist
Sandbox class cost overruns	Medium	Default to 'small' class; warn on 'large' selection
Public sandbox exposure	High	Require explicit --public flag; warn about data exposure
Volume mount security	Medium	Validate mount paths; prevent sensitive directory mounts

7. Update Implementation Phases

Location: file:SANDBOX_INTEGRATION_PLAN.md (lines 784-841)

Revise Phase 3 (Cloud Providers) to include updated Daytona implementation tasks:

• Implement Daytona provider using @daytonaio/sdk with correct API
• Add support for sandbox classes (small/medium/large)
• Implement network isolation controls (--network-block-all, --network-allow-list)
• Add sandbox ssh and sandbox exec command wrappers
• Implement preview URL generation
• Add volume mount support
• Test with custom snapshots and Dockerfiles

8. Create Daytona-Specific Documentation

Location: Create new file file:docs/DAYTONA_GUIDE.md

Create a comprehensive guide similar to file:docs/E2B_GUIDE.md that includes:

• Setup instructions for Daytona API key
• Explanation of sandbox vs workspace concepts
• Guide for using sandbox classes (when to use small/medium/large)
• Network isolation configuration examples
• Preview URL usage for web applications
• Custom snapshot creation workflow
• Volume mounting best practices
• SSH access for debugging
• Cost optimization strategies

9. Update ROADMAP.md

Location: file:ROADMAP.md (lines 796-1010)

Update the v1.5 specification to reflect the revised Daytona CLI:

• Add note about V0.135.0 CLI enhancements (January 2026)
• Update feature list to include new commands (sandbox ssh, sandbox exec, preview-url)
• Add sandbox class selection to the feature matrix
• Include network isolation controls in the security features
• Update the implementation timeline to account for new features

10. Add Validation Experiments

Location: file:SANDBOX_INTEGRATION_PLAN.md (lines 844-894)

Add new validation experiments for Daytona-specific features:

Test: Sandbox Class Performance

# Compare startup times across classes
time daytona sandbox create --class small
time daytona sandbox create --class medium
time daytona sandbox create --class large

Success criteria: Small <90ms, Medium <150ms, Large <300ms

Test: Network Isolation

# Verify network blocking
daytona sandbox create --network-block-all
daytona sandbox exec <id> "curl https://google.com" # Should fail

Success criteria: Network requests blocked, no external connectivity

Test: Preview URL Generation

# Test preview URL for web app
daytona preview-url --sandbox-id <id>

Success criteria: URL generated, accessible externally

---

Visual Architecture

sequenceDiagram
    participant User
    participant CLI as parallel-cc CLI
    participant Plan as SANDBOX_INTEGRATION_PLAN.md
    participant Daytona as Daytona CLI/SDK
    
    User->>CLI: Review Daytona integration plan
    CLI->>Plan: Read current specification
    Plan-->>CLI: Outdated SDK API (v0.1.0)
    
    User->>Daytona: Check latest CLI docs
    Daytona-->>User: V0.135.0 changes (Jan 2026)
    
    Note over User,Plan: Update Phase
    
    User->>Plan: Update SDK initialization
    User->>Plan: Add new CLI commands
    User->>Plan: Update configuration flags
    User->>Plan: Revise implementation example
    
    Plan-->>CLI: Updated specification
    CLI-->>User: Ready for v1.5 implementation

Loading

Summary Table

Document	Lines	Changes Required
SANDBOX_INTEGRATION_PLAN.md	356-405	Update Daytona provider implementation
SANDBOX_INTEGRATION_PLAN.md	112-120	Add new environment variables
SANDBOX_INTEGRATION_PLAN.md	128-150	Document new CLI flags
SANDBOX_INTEGRATION_PLAN.md	608-636	Add new CLI commands
SANDBOX_INTEGRATION_PLAN.md	932-943	Update comparison table
SANDBOX_INTEGRATION_PLAN.md	733-741	Add security considerations
SANDBOX_INTEGRATION_PLAN.md	784-841	Revise implementation phases
SANDBOX_INTEGRATION_PLAN.md	844-894	Add validation experiments
ROADMAP.md	796-1010	Update v1.5 specification
docs/DAYTONA_GUIDE.md	New file	Create comprehensive guide

Import In IDE

🤖 Prompt for AI Agents

## Observations

The parallel-cc project currently has E2B sandbox integration (v1.0) fully implemented, but Daytona support is only planned for v1.5 and exists solely in planning documents. The recent Daytona CLI enhancements (V0.135.0, January 2026) introduced new top-level `sandbox` commands (`sandbox ssh`, `sandbox exec`), a `preview-url` command, and refined the distinction between sandboxes and workspaces. The existing SANDBOX_INTEGRATION_PLAN.md contains outdated Daytona SDK API examples that don't match the actual `@daytonaio/sdk` TypeScript SDK interface.

## Approach

Since Daytona integration is planned but not implemented, the task focuses on updating planning documentation to reflect the revised CLI functionality. The approach involves reviewing the latest Daytona CLI documentation, comparing it against the current SANDBOX_INTEGRATION_PLAN.md specifications, and updating the plan to align with the actual Daytona SDK API and new CLI features. The E2B implementation in `file:src/e2b/sandbox-manager.ts` serves as the architectural reference for how a Daytona provider should be structured.

## Implementation Plan

### 1. Update Daytona Provider Specification in SANDBOX_INTEGRATION_PLAN.md

**Location:** `file:SANDBOX_INTEGRATION_PLAN.md` (lines 356-405)

Update the Daytona provider implementation example to reflect the actual SDK API:

- Replace the outdated SDK initialization pattern with the correct `Daytona` class from `@daytonaio/sdk`
- Update the `create()` method to use the actual SDK method `daytona.create()` with correct parameters (`language`, `envVars`, etc.)
- Replace `sandbox.process.exec()` with the correct method `sandbox.process.executeCommand()`
- Add new CLI command references: `sandbox ssh`, `sandbox exec`, `preview-url`
- Update configuration flags to match the latest `daytona sandbox create` options (lines 86-124):
  - Add `--class` (small, medium, large)
  - Add `--context` for build context
  - Add `--dockerfile` for custom snapshots
  - Add `--network-allow-list` and `--network-block-all` for network controls
  - Add `--public` flag
  - Add `--snapshot` option
  - Add `--volume` mounting support

### 2. Update Daytona Configuration Model

**Location:** `file:SANDBOX_INTEGRATION_PLAN.md` (lines 112-120)

Revise the Daytona environment variables and configuration to include:

- Add `DAYTONA_SANDBOX_CLASS` for sandbox sizing (small/medium/large)
- Add `DAYTONA_NETWORK_BLOCK_ALL` for network isolation
- Add `DAYTONA_SNAPSHOT` for custom snapshot selection
- Update the configuration file example (lines 177-181) to include new options:
  - `sandboxClass`: Sandbox size tier
  - `networkBlockAll`: Network isolation toggle
  - `snapshot`: Custom snapshot identifier
  - `volumeMounts`: Array of volume mount configurations

### 3. Document New Daytona CLI Commands

**Location:** `file:SANDBOX_INTEGRATION_PLAN.md` (lines 128-150)

Add new CLI flag documentation for Daytona-specific options:

- `--daytona-class <size>`: Sandbox class (small, medium, large)
- `--daytona-snapshot <id>`: Use specific snapshot
- `--daytona-network-block`: Block all network access
- `--daytona-public`: Make sandbox publicly accessible
- `--daytona-volume <mount>`: Volume mount specification

Document the new top-level commands in the CLI Commands section (lines 608-636):

```bash
# New Daytona-specific commands
parallel-cc sandbox-ssh --session-id <id>        # SSH into Daytona sandbox
parallel-cc sandbox-exec --session-id <id> <cmd> # Execute command in sandbox
parallel-cc sandbox-preview-url --session-id <id> # Generate preview URL
```

### 4. Update Provider Comparison Table

**Location:** `file:SANDBOX_INTEGRATION_PLAN.md` (lines 932-943)

Update the Daytona row in the provider comparison table:

- Change "Startup time" from "90ms" to "Sub-90ms (verified V0.135.0)"
- Add note about new `sandbox ssh` and `sandbox exec` commands
- Update "Best for" to include "Preview URLs, network-isolated environments"
- Add reference to sandbox classes (small/medium/large)

### 5. Update TypeScript Interface Definitions

**Location:** `file:SANDBOX_INTEGRATION_PLAN.md` (lines 361-397)

Revise the TypeScript implementation example to match the actual SDK:

```typescript
// Correct SDK initialization (no apiKey/apiUrl in constructor)
const daytona = new Daytona(); // Uses env vars by default

// Correct create method signature
const sandbox = await daytona.create({
  language: 'typescript', // Not 'javascript'
  envVars: { ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY },
  // Add new options
  class: 'medium',
  networkBlockAll: true,
  snapshot: 'custom-snapshot-id'
});

// Correct command execution
await sandbox.process.executeCommand('npm install -g @anthropic-ai/claude-code');
```

### 6. Add Daytona-Specific Security Considerations

**Location:** `file:SANDBOX_INTEGRATION_PLAN.md` (lines 733-741)

Add new risk assessment for Daytona's network isolation features:

| Risk | Severity | Mitigation |
|------|----------|------------|
| **Network isolation bypass** | Low | Use `--network-block-all` flag; validate allowlist |
| **Sandbox class cost overruns** | Medium | Default to 'small' class; warn on 'large' selection |
| **Public sandbox exposure** | High | Require explicit `--public` flag; warn about data exposure |
| **Volume mount security** | Medium | Validate mount paths; prevent sensitive directory mounts |

### 7. Update Implementation Phases

**Location:** `file:SANDBOX_INTEGRATION_PLAN.md` (lines 784-841)

Revise Phase 3 (Cloud Providers) to include updated Daytona implementation tasks:

- [ ] Implement Daytona provider using `@daytonaio/sdk` with correct API
- [ ] Add support for sandbox classes (small/medium/large)
- [ ] Implement network isolation controls (`--network-block-all`, `--network-allow-list`)
- [ ] Add `sandbox ssh` and `sandbox exec` command wrappers
- [ ] Implement preview URL generation
- [ ] Add volume mount support
- [ ] Test with custom snapshots and Dockerfiles

### 8. Create Daytona-Specific Documentation

**Location:** Create new file `file:docs/DAYTONA_GUIDE.md`

Create a comprehensive guide similar to `file:docs/E2B_GUIDE.md` that includes:

- Setup instructions for Daytona API key
- Explanation of sandbox vs workspace concepts
- Guide for using sandbox classes (when to use small/medium/large)
- Network isolation configuration examples
- Preview URL usage for web applications
- Custom snapshot creation workflow
- Volume mounting best practices
- SSH access for debugging
- Cost optimization strategies

### 9. Update ROADMAP.md

**Location:** `file:ROADMAP.md` (lines 796-1010)

Update the v1.5 specification to reflect the revised Daytona CLI:

- Add note about V0.135.0 CLI enhancements (January 2026)
- Update feature list to include new commands (`sandbox ssh`, `sandbox exec`, `preview-url`)
- Add sandbox class selection to the feature matrix
- Include network isolation controls in the security features
- Update the implementation timeline to account for new features

### 10. Add Validation Experiments

**Location:** `file:SANDBOX_INTEGRATION_PLAN.md` (lines 844-894)

Add new validation experiments for Daytona-specific features:

**Test: Sandbox Class Performance**
```bash
# Compare startup times across classes
time daytona sandbox create --class small
time daytona sandbox create --class medium
time daytona sandbox create --class large
```
**Success criteria:** Small <90ms, Medium <150ms, Large <300ms

**Test: Network Isolation**
```bash
# Verify network blocking
daytona sandbox create --network-block-all
daytona sandbox exec <id> "curl https://google.com" # Should fail
```
**Success criteria:** Network requests blocked, no external connectivity

**Test: Preview URL Generation**
```bash
# Test preview URL for web app
daytona preview-url --sandbox-id <id>
```
**Success criteria:** URL generated, accessible externally

---

## Visual Architecture

```mermaid
sequenceDiagram
    participant User
    participant CLI as parallel-cc CLI
    participant Plan as SANDBOX_INTEGRATION_PLAN.md
    participant Daytona as Daytona CLI/SDK
    
    User->>CLI: Review Daytona integration plan
    CLI->>Plan: Read current specification
    Plan-->>CLI: Outdated SDK API (v0.1.0)
    
    User->>Daytona: Check latest CLI docs
    Daytona-->>User: V0.135.0 changes (Jan 2026)
    
    Note over User,Plan: Update Phase
    
    User->>Plan: Update SDK initialization
    User->>Plan: Add new CLI commands
    User->>Plan: Update configuration flags
    User->>Plan: Revise implementation example
    
    Plan-->>CLI: Updated specification
    CLI-->>User: Ready for v1.5 implementation
```

## Summary Table

| Document | Lines | Changes Required |
|----------|-------|------------------|
| `SANDBOX_INTEGRATION_PLAN.md` | 356-405 | Update Daytona provider implementation |
| `SANDBOX_INTEGRATION_PLAN.md` | 112-120 | Add new environment variables |
| `SANDBOX_INTEGRATION_PLAN.md` | 128-150 | Document new CLI flags |
| `SANDBOX_INTEGRATION_PLAN.md` | 608-636 | Add new CLI commands |
| `SANDBOX_INTEGRATION_PLAN.md` | 932-943 | Update comparison table |
| `SANDBOX_INTEGRATION_PLAN.md` | 733-741 | Add security considerations |
| `SANDBOX_INTEGRATION_PLAN.md` | 784-841 | Revise implementation phases |
| `SANDBOX_INTEGRATION_PLAN.md` | 844-894 | Add validation experiments |
| `ROADMAP.md` | 796-1010 | Update v1.5 specification |
| `docs/DAYTONA_GUIDE.md` | New file | Create comprehensive guide |

---

Execution Information

Branch: main
Commit: 85c5bc0

---

💡 Tips

Supported Commands (Inside Comments)

• Use @traycerai generate to iterate on the previous version of the implementation plan.

Supported Commands (Inside Description)

• Add @traycerai ignore anywhere in the ticket description to prevent this ticket from being processed.
• Add @traycerai branch:<branch-name> anywhere in the ticket description to specify the target branch for the implementation plan.

Community

• Join our Discord Community to get help, request features, and share feedback.
• Follow us on X/Twitter for updates and announcements.

Warning

Something went wrong while processing your request.

Reference ID: 8b45e35b-9461-4a42-a6ae-d6c34085292f

Please try again or contact support if the issue persists, referencing this ID.