@atlanai/sdk 0.1.1 → 0.2.2

package/dist/raw/eval/runtime.js

@@ -0,0 +1,369 @@
+"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.TextApiResponse = exports.BlobApiResponse = exports.VoidApiResponse = exports.JSONApiResponse = exports.COLLECTION_FORMATS = exports.RequiredError = exports.FetchError = exports.ResponseError = exports.BaseAPI = exports.DefaultConfig = exports.Configuration = exports.BASE_PATH = void 0;
+exports.querystring = querystring;
+exports.exists = exists;
+exports.mapValues = mapValues;
+exports.anyToJSON = anyToJSON;
+exports.canConsumeForm = canConsumeForm;
+exports.BASE_PATH = "/eval/v1".replace(/\/+$/, "");
+class Configuration {
+    configuration;
+    constructor(configuration = {}) {
+        this.configuration = configuration;
+    }
+    set config(configuration) {
+        this.configuration = configuration;
+    }
+    get basePath() {
+        return this.configuration.basePath != null ? this.configuration.basePath : exports.BASE_PATH;
+    }
+    get fetchApi() {
+        return this.configuration.fetchApi;
+    }
+    get middleware() {
+        return this.configuration.middleware || [];
+    }
+    get queryParamsStringify() {
+        return this.configuration.queryParamsStringify || querystring;
+    }
+    get username() {
+        return this.configuration.username;
+    }
+    get password() {
+        return this.configuration.password;
+    }
+    get apiKey() {
+        const apiKey = this.configuration.apiKey;
+        if (apiKey) {
+            return typeof apiKey === 'function' ? apiKey : () => apiKey;
+        }
+        return undefined;
+    }
+    get accessToken() {
+        const accessToken = this.configuration.accessToken;
+        if (accessToken) {
+            return typeof accessToken === 'function' ? accessToken : async () => accessToken;
+        }
+        return undefined;
+    }
+    get headers() {
+        return this.configuration.headers;
+    }
+    get credentials() {
+        return this.configuration.credentials;
+    }
+}
+exports.Configuration = Configuration;
+exports.DefaultConfig = new Configuration();
+/**
+ * This is the base class for all generated API classes.
+ */
+class BaseAPI {
+    configuration;
+    static jsonRegex = /^(:?application\/json|[^;/ \t]+\/[^;/ \t]+[+]json)[ \t]*(:?;.*)?$/i;
+    middleware;
+    constructor(configuration = exports.DefaultConfig) {
+        this.configuration = configuration;
+        this.middleware = configuration.middleware;
+    }
+    withMiddleware(...middlewares) {
+        const next = this.clone();
+        next.middleware = next.middleware.concat(...middlewares);
+        return next;
+    }
+    withPreMiddleware(...preMiddlewares) {
+        const middlewares = preMiddlewares.map((pre) => ({ pre }));
+        return this.withMiddleware(...middlewares);
+    }
+    withPostMiddleware(...postMiddlewares) {
+        const middlewares = postMiddlewares.map((post) => ({ post }));
+        return this.withMiddleware(...middlewares);
+    }
+    /**
+     * Check if the given MIME is a JSON MIME.
+     * JSON MIME examples:
+     *   application/json
+     *   application/json; charset=UTF8
+     *   APPLICATION/JSON
+     *   application/vnd.company+json
+     * @param mime - MIME (Multipurpose Internet Mail Extensions)
+     * @return True if the given MIME is JSON, false otherwise.
+     */
+    isJsonMime(mime) {
+        if (!mime) {
+            return false;
+        }
+        return BaseAPI.jsonRegex.test(mime);
+    }
+    async request(context, initOverrides) {
+        const { url, init } = await this.createFetchParams(context, initOverrides);
+        const response = await this.fetchApi(url, init);
+        if (response && (response.status >= 200 && response.status < 300)) {
+            return response;
+        }
+        throw new ResponseError(response, 'Response returned an error code');
+    }
+    async createFetchParams(context, initOverrides) {
+        let url = this.configuration.basePath + context.path;
+        if (context.query !== undefined && Object.keys(context.query).length !== 0) {
+            // only add the querystring to the URL if there are query parameters.
+            // this is done to avoid urls ending with a "?" character which buggy webservers
+            // do not handle correctly sometimes.
+            url += '?' + this.configuration.queryParamsStringify(context.query);
+        }
+        const headers = Object.assign({}, this.configuration.headers, context.headers);
+        Object.keys(headers).forEach(key => headers[key] === undefined ? delete headers[key] : {});
+        const initOverrideFn = typeof initOverrides === "function"
+            ? initOverrides
+            : async () => initOverrides;
+        const initParams = {
+            method: context.method,
+            headers,
+            body: context.body,
+            credentials: this.configuration.credentials,
+        };
+        const overriddenInit = {
+            ...initParams,
+            ...(await initOverrideFn({
+                init: initParams,
+                context,
+            }))
+        };
+        let body;
+        if (isFormData(overriddenInit.body)
+            || (overriddenInit.body instanceof URLSearchParams)
+            || isBlob(overriddenInit.body)) {
+            body = overriddenInit.body;
+        }
+        else if (this.isJsonMime(headers['Content-Type'])) {
+            body = JSON.stringify(overriddenInit.body);
+        }
+        else {
+            body = overriddenInit.body;
+        }
+        const init = {
+            ...overriddenInit,
+            body
+        };
+        return { url, init };
+    }
+    fetchApi = async (url, init) => {
+        let fetchParams = { url, init };
+        for (const middleware of this.middleware) {
+            if (middleware.pre) {
+                fetchParams = await middleware.pre({
+                    fetch: this.fetchApi,
+                    ...fetchParams,
+                }) || fetchParams;
+            }
+        }
+        let response = undefined;
+        try {
+            response = await (this.configuration.fetchApi || fetch)(fetchParams.url, fetchParams.init);
+        }
+        catch (e) {
+            for (const middleware of this.middleware) {
+                if (middleware.onError) {
+                    response = await middleware.onError({
+                        fetch: this.fetchApi,
+                        url: fetchParams.url,
+                        init: fetchParams.init,
+                        error: e,
+                        response: response ? response.clone() : undefined,
+                    }) || response;
+                }
+            }
+            if (response === undefined) {
+                if (e instanceof Error) {
+                    throw new FetchError(e, 'The request failed and the interceptors did not return an alternative response');
+                }
+                else {
+                    throw e;
+                }
+            }
+        }
+        for (const middleware of this.middleware) {
+            if (middleware.post) {
+                response = await middleware.post({
+                    fetch: this.fetchApi,
+                    url: fetchParams.url,
+                    init: fetchParams.init,
+                    response: response.clone(),
+                }) || response;
+            }
+        }
+        return response;
+    };
+    /**
+     * Create a shallow clone of `this` by constructing a new instance
+     * and then shallow cloning data members.
+     */
+    clone() {
+        const constructor = this.constructor;
+        const next = new constructor(this.configuration);
+        next.middleware = this.middleware.slice();
+        return next;
+    }
+}
+exports.BaseAPI = BaseAPI;
+;
+function isBlob(value) {
+    return typeof Blob !== 'undefined' && value instanceof Blob;
+}
+function isFormData(value) {
+    return typeof FormData !== "undefined" && value instanceof FormData;
+}
+class ResponseError extends Error {
+    response;
+    name = "ResponseError";
+    constructor(response, msg) {
+        super(msg);
+        this.response = response;
+        // restore prototype chain
+        const actualProto = new.target.prototype;
+        if (Object.setPrototypeOf) {
+            Object.setPrototypeOf(this, actualProto);
+        }
+    }
+}
+exports.ResponseError = ResponseError;
+class FetchError extends Error {
+    cause;
+    name = "FetchError";
+    constructor(cause, msg) {
+        super(msg);
+        this.cause = cause;
+        // restore prototype chain
+        const actualProto = new.target.prototype;
+        if (Object.setPrototypeOf) {
+            Object.setPrototypeOf(this, actualProto);
+        }
+    }
+}
+exports.FetchError = FetchError;
+class RequiredError extends Error {
+    field;
+    name = "RequiredError";
+    constructor(field, msg) {
+        super(msg);
+        this.field = field;
+        // restore prototype chain
+        const actualProto = new.target.prototype;
+        if (Object.setPrototypeOf) {
+            Object.setPrototypeOf(this, actualProto);
+        }
+    }
+}
+exports.RequiredError = RequiredError;
+exports.COLLECTION_FORMATS = {
+    csv: ",",
+    ssv: " ",
+    tsv: "\t",
+    pipes: "|",
+};
+function querystring(params, prefix = '') {
+    return Object.keys(params)
+        .map(key => querystringSingleKey(key, params[key], prefix))
+        .filter(part => part.length > 0)
+        .join('&');
+}
+function querystringSingleKey(key, value, keyPrefix = '') {
+    const fullKey = keyPrefix + (keyPrefix.length ? `[${key}]` : key);
+    if (value instanceof Array) {
+        const multiValue = value.map(singleValue => encodeURIComponent(String(singleValue)))
+            .join(`&${encodeURIComponent(fullKey)}=`);
+        return `${encodeURIComponent(fullKey)}=${multiValue}`;
+    }
+    if (value instanceof Set) {
+        const valueAsArray = Array.from(value);
+        return querystringSingleKey(key, valueAsArray, keyPrefix);
+    }
+    if (value instanceof Date) {
+        return `${encodeURIComponent(fullKey)}=${encodeURIComponent(value.toISOString())}`;
+    }
+    if (value instanceof Object) {
+        return querystring(value, fullKey);
+    }
+    return `${encodeURIComponent(fullKey)}=${encodeURIComponent(String(value))}`;
+}
+function exists(json, key) {
+    const value = json[key];
+    return value !== null && value !== undefined;
+}
+function mapValues(data, fn) {
+    const result = {};
+    for (const key of Object.keys(data)) {
+        result[key] = fn(data[key]);
+    }
+    return result;
+}
+// Pass-through serializer for `any`-typed properties in form data. See #1877.
+function anyToJSON(value) {
+    return value;
+}
+function canConsumeForm(consumes) {
+    for (const consume of consumes) {
+        if (consume.contentType?.startsWith('multipart/form-data') == true) {
+            return true;
+        }
+    }
+    return false;
+}
+class JSONApiResponse {
+    raw;
+    transformer;
+    constructor(raw, transformer = (jsonValue) => jsonValue) {
+        this.raw = raw;
+        this.transformer = transformer;
+    }
+    async value() {
+        return this.transformer(await this.raw.json());
+    }
+}
+exports.JSONApiResponse = JSONApiResponse;
+class VoidApiResponse {
+    raw;
+    constructor(raw) {
+        this.raw = raw;
+    }
+    async value() {
+        return undefined;
+    }
+}
+exports.VoidApiResponse = VoidApiResponse;
+class BlobApiResponse {
+    raw;
+    constructor(raw) {
+        this.raw = raw;
+    }
+    async value() {
+        return await this.raw.blob();
+    }
+    ;
+}
+exports.BlobApiResponse = BlobApiResponse;
+class TextApiResponse {
+    raw;
+    constructor(raw) {
+        this.raw = raw;
+    }
+    async value() {
+        return await this.raw.text();
+    }
+    ;
+}
+exports.TextApiResponse = TextApiResponse;

