Sandbox Tools

{
  success: true;
  response: string; // Summary from Pi agent
}
// or
{
  success: false;
  error: string;
  task: string;
}

// First sandbox call in a thread
{
  task: "Create a Python script that fetches weather data"
}
// → Creates new E2B sandbox, starts Pi agent

// Second sandbox call in same thread
{
  task: "Run the weather script for New York"
}
// → Reuses existing sandbox, script is still there

{
  task: `Use agent-browser skill:
1. Open https://example.com/form
2. Take snapshot with 'snapshot -i'
3. Fill fields: name=Jordan Lee, [email protected]
4. Click submit button
5. Wait for confirmation page (use wait networkidle)
6. Capture screenshot and upload with showFile`
}

{
  task: "Use the agent-browser skill to open https://example.com/event-signup, fill the form fields with: name Jordan Lee, email [email protected], company Acme Labs, role Engineer, and notes Interested in AI automation workshop. Submit the form, capture the confirmation page as output/event-signup-confirmation.png, and upload it with showFile. Include a brief summary of what was submitted and the confirmation text."
}

{
  task: `Use AgentMail skill:
1. List unreplied threads from last 24 hours in [email protected]
2. Draft concise replies for each thread (don't send yet)
3. Save triage summary to output/agentmail-triage.md
4. Upload summary with showFile
5. Include thread IDs and draft IDs in summary`
}

{
  task: "Use AgentMail. For inbox [email protected], list unreplied threads from the last 24 hours, draft concise replies for each thread (do not send yet), save a triage summary to output/agentmail-triage.md, and upload it with showFile. Include thread IDs and draft IDs in the summary."
}

// POST https://revoke.hackclub.com/api/v1/revocations
{
  "token": "...",
  "submitter": "gorkie",
  "comment": "user-reported leak in Slack"
}

{
  task: "Use the HackClub Revoker skill to revoke token hc_live_abc123xyz456. Submit with submitter=gorkie and comment='accidental Slack share'. Report status but do NOT include the token in your response."
}

🔄 Running sandbox
  📄 Read: data.csv
  🐍 Bash: python process.py
  ✅ Write: output/results.json
  📤 Upload: output/chart.png
✅ Sandbox complete: Processed 1,247 rows and generated chart

// Good
{
  task: "Analyze sales.csv, create a bar chart showing monthly revenue, save as output/revenue-chart.png, and upload with showFile. Include total revenue in the summary."
}

// Avoid
{
  task: "Analyze the file" // Too vague
}

// First call
{ task: "Download stock data for AAPL and save to data/aapl.json" }

// Second call (references first)
{ task: "Using the AAPL data from earlier, calculate 30-day moving average" }

{ task: "Use agent-browser skill to scrape product prices from https://example.com/products" }

{
  task: `Complete workflow:
1. Read uploaded PDF with PyPDF2
2. Extract text and save to data/extracted.txt
3. Use searchWeb to find related articles
4. Create markdown summary in output/summary.md
5. Upload with showFile`
}

// End tasks with:
"...and upload with showFile"
"...capture screenshot and upload it"
"...save to output/ and use showFile"

{
  task: "Read sales-data.csv, calculate summary statistics (mean, median, std dev) by region, create visualizations (histogram and box plot), save all outputs to output/ and upload with showFile. Include key insights in summary."
}

{
  task: "Use agent-browser to open https://news.ycombinator.com, extract the top 10 story titles and URLs, save as JSON to output/hn-top10.json, and upload with showFile."
}

{
  task: "Use AgentMail to check [email protected] inbox, list messages received in the last hour, and create a summary table with: sender, subject, received time. Save to output/recent-emails.md and upload."
}

{
  task: "Use PIL to resize the uploaded image to 800x600, apply a subtle blur filter, add a watermark 'Gorkie 2026' in bottom-right corner, save as output/processed.png and upload with showFile."
}

{
  task: "Fetch weather data from OpenWeatherMap API for San Francisco (use free tier, no API key needed for basic data). Parse JSON response, extract temperature, conditions, humidity. Create a formatted markdown report in output/weather.md and upload."
}

@gorkie what files are in the sandbox output directory?

{ task: "List files in /home/user/output/ with details (size, modified time). Show file tree." }

{ task: "Show the last 50 lines of any error logs in the workspace" }

export const sandbox = {
  runtime: {
    executionTimeoutMs: 15 * 60 * 1000, // 15 minutes
  },
  // ... other settings
};