Implement FluidStack provider with OpenAPI client generation

[devin-ai-integration]

Implement FluidStack provider with OpenAPI client generation

Summary

This PR implements the FluidStack cloud provider following the established Lambda Labs pattern. Key components include:

• OpenAPI client generation: Added Makefile target to generate Go client from FluidStack's API specification
• Core provider methods: Implemented all required instance management operations (create, get, list, terminate, reboot)
• Authentication: Bearer token authentication via makeAuthContext method
• Project scoping: X-PROJECT-ID header handling for FluidStack's multi-project API
• Type conversions: Conversion functions between FluidStack API types and SDK v1 types
• Generated client fixes: Resolved naming conflicts in generated constants

The implementation generates the OpenAPI client from https://docs.atlas.fluidstack.io/redocusaurus/infrastructure-api.yaml using openapi-generator-cli v7.8.0, following the exact pattern used for Lambda Labs.

Review & Testing Checklist for Human

🔴 High Risk - Requires Manual Testing

• Test with real FluidStack credentials: The entire implementation is based on OpenAPI spec analysis and hasn't been tested with actual API calls
• Verify project ID handling: Currently hardcoded to "default-project-id" - needs proper project ID configuration
• Validate type conversions with real data: Memory parsing, GPU handling, and instance state mapping need validation against actual API responses
• Test authentication flow: Bearer token authentication pattern needs verification with FluidStack's auth requirements
• Verify OpenAPI spec URL accessibility: Ensure the API specification URL is stable and publicly accessible

Recommended test plan:

1. Set up FluidStack account and obtain API credentials
2. Test basic instance lifecycle: create → get → list → terminate
3. Test instance types and locations retrieval
4. Verify GPU instance type handling
5. Test error scenarios (invalid credentials, non-existent instances, etc.)

---

Diagram

%%{ init : { "theme" : "default" }}%%
graph TD
    Makefile["internal/fluidstack/Makefile<br/>OpenAPI Client Generation"]:::major-edit
    Client["internal/fluidstack/v1/client.go<br/>FluidStackClient + Auth"]:::major-edit
    Instance["internal/fluidstack/v1/instance.go<br/>Instance Operations"]:::major-edit
    InstanceType["internal/fluidstack/v1/instancetype.go<br/>Instance Types + Locations"]:::major-edit
    Generated["internal/fluidstack/gen/fluidstack/<br/>Generated OpenAPI Client"]:::major-edit
    
    V1Client["pkg/v1/client.go<br/>CloudClient Interface"]:::context
    V1Instance["pkg/v1/instance.go<br/>Instance Types"]:::context
    V1InstanceType["pkg/v1/instancetype.go<br/>InstanceType Types"]:::context
    
    Makefile -->|generates| Generated
    Client -->|uses| Generated
    Instance -->|uses| Generated
    InstanceType -->|uses| Generated
    
    Client -.->|implements| V1Client
    Instance -.->|converts to| V1Instance
    InstanceType -.->|converts to| V1InstanceType
    
    subgraph Legend
        L1[Major Edit]:::major-edit
        L2[Minor Edit]:::minor-edit
        L3[Context/No Edit]:::context
    end

classDef major-edit fill:#90EE90
classDef minor-edit fill:#87CEEB
classDef context fill:#FFFFFF

Loading

Notes

• Generated client modifications: Manual fixes were applied to resolve DELETING constant conflicts between ProjectState and InstanceState enums
• Reboot implementation: Uses stop → sleep(5s) → start sequence, which may need adjustment based on FluidStack's instance startup times
• Memory parsing: Assumes memory strings end with "GB" suffix - needs validation with real API responses
• GPU handling: Supports both GPU model and count from FluidStack's instance type specification

Session Details:

• Link to Devin run: https://app.devin.ai/sessions/da9859aef5af46a698ff0fa2d5b6efc4
• Requested by: @theFong

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[theFong]

if there is not reboot api call lets remove this and remove the capability