@atlanai/sdk 0.2.4 → 0.3.0

package/dist/manifest.json

@@ -1,4 +1,5 @@
 {
+    "gateway_commit": "ac5dd2693402edc491f0d831fc783037ae5b5046",
     "schema_version": 2,
     "services": [
         {
@@ -610,7 +611,7 @@
                     "visibility": "public"
                 }
             ],
-            "spec_sha256": "d290102ee63724bda78bbb7138ba9072db9aa4d01bdae3a106acd727b971b612"
+            "spec_sha256": "9c7d4668fd3223cc3130a93741c6f733272a7a3d0d907a9ec5d8dd2b5a7aac47"
         },
         {
             "api_version": "v1",
@@ -771,7 +772,7 @@
                     "visibility": "public"
                 }
             ],
-            "spec_sha256": "744f5927f216bc3ed7da2fa43f06c97f8197b72d77c24ac8ef97598582d6e8e5"
+            "spec_sha256": "5959973f44c603aa4286d00c41611701a2ca3187c42eaec3bbe2d85a7ab40c96"
         },
         {
             "api_version": "v1",
@@ -824,7 +825,7 @@
                     "visibility": "public"
                 }
             ],
-            "spec_sha256": "e715f2be247e7209d78401d2d15602c081adc94a7194bfefc6a60020cf4d3287"
+            "spec_sha256": "a611d4d767614e7582010adbba2c5e233343ff553a7c412b7195b5ac4777834a"
         },
         {
             "api_version": "v1",
@@ -1552,7 +1553,7 @@
                     "visibility": "public"
                 }
             ],
-            "spec_sha256": "826ed751c40e27f9039f58a42d6955eb44613fc7f20f4a629c7cfbcb31aec9af"
+            "spec_sha256": "3ccf97ba7fb5c24a6293f91094af3c3a60ebe5b4315c7c841f785863e3b14b32"
         },
         {
             "api_version": "v1",
@@ -1650,69 +1651,14 @@
                     "visibility": "public"
                 }
             ],
-            "spec_sha256": "afc3aff4ae51935c22f0edba307ffeb0ccd8f4553d0a65e4a203d5ed731126bf"
+            "spec_sha256": "03d7244e01583e406aa851e49bd9e9a26ff1c559cb2de936c9dc3a61c2e93ff6"
         },
         {
             "api_version": "v1",
             "base_path": "/secret/v1",
             "name": "secret",
-            "operations": [
-                {
-                    "error_contract": "native",
-                    "method": "GET",
-                    "operation_id": "secret.oauthCallback",
-                    "path": "/oauth/callback/{provider}",
-                    "stability": "stable",
-                    "summary": "`GET /<ext>/v1/oauth/callback/{provider}` — the provider's redirect target.",
-                    "visibility": "public"
-                },
-                {
-                    "error_contract": "native",
-                    "method": "POST",
-                    "operation_id": "secret.completeOauth",
-                    "path": "/oauth/complete",
-                    "stability": "stable",
-                    "summary": "`POST /<ext>/v1/oauth/complete` — polled until it answers `connected`.",
-                    "visibility": "public"
-                },
-                {
-                    "error_contract": "native",
-                    "method": "GET",
-                    "operation_id": "secret.listOauthConnections",
-                    "path": "/oauth/connections",
-                    "stability": "stable",
-                    "summary": "`GET /<ext>/v1/oauth/connections`.",
-                    "visibility": "public"
-                },
-                {
-                    "error_contract": "native",
-                    "method": "DELETE",
-                    "operation_id": "secret.disconnectOauth",
-                    "path": "/oauth/connections/{secret_id}",
-                    "stability": "stable",
-                    "summary": "`DELETE /<ext>/v1/oauth/connections/{secret_id}`.",
-                    "visibility": "public"
-                },
-                {
-                    "error_contract": "native",
-                    "method": "GET",
-                    "operation_id": "secret.listOauthProviders",
-                    "path": "/oauth/providers",
-                    "stability": "stable",
-                    "summary": "`GET /<ext>/v1/oauth/providers` — what can be connected, and the callback URL\nto register for each.",
-                    "visibility": "public"
-                },
-                {
-                    "error_contract": "native",
-                    "method": "POST",
-                    "operation_id": "secret.startOauth",
-                    "path": "/oauth/start",
-                    "stability": "stable",
-                    "summary": "`POST /<ext>/v1/oauth/start`.",
-                    "visibility": "public"
-                }
-            ],
-            "spec_sha256": "c855f6078dfc25e600930a9d5a9be59db749a65cf8e7b746251fd21fd99604b3"
+            "operations": [],
+            "spec_sha256": "d06763fdf0cfa8d1f7c59d1d83d541273bc7b4357dd6c972a38702a483424cc3"
         },
         {
             "api_version": "v1",
@@ -1765,14 +1711,14 @@
                     "visibility": "public"
                 }
             ],
