defmodule ASM.Options.Codex do
  @moduledoc """
  Codex exec provider-specific option schema.
  """

  @spec schema() :: keyword()
  def schema do
    [
      model: [type: :string],
      system_prompt: [type: {:or, [:string, nil]}, default: nil],
      reasoning_effort: [
        type:
          {:or,
           [{:in, [:none, :minimal, :low, :medium, :high, :xhigh, :max, :ultra]}, :string, nil]},
        default: nil
      ],
      provider_backend: [
        type: {:or, [{:in, [:openai, :oss, :model_provider]}, :string, nil]},
        default: nil
      ],
      model_provider: [type: {:or, [:string, nil]}, default: nil],
      oss_provider: [type: {:or, [:string, nil]}, default: nil],
      skip_git_repo_check: [type: :boolean, default: false],
      # A completion is not a coding agent: a read-only sandbox and a never
      # approval policy. It REPLACES any caller-supplied permission mode
      # rather than merging with it.
      completion_only: [type: :boolean, default: false],
      app_server: [type: :boolean, default: false],
      host_tools: [
        type: {:custom, ASM.Options, :validate_passthrough_list, [:host_tools]},
        default: []
      ],
      dynamic_tools: [
        type: {:custom, ASM.Options, :validate_passthrough_list, [:dynamic_tools]},
        default: []
      ],
      additional_directories: [type: {:list, :string}, default: []],
      # Allow a Codex model newer than the shared registry to pass through to
      # the CLI `--model` (default false = require a registered model).
      allow_unknown_model: [type: :boolean, default: false]
    ]
  end
end