@abliteration/sdk 0.1.5 → 0.1.7

package/docs/ModelsApi.md

@@ -4,12 +4,83 @@ All URIs are relative to *https://abliteration.org*
 
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
+| [**getHistoricalDeletionSummary**](ModelsApi.md#gethistoricaldeletionsummary) | **GET** /api/v1/models/historical-deletions/summary | Historical deletions — aggregate summary |
 | [**getModel**](ModelsApi.md#getmodel) | **GET** /api/v1/models/{id} | Get one model |
+| [**getModelReadmeAt**](ModelsApi.md#getmodelreadmeat) | **GET** /api/v1/models/{id}/readme-at/{commit} | README content at one commit (wayback) |
 | [**listDelistedModels**](ModelsApi.md#listdelistedmodels) | **GET** /api/v1/models/delisted | List delisted models (change stream) |
+| [**listHistoricalDeletions**](ModelsApi.md#listhistoricaldeletions) | **GET** /api/v1/models/historical-deletions/list | Historical deletions — paged list |
+| [**listModelReadmeDrifts**](ModelsApi.md#listmodelreadmedrifts) | **GET** /api/v1/models/{id}/drifts | README drift stream for one model |
 | [**listModels**](ModelsApi.md#listmodels) | **GET** /api/v1/models | List models |
 
 
 
+## getHistoricalDeletionSummary
+
+> GetHistoricalDeletionSummary200Response getHistoricalDeletionSummary()
+
+Historical deletions — aggregate summary
+
+Cost: 20 credits, flat. Aggregates from the 24-month HF snapshot analysis: total ever seen, total deleted, deletion rate, average months alive, monthly timeline of losses, top-10 by peak downloads. One call replaces half a dozen separate queries.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ModelsApi,
+} from '@abliteration/sdk';
+import type { GetHistoricalDeletionSummaryRequest } from '@abliteration/sdk';
+
+async function example() {
+  console.log("🚀 Testing @abliteration/sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new ModelsApi(config);
+
+  try {
+    const data = await api.getHistoricalDeletionSummary();
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**GetHistoricalDeletionSummary200Response**](GetHistoricalDeletionSummary200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Deletion summary. |  -  |
+| **401** | Missing, unknown or revoked key. |  -  |
+| **402** | Not enough credits. Only possible while metering is enabled. |  -  |
+| **429** | Per-key rate limit exceeded. Retry-After header is set. |  -  |
+| **503** | Catalog temporarily unreadable. Nothing was charged. |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## getModel
 
 > GetModel200Response getModel(id)
@@ -86,6 +157,85 @@ example().catch(console.error);
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## getModelReadmeAt
+
+> GetModelReadmeAt200Response getModelReadmeAt(id, commit)
+
+README content at one commit (wayback)
+
+Cost: 10 credits, flat. The wayback-machine leg of the change-stream. Returns the exact README content for one model at one commit sha — used after spotting a suspicious drift on GET /api/v1/models/{id}/drifts.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ModelsApi,
+} from '@abliteration/sdk';
+import type { GetModelReadmeAtRequest } from '@abliteration/sdk';
+
+async function example() {
+  console.log("🚀 Testing @abliteration/sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new ModelsApi(config);
+
+  const body = {
+    // string
+    id: id_example,
+    // string | HF commit sha for the README, from /drifts.
+    commit: commit_example,
+  } satisfies GetModelReadmeAtRequest;
+
+  try {
+    const data = await api.getModelReadmeAt(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **id** | `string` |  | [Defaults to `undefined`] |
+| **commit** | `string` | HF commit sha for the README, from /drifts. | [Defaults to `undefined`] |
+
+### Return type
+
+[**GetModelReadmeAt200Response**](GetModelReadmeAt200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | README content at commit. |  -  |
+| **401** | Missing, unknown or revoked key. |  -  |
+| **402** | Not enough credits. Only possible while metering is enabled. |  -  |
+| **404** | No such entity. |  -  |
+| **429** | Per-key rate limit exceeded. Retry-After header is set. |  -  |
+| **503** | Catalog temporarily unreadable. Nothing was charged. |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## listDelistedModels
 
 > ListDelistedModels200Response listDelistedModels(since, sort, limit, offset)
@@ -170,6 +320,177 @@ example().catch(console.error);
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## listHistoricalDeletions
+
+> ListHistoricalDeletions200Response listHistoricalDeletions(sinceMonth, minPeakDownloads, sort, limit, offset)
+
+Historical deletions — paged list
+
+Cost: 5 credits, flat. Paged/filterable window on the 24-month deletion backlog. Rows are frozen at the moment the model was last seen on the Hub — peak_downloads and total_months_alive never change after death. Sort by size (`downloads`, default), recency (`recent`, newest deaths first) or lifespan (`lifespan`, longest-lived first — surprising deaths).
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ModelsApi,
+} from '@abliteration/sdk';
+import type { ListHistoricalDeletionsRequest } from '@abliteration/sdk';
+
+async function example() {
+  console.log("🚀 Testing @abliteration/sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new ModelsApi(config);
+
+  const body = {
+    // string | ISO YYYY-MM. Rows with last_seen_month >= it only. (optional)
+    sinceMonth: sinceMonth_example,
+    // number | Only rows whose peak downloads >= this. `casualties over N` queries. (optional)
+    minPeakDownloads: 56,
+    // 'downloads' | 'recent' | 'lifespan' | `downloads` (default, biggest first), `recent` (newest last_seen_month first), `lifespan` (longest-lived first). (optional)
+    sort: sort_example,
+    // number | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected. (optional)
+    limit: 56,
+    // number | Rows to skip. Negative and non-numeric values are treated as 0. (optional)
+    offset: 56,
+  } satisfies ListHistoricalDeletionsRequest;
+
+  try {
+    const data = await api.listHistoricalDeletions(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **sinceMonth** | `string` | ISO YYYY-MM. Rows with last_seen_month >= it only. | [Optional] [Defaults to `undefined`] |
+| **minPeakDownloads** | `number` | Only rows whose peak downloads >= this. `casualties over N` queries. | [Optional] [Defaults to `undefined`] |
+| **sort** | `downloads`, `recent`, `lifespan` | `downloads` (default, biggest first), `recent` (newest last_seen_month first), `lifespan` (longest-lived first). | [Optional] [Defaults to `'downloads'`] [Enum: downloads, recent, lifespan] |
+| **limit** | `number` | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected. | [Optional] [Defaults to `50`] |
+| **offset** | `number` | Rows to skip. Negative and non-numeric values are treated as 0. | [Optional] [Defaults to `0`] |
+
+### Return type
+
+[**ListHistoricalDeletions200Response**](ListHistoricalDeletions200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Historical deletions. |  -  |
+| **401** | Missing, unknown or revoked key. |  -  |
+| **402** | Not enough credits. Only possible while metering is enabled. |  -  |
+| **429** | Per-key rate limit exceeded. Retry-After header is set. |  -  |
+| **503** | Catalog temporarily unreadable. Nothing was charged. |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## listModelReadmeDrifts
+
+> ListModelReadmeDrifts200Response listModelReadmeDrifts(id, sinceTs, limit, offset)
+
+README drift stream for one model
+
+Cost: 5 credits, flat. Every commit that changed the model\'s README on HF, with `size_delta` between commits so a consumer spots growth spurts and hard prunes without fetching each version. Poll with `since_ts=<max commit_ts of your previous run>` for an incremental drift feed.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ModelsApi,
+} from '@abliteration/sdk';
+import type { ListModelReadmeDriftsRequest } from '@abliteration/sdk';
+
+async function example() {
+  console.log("🚀 Testing @abliteration/sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new ModelsApi(config);
+
+  const body = {
+    // string
+    id: mlabonne/Qwen3-30B-A3B-abliterated,
+    // number | Unix epoch seconds. Rows with commit_ts >= it only. (optional)
+    sinceTs: 789,
+    // number | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected. (optional)
+    limit: 56,
+    // number | Rows to skip. Negative and non-numeric values are treated as 0. (optional)
+    offset: 56,
+  } satisfies ListModelReadmeDriftsRequest;
+
+  try {
+    const data = await api.listModelReadmeDrifts(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **id** | `string` |  | [Defaults to `undefined`] |
+| **sinceTs** | `number` | Unix epoch seconds. Rows with commit_ts >= it only. | [Optional] [Defaults to `undefined`] |
+| **limit** | `number` | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected. | [Optional] [Defaults to `50`] |
+| **offset** | `number` | Rows to skip. Negative and non-numeric values are treated as 0. | [Optional] [Defaults to `0`] |
+
+### Return type
+
+[**ListModelReadmeDrifts200Response**](ListModelReadmeDrifts200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | README commits. |  -  |
+| **401** | Missing, unknown or revoked key. |  -  |
+| **402** | Not enough credits. Only possible while metering is enabled. |  -  |
+| **429** | Per-key rate limit exceeded. Retry-After header is set. |  -  |
+| **503** | Catalog temporarily unreadable. Nothing was charged. |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## listModels
 
 > ListModels200Response listModels(method, family, author, license, downloadsGte, downloadsLte, createdAfter, createdBefore, delisted, sort, limit, offset)

package/docs/ReadmeAt.md

@@ -0,0 +1,39 @@
+
+# ReadmeAt
+
+Wayback-machine view: full README content at one commit.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`id` | string
+`commit` | string
+`content` | string
+
+## Example
+
+```typescript
+import type { ReadmeAt } from '@abliteration/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "id": null,
+  "commit": null,
+  "content": null,
+} satisfies ReadmeAt
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as ReadmeAt
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/ReadmeDrift.md

@@ -0,0 +1,43 @@
+
+# ReadmeDrift
+
+One commit that changed the model\'s README on HF.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`commit_sha` | string
+`commit_ts` | number
+`commit_message` | string
+`content_size` | number
+`size_delta` | number
+
+## Example
+
+```typescript
+import type { ReadmeDrift } from '@abliteration/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "commit_sha": null,
+  "commit_ts": null,
+  "commit_message": null,
+  "content_size": null,
+  "size_delta": null,
+} satisfies ReadmeDrift
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as ReadmeDrift
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abliteration/sdk",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "OpenAPI client for @abliteration/sdk",
   "author": "OpenAPI-Generator",
   "repository": {