@atlanai/sdk 0.1.1 → 0.2.2

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

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

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

@@ -61,6 +61,7 @@ function AgentAgentProviderArtifactViewFromJSONTyped(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'],
@@ -68,7 +69,6 @@ function AgentAgentProviderArtifactViewFromJSONTyped(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 AgentAgentProviderArtifactViewToJSONTyped(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 AgentAgentProviderArtifactViewToJSONTyped(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/AgentCreateAgentFramework400Response.d.ts

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

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

@@ -25,6 +25,8 @@ exports.AgentCreateAgentFramework400ResponseToJSONTyped = AgentCreateAgentFramew
 */
 var AgentCreateAgentFramework400ResponseCodeEnum;
 (function (AgentCreateAgentFramework400ResponseCodeEnum) {
+    AgentCreateAgentFramework400ResponseCodeEnum["InvalidBase64"] = "invalid_base64";
+    AgentCreateAgentFramework400ResponseCodeEnum["InvalidGzip"] = "invalid_gzip";
     AgentCreateAgentFramework400ResponseCodeEnum["InvalidJson"] = "invalid_json";
 })(AgentCreateAgentFramework400ResponseCodeEnum || (exports.AgentCreateAgentFramework400ResponseCodeEnum = AgentCreateAgentFramework400ResponseCodeEnum = {}));
 /**
@@ -33,8 +35,6 @@ var AgentCreateAgentFramework400ResponseCodeEnum;
 function instanceOfAgentCreateAgentFramework400Response(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/agent/models/AgentCreateAgentFramework413Response.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Harness and agent catalog
+ * A `harness` is a tool a human drives; an `agent` is built with an `agent_framework` and run on an `agent_provider`. The gateway executes neither. This surface is the typed catalog for both — plus the `agent_framework` and `harness_vendor` catalogs, the `agent_provider` substrate, the `agent_environment` sandbox, and the `session`/`session_message` run history — the one agent run-trigger, live session reads (poll + SSE), and the access-controlled trace facade.
+ *
+ * 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.
+ */
+/**
+ * RFC 7807 problem document for 413 (Payload Too Large).
+ * @export
+ * @interface AgentCreateAgentFramework413Response
+ */
+export interface AgentCreateAgentFramework413Response {
+    /**
+     * Stable machine-readable reason for this failure.
+     * @type {AgentCreateAgentFramework413ResponseCodeEnum}
+     * @memberof AgentCreateAgentFramework413Response
+     */
+    code: AgentCreateAgentFramework413ResponseCodeEnum;
+    /**
+     * Value of the `detail` field.
+     * @type {string}
+     * @memberof AgentCreateAgentFramework413Response
+     */
+    detail: string;
+    /**
+     * Current lifecycle state.
+     * @type {number}
+     * @memberof AgentCreateAgentFramework413Response
+     */
+    status: number;
+    /**
+     * Value of the `title` field.
+     * @type {string}
+     * @memberof AgentCreateAgentFramework413Response
+     */
+    title: string;
+    /**
+     * Stable identifier of the related trace resource.
+     * @type {string}
+     * @memberof AgentCreateAgentFramework413Response
+     */
+    traceId?: string;
+}
+/**
+* @export
+* @enum {string}
+*/
+export declare enum AgentCreateAgentFramework413ResponseCodeEnum {
+    CompressedPayloadTooLarge = "compressed_payload_too_large",
+    DecompressedPayloadTooLarge = "decompressed_payload_too_large"
+}
+/**
+ * Check if a given object implements the AgentCreateAgentFramework413Response interface.
+ */
+export declare function instanceOfAgentCreateAgentFramework413Response(value: object): value is AgentCreateAgentFramework413Response;
+export declare function AgentCreateAgentFramework413ResponseFromJSON(json: any): AgentCreateAgentFramework413Response;
+export declare function AgentCreateAgentFramework413ResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentCreateAgentFramework413Response;
+export declare function AgentCreateAgentFramework413ResponseToJSON(json: any): AgentCreateAgentFramework413Response;
+export declare function AgentCreateAgentFramework413ResponseToJSONTyped(value?: AgentCreateAgentFramework413Response | null, ignoreDiscriminator?: boolean): any;

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

@@ -0,0 +1,74 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Harness and agent catalog
+ * A `harness` is a tool a human drives; an `agent` is built with an `agent_framework` and run on an `agent_provider`. The gateway executes neither. This surface is the typed catalog for both — plus the `agent_framework` and `harness_vendor` catalogs, the `agent_provider` substrate, the `agent_environment` sandbox, and the `session`/`session_message` run history — the one agent run-trigger, live session reads (poll + SSE), and the access-controlled trace facade.
+ *
+ * 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.AgentCreateAgentFramework413ResponseCodeEnum = void 0;
+exports.instanceOfAgentCreateAgentFramework413Response = instanceOfAgentCreateAgentFramework413Response;
+exports.AgentCreateAgentFramework413ResponseFromJSON = AgentCreateAgentFramework413ResponseFromJSON;
+exports.AgentCreateAgentFramework413ResponseFromJSONTyped = AgentCreateAgentFramework413ResponseFromJSONTyped;
+exports.AgentCreateAgentFramework413ResponseToJSON = AgentCreateAgentFramework413ResponseToJSON;
+exports.AgentCreateAgentFramework413ResponseToJSONTyped = AgentCreateAgentFramework413ResponseToJSONTyped;
+/**
+* @export
+* @enum {string}
+*/
+var AgentCreateAgentFramework413ResponseCodeEnum;
+(function (AgentCreateAgentFramework413ResponseCodeEnum) {
+    AgentCreateAgentFramework413ResponseCodeEnum["CompressedPayloadTooLarge"] = "compressed_payload_too_large";
+    AgentCreateAgentFramework413ResponseCodeEnum["DecompressedPayloadTooLarge"] = "decompressed_payload_too_large";
+})(AgentCreateAgentFramework413ResponseCodeEnum || (exports.AgentCreateAgentFramework413ResponseCodeEnum = AgentCreateAgentFramework413ResponseCodeEnum = {}));
+/**
+ * Check if a given object implements the AgentCreateAgentFramework413Response interface.
+ */
+function instanceOfAgentCreateAgentFramework413Response(value) {
+    if (!('code' in value) || value['code'] === undefined)
+        return false;
+    if (!('detail' in value) || value['detail'] === undefined)
+        return false;
+    if (!('status' in value) || value['status'] === undefined)
+        return false;
+    if (!('title' in value) || value['title'] === undefined)
+        return false;
+    return true;
+}
+function AgentCreateAgentFramework413ResponseFromJSON(json) {
+    return AgentCreateAgentFramework413ResponseFromJSONTyped(json, false);
+}
+function AgentCreateAgentFramework413ResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'code': json['code'],
+        'detail': json['detail'],
+        'status': json['status'],
+        'title': json['title'],
+        'traceId': json['trace_id'] == null ? undefined : json['trace_id'],
+    };
+}
+function AgentCreateAgentFramework413ResponseToJSON(json) {
+    return AgentCreateAgentFramework413ResponseToJSONTyped(json, false);
+}
+function AgentCreateAgentFramework413ResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'code': value['code'],
+        'detail': value['detail'],
+        'status': value['status'],
+        'title': value['title'],
+        'trace_id': value['traceId'],
+    };
+}

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

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

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

