@abliteration/sdk 0.1.7 → 0.1.9

package/src/apis/ModelsApi.ts

@@ -23,11 +23,21 @@ import {
     GetModel200ResponseFromJSON,
     GetModel200ResponseToJSON,
 } from '../models/GetModel200Response';
+import {
+    type GetModelDownloadHistory200Response,
+    GetModelDownloadHistory200ResponseFromJSON,
+    GetModelDownloadHistory200ResponseToJSON,
+} from '../models/GetModelDownloadHistory200Response';
 import {
     type GetModelReadmeAt200Response,
     GetModelReadmeAt200ResponseFromJSON,
     GetModelReadmeAt200ResponseToJSON,
 } from '../models/GetModelReadmeAt200Response';
+import {
+    type ListAnomalies200Response,
+    ListAnomalies200ResponseFromJSON,
+    ListAnomalies200ResponseToJSON,
+} from '../models/ListAnomalies200Response';
 import {
     type ListDelistedModels200Response,
     ListDelistedModels200ResponseFromJSON,
@@ -56,6 +66,17 @@ export interface GetModelRequest {
     id: string;
 }
 
+export interface GetModelDownloadHistoryRequest {
+    /**
+     * 
+     */
+    id: string;
+    /**
+     * Window in days (max 365). Pass 0 for full history.
+     */
+    days?: number;
+}
+
 export interface GetModelReadmeAtRequest {
     /**
      * 
@@ -67,6 +88,29 @@ export interface GetModelReadmeAtRequest {
     commit: string;
 }
 
+export interface ListAnomaliesRequest {
+    /**
+     * Baseline distance in days. Default 7, min 1, max 365.
+     */
+    windowDays?: number;
+    /**
+     * Only rows where baseline downloads >= this. Filters `0→10` noise. Default 1000.
+     */
+    minBaseline?: number;
+    /**
+     * Filter to one class. Omit for both.
+     */
+    kind?: ListAnomaliesKindEnum;
+    /**
+     * 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 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.
@@ -232,6 +276,32 @@ export interface ModelsApiInterface {
      */
     getModel(requestParameters: GetModelRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetModel200Response>;
 
+    /**
+     * Creates request options for getModelDownloadHistory without sending the request
+     * @param {string} id 
+     * @param {number} [days] Window in days (max 365). Pass 0 for full history.
+     * @throws {RequiredError}
+     * @memberof ModelsApiInterface
+     */
+    getModelDownloadHistoryRequestOpts(requestParameters: GetModelDownloadHistoryRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Cost: 5 credits, flat. Raw signal that /market/anomalies scans over. Callers with a chart or their own anomaly detector pull it once per model.
+     * @summary Per-model download timeline
+     * @param {string} id 
+     * @param {number} [days] Window in days (max 365). Pass 0 for full history.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ModelsApiInterface
+     */
+    getModelDownloadHistoryRaw(requestParameters: GetModelDownloadHistoryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetModelDownloadHistory200Response>>;
+
+    /**
+     * Cost: 5 credits, flat. Raw signal that /market/anomalies scans over. Callers with a chart or their own anomaly detector pull it once per model.
+     * Per-model download timeline
+     */
+    getModelDownloadHistory(requestParameters: GetModelDownloadHistoryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetModelDownloadHistory200Response>;
+
     /**
      * Creates request options for getModelReadmeAt without sending the request
      * @param {string} id 
@@ -258,6 +328,38 @@ export interface ModelsApiInterface {
      */
     getModelReadmeAt(requestParameters: GetModelReadmeAtRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetModelReadmeAt200Response>;
 
+    /**
+     * Creates request options for listAnomalies without sending the request
+     * @param {number} [windowDays] Baseline distance in days. Default 7, min 1, max 365.
+     * @param {number} [minBaseline] Only rows where baseline downloads &gt;&#x3D; this. Filters &#x60;0→10&#x60; noise. Default 1000.
+     * @param {'spike' | 'drop'} [kind] Filter to one class. Omit for both.
+     * @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
+     */
+    listAnomaliesRequestOpts(requestParameters: ListAnomaliesRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Cost: 15 credits, flat. Every row is a model whose downloads-per-window has crossed a threshold: 2× jump = `spike`, 0.5× fall = `drop`. Sorted by absolute delta so biggest movers surface first. Consumers get \"what is happening in the field right now\" without re-implementing the ETL over `download_history`.
+     * @summary Anomalies in the download counter (change stream)
+     * @param {number} [windowDays] Baseline distance in days. Default 7, min 1, max 365.
+     * @param {number} [minBaseline] Only rows where baseline downloads &gt;&#x3D; this. Filters &#x60;0→10&#x60; noise. Default 1000.
+     * @param {'spike' | 'drop'} [kind] Filter to one class. Omit for both.
+     * @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
+     */
+    listAnomaliesRaw(requestParameters: ListAnomaliesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListAnomalies200Response>>;
+
+    /**
+     * Cost: 15 credits, flat. Every row is a model whose downloads-per-window has crossed a threshold: 2× jump = `spike`, 0.5× fall = `drop`. Sorted by absolute delta so biggest movers surface first. Consumers get \"what is happening in the field right now\" without re-implementing the ETL over `download_history`.
+     * Anomalies in the download counter (change stream)
+     */
+    listAnomalies(requestParameters: ListAnomaliesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListAnomalies200Response>;
+
     /**
      * 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.
@@ -505,6 +607,65 @@ export class ModelsApi extends runtime.BaseAPI implements ModelsApiInterface {
         return await response.value();
     }
 
+    /**
+     * Creates request options for getModelDownloadHistory without sending the request
+     */
+    async getModelDownloadHistoryRequestOpts(requestParameters: GetModelDownloadHistoryRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError(
+                'id',
+                'Required parameter "id" was null or undefined when calling getModelDownloadHistory().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['days'] != null) {
+            queryParameters['days'] = requestParameters['days'];
+        }
+
+        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}/download-history`;
+        urlPath = urlPath.replace('{id}', encodeURIComponent(String(requestParameters['id'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Cost: 5 credits, flat. Raw signal that /market/anomalies scans over. Callers with a chart or their own anomaly detector pull it once per model.
+     * Per-model download timeline
+     */
+    async getModelDownloadHistoryRaw(requestParameters: GetModelDownloadHistoryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetModelDownloadHistory200Response>> {
+        const requestOptions = await this.getModelDownloadHistoryRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetModelDownloadHistory200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Cost: 5 credits, flat. Raw signal that /market/anomalies scans over. Callers with a chart or their own anomaly detector pull it once per model.
+     * Per-model download timeline
+     */
+    async getModelDownloadHistory(requestParameters: GetModelDownloadHistoryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetModelDownloadHistory200Response> {
+        const response = await this.getModelDownloadHistoryRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for getModelReadmeAt without sending the request
      */
@@ -568,6 +729,73 @@ export class ModelsApi extends runtime.BaseAPI implements ModelsApiInterface {
         return await response.value();
     }
 
+    /**
+     * Creates request options for listAnomalies without sending the request
+     */
+    async listAnomaliesRequestOpts(requestParameters: ListAnomaliesRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['windowDays'] != null) {
+            queryParameters['window_days'] = requestParameters['windowDays'];
+        }
+
+        if (requestParameters['minBaseline'] != null) {
+            queryParameters['min_baseline'] = requestParameters['minBaseline'];
+        }
+
+        if (requestParameters['kind'] != null) {
+            queryParameters['kind'] = requestParameters['kind'];
+        }
+
+        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/market/anomalies`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Cost: 15 credits, flat. Every row is a model whose downloads-per-window has crossed a threshold: 2× jump = `spike`, 0.5× fall = `drop`. Sorted by absolute delta so biggest movers surface first. Consumers get \"what is happening in the field right now\" without re-implementing the ETL over `download_history`.
+     * Anomalies in the download counter (change stream)
+     */
+    async listAnomaliesRaw(requestParameters: ListAnomaliesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListAnomalies200Response>> {
+        const requestOptions = await this.listAnomaliesRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => ListAnomalies200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Cost: 15 credits, flat. Every row is a model whose downloads-per-window has crossed a threshold: 2× jump = `spike`, 0.5× fall = `drop`. Sorted by absolute delta so biggest movers surface first. Consumers get \"what is happening in the field right now\" without re-implementing the ETL over `download_history`.
+     * Anomalies in the download counter (change stream)
+     */
+    async listAnomalies(requestParameters: ListAnomaliesRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListAnomalies200Response> {
+        const response = await this.listAnomaliesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for listDelistedModels without sending the request
      */
@@ -862,6 +1090,14 @@ export class ModelsApi extends runtime.BaseAPI implements ModelsApiInterface {
 
 }
 
+/**
+ * @export
+ */
+export const ListAnomaliesKindEnum = {
+    Spike: 'spike',
+    Drop: 'drop',
+} as const;
+export type ListAnomaliesKindEnum = typeof ListAnomaliesKindEnum[keyof typeof ListAnomaliesKindEnum];
 /**
  * @export
  */

package/src/models/DownloadAnomaly.ts

@@ -0,0 +1,116 @@
+/* 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';
+/**
+ * One model whose downloads-per-window crossed a threshold.
+ * @export
+ * @interface DownloadAnomaly
+ */
+export interface DownloadAnomaly {
+    /**
+     * 
+     */
+    model_id?: string;
+    /**
+     * ISO-8601 timestamp of the current snapshot.
+     */
+    current_at?: string;
+    /**
+     * 
+     */
+    current_downloads?: number;
+    /**
+     * ISO-8601 timestamp of the baseline snapshot the delta is computed against.
+     */
+    baseline_at?: string;
+    /**
+     * 
+     */
+    baseline_downloads?: number;
+    /**
+     * current_downloads / baseline_downloads.
+     */
+    ratio?: number;
+    /**
+     * current_downloads - baseline_downloads (signed).
+     */
+    delta?: number;
+    /**
+     * `spike` when ratio >= 2, `drop` when ratio <= 0.5.
+     */
+    kind?: DownloadAnomalyKindEnum;
+}
+
+
+/**
+ * @export
+ */
+export const DownloadAnomalyKindEnum = {
+    Spike: 'spike',
+    Drop: 'drop',
+} as const;
+export type DownloadAnomalyKindEnum = typeof DownloadAnomalyKindEnum[keyof typeof DownloadAnomalyKindEnum];
+
+
+/**
+ * Check if a given object implements the DownloadAnomaly interface.
+ */
+export function instanceOfDownloadAnomaly(value: object): value is DownloadAnomaly {
+    return true;
+}
+
+export function DownloadAnomalyFromJSON(json: any): DownloadAnomaly {
+    return DownloadAnomalyFromJSONTyped(json, false);
+}
+
+export function DownloadAnomalyFromJSONTyped(json: any, ignoreDiscriminator: boolean): DownloadAnomaly {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'model_id': json['model_id'] == null ? undefined : json['model_id'],
+        'current_at': json['current_at'] == null ? undefined : json['current_at'],
+        'current_downloads': json['current_downloads'] == null ? undefined : json['current_downloads'],
+        'baseline_at': json['baseline_at'] == null ? undefined : json['baseline_at'],
+        'baseline_downloads': json['baseline_downloads'] == null ? undefined : json['baseline_downloads'],
+        'ratio': json['ratio'] == null ? undefined : json['ratio'],
+        'delta': json['delta'] == null ? undefined : json['delta'],
+        'kind': json['kind'] == null ? undefined : json['kind'],
+    };
+}
+
+export function DownloadAnomalyToJSON(json: any): DownloadAnomaly {
+    return DownloadAnomalyToJSONTyped(json, false);
+}
+
+export function DownloadAnomalyToJSONTyped(value?: DownloadAnomaly | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'model_id': value['model_id'],
+        'current_at': value['current_at'],
+        'current_downloads': value['current_downloads'],
+        'baseline_at': value['baseline_at'],
+        'baseline_downloads': value['baseline_downloads'],
+        'ratio': value['ratio'],
+        'delta': value['delta'],
+        'kind': value['kind'],
+    };
+}
+

package/src/models/DownloadPoint.ts

@@ -0,0 +1,69 @@
+/* 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';
+/**
+ * One snapshot in a per-model download timeline.
+ * @export
+ * @interface DownloadPoint
+ */
+export interface DownloadPoint {
+    /**
+     * ISO-8601 timestamp of the observation.
+     */
+    date?: string;
+    /**
+     * 
+     */
+    downloads?: number;
+}
+
+/**
+ * Check if a given object implements the DownloadPoint interface.
+ */
+export function instanceOfDownloadPoint(value: object): value is DownloadPoint {
+    return true;
+}
+
+export function DownloadPointFromJSON(json: any): DownloadPoint {
+    return DownloadPointFromJSONTyped(json, false);
+}
+
+export function DownloadPointFromJSONTyped(json: any, ignoreDiscriminator: boolean): DownloadPoint {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'date': json['date'] == null ? undefined : json['date'],
+        'downloads': json['downloads'] == null ? undefined : json['downloads'],
+    };
+}
+
+export function DownloadPointToJSON(json: any): DownloadPoint {
+    return DownloadPointToJSONTyped(json, false);
+}
+
+export function DownloadPointToJSONTyped(value?: DownloadPoint | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'date': value['date'],
+        'downloads': value['downloads'],
+    };
+}
+

package/src/models/FreedomVelocityDailyPoint.ts

@@ -0,0 +1,81 @@
+/* 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';
+/**
+ * One stored daily Freedom Velocity reading.
+ * @export
+ * @interface FreedomVelocityDailyPoint
+ */
+export interface FreedomVelocityDailyPoint {
+    /**
+     * UTC date of the snapshot, YYYY-MM-DD.
+     */
+    date?: string;
+    /**
+     * Mean days from a base model release to the first derived catalog model, as stored that day.
+     */
+    value?: number;
+    /**
+     * Median of the per-base days that day; null when not recorded.
+     */
+    median?: number | null;
+    /**
+     * Number of base models in the average that day; null when not recorded.
+     */
+    bases_count?: number | null;
+}
+
+/**
+ * Check if a given object implements the FreedomVelocityDailyPoint interface.
+ */
+export function instanceOfFreedomVelocityDailyPoint(value: object): value is FreedomVelocityDailyPoint {
+    return true;
+}
+
+export function FreedomVelocityDailyPointFromJSON(json: any): FreedomVelocityDailyPoint {
+    return FreedomVelocityDailyPointFromJSONTyped(json, false);
+}
+
+export function FreedomVelocityDailyPointFromJSONTyped(json: any, ignoreDiscriminator: boolean): FreedomVelocityDailyPoint {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'date': json['date'] == null ? undefined : json['date'],
+        'value': json['value'] == null ? undefined : json['value'],
+        'median': json['median'] === undefined ? undefined : json['median'] === null ? null : json['median'],
+        'bases_count': json['bases_count'] === undefined ? undefined : json['bases_count'] === null ? null : json['bases_count'],
+    };
+}
+
+export function FreedomVelocityDailyPointToJSON(json: any): FreedomVelocityDailyPoint {
+    return FreedomVelocityDailyPointToJSONTyped(json, false);
+}
+
+export function FreedomVelocityDailyPointToJSONTyped(value?: FreedomVelocityDailyPoint | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'date': value['date'],
+        'value': value['value'],
+        'median': value['median'],
+        'bases_count': value['bases_count'],
+    };
+}
+