abliteration 0.0.1 → 0.1.1

data/lib/abliteration/api/methods_api.rb

@@ -0,0 +1,147 @@
+=begin
+#abliteration.org Public API
+
+#Read access to the abliteration.org catalog: models and their method classification, alignment datasets and their passports, the M-code taxonomy, the four flagship indices and the curated field timeline.  Every call is authenticated with a bearer key and metered in credits against the same wallet the Research Agent spends from. There is no free tier for machine traffic and no separate billing.  Responses report `cost` and `credits_remaining` on every success. While `metering` reads `preview`, the cost shown is what the call will bill once metering is enabled and nothing is actually deducted; when it reads `billed`, it was.
+
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.25.0
+
+=end
+
+require 'cgi'
+
+module Abliteration
+  class MethodsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get one method
+    # Cost: 1 credit.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [GetMethod200Response]
+    def get_method(id, opts = {})
+      data, _status_code, _headers = get_method_with_http_info(id, opts)
+      data
+    end
+
+    # Get one method
+    # Cost: 1 credit.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetMethod200Response, Integer, Hash)>] GetMethod200Response data, response status code and response headers
+    def get_method_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MethodsApi.get_method ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling MethodsApi.get_method"
+      end
+      # verify enum value
+      allowable_values = ["M1", "M2", "M3", "M4", "M5", "M5-frankenstein", "M6", "M7", "M8", "M-uncensored", "unknown"]
+      if @api_client.config.client_side_validation && !allowable_values.include?(id)
+        fail ArgumentError, "invalid value for \"id\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/v1/methods/{id}'.sub('{id}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetMethod200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"MethodsApi.get_method",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MethodsApi#get_method\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List the method taxonomy
+    # Cost: 5-15 credits. Every code is returned, including ones with no models.
+    # @param [Hash] opts the optional parameters
+    # @return [ListMethods200Response]
+    def list_methods(opts = {})
+      data, _status_code, _headers = list_methods_with_http_info(opts)
+      data
+    end
+
+    # List the method taxonomy
+    # Cost: 5-15 credits. Every code is returned, including ones with no models.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ListMethods200Response, Integer, Hash)>] ListMethods200Response data, response status code and response headers
+    def list_methods_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MethodsApi.list_methods ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/methods'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ListMethods200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"MethodsApi.list_methods",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MethodsApi#list_methods\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/abliteration/api/models_api.rb