-            "spec_sha256": "aff59c7f80ccdbbcaf50ca49dc7a8df37bcf3758212d6006befd4caf29693b41"
+            "spec_sha256": "bb9dfea858ca957672aeb7695eeec2165c9bff8a4c90ac60947238622f1944af"
         },
         {
             "api_version": "v1",
             "base_path": "/api/v1",
             "name": "api",
             "operations": [],
-            "spec_sha256": "9c9ca559076804bc42c77d447f811da3d5aa723b4802462ce243509c97767ff1"
+            "spec_sha256": "e16ab58c17f9c666f71254f5e82be6a8d186108ec0e211a900fcd87d9483c9ca"
         },
         {
             "api_version": "v1",
@@ -1807,7 +1753,7 @@
                     "visibility": "public"
                 }
             ],
-            "spec_sha256": "b14b2b8f115f486587ba32f179014f3068c653d20ff661896677bf4fe39a291c"
+            "spec_sha256": "62b973fe61246b278419ec45037d660744e742a9399d7ab07622f799984c951f"
         },
         {
             "api_version": "v1",
@@ -2110,14 +2056,31 @@
                     "stability": "stable",
                     "summary": "Archive a scorer",
                     "visibility": "public"
+                },
+                {
+                    "error_contract": "native",
+                    "method": "GET",
+                    "operation_id": "eval.listScorerVersions",
+                    "path": "/scorers/{scorer_id}/versions",
+                    "stability": "stable",
+                    "summary": "List scorer versions",
+                    "visibility": "public"
+                },
+                {
+                    "error_contract": "native",
+                    "method": "GET",
+                    "operation_id": "eval.getScorerVersion",
+                    "path": "/scorers/{scorer_id}/versions/{version_ordinal}",
+                    "stability": "stable",
+                    "summary": "Get a scorer version",
+                    "visibility": "public"
                 }
             ],
-            "spec_sha256": "bd475939af81ccbc86afeb3946826aad6f293fc48c67d771d04a9fa549da6fd8"
+            "spec_sha256": "4c5c30c5784091e5a8a3dc83792225d25f58c91aabfa2fb8c0ebe9ee315a8ff6"
         }
     ],
     "source": {
-        "fetched_at": "2026-09-17T12:52:47Z",
-        "kind": "deployment",
-        "origin": "https://api.atlan.com"
+        "commit": "ac5dd2693402edc491f0d831fc783037ae5b5046",
+        "kind": "gateway_commit"
     }
 }

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

