@abliteration/sdk 0.1.4 → 0.1.6

package/dist/apis/ModelsApi.js

@@ -22,14 +22,61 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ListModelsSortEnum = exports.ModelsApi = void 0;
+exports.ListModelsSortEnum = exports.ListModelsDelistedEnum = exports.ListHistoricalDeletionsSortEnum = exports.ListDelistedModelsSortEnum = exports.ModelsApi = void 0;
 const runtime = require("../runtime");
+const GetHistoricalDeletionSummary200Response_1 = require("../models/GetHistoricalDeletionSummary200Response");
 const GetModel200Response_1 = require("../models/GetModel200Response");
+const ListDelistedModels200Response_1 = require("../models/ListDelistedModels200Response");
+const ListHistoricalDeletions200Response_1 = require("../models/ListHistoricalDeletions200Response");
 const ListModels200Response_1 = require("../models/ListModels200Response");
 /**
  *
  */
 class ModelsApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for getHistoricalDeletionSummary without sending the request
+     */
+    getHistoricalDeletionSummaryRequestOpts() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield 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
+     */
+    getHistoricalDeletionSummaryRaw(initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getHistoricalDeletionSummaryRequestOpts();
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, GetHistoricalDeletionSummary200Response_1.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
+     */
+    getHistoricalDeletionSummary(initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getHistoricalDeletionSummaryRaw(initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for getModel without sending the request
      */
@@ -58,7 +105,7 @@ class ModelsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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
      */
     getModelRaw(requestParameters, initOverrides) {
@@ -69,7 +116,7 @@ class ModelsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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, initOverrides) {
@@ -78,6 +125,121 @@ class ModelsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for listDelistedModels without sending the request
+     */
+    listDelistedModelsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryParameters = {};
+            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 = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield 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)
+     */
+    listDelistedModelsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.listDelistedModelsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ListDelistedModels200Response_1.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)
+     */
+    listDelistedModels() {
+        return __awaiter(this, arguments, void 0, function* (requestParameters = {}, initOverrides) {
+            const response = yield this.listDelistedModelsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for listHistoricalDeletions without sending the request
+     */
+    listHistoricalDeletionsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryParameters = {};
+            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 = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield 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
+     */
+    listHistoricalDeletionsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.listHistoricalDeletionsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ListHistoricalDeletions200Response_1.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
+     */
+    listHistoricalDeletions() {
+        return __awaiter(this, arguments, void 0, function* (requestParameters = {}, initOverrides) {
+            const response = yield this.listHistoricalDeletionsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for listModels without sending the request
      */
@@ -108,6 +270,9 @@ class ModelsApi extends runtime.BaseAPI {
             if (requestParameters['createdBefore'] != null) {
                 queryParameters['created_before'] = requestParameters['createdBefore'];
             }
+            if (requestParameters['delisted'] != null) {
+                queryParameters['delisted'] = requestParameters['delisted'];
+            }
             if (requestParameters['sort'] != null) {
                 queryParameters['sort'] = requestParameters['sort'];
             }
@@ -135,7 +300,7 @@ class ModelsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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
      */
     listModelsRaw(requestParameters, initOverrides) {
@@ -146,7 +311,7 @@ class ModelsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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() {
@@ -157,6 +322,29 @@ class ModelsApi extends runtime.BaseAPI {
     }
 }
 exports.ModelsApi = ModelsApi;
+/**
+ * @export
+ */
+exports.ListDelistedModelsSortEnum = {
+    Recent: 'recent',
+    Downloads: 'downloads',
+};
+/**
+ * @export
+ */
+exports.ListHistoricalDeletionsSortEnum = {
+    Downloads: 'downloads',
+    Recent: 'recent',
+    Lifespan: 'lifespan',
+};
+/**
+ * @export
+ */
+exports.ListModelsDelistedEnum = {
+    Live: 'live',
+    Dead: 'dead',
+    All: 'all',
+};
 /**
  * @export
  */

package/dist/esm/apis/ModelsApi.d.ts

@@ -10,7 +10,10 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
+import { type GetHistoricalDeletionSummary200Response } from '../models/GetHistoricalDeletionSummary200Response';
 import { type GetModel200Response } from '../models/GetModel200Response';
+import { type ListDelistedModels200Response } from '../models/ListDelistedModels200Response';
+import { type ListHistoricalDeletions200Response } from '../models/ListHistoricalDeletions200Response';
 import { type ListModels200Response } from '../models/ListModels200Response';
 export interface GetModelRequest {
     /**
@@ -18,6 +21,46 @@ 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.
@@ -51,6 +94,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.
      */
@@ -71,6 +118,25 @@ 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
@@ -79,7 +145,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.
@@ -88,10 +154,66 @@ 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.
@@ -102,6 +224,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.
@@ -110,7 +233,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.
@@ -120,6 +243,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.
@@ -129,7 +253,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>;
@@ -138,35 +262,103 @@ export interface ModelsApiInterface {
  *
  */
 export declare class ModelsApi extends runtime.BaseAPI implements ModelsApiInterface {
+    /**
+     * Creates request options for getHistoricalDeletionSummary without sending the request
+     */
+    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.
+     * Historical deletions — aggregate summary
+     */
+    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
      */
     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`.
      * Get one model
      */
     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
+     */
+    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.
+     * List delisted models (change stream)
+     */
+    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
+     */
+    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).
+     * Historical deletions — paged list
+     */
+    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
      */
     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.
      * List models
      */
     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>;
 }
+/**
+ * @export
+ */
+export declare const ListDelistedModelsSortEnum: {
+    readonly Recent: "recent";
+    readonly Downloads: "downloads";
+};
+export type ListDelistedModelsSortEnum = typeof ListDelistedModelsSortEnum[keyof typeof ListDelistedModelsSortEnum];
+/**
+ * @export
+ */
+export declare const ListHistoricalDeletionsSortEnum: {
+    readonly Downloads: "downloads";
+    readonly Recent: "recent";
+    readonly Lifespan: "lifespan";
+};
+export type ListHistoricalDeletionsSortEnum = typeof ListHistoricalDeletionsSortEnum[keyof typeof ListHistoricalDeletionsSortEnum];
+/**
+ * @export
+ */
+export declare const ListModelsDelistedEnum: {
+    readonly Live: "live";
+    readonly Dead: "dead";
+    readonly All: "all";
+};
+export type ListModelsDelistedEnum = typeof ListModelsDelistedEnum[keyof typeof ListModelsDelistedEnum];
 /**
  * @export
  */