@@ -25,6 +25,7 @@ exports.AgentCreateAgentFramework415ResponseToJSONTyped = AgentCreateAgentFramew
 */
 var AgentCreateAgentFramework415ResponseCodeEnum;
 (function (AgentCreateAgentFramework415ResponseCodeEnum) {
+    AgentCreateAgentFramework415ResponseCodeEnum["UnsupportedContentEncoding"] = "unsupported_content_encoding";
     AgentCreateAgentFramework415ResponseCodeEnum["UnsupportedContentType"] = "unsupported_content_type";
 })(AgentCreateAgentFramework415ResponseCodeEnum || (exports.AgentCreateAgentFramework415ResponseCodeEnum = AgentCreateAgentFramework415ResponseCodeEnum = {}));
 /**
@@ -33,8 +34,6 @@ var AgentCreateAgentFramework415ResponseCodeEnum;
 function instanceOfAgentCreateAgentFramework415Response(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/agent/models/AgentGetAgentTrace400Response.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Harness and agent catalog
+ * A `harness` is a tool a human drives; an `agent` is built with an `agent_framework` and run on an `agent_provider`. The gateway executes neither. This surface is the typed catalog for both — plus the `agent_framework` and `harness_vendor` catalogs, the `agent_provider` substrate, the `agent_environment` sandbox, and the `session`/`session_message` run history — the one agent run-trigger, live session reads (poll + SSE), and the access-controlled trace facade.
+ *
+ * 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.
+ */
+/**
+ * RFC 7807 problem document for 400 (Bad Request).
+ * @export
+ * @interface AgentGetAgentTrace400Response
+ */
+export interface AgentGetAgentTrace400Response {
+    /**
+     * Stable machine-readable reason for this failure.
+     * @type {AgentGetAgentTrace400ResponseCodeEnum}
+     * @memberof AgentGetAgentTrace400Response
+     */
+    code: AgentGetAgentTrace400ResponseCodeEnum;
+    /**
+     * Value of the `detail` field.
+     * @type {string}
+     * @memberof AgentGetAgentTrace400Response
+     */
+    detail: string;
+    /**
+     * Current lifecycle state.
+     * @type {number}
+     * @memberof AgentGetAgentTrace400Response
+     */
+    status: number;
+    /**
+     * Value of the `title` field.
+     * @type {string}
+     * @memberof AgentGetAgentTrace400Response
+     */
+    title: string;
+    /**
+     * Stable identifier of the related trace resource.
+     * @type {string}
+     * @memberof AgentGetAgentTrace400Response
+     */
+    traceId?: string;
+}
+/**
+* @export
+* @enum {string}
+*/
+export declare enum AgentGetAgentTrace400ResponseCodeEnum {
+    InvalidRequest = "invalid_request"
+}
+/**
+ * Check if a given object implements the AgentGetAgentTrace400Response interface.
+ */
+export declare function instanceOfAgentGetAgentTrace400Response(value: object): value is AgentGetAgentTrace400Response;
+export declare function AgentGetAgentTrace400ResponseFromJSON(json: any): AgentGetAgentTrace400Response;
+export declare function AgentGetAgentTrace400ResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentGetAgentTrace400Response;
+export declare function AgentGetAgentTrace400ResponseToJSON(json: any): AgentGetAgentTrace400Response;
+export declare function AgentGetAgentTrace400ResponseToJSONTyped(value?: AgentGetAgentTrace400Response | null, ignoreDiscriminator?: boolean): any;

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

