@atlanai/sdk 0.2.1 → 0.2.2

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

@@ -60,6 +60,7 @@ function AgentHarnessVendorArtifactViewFromJSONTyped(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'],
@@ -67,7 +68,6 @@ function AgentHarnessVendorArtifactViewFromJSONTyped(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'],
@@ -111,6 +111,7 @@ function AgentHarnessVendorArtifactViewToJSONTyped(value, ignoreDiscriminator =
         return value;
     }
     return {
+        'app': value['app'],
         'artifact_status': value['artifactStatus'],
         'commit_ts': value['commitTs'],
         'content_hash_hex': value['contentHashHex'],
@@ -118,7 +119,6 @@ function AgentHarnessVendorArtifactViewToJSONTyped(value, ignoreDiscriminator =
         '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/AgentOutputArtifactView.d.ts

@@ -19,6 +19,12 @@ import type { RegistryRelationshipsView } from './RegistryRelationshipsView';
  * @interface AgentOutputArtifactView
  */
 export interface AgentOutputArtifactView {
+    /**
+     * Value of the `app` field.
+     * @type {string}
+     * @memberof AgentOutputArtifactView
+     */
+    app?: string;
     /**
      * Value of the `artifact_status` field.
      * @type {string}
@@ -61,12 +67,6 @@ export interface AgentOutputArtifactView {
      * @memberof AgentOutputArtifactView
      */
     displayName?: string;
-    /**
-     * Value of the `extension` field.
-     * @type {string}
-     * @memberof AgentOutputArtifactView
-     */
-    extension?: string;
     /**
      * Kind-prefixed Crockford-base32 handle (`<kind>_<base32>`).
      * @type {string}
@@ -105,19 +105,28 @@ export interface AgentOutputArtifactView {
      * 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 AgentOutputArtifactView
      */
     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 AgentOutputArtifactView
      */
@@ -225,13 +234,16 @@ export interface AgentOutputArtifactView {
      */
     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 AgentOutputArtifactView
      */
     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 AgentOutputArtifactView
      */

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

@@ -62,6 +62,7 @@ function AgentOutputArtifactViewFromJSONTyped(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'],
@@ -69,7 +70,6 @@ function AgentOutputArtifactViewFromJSONTyped(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'],
@@ -114,6 +114,7 @@ function AgentOutputArtifactViewToJSONTyped(value, ignoreDiscriminator = false)
         return value;
     }
     return {
+        'app': value['app'],
         'artifact_status': value['artifactStatus'],
         'commit_ts': value['commitTs'],
         'content_hash_hex': value['contentHashHex'],
@@ -121,7 +122,6 @@ function AgentOutputArtifactViewToJSONTyped(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/AgentQueryAgentTraceStats400Response.d.ts

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

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

@@ -25,6 +25,8 @@ exports.AgentQueryAgentTraceStats400ResponseToJSONTyped = AgentQueryAgentTraceSt
 */
 var AgentQueryAgentTraceStats400ResponseCodeEnum;
 (function (AgentQueryAgentTraceStats400ResponseCodeEnum) {
+    AgentQueryAgentTraceStats400ResponseCodeEnum["InvalidBase64"] = "invalid_base64";
+    AgentQueryAgentTraceStats400ResponseCodeEnum["InvalidGzip"] = "invalid_gzip";
     AgentQueryAgentTraceStats400ResponseCodeEnum["InvalidJson"] = "invalid_json";
     AgentQueryAgentTraceStats400ResponseCodeEnum["InvalidQuery"] = "invalid_query";
 })(AgentQueryAgentTraceStats400ResponseCodeEnum || (exports.AgentQueryAgentTraceStats400ResponseCodeEnum = AgentQueryAgentTraceStats400ResponseCodeEnum = {}));

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

@@ -23,6 +23,12 @@ import type { RegistryRelationshipsView } from './RegistryRelationshipsView';
  * @interface AgentSessionArtifactView
  */
 export interface AgentSessionArtifactView {
+    /**
+     * Value of the `app` field.
+     * @type {string}
+     * @memberof AgentSessionArtifactView
+     */
+    app?: string;
     /**
      * Value of the `artifact_status` field.
      * @type {string}
@@ -65,12 +71,6 @@ export interface AgentSessionArtifactView {
      * @memberof AgentSessionArtifactView
      */
     displayName?: string;
-    /**
-     * Value of the `extension` field.
-     * @type {string}
-     * @memberof AgentSessionArtifactView
-     */
-    extension?: string;
     /**
      * Kind-prefixed Crockford-base32 handle (`<kind>_<base32>`).
      * @type {string}
@@ -109,19 +109,28 @@ export interface AgentSessionArtifactView {
      * 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 AgentSessionArtifactView
      */
     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 AgentSessionArtifactView
      */
@@ -229,13 +238,16 @@ export interface AgentSessionArtifactView {
      */
     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 AgentSessionArtifactView
      */
     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 AgentSessionArtifactView
      */

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

@@ -66,6 +66,7 @@ function AgentSessionArtifactViewFromJSONTyped(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'],
@@ -73,7 +74,6 @@ function AgentSessionArtifactViewFromJSONTyped(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'],
@@ -133,6 +133,7 @@ function AgentSessionArtifactViewToJSONTyped(value, ignoreDiscriminator = false)
         return value;
     }
     return {
+        'app': value['app'],
         'artifact_status': value['artifactStatus'],
         'commit_ts': value['commitTs'],
         'content_hash_hex': value['contentHashHex'],
@@ -140,7 +141,6 @@ function AgentSessionArtifactViewToJSONTyped(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/AgentSessionMessageArtifactView.d.ts

@@ -20,6 +20,12 @@ import type { RegistryRelationshipsView } from './RegistryRelationshipsView';
  * @interface AgentSessionMessageArtifactView
  */
 export interface AgentSessionMessageArtifactView {
+    /**
+     * Value of the `app` field.
+     * @type {string}
+     * @memberof AgentSessionMessageArtifactView
+     */
+    app?: string;
     /**
      * Value of the `artifact_status` field.
      * @type {string}
@@ -62,12 +68,6 @@ export interface AgentSessionMessageArtifactView {
      * @memberof AgentSessionMessageArtifactView
      */
     displayName?: string;
-    /**
-     * Value of the `extension` field.
-     * @type {string}
-     * @memberof AgentSessionMessageArtifactView
-     */
-    extension?: string;
     /**
      * Kind-prefixed Crockford-base32 handle (`<kind>_<base32>`).
      * @type {string}
@@ -106,19 +106,28 @@ export interface AgentSessionMessageArtifactView {
      * 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 AgentSessionMessageArtifactView
      */
     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 AgentSessionMessageArtifactView
      */
@@ -226,13 +235,16 @@ export interface AgentSessionMessageArtifactView {
      */
     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 AgentSessionMessageArtifactView
      */
     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 AgentSessionMessageArtifactView
      */

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

@@ -63,6 +63,7 @@ function AgentSessionMessageArtifactViewFromJSONTyped(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 AgentSessionMessageArtifactViewFromJSONTyped(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 AgentSessionMessageArtifactViewToJSONTyped(value, ignoreDiscriminator =
         return value;
     }
     return {
+        'app': value['app'],
         'artifact_status': value['artifactStatus'],
         'commit_ts': value['commitTs'],
         'content_hash_hex': value['contentHashHex'],
@@ -125,7 +126,6 @@ function AgentSessionMessageArtifactViewToJSONTyped(value, ignoreDiscriminator =
         '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/AgentUploadAgentProfileImage400Response.d.ts

@@ -51,7 +51,8 @@ export interface AgentUploadAgentProfileImage400Response {
 * @enum {string}
 */
 export declare enum AgentUploadAgentProfileImage400ResponseCodeEnum {
-    InvalidRequest = "invalid_request"
+    InvalidBase64 = "invalid_base64",
+    InvalidGzip = "invalid_gzip"
 }
 /**
  * Check if a given object implements the AgentUploadAgentProfileImage400Response interface.

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

@@ -25,7 +25,8 @@ exports.AgentUploadAgentProfileImage400ResponseToJSONTyped = AgentUploadAgentPro
 */
 var AgentUploadAgentProfileImage400ResponseCodeEnum;
 (function (AgentUploadAgentProfileImage400ResponseCodeEnum) {
-    AgentUploadAgentProfileImage400ResponseCodeEnum["InvalidRequest"] = "invalid_request";
+    AgentUploadAgentProfileImage400ResponseCodeEnum["InvalidBase64"] = "invalid_base64";
+    AgentUploadAgentProfileImage400ResponseCodeEnum["InvalidGzip"] = "invalid_gzip";
 })(AgentUploadAgentProfileImage400ResponseCodeEnum || (exports.AgentUploadAgentProfileImage400ResponseCodeEnum = AgentUploadAgentProfileImage400ResponseCodeEnum = {}));
 /**
  * Check if a given object implements the AgentUploadAgentProfileImage400Response interface.
@@ -33,8 +34,6 @@ var AgentUploadAgentProfileImage400ResponseCodeEnum;
 function instanceOfAgentUploadAgentProfileImage400Response(value) {
     if (!('code' in value) || value['code'] === undefined)
         return false;
-    if (value['code'] !== 'invalid_request')
-        return false;
     if (!('detail' in value) || value['detail'] === undefined)
         return false;
     if (!('status' in value) || value['status'] === undefined)

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

@@ -51,6 +51,8 @@ export interface AgentUploadAgentProfileImage413Response {
 * @enum {string}
 */
 export declare enum AgentUploadAgentProfileImage413ResponseCodeEnum {
+    CompressedPayloadTooLarge = "compressed_payload_too_large",
+    DecompressedPayloadTooLarge = "decompressed_payload_too_large",
     PayloadTooLarge = "payload_too_large"
 }
 /**

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

@@ -25,6 +25,8 @@ exports.AgentUploadAgentProfileImage413ResponseToJSONTyped = AgentUploadAgentPro
 */
 var AgentUploadAgentProfileImage413ResponseCodeEnum;
 (function (AgentUploadAgentProfileImage413ResponseCodeEnum) {
+    AgentUploadAgentProfileImage413ResponseCodeEnum["CompressedPayloadTooLarge"] = "compressed_payload_too_large";
+    AgentUploadAgentProfileImage413ResponseCodeEnum["DecompressedPayloadTooLarge"] = "decompressed_payload_too_large";
     AgentUploadAgentProfileImage413ResponseCodeEnum["PayloadTooLarge"] = "payload_too_large";
 })(AgentUploadAgentProfileImage413ResponseCodeEnum || (exports.AgentUploadAgentProfileImage413ResponseCodeEnum = AgentUploadAgentProfileImage413ResponseCodeEnum = {}));
 /**
@@ -33,8 +35,6 @@ var AgentUploadAgentProfileImage413ResponseCodeEnum;
 function instanceOfAgentUploadAgentProfileImage413Response(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/agent/models/AgentVisitorArtifactView.d.ts

@@ -19,6 +19,12 @@ import type { RegistryRelationshipsView } from './RegistryRelationshipsView';
  * @interface AgentVisitorArtifactView
  */
 export interface AgentVisitorArtifactView {
+    /**
+     * Value of the `app` field.
+     * @type {string}
+     * @memberof AgentVisitorArtifactView
+     */
+    app?: string;
     /**
      * Value of the `artifact_status` field.
      * @type {string}
@@ -61,12 +67,6 @@ export interface AgentVisitorArtifactView {
      * @memberof AgentVisitorArtifactView
      */
     displayName?: string;
-    /**
-     * Value of the `extension` field.
-     * @type {string}
-     * @memberof AgentVisitorArtifactView
-     */
-    extension?: string;
     /**
      * Kind-prefixed Crockford-base32 handle (`<kind>_<base32>`).
      * @type {string}
@@ -105,19 +105,28 @@ export interface AgentVisitorArtifactView {
      * 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 AgentVisitorArtifactView
      */
     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 AgentVisitorArtifactView
      */
@@ -225,13 +234,16 @@ export interface AgentVisitorArtifactView {
      */
     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 AgentVisitorArtifactView
      */
     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 AgentVisitorArtifactView
      */

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

@@ -62,6 +62,7 @@ function AgentVisitorArtifactViewFromJSONTyped(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'],
@@ -69,7 +70,6 @@ function AgentVisitorArtifactViewFromJSONTyped(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'],
@@ -114,6 +114,7 @@ function AgentVisitorArtifactViewToJSONTyped(value, ignoreDiscriminator = false)
         return value;
     }
     return {
+        'app': value['app'],
         'artifact_status': value['artifactStatus'],
         'commit_ts': value['commitTs'],
         'content_hash_hex': value['contentHashHex'],
@@ -121,7 +122,6 @@ function AgentVisitorArtifactViewToJSONTyped(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'],