pub(all) struct ContextBudgetInput {
  run_id : String
  stage : 
@vectie/moonfish/routine.ModelStage
ModelStage
  model : String
  gateway : ModelGateway
  packet : 
@vectie/moonfish/prompt.PromptPacket
PromptPacket
  reserved_completion_tokens : Int
  max_prompt_ratio_percent : Int
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub(all) struct ContextBudgetPlan {
  run_id : String
  stage : 
@vectie/moonfish/routine.ModelStage
ModelStage
  model : String
  context_window : Int
  estimated_prompt_tokens : Int
  reserved_completion_tokens : Int
  max_prompt_tokens : Int
  available_prompt_tokens : Int
  total_estimated_tokens : Int
  prune_required : Bool
  status : ContextBudgetStatus
  summary : String
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub(all) struct ContextBudgetReport {
  run_id : String
  ok : Bool
  plans : Array[ContextBudgetPlan]
  summary : String
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub(all) enum ContextBudgetStatus {
  ContextFits
  ContextNeedsPruning
  ContextTooLarge
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub(all) struct ModelCallRequest {
  run_id : String
  stage : 
@vectie/moonfish/routine.ModelStage
ModelStage
  model : String
  base_url : String
  schema_id : String
  messages : Array[
@vectie/moonfish/prompt.PromptMessage
PromptMessage]
  required_tools : Array[String]
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub(all) struct ModelCallResponse {
  request : ModelCallRequest
  output : 
@vectie/moonfish/routine.StageOutput
StageOutput
  health : ModelHealth
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub(all) struct ModelCatalogEntry {
  id : String
  owner : String?
  context_window : Int?
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub(all) struct ModelGateway {
  provider : ModelProvider
  base_url : String
  openai_base_url : String
  default_model : String
  health : ModelHealth
  catalog : Array[ModelCatalogEntry]
  usage : ModelUsageSnapshot
  contracts : Array[SuiteIntegrationContract]
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub(all) enum ModelHealth {
  Ready
  Degraded
  Unavailable
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub(all) enum ModelProvider {
  MoonGate
  OpenAICompatible
  FixtureProvider
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub(all) struct ModelUsageSnapshot {
  prompt_tokens_used : Int
  completion_tokens_used : Int
  total_tokens_used : Int
  quota_remaining : Int?
  quota_exhausted : Bool
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub(all) struct ProviderError {
  kind : ProviderErrorKind
  status_code : Int?
  retryable : Bool
  normalized_message : String
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub(all) enum ProviderErrorKind {
  ProviderAuthFailed
  ProviderQuotaExhausted
  ProviderRateLimited
  ProviderUnavailable
  ProviderBadRequest
  ProviderUnknown
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub(all) struct SuiteIntegrationContract {
  name : String
  path : String
  ready : Bool
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub(all) struct SuiteStatusRef {
  status_path : String
  openai_base_url : String
  default_model : String
  ready : Bool
  catalog : Array[ModelCatalogEntry]
  usage : ModelUsageSnapshot
  contracts : Array[SuiteIntegrationContract]
  health_message : String?
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

fn context_budget_input(run_id : String, gateway : ModelGateway, packet : 
@vectie/moonfish/prompt.PromptPacket
PromptPacket, model? : String, reserved_completion_tokens? : Int, max_prompt_ratio_percent? : Int) -> ContextBudgetInput

fn context_budget_report(run_id : String, plans : Array[ContextBudgetPlan]) -> ContextBudgetReport

fn context_budget_validation(plan : ContextBudgetPlan) -> 
@vectie/moonfish/domain.ValidationReport
ValidationReport

fn estimate_prompt_tokens(packet : 
@vectie/moonfish/prompt.PromptPacket
PromptPacket) -> Int

fn fixture_gateway(model? : String) -> ModelGateway

fn model_call_request(run_id : String, gateway : ModelGateway, packet : 
@vectie/moonfish/prompt.PromptPacket
PromptPacket, model? : String) -> ModelCallRequest

fn model_call_response(request : ModelCallRequest, content : String, reasoning_content? : String, usage? : 
@vectie/moonfish/routine.ModelUsage
ModelUsage, health? : ModelHealth) -> ModelCallResponse

fn model_catalog_entry(id : String, owner? : String, context_window? : Int) -> ModelCatalogEntry

fn model_usage_snapshot(prompt_tokens_used? : Int, completion_tokens_used? : Int, quota_remaining? : Int) -> ModelUsageSnapshot

fn moongate_gateway(openai_base_url : String, default_model : String, health? : ModelHealth, catalog? : Array[ModelCatalogEntry], usage? : ModelUsageSnapshot, contracts? : Array[SuiteIntegrationContract]) -> ModelGateway

fn moongate_suite_status_ref(status_path : String, openai_base_url : String, default_model : String, ready? : Bool, catalog? : Array[ModelCatalogEntry], usage? : ModelUsageSnapshot, contracts? : Array[SuiteIntegrationContract], health_message? : String) -> SuiteStatusRef

fn moonsuite_suite_status_path(root? : String) -> String

fn normalize_provider_error(message : String, status_code? : Int) -> ProviderError

fn prepare_context_budget_plan(input : ContextBudgetInput) -> ContextBudgetPlan

fn suite_integration_contract(name : String, path : String, ready? : Bool) -> SuiteIntegrationContract

fn suite_status_ref(status_path : String, openai_base_url : String, default_model : String, ready? : Bool, catalog? : Array[ModelCatalogEntry], usage? : ModelUsageSnapshot, contracts? : Array[SuiteIntegrationContract], health_message? : String) -> SuiteStatusRef