abliteration 0.1.5 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9f88d80e1a99e3b8373ec35c02986ed37ccca49626668d3e27bd52bfe405cf8b
-  data.tar.gz: b886954f040d4b73d01c47c54ab53ff3940e6db9d74088bb64c4ba63ae177214
+  metadata.gz: f4954feb3c086bc804c783fa545d66687cdde13f05e7601c6006d905bee95a71
+  data.tar.gz: e3f746c6712d3b344e621ed8ec1793cec6a59d2ad52a751f7d048dbda3a42680
 SHA512:
-  metadata.gz: e558fb52c8c013629b8e0fbc417b9154383eb560a3091cf4d225b95253051b6030c6d9407e8948840dfd80c1c33a8f91c46f74d96273c333a0e02029b0c74253
-  data.tar.gz: 050e783acb4be82d97a84b64cc9e9677bcd0bae6388e104d92015ac19d8d3540947c953e813e5be9d6ab14a1d8490cf9af1188108278187a05a19adea9d6b013
+  metadata.gz: 450a0f75eb10f2ee3386305af5eec41eebae627c4c04b9e2ba4fc0f93c8bbd8e343f936cdd9645435664bc8b9a9f98d685b9b3456cd1d135de0dd6ca8611b105
+  data.tar.gz: da5db6f4dd8925c982278808e5c7d803a63fb510802bea3abbd0a8c9fe2bf0b142a5f67b667c4333434a96873d9102cdfe676da5689fb101ec211229799d3e27

data/README.md

