provider

type ConvertRequest struct {
	OriginalTaskID string `json:"originalTaskId" jsonschema:"Task ID of the model to convert"`
	Format         string `json:"format" jsonschema:"Desired output format: GLTF, FBX, OBJ, STL, USDZ, or 3MF"`
}

type ImageToModelRequest struct {
	ImagePath      string `json:"imagePath,omitempty" jsonschema:"Local file path to the reference image. Mutually exclusive with imageUrl"`
	ImageURL       string `json:"imageUrl,omitempty" jsonschema:"Public URL of the reference image. Mutually exclusive with imagePath"`
	ModelVersion   string `json:"modelVersion,omitempty" jsonschema:"Model version. Defaults to latest"`
	FaceLimit      int    `json:"faceLimit,omitempty" jsonschema:"Target polygon face count"`
	TextureQuality string `json:"textureQuality,omitempty" jsonschema:"Texture quality: standard or detailed"`
	Orientation    string `json:"orientation,omitempty" jsonschema:"Model orientation: default or align_image"`
}

type ModelGenerator interface {
	TextToModel(ctx context.Context, req TextToModelRequest) (*ModelOperation, error)
	ImageToModel(ctx context.Context, req ImageToModelRequest) (*ModelOperation, error)
	MultiviewToModel(ctx context.Context, req MultiviewToModelRequest) (*ModelOperation, error)
}

type ModelInfo struct {
	Name         string   `json:"name"`
	ID           string   `json:"id"`
	Description  string   `json:"description"`
	Capabilities []string `json:"capabilities"`
}

type ModelLister interface {
	ListModels(ctx context.Context) ([]ModelInfo, error)
}

type ModelOperation struct {
	TaskID string `json:"taskId"`
	Status string `json:"status"`
}

type ModelPostProcessor interface {
	Retopologize(ctx context.Context, req RetopologyRequest) (*ModelOperation, error)
	ConvertFormat(ctx context.Context, req ConvertRequest) (*ModelOperation, error)
	Stylize(ctx context.Context, req StylizeRequest) (*ModelOperation, error)
}

type ModelResult struct {
	FilePath     string `json:"filePath"`
	Format       string `json:"format"`
	TaskID       string `json:"taskId"`
	ModelVersion string `json:"modelVersion,omitempty"`
}

type ModelStatus interface {
	Status(ctx context.Context, taskID string) (*ModelTaskStatus, error)
	Download(ctx context.Context, taskID string, format string) (*ModelResult, error)
}

type ModelTaskStatus struct {
	TaskID   string `json:"taskId"`
	Status   string `json:"status"`
	Progress int    `json:"progress"`
	Error    string `json:"error,omitempty"`
}

type MultiviewToModelRequest struct {
	ImagePaths   []string `` /* 138-byte string literal not displayed */
	ImageURLs    []string `` /* 134-byte string literal not displayed */
	ModelVersion string   `json:"modelVersion,omitempty" jsonschema:"Model version. Defaults to latest"`
	FaceLimit    int      `json:"faceLimit,omitempty" jsonschema:"Target polygon face count"`
}

type RetopologyRequest struct {
	OriginalTaskID string `json:"originalTaskId" jsonschema:"Task ID of the model to retopologize"`
	Quad           bool   `json:"quad,omitempty" jsonschema:"Produce quad mesh instead of triangles"`
	TargetFaces    int    `json:"targetFaces,omitempty" jsonschema:"Target face count for the lowpoly output"`
}

type StylizeRequest struct {
	OriginalTaskID string `json:"originalTaskId" jsonschema:"Task ID of the model to stylize"`
	Style          string `json:"style" jsonschema:"Stylization style: lego, voxel, voronoi, or minecraft"`
}

type TextToModelRequest struct {
	Prompt         string `json:"prompt" jsonschema:"Text description of the 3D model to generate"`
	NegativePrompt string `json:"negativePrompt,omitempty" jsonschema:"What to avoid in the generation"`
	ModelVersion   string `json:"modelVersion,omitempty" jsonschema:"Model version (e.g. v2.5, v3.0, v3.1). Defaults to latest"`
	FaceLimit      int    `json:"faceLimit,omitempty" jsonschema:"Target polygon face count"`
}