@@ -0,0 +1,75 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Harness and agent catalog
+ * A `harness` is a tool a human drives; an `agent` is built with an `agent_framework` and run on an `agent_provider`. The gateway executes neither. This surface is the typed catalog for both — plus the `agent_framework` and `harness_vendor` catalogs, the `agent_provider` substrate, the `agent_environment` sandbox, and the `session`/`session_message` run history — the one agent run-trigger, live session reads (poll + SSE), and the access-controlled trace facade.
+ *
+ * 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.AgentGetAgentTrace400ResponseCodeEnum = void 0;
+exports.instanceOfAgentGetAgentTrace400Response = instanceOfAgentGetAgentTrace400Response;
+exports.AgentGetAgentTrace400ResponseFromJSON = AgentGetAgentTrace400ResponseFromJSON;
+exports.AgentGetAgentTrace400ResponseFromJSONTyped = AgentGetAgentTrace400ResponseFromJSONTyped;
+exports.AgentGetAgentTrace400ResponseToJSON = AgentGetAgentTrace400ResponseToJSON;
+exports.AgentGetAgentTrace400ResponseToJSONTyped = AgentGetAgentTrace400ResponseToJSONTyped;
+/**
+* @export
+* @enum {string}
+*/
+var AgentGetAgentTrace400ResponseCodeEnum;
+(function (AgentGetAgentTrace400ResponseCodeEnum) {
+    AgentGetAgentTrace400ResponseCodeEnum["InvalidRequest"] = "invalid_request";
+})(AgentGetAgentTrace400ResponseCodeEnum || (exports.AgentGetAgentTrace400ResponseCodeEnum = AgentGetAgentTrace400ResponseCodeEnum = {}));
+/**
+ * Check if a given object implements the AgentGetAgentTrace400Response interface.
+ */
+function instanceOfAgentGetAgentTrace400Response(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)
+        return false;
+    if (!('title' in value) || value['title'] === undefined)
+        return false;
+    return true;
+}
+function AgentGetAgentTrace400ResponseFromJSON(json) {
+    return AgentGetAgentTrace400ResponseFromJSONTyped(json, false);
+}
+function AgentGetAgentTrace400ResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'code': json['code'],
+        'detail': json['detail'],
+        'status': json['status'],
+        'title': json['title'],
+        'traceId': json['trace_id'] == null ? undefined : json['trace_id'],
+    };
+}
+function AgentGetAgentTrace400ResponseToJSON(json) {
+    return AgentGetAgentTrace400ResponseToJSONTyped(json, false);
+}
+function AgentGetAgentTrace400ResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'code': value['code'],
+        'detail': value['detail'],
+        'status': value['status'],
+        'title': value['title'],
+        'trace_id': value['traceId'],
+    };
+}

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

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

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

@@ -61,6 +61,7 @@ function AgentHarnessArtifactViewFromJSONTyped(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'],
@@ -68,7 +69,6 @@ function AgentHarnessArtifactViewFromJSONTyped(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'],
@@ -110,6 +110,7 @@ function AgentHarnessArtifactViewToJSONTyped(value, ignoreDiscriminator = false)
         return value;
     }
     return {
+        'app': value['app'],
         'artifact_status': value['artifactStatus'],
         'commit_ts': value['commitTs'],
         'content_hash_hex': value['contentHashHex'],
@@ -117,7 +118,6 @@ function AgentHarnessArtifactViewToJSONTyped(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/AgentHarnessVendorArtifactView.d.ts

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