> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liquid.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bundle Management

> Commands for listing and canceling bundle requests in the LEAP Bundle CLI

## `list`

List bundle requests or get details for a specific request.

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
leap-bundle list [<request-id>]
```

**Arguments**

* `request-id` (optional): Specific request ID to get detailed information

**Options**

* `--json`: Output result in JSON format for programmatic parsing
* `--last`: Show only the most recent request

**Behavior**

* Without arguments: Lists 50 most recent bundle requests
* With request ID: Shows detailed information for the specific request
* With `--last`: Shows only the most recent request
* Displays requests in a formatted table (unless `--json` is used)
* JSON output available for both list and specific request queries

**Examples**

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
# List all requests
leap-bundle list

# Example output
Bundle Requests (50 most recent)
┏━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ID    ┃ Input Path               ┃ Status     ┃ Creation             ┃ Notes                       ┃
┡━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 18734 │ /path/to/model/directory │ completed  │ 2024-01-15T10:30:00Z │ Processing completed.       │
│ 18733 │ /path/to/other/directory │ processing │ 2024-01-15T09:15:00Z │ Request is being processed. │
└───────┴──────────────────────────┴────────────┴──────────────────────┴─────────────────────────────┘
✓ Found 2 bundle requests.

# Get details for specific request
leap-bundle list 18734

# Example output
✓ Request Details:
  ID:         18734
  Input Path: /path/to/model/directory
  Status:     completed
  Creation:   2024-01-15T10:30:00Z
  Update:     2024-01-15T10:45:00Z
  Notes:      Processing completed. Run "leap-bundle download 18734" to download the bundle.

# Get details with JSON output
leap-bundle list 18734 --json

# Example JSON output
{
  "request_id": "18734",
  "input_path": "/path/to/model/directory",
  "status": "completed",
  "created_at": "2024-01-15T10:30:00Z",
  "user_message": "Processing completed. Run \"leap-bundle download 18734\" to download the bundle."
}

# List all requests with JSON output
leap-bundle list --json

# Example JSON output
{
  "requests": [
    {
      "request_id": "18734",
      "input_path": "/path/to/model/directory",
      "status": "completed",
      "created_at": "2024-01-15T10:30:00Z",
      "user_message": "Processing completed."
    },
    {
      "request_id": "18733",
      "input_path": "/path/to/other/directory",
      "status": "processing",
      "created_at": "2024-01-15T09:15:00Z",
      "user_message": "Request is being processed."
    }
  ]
}

# Show only the most recent request
leap-bundle list --last

# Example output
Most Recent Bundle Request
┏━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ID    ┃ Input Path               ┃ Status     ┃ Creation             ┃ Notes                       ┃
┡━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 18734 │ /path/to/model/directory │ completed  │ 2024-01-15T10:30:00Z │ Processing completed.       │
└───────┴──────────────────────────┴────────────┴──────────────────────┴─────────────────────────────┘
✓ Found 1 bundle request.

# Show most recent request with JSON output
leap-bundle list --last --json

# Example JSON output
{
  "requests": [
    {
      "request_id": "18734",
      "input_path": "/path/to/model/directory",
      "status": "completed",
      "created_at": "2024-01-15T10:30:00Z",
      "user_message": "Processing completed."
    }
  ]
}
```

**Request Statuses**

* `New`: The request is newly created
* `Uploading`: The model files are being uploaded
* `Uploading Failed`: The upload encountered an error
* `Processing`: The bundle is being processed
* `Processing Failed`: Processing failed
* `Completed`: The request is successfully completed and ready for download
* `Cancelled`: The request is cancelled by the user
* `Archived`: The request is archived and no longer available for download; this happens automatically 5 days after completion

**Error Cases**

* Not authenticated: Prompts to login first
* Request ID not found: Shows not found error
* Network issues: Shows connection error

## `cancel`

Cancel a bundle request that is still processing.

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
leap-bundle cancel <request-id>
```

**Arguments**

* `request-id` (required): ID of the bundle request to cancel

**Behavior**

* Sends a cancellation request to the LEAP platform
* Updates the request status to "cancelled"
* Cannot cancel requests that are already completed or archived

**Examples**

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
# Cancel a processing request
leap-bundle cancel 18734

# Example output on success
ℹ Cancelling bundle request 18734...
✓ Request cancelled successfully.

# Example output when request is already completed
ℹ Cancelling bundle request 18734...
✓ Request was already completed and cannot be cancelled.
```

**Error Cases**

* Request not found: Shows request not found error
* Request already completed: Shows informational message
* Not authenticated: Prompts to login first
* Network issues: Shows connection error