@atlanai/sdk 0.1.1 → 0.2.2

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

@@ -0,0 +1,339 @@
+/**
+ * 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. 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
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { GatewayArtifactIdentityRevealView } from './GatewayArtifactIdentityRevealView';
+import type { EvalSubjectKind } from './EvalSubjectKind';
+import type { EvalExperimentStatus } from './EvalExperimentStatus';
+import type { RegistryRelationshipsView } from './RegistryRelationshipsView';
+import type { EvalDatasetSnapshot } from './EvalDatasetSnapshot';
+/**
+ * Published representation of ExperimentArtifact.
+ * @export
+ * @interface EvalExperimentArtifactView
+ */
+export interface EvalExperimentArtifactView {
+    /**
+     * Value of the `app` field.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    app?: string;
+    /**
+     * Value of the `artifact_status` field.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    artifactStatus: string;
+    /**
+     * RFC 3339 commit timestamp (the cross-table monotonic cursor).
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    commitTs: string;
+    /**
+     * Value of the `content_hash_hex` field.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    contentHashHex?: string;
+    /**
+     * Value of the `created_at` field.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    createdAt: string;
+    /**
+     * Value of the `created_by` field.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    createdBy: string;
+    /**
+     * Human-readable description.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    description?: string;
+    /**
+     * Human-readable name.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    displayName?: string;
+    /**
+     * Kind-prefixed Crockford-base32 handle (`<kind>_<base32>`).
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    id: string;
+    /**
+     * Value of the `identity` field.
+     * @type {GatewayArtifactIdentityRevealView}
+     * @memberof EvalExperimentArtifactView
+     */
+    identity?: GatewayArtifactIdentityRevealView;
+    /**
+     * Whether this is the head (latest) version of its line.
+     * @type {boolean}
+     * @memberof EvalExperimentArtifactView
+     */
+    isLatest: boolean;
+    /**
+     * Domain discriminator for this resource.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    kind: string;
+    /**
+     * Stable machine handle ([AIP-122](https://google.aip.dev/122)): a short,
+     * identifier-shaped label (kebab-case by convention) meant for references,
+     * paths and code. **Not unique**, and not the artifact's identity — `id` is
+     * the only stable handle. Not format-validated today, so existing rows may
+     * hold prose.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    name: string;
+    /**
+     * The Control-Plane OIDC client id this artifact authenticates as
+     * (`x-gateway-identity` kinds); absent for every other kind.
+     *
+     * **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 EvalExperimentArtifactView
+     */
+    oidcClientId?: string;
+    /**
+     * Canonical owner: the `users.user_id` this artifact belongs to, FK-backed.
+     *
+     * 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 EvalExperimentArtifactView
+     */
+    ownerId?: string;
+    /**
+     * `project_`-prefixed handle of the project grouping this artifact, when it has
+     * one. Absent for an artifact that lives directly in its workspace — which also
+     * means it is not packaged into any Claude Code plugin, since packaging is
+     * per-project (project-2026-07-30-first-class-project-table).
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    projectId?: string;
+    /**
+     * The source repository this artifact came from, as a `repo_`-prefixed
+     * handle. Absent when the artifact has no repo.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    repoId?: string;
+    /**
+     * Advisory origin timestamp for imported artifacts (RFC 3339); absent for
+     * natively-created artifacts. Distinct from `created_at` (the commit time).
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    sourceCreatedAt?: string;
+    /**
+     * Advisory upstream author (git `Name <email>`) of the first version
+     * upstream; absent when unset.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    sourceCreatedBy?: string;
+    /**
+     * sha256 of the materialized content; absent when unset.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    sourceDigest?: string;
+    /**
+     * The artifact's identifier in the system it came from — what the upstream
+     * calls it, as opposed to `source_uri`'s where-it-lives. Filterable and
+     * sortable, so a re-sync reconciles on this rather than on `name`; absent
+     * when unset.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    sourceId?: string;
+    /**
+     * Advisory upstream last-modified timestamp (RFC 3339); absent when unset.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    sourceLastModifiedAt?: string;
+    /**
+     * Advisory upstream author (git `Name <email>`) of the last change; absent
+     * when unset.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    sourceLastModifiedBy?: string;
+    /**
+     *
+     * @type {any}
+     * @memberof EvalExperimentArtifactView
+     */
+    sourceMetadata?: any | null;
+    /**
+     * Advisory timestamp (RFC 3339) of the last sync that produced a version.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    sourceSyncedAt?: string;
+    /**
+     * Content authority for the line: `git`, `atlan`, `local`, or `external`
+     * for a system the gateway does not know (a customer's own runner or catalog).
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    sourceType: string;
+    /**
+     * Scheme-tagged origin; absent for a service-managed (`atlan`) line.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    sourceUri?: string;
+    /**
+     * Advisory upstream version id (git commit hash / tag); distinct from
+     * `version_label`. Absent when unset.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    sourceVersion?: string;
+    /**
+     * Value of the `updated_at` field.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    updatedAt: string;
+    /**
+     * Value of the `updated_by` field.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    updatedBy: string;
+    /**
+     * 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 EvalExperimentArtifactView
+     */
+    versionLabel?: string;
+    /**
+     * 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 EvalExperimentArtifactView
+     */
+    versionOrdinal: number;
+    /**
+     * `workspace_`-prefixed handle.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    workspaceId: string;
+    /**
+     * The experiment this one is compared against (same dataset, prior
+     * configuration). Resolved at write, so a dangling baseline cannot be
+     * recorded.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    baselineExperimentId?: string | null;
+    /**
+     * What ran: model, parameters, prompt hash, commit, retrieval strategy —
+     * whatever identifies the configuration under test. Pinned after create,
+     * because it describes a run that already happened.
+     * @type {{ [key: string]: any; }}
+     * @memberof EvalExperimentArtifactView
+     */
+    config?: {
+        [key: string]: any;
+    } | null;
+    /**
+     * The dataset this run evaluated over. Optional — an ad-hoc run has none —
+     * and immutable after create.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    datasetId?: string | null;
+    /**
+     * Value of the `dataset_snapshot` field.
+     * @type {EvalDatasetSnapshot}
+     * @memberof EvalExperimentArtifactView
+     */
+    datasetSnapshot?: EvalDatasetSnapshot | null;
+    /**
+     *
+     * @type {EvalExperimentStatus}
+     * @memberof EvalExperimentArtifactView
+     */
+    experimentStatus?: EvalExperimentStatus;
+    /**
+     * The subject's artifact handle, resolved against `subject_kind`.
+     * @type {string}
+     * @memberof EvalExperimentArtifactView
+     */
+    subjectId?: string | null;
+    /**
+     * Value of the `subject_kind` field.
+     * @type {EvalSubjectKind}
+     * @memberof EvalExperimentArtifactView
+     */
+    subjectKind?: EvalSubjectKind | null;
+    /**
+     * Score aggregates, written at finalize — e.g.
+     * `{"scores": {"accuracy": {"mean": 0.82, "count": 50}}}`. The runner's
+     * vocabulary, round-tripped verbatim.
+     * @type {{ [key: string]: any; }}
+     * @memberof EvalExperimentArtifactView
+     */
+    summary?: {
+        [key: string]: any;
+    } | null;
+    /**
+     * Value of the `permissions` field.
+     * @type {{ [key: string]: boolean; }}
+     * @memberof EvalExperimentArtifactView
+     */
+    permissions?: {
+        [key: string]: boolean;
+    } | null;
+    /**
+     * Value of the `relationships` field.
+     * @type {RegistryRelationshipsView}
+     * @memberof EvalExperimentArtifactView
+     */
+    relationships?: RegistryRelationshipsView | null;
+}
+/**
+ * Check if a given object implements the EvalExperimentArtifactView interface.
+ */
+export declare function instanceOfEvalExperimentArtifactView(value: object): value is EvalExperimentArtifactView;
+export declare function EvalExperimentArtifactViewFromJSON(json: any): EvalExperimentArtifactView;
+export declare function EvalExperimentArtifactViewFromJSONTyped(json: any, ignoreDiscriminator: boolean): EvalExperimentArtifactView;
+export declare function EvalExperimentArtifactViewToJSON(json: any): EvalExperimentArtifactView;
+export declare function EvalExperimentArtifactViewToJSONTyped(value?: EvalExperimentArtifactView | null, ignoreDiscriminator?: boolean): any;

