abliteration 0.1.6 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f4954feb3c086bc804c783fa545d66687cdde13f05e7601c6006d905bee95a71
-  data.tar.gz: e3f746c6712d3b344e621ed8ec1793cec6a59d2ad52a751f7d048dbda3a42680
+  metadata.gz: 9f5e7a1545d6ef3e7437901aecc3151135560cbac829cd581e7cbc7d8249e05a
+  data.tar.gz: 62e496c73943df8111fd7bbc9e76181414d147f813e9644b317efd7690db4113
 SHA512:
-  metadata.gz: 450a0f75eb10f2ee3386305af5eec41eebae627c4c04b9e2ba4fc0f93c8bbd8e343f936cdd9645435664bc8b9a9f98d685b9b3456cd1d135de0dd6ca8611b105
-  data.tar.gz: da5db6f4dd8925c982278808e5c7d803a63fb510802bea3abbd0a8c9fe2bf0b142a5f67b667c4333434a96873d9102cdfe676da5689fb101ec211229799d3e27
+  metadata.gz: 8a8489069ee2886e5eade18511c30747070f610ea60baa91af41a0ceb5291674b746b340563c6bf1103f8a54ad83c8eb00b2640b543dd3914c26135348978588
+  data.tar.gz: baa7e9bccc443655d3ac515029cd896dfe65f257b1bafa2e4f846cbe47da4651164e9bd867da0b5c85864ba882a8e8b214af06a969a0eafbf3a9156f55477ae4

data/README.md

@@ -97,8 +97,12 @@ Class | Method | HTTP request | Description
 *Abliteration::IndicesApi* | [**list_indices**](docs/IndicesApi.md#list_indices) | **GET** /api/v1/indices | All four indices
 *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_historical_deletion_summary**](docs/ModelsApi.md#get_historical_deletion_summary) | **GET** /api/v1/models/historical-deletions/summary | Historical deletions — aggregate summary
 *Abliteration::ModelsApi* | [**get_model**](docs/ModelsApi.md#get_model) | **GET** /api/v1/models/{id} | Get one model
+*Abliteration::ModelsApi* | [**get_model_readme_at**](docs/ModelsApi.md#get_model_readme_at) | **GET** /api/v1/models/{id}/readme-at/{commit} | README content at one commit (wayback)
 *Abliteration::ModelsApi* | [**list_delisted_models**](docs/ModelsApi.md#list_delisted_models) | **GET** /api/v1/models/delisted | List delisted models (change stream)
+*Abliteration::ModelsApi* | [**list_historical_deletions**](docs/ModelsApi.md#list_historical_deletions) | **GET** /api/v1/models/historical-deletions/list | Historical deletions — paged list
+*Abliteration::ModelsApi* | [**list_model_readme_drifts**](docs/ModelsApi.md#list_model_readme_drifts) | **GET** /api/v1/models/{id}/drifts | README drift stream for one model
 *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
 
@@ -110,22 +114,30 @@ Class | Method | HTTP request | Description
  - [Abliteration::DaiPoint](docs/DaiPoint.md)
  - [Abliteration::Dataset](docs/Dataset.md)
  - [Abliteration::DatasetDetail](docs/DatasetDetail.md)
+ - [Abliteration::DeletionSummary](docs/DeletionSummary.md)
+ - [Abliteration::DeletionSummaryTimelineInner](docs/DeletionSummaryTimelineInner.md)
+ - [Abliteration::DeletionSummaryTopByDownloadsInner](docs/DeletionSummaryTopByDownloadsInner.md)
  - [Abliteration::DelistedModel](docs/DelistedModel.md)
  - [Abliteration::Envelope](docs/Envelope.md)
  - [Abliteration::Error](docs/Error.md)
  - [Abliteration::Event](docs/Event.md)
  - [Abliteration::GetAuthor200Response](docs/GetAuthor200Response.md)
  - [Abliteration::GetDataset200Response](docs/GetDataset200Response.md)
+ - [Abliteration::GetHistoricalDeletionSummary200Response](docs/GetHistoricalDeletionSummary200Response.md)
  - [Abliteration::GetIndex200Response](docs/GetIndex200Response.md)
  - [Abliteration::GetMethod200Response](docs/GetMethod200Response.md)
  - [Abliteration::GetModel200Response](docs/GetModel200Response.md)
+ - [Abliteration::GetModelReadmeAt200Response](docs/GetModelReadmeAt200Response.md)
+ - [Abliteration::HistoricalDeletion](docs/HistoricalDeletion.md)
  - [Abliteration::Index](docs/Index.md)
  - [Abliteration::IndexDetail](docs/IndexDetail.md)
  - [Abliteration::ListAuthors200Response](docs/ListAuthors200Response.md)
  - [Abliteration::ListDatasets200Response](docs/ListDatasets200Response.md)
  - [Abliteration::ListDelistedModels200Response](docs/ListDelistedModels200Response.md)
+ - [Abliteration::ListHistoricalDeletions200Response](docs/ListHistoricalDeletions200Response.md)
  - [Abliteration::ListIndices200Response](docs/ListIndices200Response.md)
  - [Abliteration::ListMethods200Response](docs/ListMethods200Response.md)
+ - [Abliteration::ListModelReadmeDrifts200Response](docs/ListModelReadmeDrifts200Response.md)
  - [Abliteration::ListModels200Response](docs/ListModels200Response.md)
  - [Abliteration::ListTimeline200Response](docs/ListTimeline200Response.md)
  - [Abliteration::Method](docs/Method.md)
@@ -134,6 +146,8 @@ Class | Method | HTTP request | Description
  - [Abliteration::ModelDetail](docs/ModelDetail.md)
  - [Abliteration::ModelSummary](docs/ModelSummary.md)
  - [Abliteration::Passport](docs/Passport.md)
+ - [Abliteration::ReadmeAt](docs/ReadmeAt.md)
+ - [Abliteration::ReadmeDrift](docs/ReadmeDrift.md)
 
 
 ## Documentation for Authorization

data/docs/DeletionSummary.md

@@ -0,0 +1,28 @@
+# Abliteration::DeletionSummary
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **total_ever_seen** | **Integer** | Live catalog size plus historical deletions. | [optional] |
+| **total_deleted** | **Integer** |  | [optional] |
+| **deletion_rate_pct** | **Float** | Percentage of ever-seen models that are now gone. | [optional] |
+| **avg_months_alive** | **Float** | Average lifespan of deleted models, in months. | [optional] |
+| **timeline** | [**Array<DeletionSummaryTimelineInner>**](DeletionSummaryTimelineInner.md) | Deletions grouped by last_seen_month, ascending. | [optional] |
+| **top_by_downloads** | [**Array<DeletionSummaryTopByDownloadsInner>**](DeletionSummaryTopByDownloadsInner.md) | Top-10 biggest casualties by peak downloads. | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::DeletionSummary.new(
+  total_ever_seen: null,
+  total_deleted: null,
+  deletion_rate_pct: null,
+  avg_months_alive: null,
+  timeline: null,
+  top_by_downloads: null
+)
+```
+

data/docs/DeletionSummaryTimelineInner.md

@@ -0,0 +1,20 @@
+# Abliteration::DeletionSummaryTimelineInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **month** | **String** |  | [optional] |
+| **count** | **Integer** |  | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::DeletionSummaryTimelineInner.new(
+  month: null,
+  count: null
+)
+```
+

data/docs/DeletionSummaryTopByDownloadsInner.md

@@ -0,0 +1,24 @@
+# Abliteration::DeletionSummaryTopByDownloadsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  | [optional] |
+| **peak_downloads** | **Integer** |  | [optional] |
+| **last_seen_month** | **String** |  | [optional] |
+| **months_alive** | **Integer** |  | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::DeletionSummaryTopByDownloadsInner.new(
+  id: null,
+  peak_downloads: null,
+  last_seen_month: null,
+  months_alive: null
+)
+```
+

data/docs/GetHistoricalDeletionSummary200Response.md

@@ -0,0 +1,32 @@
+# Abliteration::GetHistoricalDeletionSummary200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**DeletionSummary**](DeletionSummary.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::GetHistoricalDeletionSummary200Response.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/GetModelReadmeAt200Response.md

@@ -0,0 +1,32 @@
+# Abliteration::GetModelReadmeAt200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**ReadmeAt**](ReadmeAt.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::GetModelReadmeAt200Response.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/HistoricalDeletion.md

@@ -0,0 +1,28 @@
+# Abliteration::HistoricalDeletion
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  | [optional] |
+| **first_seen_month** | **String** | ISO YYYY-MM of the earliest snapshot the model appears in. | [optional] |
+| **last_seen_month** | **String** | ISO YYYY-MM of the final snapshot before deletion. | [optional] |
+| **total_months_alive** | **Integer** | Whole months between first and last observation. | [optional] |
+| **peak_downloads** | **Integer** | Highest downloads count observed during the model's lifetime. | [optional] |
+| **created_at** | **String** | ISO-8601 timestamp the model was originally created on HF (from the frozen snapshot). | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::HistoricalDeletion.new(
+  id: null,
+  first_seen_month: null,
+  last_seen_month: null,
+  total_months_alive: null,
+  peak_downloads: null,
+  created_at: null
+)
+```
+

data/docs/ListHistoricalDeletions200Response.md

@@ -0,0 +1,32 @@
+# Abliteration::ListHistoricalDeletions200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**Array<HistoricalDeletion>**](HistoricalDeletion.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::ListHistoricalDeletions200Response.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/ListModelReadmeDrifts200Response.md

@@ -0,0 +1,32 @@
+# Abliteration::ListModelReadmeDrifts200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**Array<ReadmeDrift>**](ReadmeDrift.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::ListModelReadmeDrifts200Response.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/ModelsApi.md

@@ -4,11 +4,81 @@ All URIs are relative to *https://abliteration.org*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**get_historical_deletion_summary**](ModelsApi.md#get_historical_deletion_summary) | **GET** /api/v1/models/historical-deletions/summary | Historical deletions — aggregate summary |
 | [**get_model**](ModelsApi.md#get_model) | **GET** /api/v1/models/{id} | Get one model |
+| [**get_model_readme_at**](ModelsApi.md#get_model_readme_at) | **GET** /api/v1/models/{id}/readme-at/{commit} | README content at one commit (wayback) |
 | [**list_delisted_models**](ModelsApi.md#list_delisted_models) | **GET** /api/v1/models/delisted | List delisted models (change stream) |
+| [**list_historical_deletions**](ModelsApi.md#list_historical_deletions) | **GET** /api/v1/models/historical-deletions/list | Historical deletions — paged list |
+| [**list_model_readme_drifts**](ModelsApi.md#list_model_readme_drifts) | **GET** /api/v1/models/{id}/drifts | README drift stream for one model |
 | [**list_models**](ModelsApi.md#list_models) | **GET** /api/v1/models | List models |
 
 
+## get_historical_deletion_summary
+
+> <GetHistoricalDeletionSummary200Response> get_historical_deletion_summary
+
+Historical deletions — aggregate summary
+
+Cost: 20 credits, flat. Aggregates from the 24-month HF snapshot analysis: total ever seen, total deleted, deletion rate, average months alive, monthly timeline of losses, top-10 by peak downloads. One call replaces half a dozen separate queries.
+
+### 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
+
+begin
+  # Historical deletions — aggregate summary
+  result = api_instance.get_historical_deletion_summary
+  p result
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->get_historical_deletion_summary: #{e}"
+end
+```
+
+#### Using the get_historical_deletion_summary_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetHistoricalDeletionSummary200Response>, Integer, Hash)> get_historical_deletion_summary_with_http_info
+
+```ruby
+begin
+  # Historical deletions — aggregate summary
+  data, status_code, headers = api_instance.get_historical_deletion_summary_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetHistoricalDeletionSummary200Response>
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->get_historical_deletion_summary_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**GetHistoricalDeletionSummary200Response**](GetHistoricalDeletionSummary200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## get_model
 
 > <GetModel200Response> get_model(id)
@@ -78,6 +148,77 @@ end
 - **Accept**: application/json
 
 
+## get_model_readme_at
+
+> <GetModelReadmeAt200Response> get_model_readme_at(id, commit)
+
+README content at one commit (wayback)
+
+Cost: 10 credits, flat. The wayback-machine leg of the change-stream. Returns the exact README content for one model at one commit sha — used after spotting a suspicious drift on GET /api/v1/models/{id}/drifts.
+
+### 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
+id = 'id_example' # String | 
+commit = 'commit_example' # String | HF commit sha for the README, from /drifts.
+
+begin
+  # README content at one commit (wayback)
+  result = api_instance.get_model_readme_at(id, commit)
+  p result
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->get_model_readme_at: #{e}"
+end
+```
+
+#### Using the get_model_readme_at_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetModelReadmeAt200Response>, Integer, Hash)> get_model_readme_at_with_http_info(id, commit)
+
+```ruby
+begin
+  # README content at one commit (wayback)
+  data, status_code, headers = api_instance.get_model_readme_at_with_http_info(id, commit)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetModelReadmeAt200Response>
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->get_model_readme_at_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **commit** | **String** | HF commit sha for the README, from /drifts. |  |
+
+### Return type
+
+[**GetModelReadmeAt200Response**](GetModelReadmeAt200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## list_delisted_models
 
 > <ListDelistedModels200Response> list_delisted_models(opts)
@@ -155,6 +296,162 @@ end
 - **Accept**: application/json
 
 
+## list_historical_deletions
+
+> <ListHistoricalDeletions200Response> list_historical_deletions(opts)
+
+Historical deletions — paged list
+
+Cost: 5 credits, flat. Paged/filterable window on the 24-month deletion backlog. Rows are frozen at the moment the model was last seen on the Hub — peak_downloads and total_months_alive never change after death. Sort by size (`downloads`, default), recency (`recent`, newest deaths first) or lifespan (`lifespan`, longest-lived first — surprising deaths).
+
+### 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_month: 'since_month_example', # String | ISO YYYY-MM. Rows with last_seen_month >= it only.
+  min_peak_downloads: 56, # Integer | Only rows whose peak downloads >= this. `casualties over N` queries.
+  sort: 'downloads', # String | `downloads` (default, biggest first), `recent` (newest last_seen_month first), `lifespan` (longest-lived first).
+  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
+  # Historical deletions — paged list
+  result = api_instance.list_historical_deletions(opts)
+  p result
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->list_historical_deletions: #{e}"
+end
+```
+
+#### Using the list_historical_deletions_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListHistoricalDeletions200Response>, Integer, Hash)> list_historical_deletions_with_http_info(opts)
+
+```ruby
+begin
+  # Historical deletions — paged list
+  data, status_code, headers = api_instance.list_historical_deletions_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListHistoricalDeletions200Response>
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->list_historical_deletions_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **since_month** | **String** | ISO YYYY-MM. Rows with last_seen_month &gt;&#x3D; it only. | [optional] |
+| **min_peak_downloads** | **Integer** | Only rows whose peak downloads &gt;&#x3D; this. &#x60;casualties over N&#x60; queries. | [optional] |
+| **sort** | **String** | &#x60;downloads&#x60; (default, biggest first), &#x60;recent&#x60; (newest last_seen_month first), &#x60;lifespan&#x60; (longest-lived first). | [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] |
+
+### Return type
+
+[**ListHistoricalDeletions200Response**](ListHistoricalDeletions200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_model_readme_drifts
+
+> <ListModelReadmeDrifts200Response> list_model_readme_drifts(id, opts)
+
+README drift stream for one model
+
+Cost: 5 credits, flat. Every commit that changed the model's README on HF, with `size_delta` between commits so a consumer spots growth spurts and hard prunes without fetching each version. Poll with `since_ts=<max commit_ts of your previous run>` for an incremental drift feed.
+
+### 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
+id = 'mlabonne/Qwen3-30B-A3B-abliterated' # String | 
+opts = {
+  since_ts: 789, # Integer | Unix epoch seconds. Rows with commit_ts >= it only.
+  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
+  # README drift stream for one model
+  result = api_instance.list_model_readme_drifts(id, opts)
+  p result
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->list_model_readme_drifts: #{e}"
+end
+```
+
+#### Using the list_model_readme_drifts_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListModelReadmeDrifts200Response>, Integer, Hash)> list_model_readme_drifts_with_http_info(id, opts)
+
+```ruby
+begin
+  # README drift stream for one model
+  data, status_code, headers = api_instance.list_model_readme_drifts_with_http_info(id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListModelReadmeDrifts200Response>
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->list_model_readme_drifts_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **since_ts** | **Integer** | Unix epoch seconds. Rows with commit_ts &gt;&#x3D; it only. | [optional] |
+| **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
+
+[**ListModelReadmeDrifts200Response**](ListModelReadmeDrifts200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## list_models
 
 > <ListModels200Response> list_models(opts)

data/docs/ReadmeAt.md

@@ -0,0 +1,22 @@
+# Abliteration::ReadmeAt
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | Model id (author/name). | [optional] |
+| **commit** | **String** | Commit sha (echoes the path param). | [optional] |
+| **content** | **String** | Full README markdown at that commit. Up to ~100KB. | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::ReadmeAt.new(
+  id: null,
+  commit: null,
+  content: null
+)
+```
+

data/docs/ReadmeDrift.md

@@ -0,0 +1,26 @@
+# Abliteration::ReadmeDrift
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **commit_sha** | **String** |  | [optional] |
+| **commit_ts** | **Integer** | Unix epoch seconds. | [optional] |
+| **commit_message** | **String** |  | [optional] |
+| **content_size** | **Integer** | README byte size at this commit. | [optional] |
+| **size_delta** | **Integer** | Bytes added (positive) or removed (negative) since the previous commit. First commit gets 0. | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::ReadmeDrift.new(
+  commit_sha: null,
+  commit_ts: null,
+  commit_message: null,
+  content_size: null,
+  size_delta: null
+)
+```
+