@@ -0,0 +1,191 @@
+=begin
+#abliteration.org Public API
+
+#Read access to the abliteration.org catalog: models and their method classification, alignment datasets and their passports, the M-code taxonomy, the four flagship indices and the curated field timeline.  Every call is authenticated with a bearer key and metered in credits against the same wallet the Research Agent spends from. There is no free tier for machine traffic and no separate billing.  Responses report `cost` and `credits_remaining` on every success. While `metering` reads `preview`, the cost shown is what the call will bill once metering is enabled and nothing is actually deducted; when it reads `billed`, it was.
+
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.25.0
+
+=end
+
+require 'cgi'
+
+module Abliteration
+  class ModelsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get one model
+    # Cost: 10 credits. Priced above /authors/[id], /methods/[id] and /datasets/[id] because iterating over model ids is functionally a slow dump. The id is author/name and must be percent-encoded.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [GetModel200Response]
+    def get_model(id, opts = {})
+      data, _status_code, _headers = get_model_with_http_info(id, opts)
+      data
+    end
+
+    # Get one model
+    # Cost: 10 credits. Priced above /authors/[id], /methods/[id] and /datasets/[id] because iterating over model ids is functionally a slow dump. The id is author/name and must be percent-encoded.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetModel200Response, Integer, Hash)>] GetModel200Response data, response status code and response headers
+    def get_model_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ModelsApi.get_model ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling ModelsApi.get_model"
+      end
+      # resource path
+      local_var_path = '/api/v1/models/{id}'.sub('{id}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetModel200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ModelsApi.get_model",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ModelsApi#get_model\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List models
+    # Cost: 5-300+ credits, stepped by returned rows and multiplied by `1 + (offset/2500)²`. A filtered lookup up to 200 rows costs 5; a 1000-row page on the first page costs 300; on offset=10000, 5100. Filter cheap, dump expensive. See /api#pricing. Delisted models are excluded here but remain reachable by id.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :method M-code, case-insensitive. See GET /api/v1/methods.
+    # @option opts [String] :family Base family, for example qwen or llama.
+    # @option opts [String] :author Publisher handle, case-insensitive.
+    # @option opts [String] :license SPDX-ish license string as published.
+    # @option opts [Integer] :downloads_gte 
+    # @option opts [Integer] :downloads_lte 
+    # @option opts [String] :created_after ISO-8601 date or timestamp, inclusive.
+    # @option opts [String] :created_before ISO-8601 date or timestamp, inclusive.
+    # @option opts [String] :sort Bare key is the natural direction (downloads/likes &#x3D; most first, dates &#x3D; newest first). A leading &#x60;-&#x60; flips it. &#x60;created&#x60; and &#x60;first_seen&#x60; are aliases for the full column names. (default to 'downloads')
+    # @option opts [Integer] :limit Rows to return, 1 to 1000. Values outside the range are clamped, not rejected. (default to 50)
+    # @option opts [Integer] :offset Rows to skip. Negative and non-numeric values are treated as 0. (default to 0)
+    # @return [ListModels200Response]
+    def list_models(opts = {})
+      data, _status_code, _headers = list_models_with_http_info(opts)
+      data
+    end
+
+    # List models
+    # Cost: 5-300+ credits, stepped by returned rows and multiplied by &#x60;1 + (offset/2500)²&#x60;. A filtered lookup up to 200 rows costs 5; a 1000-row page on the first page costs 300; on offset&#x3D;10000, 5100. Filter cheap, dump expensive. See /api#pricing. Delisted models are excluded here but remain reachable by id.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :method M-code, case-insensitive. See GET /api/v1/methods.
+    # @option opts [String] :family Base family, for example qwen or llama.
+    # @option opts [String] :author Publisher handle, case-insensitive.
+    # @option opts [String] :license SPDX-ish license string as published.
+    # @option opts [Integer] :downloads_gte 
+    # @option opts [Integer] :downloads_lte 
+    # @option opts [String] :created_after ISO-8601 date or timestamp, inclusive.
+    # @option opts [String] :created_before ISO-8601 date or timestamp, inclusive.
+    # @option opts [String] :sort Bare key is the natural direction (downloads/likes &#x3D; most first, dates &#x3D; newest first). A leading &#x60;-&#x60; flips it. &#x60;created&#x60; and &#x60;first_seen&#x60; are aliases for the full column names. (default to 'downloads')
+    # @option opts [Integer] :limit Rows to return, 1 to 1000. Values outside the range are clamped, not rejected. (default to 50)
+    # @option opts [Integer] :offset Rows to skip. Negative and non-numeric values are treated as 0. (default to 0)
+    # @return [Array<(ListModels200Response, Integer, Hash)>] ListModels200Response data, response status code and response headers
+    def list_models_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ModelsApi.list_models ...'
+      end
+      allowable_values = ["downloads", "-downloads", "likes", "-likes", "created", "-created", "created_at", "-created_at", "first_seen", "-first_seen", "first_seen_at", "-first_seen_at"]
+      if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
+        fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 1000
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ModelsApi.list_models, must be smaller than or equal to 1000.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ModelsApi.list_models, must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'offset'].nil? && opts[:'offset'] < 0
+        fail ArgumentError, 'invalid value for "opts[:"offset"]" when calling ModelsApi.list_models, must be greater than or equal to 0.'
+      end
+
+      # resource path
+      local_var_path = '/api/v1/models'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'method'] = opts[:'method'] if !opts[:'method'].nil?
+      query_params[:'family'] = opts[:'family'] if !opts[:'family'].nil?
+      query_params[:'author'] = opts[:'author'] if !opts[:'author'].nil?
+      query_params[:'license'] = opts[:'license'] if !opts[:'license'].nil?
+      query_params[:'downloads_gte'] = opts[:'downloads_gte'] if !opts[:'downloads_gte'].nil?
+      query_params[:'downloads_lte'] = opts[:'downloads_lte'] if !opts[:'downloads_lte'].nil?
+      query_params[:'created_after'] = opts[:'created_after'] if !opts[:'created_after'].nil?
+      query_params[:'created_before'] = opts[:'created_before'] if !opts[:'created_before'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ListModels200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ModelsApi.list_models",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ModelsApi#list_models\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/abliteration/api/timeline_api.rb

@@ -0,0 +1,99 @@
+=begin
+#abliteration.org Public API
+
+#Read access to the abliteration.org catalog: models and their method classification, alignment datasets and their passports, the M-code taxonomy, the four flagship indices and the curated field timeline.  Every call is authenticated with a bearer key and metered in credits against the same wallet the Research Agent spends from. There is no free tier for machine traffic and no separate billing.  Responses report `cost` and `credits_remaining` on every success. While `metering` reads `preview`, the cost shown is what the call will bill once metering is enabled and nothing is actually deducted; when it reads `billed`, it was.
+
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.25.0
+
+=end
+
+require 'cgi'
+
+module Abliteration
+  class TimelineApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Curated field events
+    # Cost: 50 credits, flat.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :from Inclusive lower bound on the event date, ISO-8601.
+    # @option opts [String] :to Inclusive upper bound on the event date, ISO-8601.
+    # @option opts [String] :event_type Event type, case-insensitive.
+    # @option opts [Integer] :limit  (default to 100)
+    # @return [ListTimeline200Response]
+    def list_timeline(opts = {})
+      data, _status_code, _headers = list_timeline_with_http_info(opts)
+      data
+    end
+
+    # Curated field events
+    # Cost: 50 credits, flat.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :from Inclusive lower bound on the event date, ISO-8601.
+    # @option opts [String] :to Inclusive upper bound on the event date, ISO-8601.
+    # @option opts [String] :event_type Event type, case-insensitive.
+    # @option opts [Integer] :limit  (default to 100)
+    # @return [Array<(ListTimeline200Response, Integer, Hash)>] ListTimeline200Response data, response status code and response headers
+    def list_timeline_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TimelineApi.list_timeline ...'
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 1000
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling TimelineApi.list_timeline, must be smaller than or equal to 1000.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling TimelineApi.list_timeline, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/v1/timeline'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'from'] = opts[:'from'] if !opts[:'from'].nil?
+      query_params[:'to'] = opts[:'to'] if !opts[:'to'].nil?
+      query_params[:'event_type'] = opts[:'event_type'] if !opts[:'event_type'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ListTimeline200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"TimelineApi.list_timeline",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TimelineApi#list_timeline\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end