levelfour 0.1.0__py3-none-any.whl

levelfour/types/provider_timeline_response.py

@@ -0,0 +1,27 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .provider_timeline_data import ProviderTimelineData
+
+
+class ProviderTimelineResponse(UniversalBaseModel):
+    """
+    Response for provider spending timeline
+    """
+
+    success: typing.Optional[bool] = None
+    timestamp: typing.Optional[dt.datetime] = None
+    data: ProviderTimelineData
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

levelfour/types/provider_top_service.py

@@ -0,0 +1,36 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class ProviderTopService(UniversalBaseModel):
+    """
+    Top service for provider summary
+    """
+
+    service: str = pydantic.Field()
+    """
+    Service name
+    """
+
+    cost: float = pydantic.Field()
+    """
+    Current period cost
+    """
+
+    change_percentage: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Change from previous period
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

levelfour/types/providers_summary_data.py

@@ -0,0 +1,24 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .provider import Provider
+
+
+class ProvidersSummaryData(UniversalBaseModel):
+    """
+    Summary data for all providers
+    """
+
+    providers: typing.List[Provider]
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

levelfour/types/providers_summary_response.py

@@ -0,0 +1,27 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .providers_summary_data import ProvidersSummaryData
+
+
+class ProvidersSummaryResponse(UniversalBaseModel):
+    """
+    Response for providers summary (carousel view)
+    """
+
+    success: typing.Optional[bool] = None
+    timestamp: typing.Optional[dt.datetime] = None
+    data: ProvidersSummaryData
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

levelfour/types/rate_limit_error.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .error_response import ErrorResponse
+
+RateLimitError = ErrorResponse

levelfour/types/recommendation_actions.py

@@ -0,0 +1,60 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class RecommendationActions(UniversalBaseModel):
+    """
+    Action structure with simple text fields.
+
+    All fields support markdown formatting for rich text display.
+    Frontend can use a markdown renderer (e.g., react-markdown) to display.
+
+    Example markdown formatting:
+    - **Bold text** for emphasis
+    - `code snippets` for commands
+    - Numbered/bulleted lists for steps
+    - Code blocks with ```language syntax
+    """
+
+    description: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Brief summary of the recommendation
+    """
+
+    overview: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Detailed overview explaining the recommendation (supports markdown)
+    """
+
+    implementation_process: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    How to implement this recommendation (supports markdown)
+    """
+
+    execution_method: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Technical execution details (supports markdown)
+    """
+
+    key_takeaway: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Important notes, risks, and safety information (supports markdown)
+    """
+
+    operational_impact: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Impact on operations and any downtime requirements (supports markdown)
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

levelfour/types/recommendation_detail.py

@@ -0,0 +1,42 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .recommendation_actions import RecommendationActions
+
+
+class RecommendationDetail(UniversalBaseModel):
+    """
+    Full details for a single recommendation (detail view)
+    """
+
+    recommendation_id: str = pydantic.Field()
+    """
+    Unique business identifier for the recommendation
+    """
+
+    service: str
+    environment: typing.Optional[str] = None
+    analysis_period: typing.Optional[str] = None
+    monthly_savings: float
+    annual_savings: float
+    current_spending: float
+    savings_percentage: float
+    actions: typing.Optional[RecommendationActions] = None
+    status: str = pydantic.Field()
+    """
+    Status: pending, implemented, rejected
+    """
+
+    created_at: typing.Optional[str] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

levelfour/types/recommendation_detail_response.py

@@ -0,0 +1,27 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .recommendation_detail import RecommendationDetail
+
+
+class RecommendationDetailResponse(UniversalBaseModel):
+    """
+    Response for recommendation detail
+    """
+
+    success: typing.Optional[bool] = None
+    timestamp: typing.Optional[dt.datetime] = None
+    data: RecommendationDetail
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

levelfour/types/recommendation_filter_options_data.py

@@ -0,0 +1,41 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class RecommendationFilterOptionsData(UniversalBaseModel):
+    """
+    Filter options for provider recommendation breakdown
+    """
+
+    environments: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    Distinct environment values
+    """
+
+    accounts: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    Distinct account values
+    """
+
+    tags: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    Distinct tag values
+    """
+
+    services: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    Distinct service values
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

levelfour/types/recommendation_filter_options_response.py

@@ -0,0 +1,27 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .recommendation_filter_options_data import RecommendationFilterOptionsData
+
+
+class RecommendationFilterOptionsResponse(UniversalBaseModel):
+    """
+    Response for recommendation filter options
+    """
+
+    success: typing.Optional[bool] = None
+    timestamp: typing.Optional[dt.datetime] = None
+    data: RecommendationFilterOptionsData
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

levelfour/types/recommendation_item.py

@@ -0,0 +1,36 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .recommendation_actions import RecommendationActions
+
+
+class RecommendationItem(UniversalBaseModel):
+    """
+    Detailed recommendation item (for list view)
+    """
+
+    recommendation_id: str = pydantic.Field()
+    """
+    Unique business identifier for the recommendation
+    """
+
+    service: str
+    environment: typing.Optional[str] = None
+    analysis_period: typing.Optional[str] = None
+    monthly_savings: float
+    annual_savings: float
+    current_spending: float
+    savings_percentage: float
+    actions: typing.Optional[RecommendationActions] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

levelfour/types/recommendation_wizard_data.py

