@atlanai/sdk 0.2.1 → 0.2.2

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

@@ -20,6 +20,12 @@ import type { RegistryRelationshipsView } from './RegistryRelationshipsView';
  * @interface Box
  */
 export interface Box {
+    /**
+     * Value of the `app` field.
+     * @type {string}
+     * @memberof Box
+     */
+    app?: string;
     /**
      * Value of the `artifact_status` field.
      * @type {string}
@@ -62,12 +68,6 @@ export interface Box {
      * @memberof Box
      */
     displayName?: string;
-    /**
-     * Value of the `extension` field.
-     * @type {string}
-     * @memberof Box
-     */
-    extension?: string;
     /**
      * Kind-prefixed Crockford-base32 handle (`<kind>_<base32>`).
      * @type {string}
@@ -106,19 +106,28 @@ export interface Box {
      * The Control-Plane OIDC client id this artifact authenticates as
      * (`x-gateway-identity` kinds); absent for every other kind.
      *
-     * **Derived, not stored.** The registry resolves it from the artifact's
-     * `service_principals` row rather than keeping a second copy on the artifact,
-     * so it appears on the create response and on the single-artifact read — the
-     * two paths that make that lookup — and **not** on list, search, or a `PATCH`
-     * response, none of which do a per-row identity read. It is the public half of
-     * the credential pair and is not secret.
+     * **Derived, not stored, and present on the create response only.** The
+     * registry would resolve it from the artifact's `service_principals` row
+     * rather than keep a second copy on the artifact — but only the create path
+     * does that lookup, because it has just provisioned the identity. Every read
+     * shape (single read, list, search, `PATCH`) is built by one constructor that
+     * sets this `None`, so it is absent from all four.
+     *
+     * This block used to name the single-artifact read as a second populated path.
+     * It was never one. Adding it means deciding whether list and search pay a
+     * per-row identity read too; the lookup a future implementation would call is
+     * `registry_server::identity::artifact_principal`. It is the public half of the
+     * credential pair and is not secret.
      * @type {string}
      * @memberof Box
      */
     oidcClientId?: string;
     /**
      * Canonical owner: the `users.user_id` this artifact belongs to, FK-backed.
-     * Absent when unset (legacy rows / system-plane creates).
+     *
+     * Defaulted to the creating principal, so this is normally set. Absent for a row created
+     * before that default landed, for a system-plane write, and for a principal with no directory
+     * row — a service account or a seed has nothing to own anything with.
      * @type {string}
      * @memberof Box
      */
@@ -226,13 +235,16 @@ export interface Box {
      */
     updatedBy: string;
     /**
-     * Optional human version selector (semver); absent when unset.
+     * The free-form label the write set, verbatim. Absent when none was sent, and *not* the name
+     * the version shipped under — that is the release's own `version_label`.
      * @type {string}
      * @memberof Box
      */
     versionLabel?: string;
     /**
-     * Monotonic version coordinate within the artifact line.
+     * This version's position in its line — the write index, 1-based and dense over versions
+     * *written*. Distinct from a release's `version_ordinal`, which counts versions **shipped**;
+     * the two agree under the default `auto` release policy and diverge under `manual`.
      * @type {number}
      * @memberof Box
      */

package/dist/raw/agent/models/Box.js

@@ -63,6 +63,7 @@ function BoxFromJSONTyped(json, ignoreDiscriminator) {
         return json;
     }
     return {
+        'app': json['app'] == null ? undefined : json['app'],
         'artifactStatus': json['artifact_status'],
         'commitTs': json['commit_ts'],
         'contentHashHex': json['content_hash_hex'] == null ? undefined : json['content_hash_hex'],
@@ -70,7 +71,6 @@ function BoxFromJSONTyped(json, ignoreDiscriminator) {
         'createdBy': json['created_by'],
         'description': json['description'] == null ? undefined : json['description'],
         'displayName': json['display_name'] == null ? undefined : json['display_name'],
-        'extension': json['extension'] == null ? undefined : json['extension'],
         'id': json['id'],
         'identity': json['identity'] == null ? undefined : (0, GatewayArtifactIdentityRevealView_1.GatewayArtifactIdentityRevealViewFromJSON)(json['identity']),
         'isLatest': json['is_latest'],
@@ -118,6 +118,7 @@ function BoxToJSONTyped(value, ignoreDiscriminator = false) {
         return value;
     }
     return {
+        'app': value['app'],
         'artifact_status': value['artifactStatus'],
         'commit_ts': value['commitTs'],
         'content_hash_hex': value['contentHashHex'],
@@ -125,7 +126,6 @@ function BoxToJSONTyped(value, ignoreDiscriminator = false) {
         'created_by': value['createdBy'],
         'description': value['description'],
         'display_name': value['displayName'],
-        'extension': value['extension'],
         'id': value['id'],
         'identity': (0, GatewayArtifactIdentityRevealView_1.GatewayArtifactIdentityRevealViewToJSON)(value['identity']),
         'is_latest': value['isLatest'],

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

@@ -16,6 +16,12 @@ import type { GatewayArtifactIdentityRevealView } from './GatewayArtifactIdentit
  * @interface GatewayArtifactBase
  */
 export interface GatewayArtifactBase {
+    /**
+     * Value of the `app` field.
+     * @type {string}
+     * @memberof GatewayArtifactBase
+     */
+    app?: string;
     /**
      * Value of the `artifact_status` field.
      * @type {string}
@@ -58,12 +64,6 @@ export interface GatewayArtifactBase {
      * @memberof GatewayArtifactBase
      */
     displayName?: string;
-    /**
-     * Value of the `extension` field.
-     * @type {string}
-     * @memberof GatewayArtifactBase
-     */
-    extension?: string;
     /**
      * Kind-prefixed Crockford-base32 handle (`<kind>_<base32>`).
      * @type {string}
@@ -102,19 +102,28 @@ export interface GatewayArtifactBase {
      * The Control-Plane OIDC client id this artifact authenticates as
      * (`x-gateway-identity` kinds); absent for every other kind.
      *
-     * **Derived, not stored.** The registry resolves it from the artifact's
-     * `service_principals` row rather than keeping a second copy on the artifact,
-     * so it appears on the create response and on the single-artifact read — the
-     * two paths that make that lookup — and **not** on list, search, or a `PATCH`
-     * response, none of which do a per-row identity read. It is the public half of
-     * the credential pair and is not secret.
+     * **Derived, not stored, and present on the create response only.** The
+     * registry would resolve it from the artifact's `service_principals` row
+     * rather than keep a second copy on the artifact — but only the create path
+     * does that lookup, because it has just provisioned the identity. Every read
+     * shape (single read, list, search, `PATCH`) is built by one constructor that
+     * sets this `None`, so it is absent from all four.
+     *
+     * This block used to name the single-artifact read as a second populated path.
+     * It was never one. Adding it means deciding whether list and search pay a
+     * per-row identity read too; the lookup a future implementation would call is
+     * `registry_server::identity::artifact_principal`. It is the public half of the
+     * credential pair and is not secret.
      * @type {string}
      * @memberof GatewayArtifactBase
      */
     oidcClientId?: string | null;
     /**
      * Canonical owner: the `users.user_id` this artifact belongs to, FK-backed.
-     * Absent when unset (legacy rows / system-plane creates).
+     *
+     * Defaulted to the creating principal, so this is normally set. Absent for a row created
+     * before that default landed, for a system-plane write, and for a principal with no directory
+     * row — a service account or a seed has nothing to own anything with.
      * @type {string}
      * @memberof GatewayArtifactBase
      */
@@ -222,13 +231,16 @@ export interface GatewayArtifactBase {
      */
     updatedBy: string;
     /**
-     * Optional human version selector (semver); absent when unset.
+     * The free-form label the write set, verbatim. Absent when none was sent, and *not* the name
+     * the version shipped under — that is the release's own `version_label`.
      * @type {string}
      * @memberof GatewayArtifactBase
      */
     versionLabel?: string | null;
     /**
-     * Monotonic version coordinate within the artifact line.
+     * This version's position in its line — the write index, 1-based and dense over versions
+     * *written*. Distinct from a release's `version_ordinal`, which counts versions **shipped**;
+     * the two agree under the default `auto` release policy and diverge under `manual`.
      * @type {number}
      * @memberof GatewayArtifactBase
      */

package/dist/raw/agent/models/GatewayArtifactBase.js

@@ -59,6 +59,7 @@ function GatewayArtifactBaseFromJSONTyped(json, ignoreDiscriminator) {
         return json;
     }
     return {
+        'app': json['app'] == null ? undefined : json['app'],
         'artifactStatus': json['artifact_status'],
         'commitTs': json['commit_ts'],
         'contentHashHex': json['content_hash_hex'] === undefined ? undefined : json['content_hash_hex'] === null ? null : json['content_hash_hex'],
@@ -66,7 +67,6 @@ function GatewayArtifactBaseFromJSONTyped(json, ignoreDiscriminator) {
         'createdBy': json['created_by'],
         'description': json['description'] === undefined ? undefined : json['description'] === null ? null : json['description'],
         'displayName': json['display_name'] == null ? undefined : json['display_name'],
-        'extension': json['extension'] == null ? undefined : json['extension'],
         'id': json['id'],
         'identity': json['identity'] === undefined ? undefined : json['identity'] === null ? null : (0, GatewayArtifactIdentityRevealView_1.GatewayArtifactIdentityRevealViewFromJSON)(json['identity']),
         'isLatest': json['is_latest'],
@@ -102,6 +102,7 @@ function GatewayArtifactBaseToJSONTyped(value, ignoreDiscriminator = false) {
         return value;
     }
     return {
+        'app': value['app'],
         'artifact_status': value['artifactStatus'],
         'commit_ts': value['commitTs'],
         'content_hash_hex': value['contentHashHex'],
@@ -109,7 +110,6 @@ function GatewayArtifactBaseToJSONTyped(value, ignoreDiscriminator = false) {
         'created_by': value['createdBy'],
         'description': value['description'],
         'display_name': value['displayName'],
-        'extension': value['extension'],
         'id': value['id'],
         'identity': (0, GatewayArtifactIdentityRevealView_1.GatewayArtifactIdentityRevealViewToJSON)(value['identity']),
         'is_latest': value['isLatest'],

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

@@ -22,7 +22,11 @@ export declare enum GatewayTraceStatsGroupBy {
     Mcp = "mcp",
     Tool = "tool",
     Model = "model",
-    User = "user"
+    User = "user",
+    Experiment = "experiment",
+    ScoreName = "score_name",
+    Scorer = "scorer",
+    ScorerVersion = "scorer_version"
 }
 export declare function instanceOfGatewayTraceStatsGroupBy(value: any): boolean;
 export declare function GatewayTraceStatsGroupByFromJSON(json: any): GatewayTraceStatsGroupBy;

package/dist/raw/agent/models/GatewayTraceStatsGroupBy.js

@@ -34,6 +34,10 @@ var GatewayTraceStatsGroupBy;
     GatewayTraceStatsGroupBy["Tool"] = "tool";
     GatewayTraceStatsGroupBy["Model"] = "model";
     GatewayTraceStatsGroupBy["User"] = "user";
+    GatewayTraceStatsGroupBy["Experiment"] = "experiment";
+    GatewayTraceStatsGroupBy["ScoreName"] = "score_name";
+    GatewayTraceStatsGroupBy["Scorer"] = "scorer";
+    GatewayTraceStatsGroupBy["ScorerVersion"] = "scorer_version";
 })(GatewayTraceStatsGroupBy || (exports.GatewayTraceStatsGroupBy = GatewayTraceStatsGroupBy = {}));
 function instanceOfGatewayTraceStatsGroupBy(value) {
     for (const key in GatewayTraceStatsGroupBy) {

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

@@ -28,7 +28,9 @@ export declare enum GatewayTraceStatsMeasure {
     Cost = "cost",
     LatencyP50 = "latency_p50",
     LatencyP90 = "latency_p90",
-    LatencyP99 = "latency_p99"
+    LatencyP99 = "latency_p99",
+    ScoreValue = "score_value",
+    Scores = "scores"
 }
 export declare function instanceOfGatewayTraceStatsMeasure(value: any): boolean;
 export declare function GatewayTraceStatsMeasureFromJSON(json: any): GatewayTraceStatsMeasure;

package/dist/raw/agent/models/GatewayTraceStatsMeasure.js

@@ -40,6 +40,8 @@ var GatewayTraceStatsMeasure;
     GatewayTraceStatsMeasure["LatencyP50"] = "latency_p50";
     GatewayTraceStatsMeasure["LatencyP90"] = "latency_p90";
     GatewayTraceStatsMeasure["LatencyP99"] = "latency_p99";
+    GatewayTraceStatsMeasure["ScoreValue"] = "score_value";
+    GatewayTraceStatsMeasure["Scores"] = "scores";
 })(GatewayTraceStatsMeasure || (exports.GatewayTraceStatsMeasure = GatewayTraceStatsMeasure = {}));
 function instanceOfGatewayTraceStatsMeasure(value) {
     for (const key in GatewayTraceStatsMeasure) {

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

@@ -109,6 +109,31 @@ export interface SpanViewDto {
      * @memberof SpanViewDto
      */
     provider?: string | null;
+    /**
+     * Promoted Eval score dimensions. Present together on `score` spans and
+     * omitted from every other span type.
+     * @type {string}
+     * @memberof SpanViewDto
+     */
+    scoreName?: string | null;
+    /**
+     * Value of the `score_value` field.
+     * @type {number}
+     * @memberof SpanViewDto
+     */
+    scoreValue?: number | null;
+    /**
+     * Stable identifier of the related scorer resource.
+     * @type {string}
+     * @memberof SpanViewDto
+     */
+    scorerId?: string | null;
+    /**
+     * Value of the `scorer_version` field.
+     * @type {number}
+     * @memberof SpanViewDto
+     */
+    scorerVersion?: number | null;
     /**
      * Value of the `service_name` field.
      * @type {string}

package/dist/raw/agent/models/SpanViewDto.js

@@ -64,6 +64,10 @@ function SpanViewDtoFromJSONTyped(json, ignoreDiscriminator) {
         'output': json['output'] === undefined ? undefined : json['output'] === null ? null : json['output'],
         'parentSpanId': json['parent_span_id'] === undefined ? undefined : json['parent_span_id'] === null ? null : json['parent_span_id'],
         'provider': json['provider'] === undefined ? undefined : json['provider'] === null ? null : json['provider'],
+        'scoreName': json['score_name'] === undefined ? undefined : json['score_name'] === null ? null : json['score_name'],
+        'scoreValue': json['score_value'] === undefined ? undefined : json['score_value'] === null ? null : json['score_value'],
+        'scorerId': json['scorer_id'] === undefined ? undefined : json['scorer_id'] === null ? null : json['scorer_id'],
+        'scorerVersion': json['scorer_version'] === undefined ? undefined : json['scorer_version'] === null ? null : json['scorer_version'],
         'serviceName': json['service_name'] === undefined ? undefined : json['service_name'] === null ? null : json['service_name'],
         'skillName': json['skill_name'] === undefined ? undefined : json['skill_name'] === null ? null : json['skill_name'],
         'skillVersion': json['skill_version'] === undefined ? undefined : json['skill_version'] === null ? null : json['skill_version'],
@@ -101,6 +105,10 @@ function SpanViewDtoToJSONTyped(value, ignoreDiscriminator = false) {
         'output': value['output'],
         'parent_span_id': value['parentSpanId'],
         'provider': value['provider'],
+        'score_name': value['scoreName'],
+        'score_value': value['scoreValue'],
+        'scorer_id': value['scorerId'],
+        'scorer_version': value['scorerVersion'],
         'service_name': value['serviceName'],
         'skill_name': value['skillName'],
         'skill_version': value['skillVersion'],

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

@@ -142,6 +142,15 @@ export interface TraceDetailView {
      * @memberof TraceDetailView
      */
     workspaceId?: string;
+    /**
+     * The content plane's verdict: `none` | `present` | `deleted` (tombstoned —
+     * "content removed", a different fact from "no content") | `error` (the
+     * plane could not answer; the structural detail is still complete).
+     * Absent from deployments that predate the plane — additive.
+     * @type {string}
+     * @memberof TraceDetailView
+     */
+    contentState?: string | null;
     /**
      *
      * @type {any}

package/dist/raw/agent/models/TraceDetailView.js

@@ -67,6 +67,7 @@ function TraceDetailViewFromJSONTyped(json, ignoreDiscriminator) {
         'traceStatus': (0, TraceStatus_1.TraceStatusFromJSON)(json['trace_status']),
         'userId': json['user_id'] == null ? undefined : json['user_id'],
         'workspaceId': json['workspace_id'] == null ? undefined : json['workspace_id'],
+        'contentState': json['content_state'] === undefined ? undefined : json['content_state'] === null ? null : json['content_state'],
         'input': json['input'] === undefined ? undefined : json['input'] === null ? null : json['input'],
         'links': (0, TraceLinks_1.TraceLinksFromJSON)(json['links']),
         'output': json['output'] === undefined ? undefined : json['output'] === null ? null : json['output'],
@@ -100,6 +101,7 @@ function TraceDetailViewToJSONTyped(value, ignoreDiscriminator = false) {
         'trace_status': (0, TraceStatus_1.TraceStatusToJSON)(value['traceStatus']),
         'user_id': value['userId'],
         'workspace_id': value['workspaceId'],
+        'content_state': value['contentState'],
         'input': value['input'],
         'links': (0, TraceLinks_1.TraceLinksToJSON)(value['links']),
         'output': value['output'],

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

@@ -27,12 +27,14 @@ export * from './AgentArtifactEnvelope';
 export * from './AgentArtifactSearchRequest';
 export * from './AgentCreateAgentFramework400Response';
 export * from './AgentCreateAgentFramework409Response';
+export * from './AgentCreateAgentFramework413Response';
 export * from './AgentCreateAgentFramework415Response';
 export * from './AgentCreateAgentFramework422Response';
 export * from './AgentDeleteAgentProfileImage422Response';
 export * from './AgentEnvironmentPackages';
 export * from './AgentEnvironmentType';
 export * from './AgentGetAgentFramework404Response';
+export * from './AgentGetAgentTrace400Response';
 export * from './AgentHarnessArtifactView';
 export * from './AgentHarnessCreate';
 export * from './AgentHarnessMeta';

package/dist/raw/agent/models/index.js

@@ -45,12 +45,14 @@ __exportStar(require("./AgentArtifactEnvelope"), exports);
 __exportStar(require("./AgentArtifactSearchRequest"), exports);
 __exportStar(require("./AgentCreateAgentFramework400Response"), exports);
 __exportStar(require("./AgentCreateAgentFramework409Response"), exports);
+__exportStar(require("./AgentCreateAgentFramework413Response"), exports);
 __exportStar(require("./AgentCreateAgentFramework415Response"), exports);
 __exportStar(require("./AgentCreateAgentFramework422Response"), exports);
 __exportStar(require("./AgentDeleteAgentProfileImage422Response"), exports);
 __exportStar(require("./AgentEnvironmentPackages"), exports);
 __exportStar(require("./AgentEnvironmentType"), exports);
 __exportStar(require("./AgentGetAgentFramework404Response"), exports);
+__exportStar(require("./AgentGetAgentTrace400Response"), exports);
 __exportStar(require("./AgentHarnessArtifactView"), exports);
 __exportStar(require("./AgentHarnessCreate"), exports);
 __exportStar(require("./AgentHarnessMeta"), exports);

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

@@ -1,6 +1,6 @@
 /**
  * Evaluation catalog
- * The evaluation loop as registry artifacts: curated `dataset`s of examples pinned from production sessions and traces, `experiment` run snapshots with create-only per-case `experiment_result`s, and versioned `scorer` definitions. A verdict is a score span in the run\'s trace; `POST /experiments/{id}/summarize` rolls a run\'s score spans into its durable `summary`. The gateway executes and scores nothing — external harnesses, CI, and judges run the evals, emit score spans, and upload results here.
+ * The evaluation loop as registry artifacts: curated `dataset`s of examples pinned from production sessions and traces, `experiment` run snapshots with create-only per-case `experiment_result`s, and versioned `scorer` definitions. Finalizing an experiment derives its durable score `summary` from the uploaded result rows. The gateway executes and scores nothing — external harnesses, CI, and judges run the evals, emit score spans, and upload results here.
  *
  * The version of the OpenAPI document: 0.1.0
  *
@@ -50,6 +50,18 @@ export interface EvalGetDatasetRecordRequest {
     datasetId: string;
     recordId: string;
 }
+export interface EvalGetDatasetRecordVersionRequest {
+    datasetId: string;
+    recordId: string;
+    versionOrdinal: number;
+}
+export interface EvalListDatasetRecordVersionsRequest {
+    datasetId: string;
+    recordId: string;
+    limit?: number;
+    offset?: number;
+    sort?: string;
+}
 export interface EvalListDatasetRecordsRequest {
     datasetId: string;
     limit?: number;
@@ -174,15 +186,43 @@ export declare class DatasetsApi extends runtime.BaseAPI {
      */
     evalGetDatasetRecordRequestOpts(requestParameters: EvalGetDatasetRecordRequest): Promise<runtime.RequestOpts>;
     /**
-     * Read one dataset record with its full typed metadata. `dataset_id` addresses the record within its dataset; the record\'s own handle is what resolves it, and the path\'s dataset is **not** currently checked against the record\'s own — see the open item in eval.md.
+     * Read one dataset record with its full typed metadata. The record must belong to the dataset named in the path; a mismatched parent is returned as 404.
      * Get one record
      */
     evalGetDatasetRecordRaw(requestParameters: EvalGetDatasetRecordRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<EvalDatasetRecordArtifactView>>;
     /**
-     * Read one dataset record with its full typed metadata. `dataset_id` addresses the record within its dataset; the record\'s own handle is what resolves it, and the path\'s dataset is **not** currently checked against the record\'s own — see the open item in eval.md.
+     * Read one dataset record with its full typed metadata. The record must belong to the dataset named in the path; a mismatched parent is returned as 404.
      * Get one record
      */
     evalGetDatasetRecord(requestParameters: EvalGetDatasetRecordRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EvalDatasetRecordArtifactView>;
+    /**
+     * Creates request options for evalGetDatasetRecordVersion without sending the request
+     */
+    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>;
+    /**
+     * Creates request options for evalListDatasetRecordVersions without sending the request
+     */
+    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>;
     /**
      * Creates request options for evalListDatasetRecords without sending the request
      */

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

@@ -3,7 +3,7 @@
 /* eslint-disable */
 /**
  * Evaluation catalog
- * The evaluation loop as registry artifacts: curated `dataset`s of examples pinned from production sessions and traces, `experiment` run snapshots with create-only per-case `experiment_result`s, and versioned `scorer` definitions. A verdict is a score span in the run\'s trace; `POST /experiments/{id}/summarize` rolls a run\'s score spans into its durable `summary`. The gateway executes and scores nothing — external harnesses, CI, and judges run the evals, emit score spans, and upload results here.
+ * The evaluation loop as registry artifacts: curated `dataset`s of examples pinned from production sessions and traces, `experiment` run snapshots with create-only per-case `experiment_result`s, and versioned `scorer` definitions. Finalizing an experiment derives its durable score `summary` from the uploaded result rows. The gateway executes and scores nothing — external harnesses, CI, and judges run the evals, emit score spans, and upload results here.
  *
  * The version of the OpenAPI document: 0.1.0
  *
@@ -369,7 +369,7 @@ class DatasetsApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Read one dataset record with its full typed metadata. `dataset_id` addresses the record within its dataset; the record\'s own handle is what resolves it, and the path\'s dataset is **not** currently checked against the record\'s own — see the open item in eval.md.
+     * Read one dataset record with its full typed metadata. The record must belong to the dataset named in the path; a mismatched parent is returned as 404.
      * Get one record
      */
     async evalGetDatasetRecordRaw(requestParameters, initOverrides) {
@@ -378,13 +378,118 @@ class DatasetsApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, EvalDatasetRecordArtifactView_1.EvalDatasetRecordArtifactViewFromJSON)(jsonValue));
     }
     /**
-     * Read one dataset record with its full typed metadata. `dataset_id` addresses the record within its dataset; the record\'s own handle is what resolves it, and the path\'s dataset is **not** currently checked against the record\'s own — see the open item in eval.md.
+     * Read one dataset record with its full typed metadata. The record must belong to the dataset named in the path; a mismatched parent is returned as 404.
      * Get one record
      */
     async evalGetDatasetRecord(requestParameters, initOverrides) {
         const response = await this.evalGetDatasetRecordRaw(requestParameters, initOverrides);
         return await response.value();
     }
+    /**
+     * Creates request options for evalGetDatasetRecordVersion without sending the request
+     */
+    async evalGetDatasetRecordVersionRequestOpts(requestParameters) {
+        if (requestParameters['datasetId'] == null) {
+            throw new runtime.RequiredError('datasetId', 'Required parameter "datasetId" was null or undefined when calling evalGetDatasetRecordVersion().');
+        }
+        if (requestParameters['recordId'] == null) {
+            throw new runtime.RequiredError('recordId', 'Required parameter "recordId" was null or undefined when calling evalGetDatasetRecordVersion().');
+        }
+        if (requestParameters['versionOrdinal'] == null) {
+            throw new runtime.RequiredError('versionOrdinal', 'Required parameter "versionOrdinal" was null or undefined when calling evalGetDatasetRecordVersion().');
+        }
+        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 = `/datasets/{dataset_id}/records/{record_id}/versions/{version_ordinal}`;
+        urlPath = urlPath.replace('{dataset_id}', encodeURIComponent(String(requestParameters['datasetId'])));
+        urlPath = urlPath.replace('{record_id}', encodeURIComponent(String(requestParameters['recordId'])));
+        urlPath = urlPath.replace('{version_ordinal}', encodeURIComponent(String(requestParameters['versionOrdinal'])));
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Use this operation to get a record version.
+     * Get a record version
+     */
+    async evalGetDatasetRecordVersionRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.evalGetDatasetRecordVersionRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        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) {
+        const response = await this.evalGetDatasetRecordVersionRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for evalListDatasetRecordVersions without sending the request
+     */
+    async evalListDatasetRecordVersionsRequestOpts(requestParameters) {
+        if (requestParameters['datasetId'] == null) {
+            throw new runtime.RequiredError('datasetId', 'Required parameter "datasetId" was null or undefined when calling evalListDatasetRecordVersions().');
+        }
+        if (requestParameters['recordId'] == null) {
+            throw new runtime.RequiredError('recordId', 'Required parameter "recordId" was null or undefined when calling evalListDatasetRecordVersions().');
+        }
+        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 = `/datasets/{dataset_id}/records/{record_id}/versions`;
+        urlPath = urlPath.replace('{dataset_id}', encodeURIComponent(String(requestParameters['datasetId'])));
+        urlPath = urlPath.replace('{record_id}', encodeURIComponent(String(requestParameters['recordId'])));
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Use this operation to list record versions.
+     * List record versions
+     */
+    async evalListDatasetRecordVersionsRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.evalListDatasetRecordVersionsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        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) {
+        const response = await this.evalListDatasetRecordVersionsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Creates request options for evalListDatasetRecords without sending the request
      */