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.

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

# 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.

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

# 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