@atlanai/sdk 0.1.1 → 0.2.2

package/dist/raw/agent/apis/SessionsApi.d.ts

@@ -27,13 +27,16 @@ import { type AgentSessionStreamFrame } from '../models/AgentSessionStreamFrame'
 import { type AgentSubjectKind } from '../models/AgentSubjectKind';
 export interface AgentAggregateSessionsRequest {
     agentArtifactAggregateRequest: AgentArtifactAggregateRequest;
+    contentEncoding?: AgentAggregateSessionsContentEncodingEnum;
 }
 export interface AgentCreateSessionMessageRequest {
     sessionId: string;
     agentSessionMessageCreate: AgentSessionMessageCreate;
+    contentEncoding?: AgentCreateSessionMessageContentEncodingEnum;
 }
 export interface AgentCreateSessionRecordRequest {
     agentSessionCreate: AgentSessionCreate;
+    contentEncoding?: AgentCreateSessionRecordContentEncodingEnum;
 }
 export interface AgentGetSessionRequest {
     sessionId: string;
@@ -67,6 +70,7 @@ export interface AgentPollEventsRequest {
 }
 export interface AgentSearchSessionsRequest {
     agentArtifactSearchRequest: AgentArtifactSearchRequest;
+    contentEncoding?: AgentSearchSessionsContentEncodingEnum;
 }
 export interface AgentStreamEventsRequest {
     sessionId: string;
@@ -216,3 +220,35 @@ export declare class SessionsApi extends runtime.BaseAPI {
      */
     agentStreamEvents(requestParameters: AgentStreamEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentSessionStreamFrame>;
 }
+/**
+  * @export
+  * @enum {string}
+  */
+export declare enum AgentAggregateSessionsContentEncodingEnum {
+    Base64 = "base64",
+    GzipBase64 = "gzip, base64"
+}
+/**
+  * @export
+  * @enum {string}
+  */
+export declare enum AgentCreateSessionMessageContentEncodingEnum {
+    Base64 = "base64",
+    GzipBase64 = "gzip, base64"
+}
+/**
+  * @export
+  * @enum {string}
+  */
+export declare enum AgentCreateSessionRecordContentEncodingEnum {
+    Base64 = "base64",
+    GzipBase64 = "gzip, base64"
+}
+/**
+  * @export
+  * @enum {string}
+  */
+export declare enum AgentSearchSessionsContentEncodingEnum {
+    Base64 = "base64",
+    GzipBase64 = "gzip, base64"
+}

package/dist/raw/agent/apis/SessionsApi.js

@@ -46,7 +46,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SessionsApi = void 0;
+exports.AgentSearchSessionsContentEncodingEnum = exports.AgentCreateSessionRecordContentEncodingEnum = exports.AgentCreateSessionMessageContentEncodingEnum = exports.AgentAggregateSessionsContentEncodingEnum = exports.SessionsApi = void 0;
 const runtime = __importStar(require("../runtime"));
 const AgentArtifactAggregateRequest_1 = require("../models/AgentArtifactAggregateRequest");
 const AgentArtifactAggregateResponse_1 = require("../models/AgentArtifactAggregateResponse");
@@ -73,6 +73,9 @@ class SessionsApi 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", []);
@@ -119,6 +122,9 @@ class SessionsApi 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", []);
@@ -163,6 +169,9 @@ class SessionsApi 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", []);
@@ -461,6 +470,9 @@ class SessionsApi 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", []);
@@ -538,3 +550,39 @@ class SessionsApi extends runtime.BaseAPI {
     }
 }
 exports.SessionsApi = SessionsApi;
+/**
+  * @export
+  * @enum {string}
+  */
+var AgentAggregateSessionsContentEncodingEnum;
+(function (AgentAggregateSessionsContentEncodingEnum) {
+    AgentAggregateSessionsContentEncodingEnum["Base64"] = "base64";
+    AgentAggregateSessionsContentEncodingEnum["GzipBase64"] = "gzip, base64";
+})(AgentAggregateSessionsContentEncodingEnum || (exports.AgentAggregateSessionsContentEncodingEnum = AgentAggregateSessionsContentEncodingEnum = {}));
+/**
+  * @export
+  * @enum {string}
+  */
+var AgentCreateSessionMessageContentEncodingEnum;
+(function (AgentCreateSessionMessageContentEncodingEnum) {
+    AgentCreateSessionMessageContentEncodingEnum["Base64"] = "base64";
+    AgentCreateSessionMessageContentEncodingEnum["GzipBase64"] = "gzip, base64";
+})(AgentCreateSessionMessageContentEncodingEnum || (exports.AgentCreateSessionMessageContentEncodingEnum = AgentCreateSessionMessageContentEncodingEnum = {}));
+/**
+  * @export
+  * @enum {string}
+  */
+var AgentCreateSessionRecordContentEncodingEnum;
+(function (AgentCreateSessionRecordContentEncodingEnum) {
+    AgentCreateSessionRecordContentEncodingEnum["Base64"] = "base64";
+    AgentCreateSessionRecordContentEncodingEnum["GzipBase64"] = "gzip, base64";
+})(AgentCreateSessionRecordContentEncodingEnum || (exports.AgentCreateSessionRecordContentEncodingEnum = AgentCreateSessionRecordContentEncodingEnum = {}));
+/**
+  * @export
+  * @enum {string}
+  */
+var AgentSearchSessionsContentEncodingEnum;
+(function (AgentSearchSessionsContentEncodingEnum) {
+    AgentSearchSessionsContentEncodingEnum["Base64"] = "base64";
+    AgentSearchSessionsContentEncodingEnum["GzipBase64"] = "gzip, base64";
+})(AgentSearchSessionsContentEncodingEnum || (exports.AgentSearchSessionsContentEncodingEnum = AgentSearchSessionsContentEncodingEnum = {}));

package/dist/raw/agent/apis/TracesApi.d.ts

@@ -76,6 +76,7 @@ export interface AgentQueryAgentTraceStatsRequest {
     sort?: string;
     userId?: string;
     sessionStatus?: string;
+    contentEncoding?: AgentQueryAgentTraceStatsContentEncodingEnum;
 }
 export interface AgentQueryHarnessTraceStatsRequest {
     harnessId: string;
@@ -87,6 +88,7 @@ export interface AgentQueryHarnessTraceStatsRequest {
     sort?: string;
     userId?: string;
     sessionStatus?: string;
+    contentEncoding?: AgentQueryHarnessTraceStatsContentEncodingEnum;
 }
 /**
  *
@@ -219,3 +221,19 @@ export declare class TracesApi extends runtime.BaseAPI {
      */
     agentQueryHarnessTraceStats(requestParameters: AgentQueryHarnessTraceStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GatewayTraceStatsEnvelope>;
 }
+/**
+  * @export
+  * @enum {string}
+  */
+export declare enum AgentQueryAgentTraceStatsContentEncodingEnum {
+    Base64 = "base64",
+    GzipBase64 = "gzip, base64"
+}
+/**
+  * @export
+  * @enum {string}
+  */
+export declare enum AgentQueryHarnessTraceStatsContentEncodingEnum {
+    Base64 = "base64",
+    GzipBase64 = "gzip, base64"
+}

package/dist/raw/agent/apis/TracesApi.js

@@ -46,7 +46,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TracesApi = void 0;
+exports.AgentQueryHarnessTraceStatsContentEncodingEnum = exports.AgentQueryAgentTraceStatsContentEncodingEnum = exports.TracesApi = void 0;
 const runtime = __importStar(require("../runtime"));
 const GatewayTraceStatsEnvelope_1 = require("../models/GatewayTraceStatsEnvelope");
 const GatewayTraceStatsRequest_1 = require("../models/GatewayTraceStatsRequest");
@@ -479,6 +479,9 @@ class TracesApi extends runtime.BaseAPI {
         }
         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", []);
@@ -547,6 +550,9 @@ class TracesApi extends runtime.BaseAPI {
         }
         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", []);
@@ -583,3 +589,21 @@ class TracesApi extends runtime.BaseAPI {
     }
 }
 exports.TracesApi = TracesApi;
+/**
+  * @export
+  * @enum {string}
+  */
+var AgentQueryAgentTraceStatsContentEncodingEnum;
+(function (AgentQueryAgentTraceStatsContentEncodingEnum) {
+    AgentQueryAgentTraceStatsContentEncodingEnum["Base64"] = "base64";
+    AgentQueryAgentTraceStatsContentEncodingEnum["GzipBase64"] = "gzip, base64";
+})(AgentQueryAgentTraceStatsContentEncodingEnum || (exports.AgentQueryAgentTraceStatsContentEncodingEnum = AgentQueryAgentTraceStatsContentEncodingEnum = {}));
+/**
+  * @export
+  * @enum {string}
+  */
+var AgentQueryHarnessTraceStatsContentEncodingEnum;
+(function (AgentQueryHarnessTraceStatsContentEncodingEnum) {
+    AgentQueryHarnessTraceStatsContentEncodingEnum["Base64"] = "base64";
+    AgentQueryHarnessTraceStatsContentEncodingEnum["GzipBase64"] = "gzip, base64";
+})(AgentQueryHarnessTraceStatsContentEncodingEnum || (exports.AgentQueryHarnessTraceStatsContentEncodingEnum = AgentQueryHarnessTraceStatsContentEncodingEnum = {}));

package/dist/raw/agent/apis/VisitorsApi.d.ts

@@ -14,6 +14,7 @@ import { type AgentVisitorArtifactView } from '../models/AgentVisitorArtifactVie
 import { type AgentVisitorIdentifyRequest } from '../models/AgentVisitorIdentifyRequest';
 export interface AgentIdentifyVisitorRequest {
     agentVisitorIdentifyRequest: AgentVisitorIdentifyRequest;
+    contentEncoding?: AgentIdentifyVisitorContentEncodingEnum;
 }
 /**
  *
@@ -34,3 +35,11 @@ export declare class VisitorsApi extends runtime.BaseAPI {
      */
     agentIdentifyVisitor(requestParameters: AgentIdentifyVisitorRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentVisitorArtifactView>;
 }
+/**
+  * @export
+  * @enum {string}
+  */
+export declare enum AgentIdentifyVisitorContentEncodingEnum {
+    Base64 = "base64",
+    GzipBase64 = "gzip, base64"
+}

package/dist/raw/agent/apis/VisitorsApi.js

@@ -46,7 +46,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VisitorsApi = void 0;
+exports.AgentIdentifyVisitorContentEncodingEnum = exports.VisitorsApi = void 0;
 const runtime = __importStar(require("../runtime"));
 const AgentVisitorArtifactView_1 = require("../models/AgentVisitorArtifactView");
 const AgentVisitorIdentifyRequest_1 = require("../models/AgentVisitorIdentifyRequest");
@@ -64,6 +64,9 @@ class VisitorsApi 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", []);
@@ -99,3 +102,12 @@ class VisitorsApi extends runtime.BaseAPI {
     }
 }
 exports.VisitorsApi = VisitorsApi;
+/**
+  * @export
+  * @enum {string}
+  */
+var AgentIdentifyVisitorContentEncodingEnum;
+(function (AgentIdentifyVisitorContentEncodingEnum) {
+    AgentIdentifyVisitorContentEncodingEnum["Base64"] = "base64";
+    AgentIdentifyVisitorContentEncodingEnum["GzipBase64"] = "gzip, base64";
+})(AgentIdentifyVisitorContentEncodingEnum || (exports.AgentIdentifyVisitorContentEncodingEnum = AgentIdentifyVisitorContentEncodingEnum = {}));

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

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

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

@@ -61,6 +61,7 @@ function AgentAgentArtifactViewFromJSONTyped(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 AgentAgentArtifactViewFromJSONTyped(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'],
@@ -115,6 +115,7 @@ function AgentAgentArtifactViewToJSONTyped(value, ignoreDiscriminator = false) {
         return value;
     }
     return {
+        'app': value['app'],
         'artifact_status': value['artifactStatus'],
         'commit_ts': value['commitTs'],
         'content_hash_hex': value['contentHashHex'],
@@ -122,7 +123,6 @@ function AgentAgentArtifactViewToJSONTyped(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/AgentAgentEnvironmentArtifactView.d.ts

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

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

@@ -63,6 +63,7 @@ function AgentAgentEnvironmentArtifactViewFromJSONTyped(json, ignoreDiscriminato
         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 AgentAgentEnvironmentArtifactViewFromJSONTyped(json, ignoreDiscriminato
         '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'],
@@ -116,6 +116,7 @@ function AgentAgentEnvironmentArtifactViewToJSONTyped(value, ignoreDiscriminator
         return value;
     }
     return {
+        'app': value['app'],
         'artifact_status': value['artifactStatus'],
         'commit_ts': value['commitTs'],
         'content_hash_hex': value['contentHashHex'],
@@ -123,7 +124,6 @@ function AgentAgentEnvironmentArtifactViewToJSONTyped(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/AgentAgentFrameworkArtifactView.d.ts

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

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

@@ -60,6 +60,7 @@ function AgentAgentFrameworkArtifactViewFromJSONTyped(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 AgentAgentFrameworkArtifactViewFromJSONTyped(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 AgentAgentFrameworkArtifactViewToJSONTyped(value, ignoreDiscriminator =
         return value;
     }
     return {
+        'app': value['app'],
         'artifact_status': value['artifactStatus'],
         'commit_ts': value['commitTs'],
         'content_hash_hex': value['contentHashHex'],
@@ -117,7 +118,6 @@ function AgentAgentFrameworkArtifactViewToJSONTyped(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'],