@@ -0,0 +1,173 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .comparison_item import ComparisonItem
+from .execution_log_entry import ExecutionLogEntry
+from .execution_step_schema import ExecutionStepSchema
+from .implementation_step import ImplementationStep
+from .recommendation_wizard_data_metrics import RecommendationWizardDataMetrics
+from .risk_assessment import RiskAssessment
+from .trigger_info import TriggerInfo
+
+
+class RecommendationWizardData(UniversalBaseModel):
+    """
+    Full recommendation data for wizard flow
+    """
+
+    recommendation_id: str = pydantic.Field()
+    """
+    Unique business identifier
+    """
+
+    service: str
+    account: typing.Optional[str] = None
+    region: typing.Optional[str] = None
+    monthly_spending: float = pydantic.Field()
+    """
+    Current monthly spending
+    """
+
+    monthly_savings: float = pydantic.Field()
+    """
+    Potential monthly savings
+    """
+
+    annual_savings: float = pydantic.Field()
+    """
+    Annual savings amount
+    """
+
+    monthly_spending_percentage: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Spending as percentage
+    """
+
+    monthly_savings_percentage: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Savings as percentage
+    """
+
+    implementation_tags: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    Available implementation methods: Automated Savings, IaC, Manual Setup
+    """
+
+    terms_accepted_by: typing.Optional[str] = None
+    terms_accepted_at: typing.Optional[str] = None
+    saving_acceptance: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    pending, accepted, rejected
+    """
+
+    saving_accepted_by: typing.Optional[str] = None
+    saving_accepted_at: typing.Optional[str] = None
+    rejection_reason: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    operational, strategy, not_applicable, other
+    """
+
+    rejection_explanation: typing.Optional[str] = None
+    implementation_method: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    one-click, iac, one-click-plus-iac
+    """
+
+    status: typing.Optional[str] = None
+    overview: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Markdown overview of the recommendation
+    """
+
+    key_takeaway: typing.Optional[str] = None
+    operational_impact: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Markdown description of operational impact
+    """
+
+    iam_role_arn: typing.Optional[str] = None
+    iam_policy: typing.Optional[typing.Dict[str, typing.Any]] = None
+    vcs_username: typing.Optional[str] = None
+    vcs_email: typing.Optional[str] = None
+    manual_instructions: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Markdown instructions for manual implementation
+    """
+
+    completed_at: typing.Optional[str] = None
+    environment: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Environment (e.g., Production, Staging)
+    """
+
+    tag: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Resource tag value
+    """
+
+    tags: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    All resource tags
+    """
+
+    resource_console_url: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Direct link to resource in cloud console
+    """
+
+    description: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Brief summary of the recommendation
+    """
+
+    comparison_data: typing.Optional[typing.List[ComparisonItem]] = pydantic.Field(default=None)
+    """
+    Before/after comparison rows
+    """
+
+    metrics: typing.Optional[RecommendationWizardDataMetrics] = pydantic.Field(default=None)
+    """
+    Historical metric series for the resource
+    """
+
+    risk_assessment: typing.Optional[RiskAssessment] = pydantic.Field(default=None)
+    """
+    Risk level and factors
+    """
+
+    implementation_steps: typing.Optional[typing.List[ImplementationStep]] = pydantic.Field(default=None)
+    """
+    Ordered implementation steps
+    """
+
+    execution_steps: typing.Optional[typing.List[ExecutionStepSchema]] = pydantic.Field(default=None)
+    """
+    Execution pipeline steps for status flow
+    """
+
+    execution_logs: typing.Optional[typing.List[ExecutionLogEntry]] = pydantic.Field(default=None)
+    """
+    Execution log entries with commands
+    """
+
+    trigger_info: typing.Optional[TriggerInfo] = pydantic.Field(default=None)
+    """
+    Who triggered the execution and when
+    """
+
+    implementation_status: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Overall implementation status label
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

levelfour/types/recommendation_wizard_data_metrics.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from .metric_series import MetricSeries
+
+RecommendationWizardDataMetrics = typing.Union[typing.List[MetricSeries], typing.Dict[str, typing.Any]]

levelfour/types/recommendation_wizard_response.py

@@ -0,0 +1,27 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .recommendation_wizard_data import RecommendationWizardData
+
+
+class RecommendationWizardResponse(UniversalBaseModel):
+    """
+    Response for wizard recommendation detail
+    """
+
+    success: typing.Optional[bool] = None
+    timestamp: typing.Optional[dt.datetime] = None
+    data: RecommendationWizardData
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

levelfour/types/recommendations_breakdown_data.py

@@ -0,0 +1,26 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .pagination_meta import PaginationMeta
+from .recommendation_item import RecommendationItem
+
+
+class RecommendationsBreakdownData(UniversalBaseModel):
+    """
+    Recommendations breakdown data with pagination
+    """
+
+    items: typing.List[RecommendationItem]
+    pagination: PaginationMeta
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

levelfour/types/recommendations_breakdown_response.py

@@ -0,0 +1,27 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .recommendations_breakdown_data import RecommendationsBreakdownData
+
+
+class RecommendationsBreakdownResponse(UniversalBaseModel):
+    """
+    Response for recommendations breakdown
+    """
+
+    success: typing.Optional[bool] = None
+    timestamp: typing.Optional[dt.datetime] = None
+    data: RecommendationsBreakdownData
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

levelfour/types/recommendations_overview_data.py

@@ -0,0 +1,51 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class RecommendationsOverviewData(UniversalBaseModel):
+    """
+    Recommendations overview metrics for a provider
+    """
+
+    total_spend: float = pydantic.Field()
+    """
+    Total cost from last month's complete billing cycle (from aws_costs_daily)
+    """
+
+    available_savings: float = pydantic.Field()
+    """
+    Savings opportunities identified and available to execute
+    """
+
+    pending_savings: float = pydantic.Field()
+    """
+    Savings opportunities pending required actions
+    """
+
+    saved_itd: float = pydantic.Field()
+    """
+    Total savings implemented inception to date
+    """
+
+    potential_savings: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Sum of all recommendations' monthly_savings
+    """
+
+    evaluation_available_savings: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Sum of allowed evaluation IDs' monthly_savings
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow