@abliteration/sdk 0.1.4 → 0.1.6

package/src/apis/ModelsApi.ts

@@ -13,11 +13,26 @@
  */
 
 import * as runtime from '../runtime';
+import {
+    type GetHistoricalDeletionSummary200Response,
+    GetHistoricalDeletionSummary200ResponseFromJSON,
+    GetHistoricalDeletionSummary200ResponseToJSON,
+} from '../models/GetHistoricalDeletionSummary200Response';
 import {
     type GetModel200Response,
     GetModel200ResponseFromJSON,
     GetModel200ResponseToJSON,
 } from '../models/GetModel200Response';
+import {
+    type ListDelistedModels200Response,
+    ListDelistedModels200ResponseFromJSON,
+    ListDelistedModels200ResponseToJSON,
+} from '../models/ListDelistedModels200Response';
+import {
+    type ListHistoricalDeletions200Response,
+    ListHistoricalDeletions200ResponseFromJSON,
+    ListHistoricalDeletions200ResponseToJSON,
+} from '../models/ListHistoricalDeletions200Response';
 import {
     type ListModels200Response,
     ListModels200ResponseFromJSON,
@@ -31,6 +46,48 @@ export interface GetModelRequest {
     id: string;
 }
 
+export interface ListDelistedModelsRequest {
+    /**
+     * 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.
+     */
+    since?: string;
+    /**
+     * `recent` (default, newest disappearance first) or `downloads` (biggest casualties first — best for post-mortem coverage).
+     */
+    sort?: ListDelistedModelsSortEnum;
+    /**
+     * Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+     */
+    limit?: number;
+    /**
+     * Rows to skip. Negative and non-numeric values are treated as 0.
+     */
+    offset?: number;
+}
+
+export interface ListHistoricalDeletionsRequest {
+    /**
+     * ISO YYYY-MM. Rows with last_seen_month >= it only.
+     */
+    sinceMonth?: string;
+    /**
+     * Only rows whose peak downloads >= this. `casualties over N` queries.
+     */
+    minPeakDownloads?: number;
+    /**
+     * `downloads` (default, biggest first), `recent` (newest last_seen_month first), `lifespan` (longest-lived first).
+     */
+    sort?: ListHistoricalDeletionsSortEnum;
+    /**
+     * Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+     */
+    limit?: number;
+    /**
+     * Rows to skip. Negative and non-numeric values are treated as 0.
+     */
+    offset?: number;
+}
+
 export interface ListModelsRequest {
     /**
      * M-code, case-insensitive. See GET /api/v1/methods.
@@ -64,6 +121,10 @@ export interface ListModelsRequest {
      * ISO-8601 date or timestamp, inclusive.
      */
     createdBefore?: 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.
+     */
+    delisted?: ListModelsDelistedEnum;
     /**
      * 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.
      */
@@ -85,6 +146,28 @@ export interface ListModelsRequest {
  * @interface ModelsApiInterface
  */
 export interface ModelsApiInterface {
+    /**
+     * Creates request options for getHistoricalDeletionSummary without sending the request
+     * @throws {RequiredError}
+     * @memberof ModelsApiInterface
+     */
+    getHistoricalDeletionSummaryRequestOpts(): Promise<runtime.RequestOpts>;
+
+    /**
+     * 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.
+     * @summary Historical deletions — aggregate summary
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ModelsApiInterface
+     */
+    getHistoricalDeletionSummaryRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetHistoricalDeletionSummary200Response>>;
+
+    /**
+     * 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.
+     * Historical deletions — aggregate summary
+     */
+    getHistoricalDeletionSummary(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetHistoricalDeletionSummary200Response>;
+
     /**
      * Creates request options for getModel without sending the request
      * @param {string} id 
@@ -94,7 +177,7 @@ export interface ModelsApiInterface {
     getModelRequestOpts(requestParameters: GetModelRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * 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`.
      * @summary Get one model
      * @param {string} id 
      * @param {*} [options] Override http request option.
@@ -104,11 +187,73 @@ export interface ModelsApiInterface {
     getModelRaw(requestParameters: GetModelRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetModel200Response>>;
 
     /**
-     * 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`.
      * Get one model
      */
     getModel(requestParameters: GetModelRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetModel200Response>;
 
+    /**
+     * Creates request options for listDelistedModels without sending the request
+     * @param {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.
+     * @param {'recent' | 'downloads'} [sort] &#x60;recent&#x60; (default, newest disappearance first) or &#x60;downloads&#x60; (biggest casualties first — best for post-mortem coverage).
+     * @param {number} [limit] Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+     * @param {number} [offset] Rows to skip. Negative and non-numeric values are treated as 0.
+     * @throws {RequiredError}
+     * @memberof ModelsApiInterface
+     */
+    listDelistedModelsRequestOpts(requestParameters: ListDelistedModelsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * 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.
+     * @summary List delisted models (change stream)
+     * @param {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.
+     * @param {'recent' | 'downloads'} [sort] &#x60;recent&#x60; (default, newest disappearance first) or &#x60;downloads&#x60; (biggest casualties first — best for post-mortem coverage).
+     * @param {number} [limit] Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+     * @param {number} [offset] Rows to skip. Negative and non-numeric values are treated as 0.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ModelsApiInterface
+     */
+    listDelistedModelsRaw(requestParameters: ListDelistedModelsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListDelistedModels200Response>>;
+
+    /**
+     * 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.
+     * List delisted models (change stream)
+     */
+    listDelistedModels(requestParameters: ListDelistedModelsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListDelistedModels200Response>;
+
+    /**
+     * Creates request options for listHistoricalDeletions without sending the request
+     * @param {string} [sinceMonth] ISO YYYY-MM. Rows with last_seen_month &gt;&#x3D; it only.
+     * @param {number} [minPeakDownloads] Only rows whose peak downloads &gt;&#x3D; this. &#x60;casualties over N&#x60; queries.
+     * @param {'downloads' | 'recent' | 'lifespan'} [sort] &#x60;downloads&#x60; (default, biggest first), &#x60;recent&#x60; (newest last_seen_month first), &#x60;lifespan&#x60; (longest-lived first).
+     * @param {number} [limit] Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+     * @param {number} [offset] Rows to skip. Negative and non-numeric values are treated as 0.
+     * @throws {RequiredError}
+     * @memberof ModelsApiInterface
+     */
+    listHistoricalDeletionsRequestOpts(requestParameters: ListHistoricalDeletionsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * 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).
+     * @summary Historical deletions — paged list
+     * @param {string} [sinceMonth] ISO YYYY-MM. Rows with last_seen_month &gt;&#x3D; it only.
+     * @param {number} [minPeakDownloads] Only rows whose peak downloads &gt;&#x3D; this. &#x60;casualties over N&#x60; queries.
+     * @param {'downloads' | 'recent' | 'lifespan'} [sort] &#x60;downloads&#x60; (default, biggest first), &#x60;recent&#x60; (newest last_seen_month first), &#x60;lifespan&#x60; (longest-lived first).
+     * @param {number} [limit] Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+     * @param {number} [offset] Rows to skip. Negative and non-numeric values are treated as 0.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ModelsApiInterface
+     */
+    listHistoricalDeletionsRaw(requestParameters: ListHistoricalDeletionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListHistoricalDeletions200Response>>;
+
+    /**
+     * 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).
+     * Historical deletions — paged list
+     */
+    listHistoricalDeletions(requestParameters: ListHistoricalDeletionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListHistoricalDeletions200Response>;
+
     /**
      * Creates request options for listModels without sending the request
      * @param {string} [method] M-code, case-insensitive. See GET /api/v1/methods.
@@ -119,6 +264,7 @@ export interface ModelsApiInterface {
      * @param {number} [downloadsLte] 
      * @param {string} [createdAfter] ISO-8601 date or timestamp, inclusive.
      * @param {string} [createdBefore] ISO-8601 date or timestamp, inclusive.
+     * @param {'live' | 'dead' | 'all'} [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.
      * @param {'downloads' | '-downloads' | 'likes' | '-likes' | 'created' | '-created' | 'created_at' | '-created_at' | 'first_seen' | '-first_seen' | 'first_seen_at' | '-first_seen_at'} [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.
      * @param {number} [limit] Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
      * @param {number} [offset] Rows to skip. Negative and non-numeric values are treated as 0.
@@ -128,7 +274,7 @@ export interface ModelsApiInterface {
     listModelsRequestOpts(requestParameters: ListModelsRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * 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.
      * @summary List models
      * @param {string} [method] M-code, case-insensitive. See GET /api/v1/methods.
      * @param {string} [family] Base family, for example qwen or llama.
@@ -138,6 +284,7 @@ export interface ModelsApiInterface {
      * @param {number} [downloadsLte] 
      * @param {string} [createdAfter] ISO-8601 date or timestamp, inclusive.
      * @param {string} [createdBefore] ISO-8601 date or timestamp, inclusive.
+     * @param {'live' | 'dead' | 'all'} [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.
      * @param {'downloads' | '-downloads' | 'likes' | '-likes' | 'created' | '-created' | 'created_at' | '-created_at' | 'first_seen' | '-first_seen' | 'first_seen_at' | '-first_seen_at'} [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.
      * @param {number} [limit] Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
      * @param {number} [offset] Rows to skip. Negative and non-numeric values are treated as 0.
@@ -148,7 +295,7 @@ export interface ModelsApiInterface {
     listModelsRaw(requestParameters: ListModelsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListModels200Response>>;
 
     /**
-     * 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.
      * List models
      */
     listModels(requestParameters: ListModelsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListModels200Response>;
@@ -160,6 +307,53 @@ export interface ModelsApiInterface {
  */
 export class ModelsApi extends runtime.BaseAPI implements ModelsApiInterface {
 
+    /**
+     * Creates request options for getHistoricalDeletionSummary without sending the request
+     */
+    async getHistoricalDeletionSummaryRequestOpts(): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/v1/models/historical-deletions/summary`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * 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.
+     * Historical deletions — aggregate summary
+     */
+    async getHistoricalDeletionSummaryRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetHistoricalDeletionSummary200Response>> {
+        const requestOptions = await this.getHistoricalDeletionSummaryRequestOpts();
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetHistoricalDeletionSummary200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 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.
+     * Historical deletions — aggregate summary
+     */
+    async getHistoricalDeletionSummary(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetHistoricalDeletionSummary200Response> {
+        const response = await this.getHistoricalDeletionSummaryRaw(initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for getModel without sending the request
      */
@@ -196,7 +390,7 @@ export class ModelsApi extends runtime.BaseAPI implements ModelsApiInterface {
     }
 
     /**
-     * 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`.
      * Get one model
      */
     async getModelRaw(requestParameters: GetModelRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetModel200Response>> {
@@ -207,7 +401,7 @@ export class ModelsApi extends runtime.BaseAPI implements ModelsApiInterface {
     }
 
     /**
-     * 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`.
      * Get one model
      */
     async getModel(requestParameters: GetModelRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetModel200Response> {
@@ -215,6 +409,136 @@ export class ModelsApi extends runtime.BaseAPI implements ModelsApiInterface {
         return await response.value();
     }
 
+    /**
+     * Creates request options for listDelistedModels without sending the request
+     */
+    async listDelistedModelsRequestOpts(requestParameters: ListDelistedModelsRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['since'] != null) {
+            queryParameters['since'] = requestParameters['since'];
+        }
+
+        if (requestParameters['sort'] != null) {
+            queryParameters['sort'] = requestParameters['sort'];
+        }
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        if (requestParameters['offset'] != null) {
+            queryParameters['offset'] = requestParameters['offset'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/v1/models/delisted`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * 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.
+     * List delisted models (change stream)
+     */
+    async listDelistedModelsRaw(requestParameters: ListDelistedModelsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListDelistedModels200Response>> {
+        const requestOptions = await this.listDelistedModelsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => ListDelistedModels200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 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.
+     * List delisted models (change stream)
+     */
+    async listDelistedModels(requestParameters: ListDelistedModelsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListDelistedModels200Response> {
+        const response = await this.listDelistedModelsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listHistoricalDeletions without sending the request
+     */
+    async listHistoricalDeletionsRequestOpts(requestParameters: ListHistoricalDeletionsRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['sinceMonth'] != null) {
+            queryParameters['since_month'] = requestParameters['sinceMonth'];
+        }
+
+        if (requestParameters['minPeakDownloads'] != null) {
+            queryParameters['min_peak_downloads'] = requestParameters['minPeakDownloads'];
+        }
+
+        if (requestParameters['sort'] != null) {
+            queryParameters['sort'] = requestParameters['sort'];
+        }
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        if (requestParameters['offset'] != null) {
+            queryParameters['offset'] = requestParameters['offset'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/v1/models/historical-deletions/list`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * 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).
+     * Historical deletions — paged list
+     */
+    async listHistoricalDeletionsRaw(requestParameters: ListHistoricalDeletionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListHistoricalDeletions200Response>> {
+        const requestOptions = await this.listHistoricalDeletionsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => ListHistoricalDeletions200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 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).
+     * Historical deletions — paged list
+     */
+    async listHistoricalDeletions(requestParameters: ListHistoricalDeletionsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListHistoricalDeletions200Response> {
+        const response = await this.listHistoricalDeletionsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for listModels without sending the request
      */
@@ -253,6 +577,10 @@ export class ModelsApi extends runtime.BaseAPI implements ModelsApiInterface {
             queryParameters['created_before'] = requestParameters['createdBefore'];
         }
 
+        if (requestParameters['delisted'] != null) {
+            queryParameters['delisted'] = requestParameters['delisted'];
+        }
+
         if (requestParameters['sort'] != null) {
             queryParameters['sort'] = requestParameters['sort'];
         }
@@ -287,7 +615,7 @@ export class ModelsApi extends runtime.BaseAPI implements ModelsApiInterface {
     }
 
     /**
-     * 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.
      * List models
      */
     async listModelsRaw(requestParameters: ListModelsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListModels200Response>> {
@@ -298,7 +626,7 @@ export class ModelsApi extends runtime.BaseAPI implements ModelsApiInterface {
     }
 
     /**
-     * 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.
      * List models
      */
     async listModels(requestParameters: ListModelsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListModels200Response> {
@@ -308,6 +636,32 @@ export class ModelsApi extends runtime.BaseAPI implements ModelsApiInterface {
 
 }
 
+/**
+ * @export
+ */
+export const ListDelistedModelsSortEnum = {
+    Recent: 'recent',
+    Downloads: 'downloads',
+} as const;
+export type ListDelistedModelsSortEnum = typeof ListDelistedModelsSortEnum[keyof typeof ListDelistedModelsSortEnum];
+/**
+ * @export
+ */
+export const ListHistoricalDeletionsSortEnum = {
+    Downloads: 'downloads',
+    Recent: 'recent',
+    Lifespan: 'lifespan',
+} as const;
+export type ListHistoricalDeletionsSortEnum = typeof ListHistoricalDeletionsSortEnum[keyof typeof ListHistoricalDeletionsSortEnum];
+/**
+ * @export
+ */
+export const ListModelsDelistedEnum = {
+    Live: 'live',
+    Dead: 'dead',
+    All: 'all',
+} as const;
+export type ListModelsDelistedEnum = typeof ListModelsDelistedEnum[keyof typeof ListModelsDelistedEnum];
 /**
  * @export
  */

package/src/models/DeletionSummary.ts

@@ -0,0 +1,108 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { mapValues } from '../runtime';
+import type { DeletionSummaryTopByDownloadsInner } from './DeletionSummaryTopByDownloadsInner';
+import {
+    DeletionSummaryTopByDownloadsInnerFromJSON,
+    DeletionSummaryTopByDownloadsInnerFromJSONTyped,
+    DeletionSummaryTopByDownloadsInnerToJSON,
+    DeletionSummaryTopByDownloadsInnerToJSONTyped,
+} from './DeletionSummaryTopByDownloadsInner';
+import type { DeletionSummaryTimelineInner } from './DeletionSummaryTimelineInner';
+import {
+    DeletionSummaryTimelineInnerFromJSON,
+    DeletionSummaryTimelineInnerFromJSONTyped,
+    DeletionSummaryTimelineInnerToJSON,
+    DeletionSummaryTimelineInnerToJSONTyped,
+} from './DeletionSummaryTimelineInner';
+
+/**
+ * Aggregate rollup of the 24-month HF deletion analysis.
+ * @export
+ * @interface DeletionSummary
+ */
+export interface DeletionSummary {
+    /**
+     * Live catalog size plus historical deletions.
+     */
+    total_ever_seen?: number;
+    /**
+     * 
+     */
+    total_deleted?: number;
+    /**
+     * Percentage of ever-seen models that are now gone.
+     */
+    deletion_rate_pct?: number;
+    /**
+     * Average lifespan of deleted models, in months.
+     */
+    avg_months_alive?: number;
+    /**
+     * Deletions grouped by last_seen_month, ascending.
+     */
+    timeline?: Array<DeletionSummaryTimelineInner>;
+    /**
+     * Top-10 biggest casualties by peak downloads.
+     */
+    top_by_downloads?: Array<DeletionSummaryTopByDownloadsInner>;
+}
+
+/**
+ * Check if a given object implements the DeletionSummary interface.
+ */
+export function instanceOfDeletionSummary(value: object): value is DeletionSummary {
+    return true;
+}
+
+export function DeletionSummaryFromJSON(json: any): DeletionSummary {
+    return DeletionSummaryFromJSONTyped(json, false);
+}
+
+export function DeletionSummaryFromJSONTyped(json: any, ignoreDiscriminator: boolean): DeletionSummary {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'total_ever_seen': json['total_ever_seen'] == null ? undefined : json['total_ever_seen'],
+        'total_deleted': json['total_deleted'] == null ? undefined : json['total_deleted'],
+        'deletion_rate_pct': json['deletion_rate_pct'] == null ? undefined : json['deletion_rate_pct'],
+        'avg_months_alive': json['avg_months_alive'] == null ? undefined : json['avg_months_alive'],
+        'timeline': json['timeline'] == null ? undefined : ((json['timeline'] as Array<any>).map(DeletionSummaryTimelineInnerFromJSON)),
+        'top_by_downloads': json['top_by_downloads'] == null ? undefined : ((json['top_by_downloads'] as Array<any>).map(DeletionSummaryTopByDownloadsInnerFromJSON)),
+    };
+}
+
+export function DeletionSummaryToJSON(json: any): DeletionSummary {
+    return DeletionSummaryToJSONTyped(json, false);
+}
+
+export function DeletionSummaryToJSONTyped(value?: DeletionSummary | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'total_ever_seen': value['total_ever_seen'],
+        'total_deleted': value['total_deleted'],
+        'deletion_rate_pct': value['deletion_rate_pct'],
+        'avg_months_alive': value['avg_months_alive'],
+        'timeline': value['timeline'] == null ? undefined : ((value['timeline'] as Array<any>).map(DeletionSummaryTimelineInnerToJSON)),
+        'top_by_downloads': value['top_by_downloads'] == null ? undefined : ((value['top_by_downloads'] as Array<any>).map(DeletionSummaryTopByDownloadsInnerToJSON)),
+    };
+}
+