@@ -98,6 +98,7 @@ Class | Method | HTTP request | Description
 *Abliteration::MethodsApi* | [**get_method**](docs/MethodsApi.md#get_method) | **GET** /api/v1/methods/{id} | Get one method
 *Abliteration::MethodsApi* | [**list_methods**](docs/MethodsApi.md#list_methods) | **GET** /api/v1/methods | List the method taxonomy
 *Abliteration::ModelsApi* | [**get_model**](docs/ModelsApi.md#get_model) | **GET** /api/v1/models/{id} | Get one model
+*Abliteration::ModelsApi* | [**list_delisted_models**](docs/ModelsApi.md#list_delisted_models) | **GET** /api/v1/models/delisted | List delisted models (change stream)
 *Abliteration::ModelsApi* | [**list_models**](docs/ModelsApi.md#list_models) | **GET** /api/v1/models | List models
 *Abliteration::TimelineApi* | [**list_timeline**](docs/TimelineApi.md#list_timeline) | **GET** /api/v1/timeline | Curated field events
 
@@ -109,6 +110,7 @@ Class | Method | HTTP request | Description
  - [Abliteration::DaiPoint](docs/DaiPoint.md)
  - [Abliteration::Dataset](docs/Dataset.md)
  - [Abliteration::DatasetDetail](docs/DatasetDetail.md)
+ - [Abliteration::DelistedModel](docs/DelistedModel.md)
  - [Abliteration::Envelope](docs/Envelope.md)
  - [Abliteration::Error](docs/Error.md)
  - [Abliteration::Event](docs/Event.md)
@@ -121,6 +123,7 @@ Class | Method | HTTP request | Description
  - [Abliteration::IndexDetail](docs/IndexDetail.md)
  - [Abliteration::ListAuthors200Response](docs/ListAuthors200Response.md)
  - [Abliteration::ListDatasets200Response](docs/ListDatasets200Response.md)
+ - [Abliteration::ListDelistedModels200Response](docs/ListDelistedModels200Response.md)
  - [Abliteration::ListIndices200Response](docs/ListIndices200Response.md)
  - [Abliteration::ListMethods200Response](docs/ListMethods200Response.md)
  - [Abliteration::ListModels200Response](docs/ListModels200Response.md)

data/docs/DelistedModel.md

@@ -0,0 +1,30 @@
+# Abliteration::DelistedModel
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  | [optional] |
+| **author** | **String** |  | [optional] |
+| **family** | **String** |  | [optional] |
+| **params_b** | **Float** |  | [optional] |
+| **downloads** | **Integer** | Downloads at the moment the model was last visible on HF. Not a live counter. | [optional] |
+| **last_seen_at** | **String** | ISO-8601 timestamp of the last successful Hub observation. Approximately when the model died. | [optional] |
+| **days_since_gone** | **Integer** | Whole days between last_seen_at and now, computed server-side for convenience. | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::DelistedModel.new(
+  id: null,
+  author: null,
+  family: null,
+  params_b: null,
+  downloads: null,
+  last_seen_at: null,
+  days_since_gone: null
+)
+```
+

data/docs/ListDelistedModels200Response.md

@@ -0,0 +1,32 @@
+# Abliteration::ListDelistedModels200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**Array<DelistedModel>**](DelistedModel.md) |  |  |
+| **cost** | **Integer** | Credits this call costs. |  |
+| **credits_remaining** | **Integer** | Wallet balance after the call. Unchanged while metering is preview. |  |
+| **rate_limit_limit** | **Integer** | Ceiling for the current window. Also returned as X-RateLimit-Limit. |  |
+| **rate_limit_remaining** | **Integer** | Calls left in the current window for this key. Also returned as X-RateLimit-Remaining. |  |
+| **rate_limit_reset** | **Integer** | Unix seconds at which the window resets to full ceiling. Also returned as X-RateLimit-Reset. |  |
+| **metering** | **String** | Whether cost was actually deducted. |  |
+| **request_id** | **String** | Also returned in the x-request-id header. |  |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::ListDelistedModels200Response.new(
+  data: null,
+  cost: null,
+  credits_remaining: null,
+  rate_limit_limit: null,
+  rate_limit_remaining: null,
+  rate_limit_reset: null,
+  metering: null,
+  request_id: null
+)
+```
+

data/docs/ModelDetail.md

@@ -26,6 +26,8 @@
 | **last_modified** | **String** |  | [optional] |
 | **first_seen_at** | **String** |  | [optional] |
 | **last_seen_at** | **String** |  | [optional] |
+| **is_delisted** | **Integer** | 0/1 flag. `1` means HF no longer serves this model — the response is the last state we recorded. | [optional] |
+| **days_since_gone** | **Integer** | Whole days between last_seen_at and now. `null` unless is_delisted=1. | [optional] |
 | **readme_text** | **String** |  | [optional] |
 | **readme_status** | **String** |  | [optional] |
 | **tags** | **String** | JSON-encoded array of Hub tags. | [optional] |
@@ -82,6 +84,8 @@ instance = Abliteration::ModelDetail.new(
   last_modified: null,
   first_seen_at: null,
   last_seen_at: null,
+  is_delisted: null,
+  days_since_gone: null,
   readme_text: null,
   readme_status: null,
   tags: null,

data/docs/ModelSummary.md

@@ -17,6 +17,8 @@
 | **is_gguf** | **Integer** |  | [optional] |
 | **created_at** | **String** |  | [optional] |
 | **first_seen_at** | **String** |  | [optional] |
+| **is_delisted** | **Integer** | 0/1 flag, present in every response row. `1` means the model is no longer on the Hub. | [optional] |
+| **last_seen_at** | **String** | ISO-8601 timestamp of the last successful Hub observation. Non-null on delisted rows. | [optional] |
 
 ## Example
 
@@ -36,7 +38,9 @@ instance = Abliteration::ModelSummary.new(
   likes: null,
   is_gguf: null,
   created_at: null,
-  first_seen_at: null
+  first_seen_at: null,
+  is_delisted: null,
+  last_seen_at: null
 )
 ```
 

data/docs/ModelsApi.md

@@ -5,6 +5,7 @@ All URIs are relative to *https://abliteration.org*
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
 | [**get_model**](ModelsApi.md#get_model) | **GET** /api/v1/models/{id} | Get one model |
+| [**list_delisted_models**](ModelsApi.md#list_delisted_models) | **GET** /api/v1/models/delisted | List delisted models (change stream) |
 | [**list_models**](ModelsApi.md#list_models) | **GET** /api/v1/models | List models |
 
 
@@ -14,7 +15,7 @@ All URIs are relative to *https://abliteration.org*
 
 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.
+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. Delisted models are served here even though they are hidden from the default catalog list; the response then carries `is_delisted=1` and `days_since_gone`.
 
 ### Examples
 
@@ -77,13 +78,90 @@ end
 - **Accept**: application/json
 
 
+## list_delisted_models
+
+> <ListDelistedModels200Response> list_delisted_models(opts)
+
+List delisted models (change stream)
+
+Cost: 5 credits, flat. Change-stream companion to /models: every row is a tombstone — a model that HF no longer serves, preserved here at its final state. Poll with `since=<last_seen_at of your previous run>` to fetch only new casualties; callers building compliance dashboards, safety-research corpora, or \"wayback\" tools live on this endpoint. See /api#change-stream.
+
+### Examples
+
+```ruby
+require 'time'
+require 'abliteration'
+# setup authorization
+Abliteration.configure do |config|
+  # Configure Bearer authorization: bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Abliteration::ModelsApi.new
+opts = {
+  since: 'since_example', # String | ISO-8601 date or timestamp. Rows with last_seen_at >= since only. Use your previous poll's newest last_seen_at to build an incremental feed.
+  sort: 'recent', # String | `recent` (default, newest disappearance first) or `downloads` (biggest casualties first — best for post-mortem coverage).
+  limit: 56, # Integer | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+  offset: 56 # Integer | Rows to skip. Negative and non-numeric values are treated as 0.
+}
+
+begin
+  # List delisted models (change stream)
+  result = api_instance.list_delisted_models(opts)
+  p result
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->list_delisted_models: #{e}"
+end
+```
+
+#### Using the list_delisted_models_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListDelistedModels200Response>, Integer, Hash)> list_delisted_models_with_http_info(opts)
+
+```ruby
+begin
+  # List delisted models (change stream)
+  data, status_code, headers = api_instance.list_delisted_models_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListDelistedModels200Response>
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->list_delisted_models_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **since** | **String** | ISO-8601 date or timestamp. Rows with last_seen_at &gt;&#x3D; since only. Use your previous poll&#39;s newest last_seen_at to build an incremental feed. | [optional] |
+| **sort** | **String** | &#x60;recent&#x60; (default, newest disappearance first) or &#x60;downloads&#x60; (biggest casualties first — best for post-mortem coverage). | [optional][default to &#39;recent&#39;] |
+| **limit** | **Integer** | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected. | [optional][default to 50] |
+| **offset** | **Integer** | Rows to skip. Negative and non-numeric values are treated as 0. | [optional][default to 0] |
+
+### Return type
+
+[**ListDelistedModels200Response**](ListDelistedModels200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## list_models
 
 > <ListModels200Response> list_models(opts)
 
 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.
+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 by default (`delisted=live`); pass `delisted=dead|all` to include tombstoned records. A dedicated change-stream endpoint is at GET /api/v1/models/delisted.
 
 ### Examples
 
@@ -106,6 +184,7 @@ opts = {
   downloads_lte: 56, # Integer | 
   created_after: 'created_after_example', # String | ISO-8601 date or timestamp, inclusive.
   created_before: 'created_before_example', # String | ISO-8601 date or timestamp, inclusive.
+  delisted: 'live', # String | Tombstone filter. `live` (default): HF-visible models only. `dead`: delisted-only (same shape as this endpoint plus is_delisted=1 and last_seen_at). `all`: both, in one page. For a purpose-built change-stream feed, prefer GET /api/v1/models/delisted.
   sort: 'downloads', # String | Bare key is the natural direction (downloads/likes = most first, dates = newest first). A leading `-` flips it. `created` and `first_seen` are aliases for the full column names.
   limit: 56, # Integer | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
   offset: 56 # Integer | Rows to skip. Negative and non-numeric values are treated as 0.
@@ -150,6 +229,7 @@ end
 | **downloads_lte** | **Integer** |  | [optional] |
 | **created_after** | **String** | ISO-8601 date or timestamp, inclusive. | [optional] |
 | **created_before** | **String** | ISO-8601 date or timestamp, inclusive. | [optional] |
+| **delisted** | **String** | Tombstone filter. &#x60;live&#x60; (default): HF-visible models only. &#x60;dead&#x60;: delisted-only (same shape as this endpoint plus is_delisted&#x3D;1 and last_seen_at). &#x60;all&#x60;: both, in one page. For a purpose-built change-stream feed, prefer GET /api/v1/models/delisted. | [optional][default to &#39;live&#39;] |
 | **sort** | **String** | 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. | [optional][default to &#39;downloads&#39;] |
 | **limit** | **Integer** | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected. | [optional][default to 50] |
 | **offset** | **Integer** | Rows to skip. Negative and non-numeric values are treated as 0. | [optional][default to 0] |

data/lib/abliteration/api/models_api.rb

@@ -20,7 +20,7 @@ module Abliteration
       @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.
+    # 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. Delisted models are served here even though they are hidden from the default catalog list; the response then carries `is_delisted=1` and `days_since_gone`.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [GetModel200Response]
@@ -30,7 +30,7 @@ module Abliteration
     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.
+    # 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. Delisted models are served here even though they are hidden from the default catalog list; the response then carries `is_delisted=1` and `days_since_gone`.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(GetModel200Response, Integer, Hash)>] GetModel200Response data, response status code and response headers
@@ -82,8 +82,93 @@ module Abliteration
       return data, status_code, headers
     end
 
+    # List delisted models (change stream)
+    # Cost: 5 credits, flat. Change-stream companion to /models: every row is a tombstone — a model that HF no longer serves, preserved here at its final state. Poll with `since=<last_seen_at of your previous run>` to fetch only new casualties; callers building compliance dashboards, safety-research corpora, or \"wayback\" tools live on this endpoint. See /api#change-stream.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :since ISO-8601 date or timestamp. Rows with last_seen_at &gt;&#x3D; since only. Use your previous poll&#39;s newest last_seen_at to build an incremental feed.
+    # @option opts [String] :sort &#x60;recent&#x60; (default, newest disappearance first) or &#x60;downloads&#x60; (biggest casualties first — best for post-mortem coverage). (default to 'recent')
+    # @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 [ListDelistedModels200Response]
+    def list_delisted_models(opts = {})
+      data, _status_code, _headers = list_delisted_models_with_http_info(opts)
+      data
+    end
+
+    # List delisted models (change stream)
+    # Cost: 5 credits, flat. Change-stream companion to /models: every row is a tombstone — a model that HF no longer serves, preserved here at its final state. Poll with &#x60;since&#x3D;&lt;last_seen_at of your previous run&gt;&#x60; to fetch only new casualties; callers building compliance dashboards, safety-research corpora, or \&quot;wayback\&quot; tools live on this endpoint. See /api#change-stream.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :since ISO-8601 date or timestamp. Rows with last_seen_at &gt;&#x3D; since only. Use your previous poll&#39;s newest last_seen_at to build an incremental feed.
+    # @option opts [String] :sort &#x60;recent&#x60; (default, newest disappearance first) or &#x60;downloads&#x60; (biggest casualties first — best for post-mortem coverage). (default to 'recent')
+    # @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<(ListDelistedModels200Response, Integer, Hash)>] ListDelistedModels200Response data, response status code and response headers
+    def list_delisted_models_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ModelsApi.list_delisted_models ...'
+      end
+      allowable_values = ["recent", "downloads"]
+      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_delisted_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_delisted_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_delisted_models, must be greater than or equal to 0.'
+      end
+
+      # resource path
+      local_var_path = '/api/v1/models/delisted'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'since'] = opts[:'since'] if !opts[:'since'].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] || 'ListDelistedModels200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ModelsApi.list_delisted_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_delisted_models\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.
+    # 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 by default (`delisted=live`); pass `delisted=dead|all` to include tombstoned records. A dedicated change-stream endpoint is at GET /api/v1/models/delisted.
     # @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.
@@ -93,6 +178,7 @@ module Abliteration
     # @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] :delisted Tombstone filter. &#x60;live&#x60; (default): HF-visible models only. &#x60;dead&#x60;: delisted-only (same shape as this endpoint plus is_delisted&#x3D;1 and last_seen_at). &#x60;all&#x60;: both, in one page. For a purpose-built change-stream feed, prefer GET /api/v1/models/delisted. (default to 'live')
     # @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)
@@ -103,7 +189,7 @@ module Abliteration
     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.
+    # 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 by default (&#x60;delisted&#x3D;live&#x60;); pass &#x60;delisted&#x3D;dead|all&#x60; to include tombstoned records. A dedicated change-stream endpoint is at GET /api/v1/models/delisted.
     # @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.
@@ -113,6 +199,7 @@ module Abliteration
     # @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] :delisted Tombstone filter. &#x60;live&#x60; (default): HF-visible models only. &#x60;dead&#x60;: delisted-only (same shape as this endpoint plus is_delisted&#x3D;1 and last_seen_at). &#x60;all&#x60;: both, in one page. For a purpose-built change-stream feed, prefer GET /api/v1/models/delisted. (default to 'live')
     # @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)
@@ -121,6 +208,10 @@ module Abliteration
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: ModelsApi.list_models ...'
       end
+      allowable_values = ["live", "dead", "all"]
+      if @api_client.config.client_side_validation && opts[:'delisted'] && !allowable_values.include?(opts[:'delisted'])
+        fail ArgumentError, "invalid value for \"delisted\", must be one of #{allowable_values}"
+      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}"
@@ -150,6 +241,7 @@ module Abliteration
       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[:'delisted'] = opts[:'delisted'] if !opts[:'delisted'].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?

data/lib/abliteration/models/delisted_model.rb

@@ -0,0 +1,206 @@
+=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 'date'
+require 'time'
+
+module Abliteration
+  class DelistedModel < ApiModelBase
+    attr_accessor :id
+
+    attr_accessor :author
+
+    attr_accessor :family
+
+    attr_accessor :params_b
+
+    # Downloads at the moment the model was last visible on HF. Not a live counter.
+    attr_accessor :downloads
+
+    # ISO-8601 timestamp of the last successful Hub observation. Approximately when the model died.
+    attr_accessor :last_seen_at
+
+    # Whole days between last_seen_at and now, computed server-side for convenience.
+    attr_accessor :days_since_gone
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'id' => :'id',
+        :'author' => :'author',
+        :'family' => :'family',
+        :'params_b' => :'params_b',
+        :'downloads' => :'downloads',
+        :'last_seen_at' => :'last_seen_at',
+        :'days_since_gone' => :'days_since_gone'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'id' => :'String',
+        :'author' => :'String',
+        :'family' => :'String',
+        :'params_b' => :'Float',
+        :'downloads' => :'Integer',
+        :'last_seen_at' => :'String',
+        :'days_since_gone' => :'Integer'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+        :'family',
+        :'params_b',
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Abliteration::DelistedModel` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Abliteration::DelistedModel`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'id')
+        self.id = attributes[:'id']
+      end
+
+      if attributes.key?(:'author')
+        self.author = attributes[:'author']
+      end
+
+      if attributes.key?(:'family')
+        self.family = attributes[:'family']
+      end
+
+      if attributes.key?(:'params_b')
+        self.params_b = attributes[:'params_b']
+      end
+
+      if attributes.key?(:'downloads')
+        self.downloads = attributes[:'downloads']
+      end
+
+      if attributes.key?(:'last_seen_at')
+        self.last_seen_at = attributes[:'last_seen_at']
+      end
+
+      if attributes.key?(:'days_since_gone')
+        self.days_since_gone = attributes[:'days_since_gone']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          id == o.id &&
+          author == o.author &&
+          family == o.family &&
+          params_b == o.params_b &&
+          downloads == o.downloads &&
+          last_seen_at == o.last_seen_at &&
+          days_since_gone == o.days_since_gone
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [id, author, family, params_b, downloads, last_seen_at, days_since_gone].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end