package/dist/raw/eval/models/EvalExperimentArtifactView.js

@@ -0,0 +1,163 @@
+"use strict";
+/* tslint:disable */
+/* 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. 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
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instanceOfEvalExperimentArtifactView = instanceOfEvalExperimentArtifactView;
+exports.EvalExperimentArtifactViewFromJSON = EvalExperimentArtifactViewFromJSON;
+exports.EvalExperimentArtifactViewFromJSONTyped = EvalExperimentArtifactViewFromJSONTyped;
+exports.EvalExperimentArtifactViewToJSON = EvalExperimentArtifactViewToJSON;
+exports.EvalExperimentArtifactViewToJSONTyped = EvalExperimentArtifactViewToJSONTyped;
+const GatewayArtifactIdentityRevealView_1 = require("./GatewayArtifactIdentityRevealView");
+const EvalSubjectKind_1 = require("./EvalSubjectKind");
+const EvalExperimentStatus_1 = require("./EvalExperimentStatus");
+const RegistryRelationshipsView_1 = require("./RegistryRelationshipsView");
+const EvalDatasetSnapshot_1 = require("./EvalDatasetSnapshot");
+/**
+ * Check if a given object implements the EvalExperimentArtifactView interface.
+ */
+function instanceOfEvalExperimentArtifactView(value) {
+    if ((!('artifactStatus' in value) && !('artifact_status' in value)) || (value['artifactStatus'] === undefined && value['artifact_status'] === undefined))
+        return false;
+    if ((!('commitTs' in value) && !('commit_ts' in value)) || (value['commitTs'] === undefined && value['commit_ts'] === undefined))
+        return false;
+    if ((!('createdAt' in value) && !('created_at' in value)) || (value['createdAt'] === undefined && value['created_at'] === undefined))
+        return false;
+    if ((!('createdBy' in value) && !('created_by' in value)) || (value['createdBy'] === undefined && value['created_by'] === undefined))
+        return false;
+    if (!('id' in value) || value['id'] === undefined)
+        return false;
+    if ((!('isLatest' in value) && !('is_latest' in value)) || (value['isLatest'] === undefined && value['is_latest'] === undefined))
+        return false;
+    if (!('kind' in value) || value['kind'] === undefined)
+        return false;
+    if (!('name' in value) || value['name'] === undefined)
+        return false;
+    if ((!('sourceType' in value) && !('source_type' in value)) || (value['sourceType'] === undefined && value['source_type'] === undefined))
+        return false;
+    if ((!('updatedAt' in value) && !('updated_at' in value)) || (value['updatedAt'] === undefined && value['updated_at'] === undefined))
+        return false;
+    if ((!('updatedBy' in value) && !('updated_by' in value)) || (value['updatedBy'] === undefined && value['updated_by'] === undefined))
+        return false;
+    if ((!('versionOrdinal' in value) && !('version_ordinal' in value)) || (value['versionOrdinal'] === undefined && value['version_ordinal'] === undefined))
+        return false;
+    if ((!('workspaceId' in value) && !('workspace_id' in value)) || (value['workspaceId'] === undefined && value['workspace_id'] === undefined))
+        return false;
+    return true;
+}
+function EvalExperimentArtifactViewFromJSON(json) {
+    return EvalExperimentArtifactViewFromJSONTyped(json, false);
+}
+function EvalExperimentArtifactViewFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        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'],
+        'createdAt': json['created_at'],
+        'createdBy': json['created_by'],
+        'description': json['description'] == null ? undefined : json['description'],
+        'displayName': json['display_name'] == null ? undefined : json['display_name'],
+        'id': json['id'],
+        'identity': json['identity'] == null ? undefined : (0, GatewayArtifactIdentityRevealView_1.GatewayArtifactIdentityRevealViewFromJSON)(json['identity']),
+        'isLatest': json['is_latest'],
+        'kind': json['kind'],
+        'name': json['name'],
+        'oidcClientId': json['oidc_client_id'] == null ? undefined : json['oidc_client_id'],
+        'ownerId': json['owner_id'] == null ? undefined : json['owner_id'],
+        'projectId': json['project_id'] == null ? undefined : json['project_id'],
+        'repoId': json['repo_id'] == null ? undefined : json['repo_id'],
+        'sourceCreatedAt': json['source_created_at'] == null ? undefined : json['source_created_at'],
+        'sourceCreatedBy': json['source_created_by'] == null ? undefined : json['source_created_by'],
+        'sourceDigest': json['source_digest'] == null ? undefined : json['source_digest'],
+        'sourceId': json['source_id'] == null ? undefined : json['source_id'],
+        'sourceLastModifiedAt': json['source_last_modified_at'] == null ? undefined : json['source_last_modified_at'],
+        'sourceLastModifiedBy': json['source_last_modified_by'] == null ? undefined : json['source_last_modified_by'],
+        'sourceMetadata': json['source_metadata'] === undefined ? undefined : json['source_metadata'] === null ? null : json['source_metadata'],
+        'sourceSyncedAt': json['source_synced_at'] == null ? undefined : json['source_synced_at'],
+        'sourceType': json['source_type'],
+        'sourceUri': json['source_uri'] == null ? undefined : json['source_uri'],
+        'sourceVersion': json['source_version'] == null ? undefined : json['source_version'],
+        'updatedAt': json['updated_at'],
+        'updatedBy': json['updated_by'],
+        'versionLabel': json['version_label'] == null ? undefined : json['version_label'],
+        'versionOrdinal': json['version_ordinal'],
+        'workspaceId': json['workspace_id'],
+        'baselineExperimentId': json['baseline_experiment_id'] === undefined ? undefined : json['baseline_experiment_id'] === null ? null : json['baseline_experiment_id'],
+        'config': json['config'] === undefined ? undefined : json['config'] === null ? null : json['config'],
+        'datasetId': json['dataset_id'] === undefined ? undefined : json['dataset_id'] === null ? null : json['dataset_id'],
+        'datasetSnapshot': json['dataset_snapshot'] === undefined ? undefined : json['dataset_snapshot'] === null ? null : (0, EvalDatasetSnapshot_1.EvalDatasetSnapshotFromJSON)(json['dataset_snapshot']),
+        'experimentStatus': json['experiment_status'] == null ? undefined : (0, EvalExperimentStatus_1.EvalExperimentStatusFromJSON)(json['experiment_status']),
+        'subjectId': json['subject_id'] === undefined ? undefined : json['subject_id'] === null ? null : json['subject_id'],
+        'subjectKind': json['subject_kind'] === undefined ? undefined : json['subject_kind'] === null ? null : (0, EvalSubjectKind_1.EvalSubjectKindFromJSON)(json['subject_kind']),
+        'summary': json['summary'] === undefined ? undefined : json['summary'] === null ? null : json['summary'],
+        'permissions': json['permissions'] === undefined ? undefined : json['permissions'] === null ? null : json['permissions'],
+        'relationships': json['relationships'] === undefined ? undefined : json['relationships'] === null ? null : (0, RegistryRelationshipsView_1.RegistryRelationshipsViewFromJSON)(json['relationships']),
+    };
+}
+function EvalExperimentArtifactViewToJSON(json) {
+    return EvalExperimentArtifactViewToJSONTyped(json, false);
+}
+function EvalExperimentArtifactViewToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'app': value['app'],
+        'artifact_status': value['artifactStatus'],
+        'commit_ts': value['commitTs'],
+        'content_hash_hex': value['contentHashHex'],
+        'created_at': value['createdAt'],
+        'created_by': value['createdBy'],
+        'description': value['description'],
+        'display_name': value['displayName'],
+        'id': value['id'],
+        'identity': (0, GatewayArtifactIdentityRevealView_1.GatewayArtifactIdentityRevealViewToJSON)(value['identity']),
+        'is_latest': value['isLatest'],
+        'kind': value['kind'],
+        'name': value['name'],
+        'oidc_client_id': value['oidcClientId'],
+        'owner_id': value['ownerId'],
+        'project_id': value['projectId'],
+        'repo_id': value['repoId'],
+        'source_created_at': value['sourceCreatedAt'],
+        'source_created_by': value['sourceCreatedBy'],
+        'source_digest': value['sourceDigest'],
+        'source_id': value['sourceId'],
+        'source_last_modified_at': value['sourceLastModifiedAt'],
+        'source_last_modified_by': value['sourceLastModifiedBy'],
+        'source_metadata': value['sourceMetadata'],
+        'source_synced_at': value['sourceSyncedAt'],
+        'source_type': value['sourceType'],
+        'source_uri': value['sourceUri'],
+        'source_version': value['sourceVersion'],
+        'updated_at': value['updatedAt'],
+        'updated_by': value['updatedBy'],
+        'version_label': value['versionLabel'],
+        'version_ordinal': value['versionOrdinal'],
+        'workspace_id': value['workspaceId'],
+        'baseline_experiment_id': value['baselineExperimentId'],
+        'config': value['config'],
+        'dataset_id': value['datasetId'],
+        'dataset_snapshot': (0, EvalDatasetSnapshot_1.EvalDatasetSnapshotToJSON)(value['datasetSnapshot']),
+        'experiment_status': (0, EvalExperimentStatus_1.EvalExperimentStatusToJSON)(value['experimentStatus']),
+        'subject_id': value['subjectId'],
+        'subject_kind': (0, EvalSubjectKind_1.EvalSubjectKindToJSON)(value['subjectKind']),
+        'summary': value['summary'],
+        'permissions': value['permissions'],
+        'relationships': (0, RegistryRelationshipsView_1.RegistryRelationshipsViewToJSON)(value['relationships']),
+    };
+}