@abliteration/sdk 0.1.5 → 0.1.7

package/src/apis/ModelsApi.ts

@@ -13,16 +13,36 @@
  */
 
 import * as runtime from '../runtime';
+import {
+    type GetHistoricalDeletionSummary200Response,
+    GetHistoricalDeletionSummary200ResponseFromJSON,
+    GetHistoricalDeletionSummary200ResponseToJSON,
+} from '../models/GetHistoricalDeletionSummary200Response';
 import {
     type GetModel200Response,
     GetModel200ResponseFromJSON,
     GetModel200ResponseToJSON,
 } from '../models/GetModel200Response';
+import {
+    type GetModelReadmeAt200Response,
+    GetModelReadmeAt200ResponseFromJSON,
+    GetModelReadmeAt200ResponseToJSON,
+} from '../models/GetModelReadmeAt200Response';
 import {
     type ListDelistedModels200Response,
     ListDelistedModels200ResponseFromJSON,
     ListDelistedModels200ResponseToJSON,
 } from '../models/ListDelistedModels200Response';
+import {
+    type ListHistoricalDeletions200Response,
+    ListHistoricalDeletions200ResponseFromJSON,
+    ListHistoricalDeletions200ResponseToJSON,
+} from '../models/ListHistoricalDeletions200Response';
+import {
+    type ListModelReadmeDrifts200Response,
+    ListModelReadmeDrifts200ResponseFromJSON,
+    ListModelReadmeDrifts200ResponseToJSON,
+} from '../models/ListModelReadmeDrifts200Response';
 import {
     type ListModels200Response,
     ListModels200ResponseFromJSON,
@@ -36,6 +56,17 @@ export interface GetModelRequest {
     id: string;
 }
 
+export interface GetModelReadmeAtRequest {
+    /**
+     * 
+     */
+    id: string;
+    /**
+     * HF commit sha for the README, from /drifts.
+     */
+    commit: 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.
@@ -55,6 +86,48 @@ export interface ListDelistedModelsRequest {
     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 ListModelReadmeDriftsRequest {
+    /**
+     * 
+     */
+    id: string;
+    /**
+     * Unix epoch seconds. Rows with commit_ts >= it only.
+     */
+    sinceTs?: number;
+    /**
+     * 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.
@@ -113,6 +186,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 
@@ -137,6 +232,32 @@ export interface ModelsApiInterface {
      */
     getModel(requestParameters: GetModelRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetModel200Response>;
 
+    /**
+     * Creates request options for getModelReadmeAt without sending the request
+     * @param {string} id 
+     * @param {string} commit HF commit sha for the README, from /drifts.
+     * @throws {RequiredError}
+     * @memberof ModelsApiInterface
+     */
+    getModelReadmeAtRequestOpts(requestParameters: GetModelReadmeAtRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * 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.
+     * @summary README content at one commit (wayback)
+     * @param {string} id 
+     * @param {string} commit HF commit sha for the README, from /drifts.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ModelsApiInterface
+     */
+    getModelReadmeAtRaw(requestParameters: GetModelReadmeAtRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetModelReadmeAt200Response>>;
+
+    /**
+     * 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.
+     * README content at one commit (wayback)
+     */
+    getModelReadmeAt(requestParameters: GetModelReadmeAtRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetModelReadmeAt200Response>;
+
     /**
      * 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.
@@ -167,6 +288,68 @@ export interface ModelsApiInterface {
      */
     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 listModelReadmeDrifts without sending the request
+     * @param {string} id 
+     * @param {number} [sinceTs] Unix epoch seconds. Rows with commit_ts &gt;&#x3D; it only.
+     * @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
+     */
+    listModelReadmeDriftsRequestOpts(requestParameters: ListModelReadmeDriftsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * 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.
+     * @summary README drift stream for one model
+     * @param {string} id 
+     * @param {number} [sinceTs] Unix epoch seconds. Rows with commit_ts &gt;&#x3D; it only.
+     * @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
+     */
+    listModelReadmeDriftsRaw(requestParameters: ListModelReadmeDriftsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListModelReadmeDrifts200Response>>;
+
+    /**
+     * 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.
+     * README drift stream for one model
+     */
+    listModelReadmeDrifts(requestParameters: ListModelReadmeDriftsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListModelReadmeDrifts200Response>;
+
     /**
      * Creates request options for listModels without sending the request
      * @param {string} [method] M-code, case-insensitive. See GET /api/v1/methods.
@@ -220,6 +403,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
      */
@@ -275,6 +505,69 @@ export class ModelsApi extends runtime.BaseAPI implements ModelsApiInterface {
         return await response.value();
     }
 
+    /**
+     * Creates request options for getModelReadmeAt without sending the request
+     */
+    async getModelReadmeAtRequestOpts(requestParameters: GetModelReadmeAtRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError(
+                'id',
+                'Required parameter "id" was null or undefined when calling getModelReadmeAt().'
+            );
+        }
+
+        if (requestParameters['commit'] == null) {
+            throw new runtime.RequiredError(
+                'commit',
+                'Required parameter "commit" was null or undefined when calling getModelReadmeAt().'
+            );
+        }
+
+        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/{id}/readme-at/{commit}`;
+        urlPath = urlPath.replace('{id}', encodeURIComponent(String(requestParameters['id'])));
+        urlPath = urlPath.replace('{commit}', encodeURIComponent(String(requestParameters['commit'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * 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.
+     * README content at one commit (wayback)
+     */
+    async getModelReadmeAtRaw(requestParameters: GetModelReadmeAtRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetModelReadmeAt200Response>> {
+        const requestOptions = await this.getModelReadmeAtRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetModelReadmeAt200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 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.
+     * README content at one commit (wayback)
+     */
+    async getModelReadmeAt(requestParameters: GetModelReadmeAtRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetModelReadmeAt200Response> {
+        const response = await this.getModelReadmeAtRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for listDelistedModels without sending the request
      */
@@ -338,6 +631,140 @@ export class ModelsApi extends runtime.BaseAPI implements ModelsApiInterface {
         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 listModelReadmeDrifts without sending the request
+     */
+    async listModelReadmeDriftsRequestOpts(requestParameters: ListModelReadmeDriftsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError(
+                'id',
+                'Required parameter "id" was null or undefined when calling listModelReadmeDrifts().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['sinceTs'] != null) {
+            queryParameters['since_ts'] = requestParameters['sinceTs'];
+        }
+
+        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/{id}/drifts`;
+        urlPath = urlPath.replace('{id}', encodeURIComponent(String(requestParameters['id'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * 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.
+     * README drift stream for one model
+     */
+    async listModelReadmeDriftsRaw(requestParameters: ListModelReadmeDriftsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListModelReadmeDrifts200Response>> {
+        const requestOptions = await this.listModelReadmeDriftsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => ListModelReadmeDrifts200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 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.
+     * README drift stream for one model
+     */
+    async listModelReadmeDrifts(requestParameters: ListModelReadmeDriftsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListModelReadmeDrifts200Response> {
+        const response = await this.listModelReadmeDriftsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for listModels without sending the request
      */
@@ -443,6 +870,15 @@ export const ListDelistedModelsSortEnum = {
     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
  */

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)),
+    };
+}
+