package/dist/raw/file/apis/FileApi.d.ts

@@ -15,6 +15,7 @@ import { type FileUploadRequest } from '../models/FileUploadRequest';
 import { type FileUploadTicket } from '../models/FileUploadTicket';
 export interface FileCreateUploadRequest {
     fileUploadRequest: FileUploadRequest;
+    contentEncoding?: FileCreateUploadContentEncodingEnum;
 }
 export interface FileGetContentRequest {
     fileId: string;
@@ -26,6 +27,7 @@ export interface FileGetVersionContentRequest {
 export interface FileIngestUploadRequest {
     uploadKey: string;
     body: Blob;
+    contentEncoding?: FileIngestUploadContentEncodingEnum;
 }
 export interface FileListRequest {
     parentKind?: string | null;
@@ -108,3 +110,19 @@ export declare class FileApi extends runtime.BaseAPI {
      */
     fileList(requestParameters?: FileListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileFilePage>;
 }
+/**
+  * @export
+  * @enum {string}
+  */
+export declare enum FileCreateUploadContentEncodingEnum {
+    Base64 = "base64",
+    GzipBase64 = "gzip, base64"
+}
+/**
+  * @export
+  * @enum {string}
+  */
+export declare enum FileIngestUploadContentEncodingEnum {
+    Base64 = "base64",
+    GzipBase64 = "gzip, base64"
+}

package/dist/raw/file/apis/FileApi.js

@@ -46,7 +46,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileApi = void 0;
+exports.FileIngestUploadContentEncodingEnum = exports.FileCreateUploadContentEncodingEnum = exports.FileApi = void 0;
 const runtime = __importStar(require("../runtime"));
 const FileFilePage_1 = require("../models/FileFilePage");
 const FileUploadRequest_1 = require("../models/FileUploadRequest");
@@ -65,6 +65,9 @@ class FileApi extends runtime.BaseAPI {
         const queryParameters = {};
         const headerParameters = {};
         headerParameters['Content-Type'] = 'application/json';
+        if (requestParameters['contentEncoding'] != null) {
+            headerParameters['Content-Encoding'] = String(requestParameters['contentEncoding']);
+        }
         if (this.configuration && this.configuration.accessToken) {
             const token = this.configuration.accessToken;
             const tokenString = await token("bearer", []);
@@ -199,6 +202,9 @@ class FileApi extends runtime.BaseAPI {
         const queryParameters = {};
         const headerParameters = {};
         headerParameters['Content-Type'] = 'application/octet-stream';
+        if (requestParameters['contentEncoding'] != null) {
+            headerParameters['Content-Encoding'] = String(requestParameters['contentEncoding']);
+        }
         if (this.configuration && this.configuration.accessToken) {
             const token = this.configuration.accessToken;
             const tokenString = await token("bearer", []);
@@ -284,3 +290,21 @@ class FileApi extends runtime.BaseAPI {
     }
 }
 exports.FileApi = FileApi;
+/**
+  * @export
+  * @enum {string}
+  */
+var FileCreateUploadContentEncodingEnum;
+(function (FileCreateUploadContentEncodingEnum) {
+    FileCreateUploadContentEncodingEnum["Base64"] = "base64";
+    FileCreateUploadContentEncodingEnum["GzipBase64"] = "gzip, base64";
+})(FileCreateUploadContentEncodingEnum || (exports.FileCreateUploadContentEncodingEnum = FileCreateUploadContentEncodingEnum = {}));
+/**
+  * @export
+  * @enum {string}
+  */
+var FileIngestUploadContentEncodingEnum;
+(function (FileIngestUploadContentEncodingEnum) {
+    FileIngestUploadContentEncodingEnum["Base64"] = "base64";
+    FileIngestUploadContentEncodingEnum["GzipBase64"] = "gzip, base64";
+})(FileIngestUploadContentEncodingEnum || (exports.FileIngestUploadContentEncodingEnum = FileIngestUploadContentEncodingEnum = {}));

package/dist/raw/file/models/FileCreateUpload400Response.d.ts

@@ -51,6 +51,8 @@ export interface FileCreateUpload400Response {
 * @enum {string}
 */
 export declare enum FileCreateUpload400ResponseCodeEnum {
+    InvalidBase64 = "invalid_base64",
+    InvalidGzip = "invalid_gzip",
     InvalidJson = "invalid_json"
 }
 /**

package/dist/raw/file/models/FileCreateUpload400Response.js

@@ -25,6 +25,8 @@ exports.FileCreateUpload400ResponseToJSONTyped = FileCreateUpload400ResponseToJS
 */
 var FileCreateUpload400ResponseCodeEnum;
 (function (FileCreateUpload400ResponseCodeEnum) {
+    FileCreateUpload400ResponseCodeEnum["InvalidBase64"] = "invalid_base64";
+    FileCreateUpload400ResponseCodeEnum["InvalidGzip"] = "invalid_gzip";
     FileCreateUpload400ResponseCodeEnum["InvalidJson"] = "invalid_json";
 })(FileCreateUpload400ResponseCodeEnum || (exports.FileCreateUpload400ResponseCodeEnum = FileCreateUpload400ResponseCodeEnum = {}));
 /**
@@ -33,8 +35,6 @@ var FileCreateUpload400ResponseCodeEnum;
 function instanceOfFileCreateUpload400Response(value) {
     if (!('code' in value) || value['code'] === undefined)
         return false;
-    if (value['code'] !== 'invalid_json')
-        return false;
     if (!('detail' in value) || value['detail'] === undefined)
         return false;
     if (!('status' in value) || value['status'] === undefined)

package/dist/raw/file/models/FileCreateUpload413Response.d.ts

@@ -51,7 +51,8 @@ export interface FileCreateUpload413Response {
 * @enum {string}
 */
 export declare enum FileCreateUpload413ResponseCodeEnum {
-    PayloadTooLarge = "payload_too_large"
+    CompressedPayloadTooLarge = "compressed_payload_too_large",
+    DecompressedPayloadTooLarge = "decompressed_payload_too_large"
 }
 /**
  * Check if a given object implements the FileCreateUpload413Response interface.

package/dist/raw/file/models/FileCreateUpload413Response.js

@@ -25,7 +25,8 @@ exports.FileCreateUpload413ResponseToJSONTyped = FileCreateUpload413ResponseToJS
 */
 var FileCreateUpload413ResponseCodeEnum;
 (function (FileCreateUpload413ResponseCodeEnum) {
-    FileCreateUpload413ResponseCodeEnum["PayloadTooLarge"] = "payload_too_large";
+    FileCreateUpload413ResponseCodeEnum["CompressedPayloadTooLarge"] = "compressed_payload_too_large";
+    FileCreateUpload413ResponseCodeEnum["DecompressedPayloadTooLarge"] = "decompressed_payload_too_large";
 })(FileCreateUpload413ResponseCodeEnum || (exports.FileCreateUpload413ResponseCodeEnum = FileCreateUpload413ResponseCodeEnum = {}));
 /**
  * Check if a given object implements the FileCreateUpload413Response interface.
@@ -33,8 +34,6 @@ var FileCreateUpload413ResponseCodeEnum;
 function instanceOfFileCreateUpload413Response(value) {
     if (!('code' in value) || value['code'] === undefined)
         return false;
-    if (value['code'] !== 'payload_too_large')
-        return false;
     if (!('detail' in value) || value['detail'] === undefined)
         return false;
     if (!('status' in value) || value['status'] === undefined)

package/dist/raw/file/models/FileCreateUpload415Response.d.ts

@@ -51,6 +51,7 @@ export interface FileCreateUpload415Response {
 * @enum {string}
 */
 export declare enum FileCreateUpload415ResponseCodeEnum {
+    UnsupportedContentEncoding = "unsupported_content_encoding",
     UnsupportedContentType = "unsupported_content_type"
 }
 /**

package/dist/raw/file/models/FileCreateUpload415Response.js

@@ -25,6 +25,7 @@ exports.FileCreateUpload415ResponseToJSONTyped = FileCreateUpload415ResponseToJS
 */
 var FileCreateUpload415ResponseCodeEnum;
 (function (FileCreateUpload415ResponseCodeEnum) {
+    FileCreateUpload415ResponseCodeEnum["UnsupportedContentEncoding"] = "unsupported_content_encoding";
     FileCreateUpload415ResponseCodeEnum["UnsupportedContentType"] = "unsupported_content_type";
 })(FileCreateUpload415ResponseCodeEnum || (exports.FileCreateUpload415ResponseCodeEnum = FileCreateUpload415ResponseCodeEnum = {}));
 /**
@@ -33,8 +34,6 @@ var FileCreateUpload415ResponseCodeEnum;
 function instanceOfFileCreateUpload415Response(value) {
     if (!('code' in value) || value['code'] === undefined)
         return false;
-    if (value['code'] !== 'unsupported_content_type')
-        return false;
     if (!('detail' in value) || value['detail'] === undefined)
         return false;
     if (!('status' in value) || value['status'] === undefined)

package/dist/raw/file/models/FileFile.d.ts

@@ -70,6 +70,10 @@ export interface FileFile {
      * Send this **or** a body, never both. Use it for content too large to put in a
      * request. The key only ever resolves to an object uploaded under the caller's
      * own account, so it names bytes the caller was issued a URL for and no others.
+     *
+     * **Accepted on a create and on a version append (`POST …/versions`) only.** A
+     * `PATCH` carrying one is refused with `422 immutable_field`: content is immutable
+     * per version, so new bytes are a new version, never an edit of an existing one.
      * @type {string}
      * @memberof FileFile
      */

package/dist/raw/file/models/FileFileArtifact.d.ts

@@ -16,6 +16,12 @@ import type { GatewayArtifactIdentityRevealView } from './GatewayArtifactIdentit
  * @interface FileFileArtifact
  */
 export interface FileFileArtifact {
+    /**
+     * Value of the `app` field.
+     * @type {string}
+     * @memberof FileFileArtifact
+     */
+    app?: string;
     /**
      * Value of the `artifact_status` field.
      * @type {string}
@@ -58,12 +64,6 @@ export interface FileFileArtifact {
      * @memberof FileFileArtifact
      */
     displayName?: string;
-    /**
-     * Value of the `extension` field.
-     * @type {string}
-     * @memberof FileFileArtifact
-     */
-    extension?: string;
     /**
      * Kind-prefixed Crockford-base32 handle (`<kind>_<base32>`).
      * @type {string}
@@ -102,19 +102,28 @@ export interface FileFileArtifact {
      * 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 FileFileArtifact
      */
     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 FileFileArtifact
      */
@@ -222,13 +231,16 @@ export interface FileFileArtifact {
      */
     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 FileFileArtifact
      */
     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 FileFileArtifact
      */
@@ -290,6 +302,10 @@ export interface FileFileArtifact {
      * Send this **or** a body, never both. Use it for content too large to put in a
      * request. The key only ever resolves to an object uploaded under the caller's
      * own account, so it names bytes the caller was issued a URL for and no others.
+     *
+     * **Accepted on a create and on a version append (`POST …/versions`) only.** A
+     * `PATCH` carrying one is refused with `422 immutable_field`: content is immutable
+     * per version, so new bytes are a new version, never an edit of an existing one.
      * @type {string}
      * @memberof FileFileArtifact
      */

package/dist/raw/file/models/FileFileArtifact.js

@@ -59,6 +59,7 @@ function FileFileArtifactFromJSONTyped(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'],
@@ -66,7 +67,6 @@ function FileFileArtifactFromJSONTyped(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'],
@@ -109,6 +109,7 @@ function FileFileArtifactToJSONTyped(value, ignoreDiscriminator = false) {
         return value;
     }
     return {
+        'app': value['app'],
         'artifact_status': value['artifactStatus'],
         'commit_ts': value['commitTs'],
         'content_hash_hex': value['contentHashHex'],
@@ -116,7 +117,6 @@ function FileFileArtifactToJSONTyped(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'],