# sandbox_runner (`net.2xcel.aus.sandbox-runner`)

> Agent Utility Service (AUS) Secure Micro-VM Code Execution: Isolated multi-runtime micro-VM sandbox supporting Python, TypeScript, and JavaScript with memory bounds, timeouts, and zero-trust sandboxing.

## Metadata & Execution
- **Namespace**: `net.2xcel.aus.sandbox-runner`
- **Canonical HTML Page**: https://aipages.tech/tool/net.2xcel.aus.sandbox-runner
- **JSON Specification**: https://aipages.tech/api/tools/net.2xcel.aus.sandbox-runner
- **Execution Endpoint**: `POST https://aipages.tech/tool/sandbox-runner`
- **Connection Protocol**: `http`
- **Pricing**: $0.004 USDC per call (Base Mainnet Chain ID 8453)
- **Health Status**: `unknown`
- **Capabilities**: code-execution, python-runtime, typescript, secure-sandbox
- **Authentication**: x402 payment protocol (Header: x-payment-receipt; Token: USDC on Base Mainnet; Recipient: 0xE57cB8C73c4000EA04ba0eb607228CbAec7f8e9C)

## Input Parameters (JSON Schema Draft-07)
```json
{
  "type": "object",
  "properties": {
    "runtime": {
      "type": "string",
      "enum": [
        "python",
        "typescript",
        "javascript"
      ],
      "default": "typescript",
      "description": "Target runtime environment"
    },
    "code": {
      "type": "string",
      "description": "Source code to execute inside micro-VM container"
    },
    "entrypoint": {
      "type": "string",
      "description": "Optional function or entry script name"
    },
    "timeoutMs": {
      "type": "integer",
      "default": 2000,
      "maximum": 5000,
      "description": "Maximum execution time in milliseconds (ceiling 5000ms)"
    },
    "memoryLimitMb": {
      "type": "integer",
      "default": 128,
      "description": "Memory allocation ceiling in megabytes"
    },
    "allowNetwork": {
      "type": "boolean",
      "default": false,
      "description": "Enable restricted egress network access"
    }
  },
  "required": [
    "code"
  ]
}
```

## Invocation Examples

### 1. Zero-Friction Sandbox Test (No Payment Required)
```bash
curl -X POST "https://aipages.tech/tool/net.2xcel.aus.sandbox-runner" \
  -H "Content-Type: application/json" \
  -H "x-playground-test: true" \
  -H "x-agent-id: markdown-agent" \
  -d '{}'
```

### 2. Production Invocation (x402 Base Mainnet Settlement)
```bash
curl -X POST "https://aipages.tech/tool/sandbox-runner" \
  -H "Content-Type: application/json" \
  -H "x-payment-receipt: <BASE_USDC_PAYMENT_RECEIPT>" \
  -d '{}'
```