@@ -99,12 +99,10 @@ export declare class TracesApi extends runtime.BaseAPI {
      */
     agentGetAgentTraceRequestOpts(requestParameters: AgentGetAgentTraceRequest): Promise<runtime.RequestOpts>;
     /**
-     * Use this operation to read one trace for an agent.
      * Read one trace for an agent
      */
     agentGetAgentTraceRaw(requestParameters: AgentGetAgentTraceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TraceDetailView>>;
     /**
-     * Use this operation to read one trace for an agent.
      * Read one trace for an agent
      */
     agentGetAgentTrace(requestParameters: AgentGetAgentTraceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TraceDetailView>;
@@ -113,12 +111,10 @@ export declare class TracesApi extends runtime.BaseAPI {
      */
     agentGetHarnessTraceRequestOpts(requestParameters: AgentGetHarnessTraceRequest): Promise<runtime.RequestOpts>;
     /**
-     * Use this operation to read one trace for a harness.
      * Read one trace for a harness
      */
     agentGetHarnessTraceRaw(requestParameters: AgentGetHarnessTraceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TraceDetailView>>;
     /**
-     * Use this operation to read one trace for a harness.
      * Read one trace for a harness
      */
     agentGetHarnessTrace(requestParameters: AgentGetHarnessTraceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TraceDetailView>;
@@ -127,12 +123,10 @@ export declare class TracesApi extends runtime.BaseAPI {
      */
     agentListAgentTraceSpansRequestOpts(requestParameters: AgentListAgentTraceSpansRequest): Promise<runtime.RequestOpts>;
     /**
-     * Use this operation to list spans in a trace for an agent.
      * List spans in a trace for an agent
      */
     agentListAgentTraceSpansRaw(requestParameters: AgentListAgentTraceSpansRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SpanListEnvelope>>;
     /**
-     * Use this operation to list spans in a trace for an agent.
      * List spans in a trace for an agent
      */
     agentListAgentTraceSpans(requestParameters: AgentListAgentTraceSpansRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SpanListEnvelope>;
@@ -141,12 +135,10 @@ export declare class TracesApi extends runtime.BaseAPI {
      */
     agentListAgentTracesRequestOpts(requestParameters: AgentListAgentTracesRequest): Promise<runtime.RequestOpts>;
     /**
-     * Use this operation to list traces for an agent.
      * List traces for an agent
      */
     agentListAgentTracesRaw(requestParameters: AgentListAgentTracesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TraceListEnvelope>>;
     /**
-     * Use this operation to list traces for an agent.
      * List traces for an agent
      */
     agentListAgentTraces(requestParameters: AgentListAgentTracesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TraceListEnvelope>;
@@ -155,12 +147,10 @@ export declare class TracesApi extends runtime.BaseAPI {
      */
     agentListHarnessTraceSpansRequestOpts(requestParameters: AgentListHarnessTraceSpansRequest): Promise<runtime.RequestOpts>;
     /**
-     * Use this operation to list spans in a trace for a harness.
      * List spans in a trace for a harness
      */
     agentListHarnessTraceSpansRaw(requestParameters: AgentListHarnessTraceSpansRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SpanListEnvelope>>;
     /**
-     * Use this operation to list spans in a trace for a harness.
      * List spans in a trace for a harness
      */
     agentListHarnessTraceSpans(requestParameters: AgentListHarnessTraceSpansRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SpanListEnvelope>;
@@ -169,12 +159,10 @@ export declare class TracesApi extends runtime.BaseAPI {
      */
     agentListHarnessTracesRequestOpts(requestParameters: AgentListHarnessTracesRequest): Promise<runtime.RequestOpts>;
     /**
-     * Use this operation to list traces for a harness.
      * List traces for a harness
      */
     agentListHarnessTracesRaw(requestParameters: AgentListHarnessTracesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TraceListEnvelope>>;
     /**
-     * Use this operation to list traces for a harness.
      * List traces for a harness
      */
     agentListHarnessTraces(requestParameters: AgentListHarnessTracesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TraceListEnvelope>;
@@ -183,12 +171,10 @@ export declare class TracesApi extends runtime.BaseAPI {
      */
     agentListSessionTracesRequestOpts(requestParameters: AgentListSessionTracesRequest): Promise<runtime.RequestOpts>;
     /**
-     * Use this operation to list traces for a session.
      * List traces for a session
      */
     agentListSessionTracesRaw(requestParameters: AgentListSessionTracesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TraceListEnvelope>>;
     /**
-     * Use this operation to list traces for a session.
      * List traces for a session
      */
     agentListSessionTraces(requestParameters: AgentListSessionTracesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TraceListEnvelope>;
@@ -197,12 +183,10 @@ export declare class TracesApi extends runtime.BaseAPI {
      */
     agentQueryAgentTraceStatsRequestOpts(requestParameters: AgentQueryAgentTraceStatsRequest): Promise<runtime.RequestOpts>;
     /**
-     * Use this operation to query trace statistics for an agent.
      * Query trace statistics for an agent
      */
     agentQueryAgentTraceStatsRaw(requestParameters: AgentQueryAgentTraceStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GatewayTraceStatsEnvelope>>;
     /**
-     * Use this operation to query trace statistics for an agent.
      * Query trace statistics for an agent
      */
     agentQueryAgentTraceStats(requestParameters: AgentQueryAgentTraceStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GatewayTraceStatsEnvelope>;
@@ -211,12 +195,10 @@ export declare class TracesApi extends runtime.BaseAPI {
      */
     agentQueryHarnessTraceStatsRequestOpts(requestParameters: AgentQueryHarnessTraceStatsRequest): Promise<runtime.RequestOpts>;
     /**
-     * Use this operation to query trace statistics for a harness.
      * Query trace statistics for a harness
      */
     agentQueryHarnessTraceStatsRaw(requestParameters: AgentQueryHarnessTraceStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GatewayTraceStatsEnvelope>>;
     /**
-     * Use this operation to query trace statistics for a harness.
      * Query trace statistics for a harness
      */
     agentQueryHarnessTraceStats(requestParameters: AgentQueryHarnessTraceStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GatewayTraceStatsEnvelope>;

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

@@ -87,7 +87,6 @@ class TracesApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Use this operation to read one trace for an agent.
      * Read one trace for an agent
      */
     async agentGetAgentTraceRaw(requestParameters, initOverrides) {
@@ -96,7 +95,6 @@ class TracesApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, TraceDetailView_1.TraceDetailViewFromJSON)(jsonValue));
     }
     /**
-     * Use this operation to read one trace for an agent.
      * Read one trace for an agent
      */
     async agentGetAgentTrace(requestParameters, initOverrides) {
@@ -133,7 +131,6 @@ class TracesApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Use this operation to read one trace for a harness.
      * Read one trace for a harness
      */
     async agentGetHarnessTraceRaw(requestParameters, initOverrides) {
@@ -142,7 +139,6 @@ class TracesApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, TraceDetailView_1.TraceDetailViewFromJSON)(jsonValue));
     }
     /**
-     * Use this operation to read one trace for a harness.
      * Read one trace for a harness
      */
     async agentGetHarnessTrace(requestParameters, initOverrides) {
@@ -188,7 +184,6 @@ class TracesApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Use this operation to list spans in a trace for an agent.
      * List spans in a trace for an agent
      */
     async agentListAgentTraceSpansRaw(requestParameters, initOverrides) {
@@ -197,7 +192,6 @@ class TracesApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, SpanListEnvelope_1.SpanListEnvelopeFromJSON)(jsonValue));
     }
     /**
-     * Use this operation to list spans in a trace for an agent.
      * List spans in a trace for an agent
      */
     async agentListAgentTraceSpans(requestParameters, initOverrides) {
@@ -251,7 +245,6 @@ class TracesApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Use this operation to list traces for an agent.
      * List traces for an agent
      */
     async agentListAgentTracesRaw(requestParameters, initOverrides) {
@@ -260,7 +253,6 @@ class TracesApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, TraceListEnvelope_1.TraceListEnvelopeFromJSON)(jsonValue));
     }
     /**
-     * Use this operation to list traces for an agent.
      * List traces for an agent
      */
     async agentListAgentTraces(requestParameters, initOverrides) {
@@ -306,7 +298,6 @@ class TracesApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Use this operation to list spans in a trace for a harness.
      * List spans in a trace for a harness
      */
     async agentListHarnessTraceSpansRaw(requestParameters, initOverrides) {
@@ -315,7 +306,6 @@ class TracesApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, SpanListEnvelope_1.SpanListEnvelopeFromJSON)(jsonValue));
     }
     /**
-     * Use this operation to list spans in a trace for a harness.
      * List spans in a trace for a harness
      */
     async agentListHarnessTraceSpans(requestParameters, initOverrides) {
@@ -369,7 +359,6 @@ class TracesApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Use this operation to list traces for a harness.
      * List traces for a harness
      */
     async agentListHarnessTracesRaw(requestParameters, initOverrides) {
@@ -378,7 +367,6 @@ class TracesApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, TraceListEnvelope_1.TraceListEnvelopeFromJSON)(jsonValue));
     }
     /**
-     * Use this operation to list traces for a harness.
      * List traces for a harness
      */
     async agentListHarnessTraces(requestParameters, initOverrides) {
@@ -429,7 +417,6 @@ class TracesApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Use this operation to list traces for a session.
      * List traces for a session
      */
     async agentListSessionTracesRaw(requestParameters, initOverrides) {
@@ -438,7 +425,6 @@ class TracesApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, TraceListEnvelope_1.TraceListEnvelopeFromJSON)(jsonValue));
     }
     /**
-     * Use this operation to list traces for a session.
      * List traces for a session
      */
     async agentListSessionTraces(requestParameters, initOverrides) {
@@ -500,7 +486,6 @@ class TracesApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Use this operation to query trace statistics for an agent.
      * Query trace statistics for an agent
      */
     async agentQueryAgentTraceStatsRaw(requestParameters, initOverrides) {
@@ -509,7 +494,6 @@ class TracesApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, GatewayTraceStatsEnvelope_1.GatewayTraceStatsEnvelopeFromJSON)(jsonValue));
     }
     /**
-     * Use this operation to query trace statistics for an agent.
      * Query trace statistics for an agent
      */
     async agentQueryAgentTraceStats(requestParameters, initOverrides) {
@@ -571,7 +555,6 @@ class TracesApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Use this operation to query trace statistics for a harness.
      * Query trace statistics for a harness
      */
     async agentQueryHarnessTraceStatsRaw(requestParameters, initOverrides) {
@@ -580,7 +563,6 @@ class TracesApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, GatewayTraceStatsEnvelope_1.GatewayTraceStatsEnvelopeFromJSON)(jsonValue));
     }
     /**
-     * Use this operation to query trace statistics for a harness.
      * Query trace statistics for a harness
      */
     async agentQueryHarnessTraceStats(requestParameters, initOverrides) {

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

@@ -21,13 +21,31 @@ import type { AgentSyncState } from './AgentSyncState';
  */
 export interface AgentAgentArtifactView {
     /**
-     * Value of the `app` field.
+     * The extension that registered the kind.
+     *
+     * `#[serde(default)]` because the registry's **L1** view omits it: `registry_http::artifact`
+     * serves `l1_view` — deliberately kind-polymorphic, deliberately without an extension name —
+     * from ranked search and from archive. Without the default, `flatten` being a whitelist made
+     * the absence a hard decode failure, so *every* extension-scoped `POST …/search` and
+     * `POST …/{id}/archive` answered `500 unexpected registry response shape` the moment a row came
+     * back. Empty result sets decoded fine, which is why it read as working.
+     *
+     * The archive case was the worse of the two: the write had already committed, so the caller saw
+     * a 500 for a request that succeeded.
+     *
+     * Serialization skips it when empty rather than emitting `""`, so a typed view built from an L1
+     * row **omits** the field exactly as the registry's own L1 row does. A client that needs it for
+     * a search hit resolves it from `kind` through `GET /kinds`, which is the same lookup the
+     * registry would do.
+     *
+     * Named `extension` until `apps-2026-09-15-the-extension-tables-are-dropped`; renamed with no
+     * alias, matching the registry's own `ArtifactView`.
      * @type {string}
      * @memberof AgentAgentArtifactView
      */
     app?: string;
     /**
-     * Value of the `artifact_status` field.
+     *
      * @type {string}
      * @memberof AgentAgentArtifactView
      */
@@ -39,31 +57,57 @@ export interface AgentAgentArtifactView {
      */
     commitTs: string;
     /**
-     * Value of the `content_hash_hex` field.
+     * BLAKE3 (hex) of the canonicalised per-kind properties — the artifact's `ETag`, and the
+     * `If-Match` precondition's subject. Named `_hex` for the shipped contract's sake.
+     *
+     * `#[serde(default)]` for the same reason `extension` above has one, and this is the second
+     * time that reason has cost every extension its read surface. The registry types the field
+     * `Option<String>` and **omits** it when the row's `content_hash` is NULL
+     * (`registry_http::ArtifactView`), populating it straight from the nullable column; `flatten`
+     * is a whitelist, so a bare `String` here made that omission a hard decode failure — every
+     * `skill`, `mcp` and `agent` read answered `500 unexpected registry response shape` for a
+     * request the registry had served correctly, while the registry's own `/artifacts` surface
+     * kept working and made it read as an extension bug.
+     *
+     * The absence is legitimate, which is why the fix is here and not a backfill: no write path
+     * leaves the column NULL, but the spanner→postgres mover deliberately **invalidates** every
+     * migrated hash — Spanner hashed `sha256(jcs(metadata))` and this stack hashes
+     * `blake3(write_canonical(metadata))`, so a carried-over digest could never match a
+     * recomputation. A migrated artifact has no hash until its next property write recomputes
+     * one, so a caller that wants a conditional write against it sends `*` or no `If-Match`.
+     *
+     * Skipped on the way out rather than serialized as `null`, so a typed per-kind view renders
+     * exactly the shape the registry served.
      * @type {string}
      * @memberof AgentAgentArtifactView
      */
     contentHashHex?: string;
     /**
-     * Value of the `created_at` field.
+     *
      * @type {string}
      * @memberof AgentAgentArtifactView
      */
     createdAt: string;
     /**
-     * Value of the `created_by` field.
+     *
      * @type {string}
      * @memberof AgentAgentArtifactView
      */
     createdBy: string;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof AgentAgentArtifactView
      */
     description?: string;
     /**
-     * Human-readable name.
+     * Human-readable label. The registry defaults it to `name` when a create
+     * body omits it, so it is always present on read and never null. Edit it
+     * freely without moving `name`.
+     *
+     * `#[serde(default)]` because `flatten` is a whitelist: without it, a view
+     * deserialized from a registry that predates this field would fail rather
+     * than fall back.
      * @type {string}
      * @memberof AgentAgentArtifactView
      */
@@ -75,7 +119,7 @@ export interface AgentAgentArtifactView {
      */
     id: string;
     /**
-     * Value of the `identity` field.
+     *
      * @type {GatewayArtifactIdentityRevealView}
      * @memberof AgentAgentArtifactView
      */
@@ -87,7 +131,7 @@ export interface AgentAgentArtifactView {
      */
     isLatest: boolean;
     /**
-     * Domain discriminator for this resource.
+     *
      * @type {string}
      * @memberof AgentAgentArtifactView
      */
@@ -223,13 +267,13 @@ export interface AgentAgentArtifactView {
      */
     sourceVersion?: string;
     /**
-     * Value of the `updated_at` field.
+     *
      * @type {string}
      * @memberof AgentAgentArtifactView
      */
     updatedAt: string;
     /**
-     * Value of the `updated_by` field.
+     *
      * @type {string}
      * @memberof AgentAgentArtifactView
      */
@@ -373,7 +417,7 @@ export interface AgentAgentArtifactView {
      */
     syncError?: string | null;
     /**
-     * Value of the `sync_state` field.
+     *
      * @type {AgentSyncState}
      * @memberof AgentAgentArtifactView
      */
@@ -395,7 +439,16 @@ export interface AgentAgentArtifactView {
      */
     tools?: Array<GatewayToolRef>;
     /**
-     * Value of the `permissions` field.
+     * The caller's advisory `can_*` capability matrix on a resource.
+     *
+     * Advisory only: it reflects what the caller may do, and is for a UI to gate
+     * controls on. It never authorizes a request — the platform decides that
+     * independently on every call.
+     *
+     * Deliberately an open map rather than a typed struct. The authoritative
+     * permission tables are internal to the platform core, and lifting them into the
+     * SDK would put an authorization decision surface into every extension. An
+     * extension reads this matrix; it never derives one.
      * @type {{ [key: string]: boolean; }}
      * @memberof AgentAgentArtifactView
      */
@@ -418,7 +471,7 @@ export interface AgentAgentArtifactView {
      */
     profileImageUrl?: string | null;
     /**
-     * Value of the `relationships` field.
+     *
      * @type {RegistryRelationshipsView}
      * @memberof AgentAgentArtifactView
      */

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

@@ -82,7 +82,7 @@ export interface AgentAgentCreate {
      */
     sourceVersion?: string;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof AgentAgentCreate
      */