scorecard-ai 2.1.0 → 2.2.0

package/src/resources/runs.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
+import { PagePromise, PaginatedResponse, type PaginatedResponseParams } from '../core/pagination';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
@@ -21,8 +22,45 @@ export class Runs extends APIResource {
   create(projectID: string, body: RunCreateParams, options?: RequestOptions): APIPromise<Run> {
     return this._client.post(path`/projects/${projectID}/runs`, { body, ...options });
   }
+
+  /**
+   * Retrieve a paginated list of all Runs for a Project. Runs are ordered by
+   * creation date, most recent first.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const run of client.runs.list('314')) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    projectID: string,
+    query: RunListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<RunsPaginatedResponse, Run> {
+    return this._client.getAPIList(path`/projects/${projectID}/runs`, PaginatedResponse<Run>, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Retrieve a specific Run by ID.
+   *
+   * @example
+   * ```ts
+   * const run = await client.runs.get('135');
+   * ```
+   */
+  get(runID: string, options?: RequestOptions): APIPromise<Run> {
+    return this._client.get(path`/runs/${runID}`, options);
+  }
 }
 
+export type RunsPaginatedResponse = PaginatedResponse<Run>;
+
 /**
  * A Run in the Scorecard system.
  */
@@ -37,6 +75,27 @@ export interface Run {
    */
   metricIds: Array<string>;
 
+  /**
+   * The IDs of the metric versions this Run is using.
+   */
+  metricVersionIds: Array<string>;
+
+  /**
+   * The number of expected records in the Run. Determined by the number of testcases
+   * in the Run's Testset at the time of Run creation.
+   */
+  numExpectedRecords: number | null;
+
+  /**
+   * The number of records in the Run.
+   */
+  numRecords: number;
+
+  /**
+   * The number of completed scores in the Run so far.
+   */
+  numScores: number;
+
   /**
    * The status of the Run.
    */
@@ -50,14 +109,19 @@ export interface Run {
     | 'completed';
 
   /**
-   * The ID of the Testset this Run is testing.
+   * The ID of the system this Run is using.
    */
-  testsetId: string | null;
+  systemId: string | null;
 
   /**
    * The ID of the system version this Run is using.
    */
-  systemVersionId?: string;
+  systemVersionId: string | null;
+
+  /**
+   * The ID of the Testset this Run is testing.
+   */
+  testsetId: string | null;
 }
 
 export interface RunCreateParams {
@@ -69,7 +133,7 @@ export interface RunCreateParams {
   /**
    * The ID of the system version this Run is using.
    */
-  systemVersionId?: string;
+  systemVersionId?: string | null;
 
   /**
    * The ID of the Testset this Run is testing.
@@ -77,6 +141,13 @@ export interface RunCreateParams {
   testsetId?: string | null;
 }
 
+export interface RunListParams extends PaginatedResponseParams {}
+
 export declare namespace Runs {
-  export { type Run as Run, type RunCreateParams as RunCreateParams };
+  export {
+    type Run as Run,
+    type RunsPaginatedResponse as RunsPaginatedResponse,
+    type RunCreateParams as RunCreateParams,
+    type RunListParams as RunListParams,
+  };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '2.1.0'; // x-release-please-version
+export const VERSION = '2.2.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.1.0";
+export declare const VERSION = "2.2.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.1.0";
+export declare const VERSION = "2.2.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '2.1.0'; // x-release-please-version
+exports.VERSION = '2.2.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '2.1.0'; // x-release-please-version
+export const VERSION = '2.2.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map