@atlanai/sdk 0.2.3 → 0.3.0

package/dist/raw/agent/models/UsageView.d.ts

@@ -16,31 +16,31 @@
  */
 export interface UsageView {
     /**
-     * Value of the `cache_read_tokens` field.
+     *
      * @type {number}
      * @memberof UsageView
      */
     cacheReadTokens: number;
     /**
-     * Value of the `cache_write_tokens` field.
+     *
      * @type {number}
      * @memberof UsageView
      */
     cacheWriteTokens: number;
     /**
-     * Value of the `input_tokens` field.
+     *
      * @type {number}
      * @memberof UsageView
      */
     inputTokens: number;
     /**
-     * Value of the `output_tokens` field.
+     *
      * @type {number}
      * @memberof UsageView
      */
     outputTokens: number;
     /**
-     * Value of the `total_tokens` field.
+     *
      * @type {number}
      * @memberof UsageView
      */

package/dist/raw/api/models/ArtifactConflictProblem.d.ts

@@ -22,31 +22,31 @@
  */
 export interface ArtifactConflictProblem {
     /**
-     * Value of the `code` field.
+     *
      * @type {string}
      * @memberof ArtifactConflictProblem
      */
     code: string;
     /**
-     * Value of the `detail` field.
+     *
      * @type {string}
      * @memberof ArtifactConflictProblem
      */
     detail: string;
     /**
-     * Current lifecycle state.
+     *
      * @type {number}
      * @memberof ArtifactConflictProblem
      */
     status: number;
     /**
-     * Value of the `title` field.
+     *
      * @type {string}
      * @memberof ArtifactConflictProblem
      */
     title: string;
     /**
-     * Stable identifier of the related trace resource.
+     *
      * @type {string}
      * @memberof ArtifactConflictProblem
      */

package/dist/raw/api/models/ProblemDetails.d.ts

@@ -36,31 +36,31 @@
  */
 export interface ProblemDetails {
     /**
-     * Value of the `code` field.
+     *
      * @type {string}
      * @memberof ProblemDetails
      */
     code: string;
     /**
-     * Value of the `detail` field.
+     *
      * @type {string}
      * @memberof ProblemDetails
      */
     detail: string;
     /**
-     * Current lifecycle state.
+     *
      * @type {number}
      * @memberof ProblemDetails
      */
     status: number;
     /**
-     * Value of the `title` field.
+     *
      * @type {string}
      * @memberof ProblemDetails
      */
     title: string;
     /**
-     * Stable identifier of the related trace resource.
+     *
      * @type {string}
      * @memberof ProblemDetails
      */

package/dist/raw/eval/apis/DatasetsApi.d.ts

@@ -200,12 +200,10 @@ export declare class DatasetsApi extends runtime.BaseAPI {
      */
     evalGetDatasetRecordVersionRequestOpts(requestParameters: EvalGetDatasetRecordVersionRequest): Promise<runtime.RequestOpts>;
     /**
-     * Use this operation to get a record version.
      * Get a record version
      */
     evalGetDatasetRecordVersionRaw(requestParameters: EvalGetDatasetRecordVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<EvalDatasetRecordArtifactView>>;
     /**
-     * Use this operation to get a record version.
      * Get a record version
      */
     evalGetDatasetRecordVersion(requestParameters: EvalGetDatasetRecordVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EvalDatasetRecordArtifactView>;
@@ -214,12 +212,10 @@ export declare class DatasetsApi extends runtime.BaseAPI {
      */
     evalListDatasetRecordVersionsRequestOpts(requestParameters: EvalListDatasetRecordVersionsRequest): Promise<runtime.RequestOpts>;
     /**
-     * Use this operation to list record versions.
      * List record versions
      */
     evalListDatasetRecordVersionsRaw(requestParameters: EvalListDatasetRecordVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<EvalPageDatasetRecordArtifactView>>;
     /**
-     * Use this operation to list record versions.
      * List record versions
      */
     evalListDatasetRecordVersions(requestParameters: EvalListDatasetRecordVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EvalPageDatasetRecordArtifactView>;

package/dist/raw/eval/apis/DatasetsApi.js

@@ -419,7 +419,6 @@ class DatasetsApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Use this operation to get a record version.
      * Get a record version
      */
     async evalGetDatasetRecordVersionRaw(requestParameters, initOverrides) {
@@ -428,7 +427,6 @@ class DatasetsApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, EvalDatasetRecordArtifactView_1.EvalDatasetRecordArtifactViewFromJSON)(jsonValue));
     }
     /**
-     * Use this operation to get a record version.
      * Get a record version
      */
     async evalGetDatasetRecordVersion(requestParameters, initOverrides) {
@@ -474,7 +472,6 @@ class DatasetsApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Use this operation to list record versions.
      * List record versions
      */
     async evalListDatasetRecordVersionsRaw(requestParameters, initOverrides) {
@@ -483,7 +480,6 @@ class DatasetsApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, EvalPageDatasetRecordArtifactView_1.EvalPageDatasetRecordArtifactViewFromJSON)(jsonValue));
     }
     /**
-     * Use this operation to list record versions.
      * List record versions
      */
     async evalListDatasetRecordVersions(requestParameters, initOverrides) {

package/dist/raw/eval/apis/ExperimentsApi.d.ts

@@ -82,6 +82,7 @@ export interface EvalListExperimentTracesRequest {
 export interface EvalListExperimentsRequest {
     limit?: number;
     offset?: number;
+    workspaceId?: string;
     datasetId?: string;
     subjectKind?: EvalSubjectKind;
     subjectId?: string;
@@ -127,12 +128,12 @@ export declare class ExperimentsApi extends runtime.BaseAPI {
      */
     evalCreateExperimentRequestOpts(requestParameters: EvalCreateExperimentRequest): Promise<runtime.RequestOpts>;
     /**
-     * Record the start of an evaluation run: the subject under test (an agent, harness, or skill), the dataset, the configuration, and optionally the baseline it is compared against. The gateway does not execute anything — your runner or CI executes the cases and uploads results here. Created `running` by default; upload results, then finalize with one PATCH to `completed`. The finalization response contains the server-derived score summary.
+     * Record the start of an evaluation run: the subject under test (an agent, harness, or skill), the dataset, the configuration, and optionally the baseline it is compared against. The gateway does not execute anything — your runner or CI executes the cases and uploads results here. Created `running` by default; upload results, then finalize with one PATCH to `completed`. The finalization response contains the server-derived score summary. **`workspace_id` is taken as sent and never inferred.** It decides who can read the run\'s traces, so a subject-scoped run belongs in the workspace of the agent, harness, or skill it reports on — naming the right one is the caller\'s responsibility and the gateway does not check it.
      * Create an experiment
      */
     evalCreateExperimentRaw(requestParameters: EvalCreateExperimentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<EvalExperimentArtifactView>>;
     /**
-     * Record the start of an evaluation run: the subject under test (an agent, harness, or skill), the dataset, the configuration, and optionally the baseline it is compared against. The gateway does not execute anything — your runner or CI executes the cases and uploads results here. Created `running` by default; upload results, then finalize with one PATCH to `completed`. The finalization response contains the server-derived score summary.
+     * Record the start of an evaluation run: the subject under test (an agent, harness, or skill), the dataset, the configuration, and optionally the baseline it is compared against. The gateway does not execute anything — your runner or CI executes the cases and uploads results here. Created `running` by default; upload results, then finalize with one PATCH to `completed`. The finalization response contains the server-derived score summary. **`workspace_id` is taken as sent and never inferred.** It decides who can read the run\'s traces, so a subject-scoped run belongs in the workspace of the agent, harness, or skill it reports on — naming the right one is the caller\'s responsibility and the gateway does not check it.
      * Create an experiment
      */
     evalCreateExperiment(requestParameters: EvalCreateExperimentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EvalExperimentArtifactView>;
@@ -197,12 +198,10 @@ export declare class ExperimentsApi extends runtime.BaseAPI {
      */
     evalGetExperimentTraceRequestOpts(requestParameters: EvalGetExperimentTraceRequest): Promise<runtime.RequestOpts>;
     /**
-     * Use this operation to read one of an experiment\'s traces.
      * Read one of an experiment\'s traces
      */
     evalGetExperimentTraceRaw(requestParameters: EvalGetExperimentTraceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TraceDetailView>>;
     /**
-     * Use this operation to read one of an experiment\'s traces.
      * Read one of an experiment\'s traces
      */
     evalGetExperimentTrace(requestParameters: EvalGetExperimentTraceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TraceDetailView>;
@@ -225,12 +224,10 @@ export declare class ExperimentsApi extends runtime.BaseAPI {
      */
     evalListExperimentTraceSpansRequestOpts(requestParameters: EvalListExperimentTraceSpansRequest): Promise<runtime.RequestOpts>;
     /**
-     * Use this operation to list spans in one of an experiment\'s traces.
      * List spans in one of an experiment\'s traces
      */
     evalListExperimentTraceSpansRaw(requestParameters: EvalListExperimentTraceSpansRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SpanListEnvelope>>;
     /**
-     * Use this operation to list spans in one of an experiment\'s traces.
      * List spans in one of an experiment\'s traces
      */
     evalListExperimentTraceSpans(requestParameters: EvalListExperimentTraceSpansRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SpanListEnvelope>;
@@ -253,12 +250,12 @@ export declare class ExperimentsApi extends runtime.BaseAPI {
      */
     evalListExperimentsRequestOpts(requestParameters: EvalListExperimentsRequest): Promise<runtime.RequestOpts>;
     /**
-     * Page the account\'s experiments. Filter by subject pair for one agent\'s, harness\'s, or skill\'s runs; by `dataset_id` for every run over a golden set; by `baseline_experiment_id` for everything compared against one run; or by `config` for the arms of a sweep that share a dimension — `?config=model:claude-sonnet-5,engine:duckdb` answers \"every run of this model on this engine\", which is the slice a multi-arm sweep is actually compared along.
+     * Page every experiment in the workspaces the caller can read. Narrow by `workspace_id`, by subject pair for one agent\'s, harness\'s, or skill\'s runs, by `dataset_id` for every run over a golden set, by `baseline_experiment_id` for everything compared against one run, or by `config` for the arms of a sweep that share a dimension — `?config=model:claude-sonnet-5,engine:duckdb` answers \"every run of this model on this engine\", which is the slice a multi-arm sweep is actually compared along.
      * List experiments
      */
     evalListExperimentsRaw(requestParameters: EvalListExperimentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<EvalPageExperimentArtifactView>>;
     /**
-     * Page the account\'s experiments. Filter by subject pair for one agent\'s, harness\'s, or skill\'s runs; by `dataset_id` for every run over a golden set; by `baseline_experiment_id` for everything compared against one run; or by `config` for the arms of a sweep that share a dimension — `?config=model:claude-sonnet-5,engine:duckdb` answers \"every run of this model on this engine\", which is the slice a multi-arm sweep is actually compared along.
+     * Page every experiment in the workspaces the caller can read. Narrow by `workspace_id`, by subject pair for one agent\'s, harness\'s, or skill\'s runs, by `dataset_id` for every run over a golden set, by `baseline_experiment_id` for everything compared against one run, or by `config` for the arms of a sweep that share a dimension — `?config=model:claude-sonnet-5,engine:duckdb` answers \"every run of this model on this engine\", which is the slice a multi-arm sweep is actually compared along.
      * List experiments
      */
     evalListExperiments(requestParameters?: EvalListExperimentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EvalPageExperimentArtifactView>;
@@ -281,12 +278,12 @@ export declare class ExperimentsApi extends runtime.BaseAPI {
      */
     evalQueryExperimentTraceStatsRequestOpts(requestParameters: EvalQueryExperimentTraceStatsRequest): Promise<runtime.RequestOpts>;
     /**
-     * Use this operation to query statistics over an experiment\'s traces.
+     * Cost, tokens, latency, error rate, and scores over the run\'s traces, from ClickHouse — the same query vocabulary as `POST /otel/v1/traces/stats/query`, scoped to this experiment by the promoted `experiment_id` column. A verdict is a span typed `score`, so `score_value` grouped by `score_name` is \"how did this run do\" live. The experiment\'s durable summary is derived automatically from result score snapshots when the run is finalized.
      * Query statistics over an experiment\'s traces
      */
     evalQueryExperimentTraceStatsRaw(requestParameters: EvalQueryExperimentTraceStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GatewayTraceStatsEnvelope>>;
     /**
-     * Use this operation to query statistics over an experiment\'s traces.
+     * Cost, tokens, latency, error rate, and scores over the run\'s traces, from ClickHouse — the same query vocabulary as `POST /otel/v1/traces/stats/query`, scoped to this experiment by the promoted `experiment_id` column. A verdict is a span typed `score`, so `score_value` grouped by `score_name` is \"how did this run do\" live. The experiment\'s durable summary is derived automatically from result score snapshots when the run is finalized.
      * Query statistics over an experiment\'s traces
      */
     evalQueryExperimentTraceStats(requestParameters: EvalQueryExperimentTraceStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GatewayTraceStatsEnvelope>;

package/dist/raw/eval/apis/ExperimentsApi.js

@@ -139,7 +139,7 @@ class ExperimentsApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Record the start of an evaluation run: the subject under test (an agent, harness, or skill), the dataset, the configuration, and optionally the baseline it is compared against. The gateway does not execute anything — your runner or CI executes the cases and uploads results here. Created `running` by default; upload results, then finalize with one PATCH to `completed`. The finalization response contains the server-derived score summary.
+     * Record the start of an evaluation run: the subject under test (an agent, harness, or skill), the dataset, the configuration, and optionally the baseline it is compared against. The gateway does not execute anything — your runner or CI executes the cases and uploads results here. Created `running` by default; upload results, then finalize with one PATCH to `completed`. The finalization response contains the server-derived score summary. **`workspace_id` is taken as sent and never inferred.** It decides who can read the run\'s traces, so a subject-scoped run belongs in the workspace of the agent, harness, or skill it reports on — naming the right one is the caller\'s responsibility and the gateway does not check it.
      * Create an experiment
      */
     async evalCreateExperimentRaw(requestParameters, initOverrides) {
@@ -148,7 +148,7 @@ class ExperimentsApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, EvalExperimentArtifactView_1.EvalExperimentArtifactViewFromJSON)(jsonValue));
     }
     /**
-     * Record the start of an evaluation run: the subject under test (an agent, harness, or skill), the dataset, the configuration, and optionally the baseline it is compared against. The gateway does not execute anything — your runner or CI executes the cases and uploads results here. Created `running` by default; upload results, then finalize with one PATCH to `completed`. The finalization response contains the server-derived score summary.
+     * Record the start of an evaluation run: the subject under test (an agent, harness, or skill), the dataset, the configuration, and optionally the baseline it is compared against. The gateway does not execute anything — your runner or CI executes the cases and uploads results here. Created `running` by default; upload results, then finalize with one PATCH to `completed`. The finalization response contains the server-derived score summary. **`workspace_id` is taken as sent and never inferred.** It decides who can read the run\'s traces, so a subject-scoped run belongs in the workspace of the agent, harness, or skill it reports on — naming the right one is the caller\'s responsibility and the gateway does not check it.
      * Create an experiment
      */
     async evalCreateExperiment(requestParameters, initOverrides) {
@@ -373,7 +373,6 @@ class ExperimentsApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Use this operation to read one of an experiment\'s traces.
      * Read one of an experiment\'s traces
      */
     async evalGetExperimentTraceRaw(requestParameters, initOverrides) {
@@ -382,7 +381,6 @@ class ExperimentsApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, TraceDetailView_1.TraceDetailViewFromJSON)(jsonValue));
     }
     /**
-     * Use this operation to read one of an experiment\'s traces.
      * Read one of an experiment\'s traces
      */
     async evalGetExperimentTrace(requestParameters, initOverrides) {
@@ -488,7 +486,6 @@ class ExperimentsApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Use this operation to list spans in one of an experiment\'s traces.
      * List spans in one of an experiment\'s traces
      */
     async evalListExperimentTraceSpansRaw(requestParameters, initOverrides) {
@@ -497,7 +494,6 @@ class ExperimentsApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, SpanListEnvelope_1.SpanListEnvelopeFromJSON)(jsonValue));
     }
     /**
-     * Use this operation to list spans in one of an experiment\'s traces.
      * List spans in one of an experiment\'s traces
      */
     async evalListExperimentTraceSpans(requestParameters, initOverrides) {
@@ -572,6 +568,9 @@ class ExperimentsApi extends runtime.BaseAPI {
         if (requestParameters['offset'] != null) {
             queryParameters['offset'] = requestParameters['offset'];
         }
+        if (requestParameters['workspaceId'] != null) {
+            queryParameters['workspace_id'] = requestParameters['workspaceId'];
+        }
         if (requestParameters['datasetId'] != null) {
             queryParameters['dataset_id'] = requestParameters['datasetId'];
         }
@@ -610,7 +609,7 @@ class ExperimentsApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Page the account\'s experiments. Filter by subject pair for one agent\'s, harness\'s, or skill\'s runs; by `dataset_id` for every run over a golden set; by `baseline_experiment_id` for everything compared against one run; or by `config` for the arms of a sweep that share a dimension — `?config=model:claude-sonnet-5,engine:duckdb` answers \"every run of this model on this engine\", which is the slice a multi-arm sweep is actually compared along.
+     * Page every experiment in the workspaces the caller can read. Narrow by `workspace_id`, by subject pair for one agent\'s, harness\'s, or skill\'s runs, by `dataset_id` for every run over a golden set, by `baseline_experiment_id` for everything compared against one run, or by `config` for the arms of a sweep that share a dimension — `?config=model:claude-sonnet-5,engine:duckdb` answers \"every run of this model on this engine\", which is the slice a multi-arm sweep is actually compared along.
      * List experiments
      */
     async evalListExperimentsRaw(requestParameters, initOverrides) {
@@ -619,7 +618,7 @@ class ExperimentsApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, EvalPageExperimentArtifactView_1.EvalPageExperimentArtifactViewFromJSON)(jsonValue));
     }
     /**
-     * Page the account\'s experiments. Filter by subject pair for one agent\'s, harness\'s, or skill\'s runs; by `dataset_id` for every run over a golden set; by `baseline_experiment_id` for everything compared against one run; or by `config` for the arms of a sweep that share a dimension — `?config=model:claude-sonnet-5,engine:duckdb` answers \"every run of this model on this engine\", which is the slice a multi-arm sweep is actually compared along.
+     * Page every experiment in the workspaces the caller can read. Narrow by `workspace_id`, by subject pair for one agent\'s, harness\'s, or skill\'s runs, by `dataset_id` for every run over a golden set, by `baseline_experiment_id` for everything compared against one run, or by `config` for the arms of a sweep that share a dimension — `?config=model:claude-sonnet-5,engine:duckdb` answers \"every run of this model on this engine\", which is the slice a multi-arm sweep is actually compared along.
      * List experiments
      */
     async evalListExperiments(requestParameters = {}, initOverrides) {
@@ -710,7 +709,7 @@ class ExperimentsApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Use this operation to query statistics over an experiment\'s traces.
+     * Cost, tokens, latency, error rate, and scores over the run\'s traces, from ClickHouse — the same query vocabulary as `POST /otel/v1/traces/stats/query`, scoped to this experiment by the promoted `experiment_id` column. A verdict is a span typed `score`, so `score_value` grouped by `score_name` is \"how did this run do\" live. The experiment\'s durable summary is derived automatically from result score snapshots when the run is finalized.
      * Query statistics over an experiment\'s traces
      */
     async evalQueryExperimentTraceStatsRaw(requestParameters, initOverrides) {
@@ -719,7 +718,7 @@ class ExperimentsApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, GatewayTraceStatsEnvelope_1.GatewayTraceStatsEnvelopeFromJSON)(jsonValue));
     }
     /**
-     * Use this operation to query statistics over an experiment\'s traces.
+     * Cost, tokens, latency, error rate, and scores over the run\'s traces, from ClickHouse — the same query vocabulary as `POST /otel/v1/traces/stats/query`, scoped to this experiment by the promoted `experiment_id` column. A verdict is a span typed `score`, so `score_value` grouped by `score_name` is \"how did this run do\" live. The experiment\'s durable summary is derived automatically from result score snapshots when the run is finalized.
      * Query statistics over an experiment\'s traces
      */
     async evalQueryExperimentTraceStats(requestParameters, initOverrides) {

package/dist/raw/eval/apis/ScorersApi.d.ts

@@ -25,6 +25,16 @@ export interface EvalCreateScorerRequest {
 export interface EvalGetScorerRequest {
     scorerId: string;
 }
+export interface EvalGetScorerVersionRequest {
+    scorerId: string;
+    versionOrdinal: number;
+}
+export interface EvalListScorerVersionsRequest {
+    scorerId: string;
+    limit?: number;
+    offset?: number;
+    sort?: string;
+}
 export interface EvalListScorersRequest {
     limit?: number;
     offset?: number;
@@ -82,6 +92,34 @@ export declare class ScorersApi extends runtime.BaseAPI {
      * Get a scorer
      */
     evalGetScorer(requestParameters: EvalGetScorerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EvalScorerArtifactView>;
+    /**
+     * Creates request options for evalGetScorerVersion without sending the request
+     */
+    evalGetScorerVersionRequestOpts(requestParameters: EvalGetScorerVersionRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Read the exact immutable scorer revision cited by a score span.
+     * Get a scorer version
+     */
+    evalGetScorerVersionRaw(requestParameters: EvalGetScorerVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<EvalScorerArtifactView>>;
+    /**
+     * Read the exact immutable scorer revision cited by a score span.
+     * Get a scorer version
+     */
+    evalGetScorerVersion(requestParameters: EvalGetScorerVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EvalScorerArtifactView>;
+    /**
+     * Creates request options for evalListScorerVersions without sending the request
+     */
+    evalListScorerVersionsRequestOpts(requestParameters: EvalListScorerVersionsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * List the immutable rubric and output-contract revisions for one scorer line.
+     * List scorer versions
+     */
+    evalListScorerVersionsRaw(requestParameters: EvalListScorerVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<EvalPageScorerArtifactView>>;
+    /**
+     * List the immutable rubric and output-contract revisions for one scorer line.
+     * List scorer versions
+     */
+    evalListScorerVersions(requestParameters: EvalListScorerVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EvalPageScorerArtifactView>;
     /**
      * Creates request options for evalListScorers without sending the request
      */
@@ -101,12 +139,12 @@ export declare class ScorersApi extends runtime.BaseAPI {
      */
     evalPatchScorerRequestOpts(requestParameters: EvalPatchScorerRequest): Promise<runtime.RequestOpts>;
     /**
-     * Partially update a scorer by RFC 7396 JSON Merge Patch. `scorer_kind` and `scope` are the scorer\'s identity and are not editable. **Editing `spec` or `outputs` does not mint a new version**, so scores already pinned to this scorer\'s current version will read as having been judged by the edited rubric. Create a new scorer instead when the rubric changes materially. Send `If-Match` with a prior read\'s `content_hash_hex` to make the write conditional.
+     * Partially update a scorer by RFC 7396 JSON Merge Patch. `scorer_kind` and `scope` are the scorer\'s identity and are not editable. Every accepted PATCH appends one immutable scorer version, so score spans pinned to an earlier ordinal continue to resolve the rubric and output contract that judged them. Send `If-Match` with a prior read\'s `content_hash_hex` to make the write conditional.
      * Update a scorer
      */
     evalPatchScorerRaw(requestParameters: EvalPatchScorerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<EvalScorerArtifactView>>;
     /**
-     * Partially update a scorer by RFC 7396 JSON Merge Patch. `scorer_kind` and `scope` are the scorer\'s identity and are not editable. **Editing `spec` or `outputs` does not mint a new version**, so scores already pinned to this scorer\'s current version will read as having been judged by the edited rubric. Create a new scorer instead when the rubric changes materially. Send `If-Match` with a prior read\'s `content_hash_hex` to make the write conditional.
+     * Partially update a scorer by RFC 7396 JSON Merge Patch. `scorer_kind` and `scope` are the scorer\'s identity and are not editable. Every accepted PATCH appends one immutable scorer version, so score spans pinned to an earlier ordinal continue to resolve the rubric and output contract that judged them. Send `If-Match` with a prior read\'s `content_hash_hex` to make the write conditional.
      * Update a scorer
      */
     evalPatchScorer(requestParameters: EvalPatchScorerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EvalScorerArtifactView>;

package/dist/raw/eval/apis/ScorersApi.js

@@ -186,6 +186,103 @@ class ScorersApi extends runtime.BaseAPI {
         const response = await this.evalGetScorerRaw(requestParameters, initOverrides);
         return await response.value();
     }
+    /**
+     * Creates request options for evalGetScorerVersion without sending the request
+     */
+    async evalGetScorerVersionRequestOpts(requestParameters) {
+        if (requestParameters['scorerId'] == null) {
+            throw new runtime.RequiredError('scorerId', 'Required parameter "scorerId" was null or undefined when calling evalGetScorerVersion().');
+        }
+        if (requestParameters['versionOrdinal'] == null) {
+            throw new runtime.RequiredError('versionOrdinal', 'Required parameter "versionOrdinal" was null or undefined when calling evalGetScorerVersion().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/scorers/{scorer_id}/versions/{version_ordinal}`;
+        urlPath = urlPath.replace('{scorer_id}', encodeURIComponent(String(requestParameters['scorerId'])));
+        urlPath = urlPath.replace('{version_ordinal}', encodeURIComponent(String(requestParameters['versionOrdinal'])));
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Read the exact immutable scorer revision cited by a score span.
+     * Get a scorer version
+     */
+    async evalGetScorerVersionRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.evalGetScorerVersionRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, EvalScorerArtifactView_1.EvalScorerArtifactViewFromJSON)(jsonValue));
+    }
+    /**
+     * Read the exact immutable scorer revision cited by a score span.
+     * Get a scorer version
+     */
+    async evalGetScorerVersion(requestParameters, initOverrides) {
+        const response = await this.evalGetScorerVersionRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for evalListScorerVersions without sending the request
+     */
+    async evalListScorerVersionsRequestOpts(requestParameters) {
+        if (requestParameters['scorerId'] == null) {
+            throw new runtime.RequiredError('scorerId', 'Required parameter "scorerId" was null or undefined when calling evalListScorerVersions().');
+        }
+        const queryParameters = {};
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+        if (requestParameters['offset'] != null) {
+            queryParameters['offset'] = requestParameters['offset'];
+        }
+        if (requestParameters['sort'] != null) {
+            queryParameters['sort'] = requestParameters['sort'];
+        }
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/scorers/{scorer_id}/versions`;
+        urlPath = urlPath.replace('{scorer_id}', encodeURIComponent(String(requestParameters['scorerId'])));
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * List the immutable rubric and output-contract revisions for one scorer line.
+     * List scorer versions
+     */
+    async evalListScorerVersionsRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.evalListScorerVersionsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, EvalPageScorerArtifactView_1.EvalPageScorerArtifactViewFromJSON)(jsonValue));
+    }
+    /**
+     * List the immutable rubric and output-contract revisions for one scorer line.
+     * List scorer versions
+     */
+    async evalListScorerVersions(requestParameters, initOverrides) {
+        const response = await this.evalListScorerVersionsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Creates request options for evalListScorers without sending the request
      */
@@ -270,7 +367,7 @@ class ScorersApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Partially update a scorer by RFC 7396 JSON Merge Patch. `scorer_kind` and `scope` are the scorer\'s identity and are not editable. **Editing `spec` or `outputs` does not mint a new version**, so scores already pinned to this scorer\'s current version will read as having been judged by the edited rubric. Create a new scorer instead when the rubric changes materially. Send `If-Match` with a prior read\'s `content_hash_hex` to make the write conditional.
+     * Partially update a scorer by RFC 7396 JSON Merge Patch. `scorer_kind` and `scope` are the scorer\'s identity and are not editable. Every accepted PATCH appends one immutable scorer version, so score spans pinned to an earlier ordinal continue to resolve the rubric and output contract that judged them. Send `If-Match` with a prior read\'s `content_hash_hex` to make the write conditional.
      * Update a scorer
      */
     async evalPatchScorerRaw(requestParameters, initOverrides) {
@@ -279,7 +376,7 @@ class ScorersApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, EvalScorerArtifactView_1.EvalScorerArtifactViewFromJSON)(jsonValue));
     }
     /**
-     * Partially update a scorer by RFC 7396 JSON Merge Patch. `scorer_kind` and `scope` are the scorer\'s identity and are not editable. **Editing `spec` or `outputs` does not mint a new version**, so scores already pinned to this scorer\'s current version will read as having been judged by the edited rubric. Create a new scorer instead when the rubric changes materially. Send `If-Match` with a prior read\'s `content_hash_hex` to make the write conditional.
+     * Partially update a scorer by RFC 7396 JSON Merge Patch. `scorer_kind` and `scope` are the scorer\'s identity and are not editable. Every accepted PATCH appends one immutable scorer version, so score spans pinned to an earlier ordinal continue to resolve the rubric and output contract that judged them. Send `If-Match` with a prior read\'s `content_hash_hex` to make the write conditional.
      * Update a scorer
      */
     async evalPatchScorer(requestParameters, initOverrides) {

package/dist/raw/eval/models/ArtifactConflictProblem.d.ts

@@ -22,31 +22,31 @@
  */
 export interface ArtifactConflictProblem {
     /**
-     * Value of the `code` field.
+     *
      * @type {string}
      * @memberof ArtifactConflictProblem
      */
     code: string;
     /**
-     * Value of the `detail` field.
+     *
      * @type {string}
      * @memberof ArtifactConflictProblem
      */
     detail: string;
     /**
-     * Current lifecycle state.
+     *
      * @type {number}
      * @memberof ArtifactConflictProblem
      */
     status: number;
     /**
-     * Value of the `title` field.
+     *
      * @type {string}
      * @memberof ArtifactConflictProblem
      */
     title: string;
     /**
-     * Stable identifier of the related trace resource.
+     *
      * @type {string}
      * @memberof ArtifactConflictProblem
      */

package/dist/raw/eval/models/CostView.d.ts

@@ -16,25 +16,25 @@
  */
 export interface CostView {
     /**
-     * Input cost in US dollars.
+     *
      * @type {number}
      * @memberof CostView
      */
     inputCostUsd: number;
     /**
-     * Output cost in US dollars.
+     *
      * @type {number}
      * @memberof CostView
      */
     outputCostUsd: number;
     /**
-     * Origin of this data.
+     *
      * @type {string}
      * @memberof CostView
      */
     source?: string | null;
     /**
-     * Total cost in US dollars.
+     *
      * @type {number}
      * @memberof CostView
      */

package/dist/raw/eval/models/CursorPage.d.ts

@@ -16,13 +16,13 @@
  */
 export interface CursorPage {
     /**
-     * Maximum number of items to return.
+     *
      * @type {number}
      * @memberof CursorPage
      */
     limit: number;
     /**
-     * Opaque pagination cursor.
+     *
      * @type {string}
      * @memberof CursorPage
      */

package/dist/raw/eval/models/EvalArtifactEnvelope.d.ts

@@ -84,7 +84,7 @@ export interface EvalArtifactEnvelope {
      */
     sourceVersion?: string;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof EvalArtifactEnvelope
      */