@atlanai/sdk 0.2.4 → 0.3.1

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

@@ -42,7 +42,7 @@ export interface AgentAgentPatch {
      */
     description?: string | null;
     /**
-     * Human-readable name.
+     *
      * @type {string}
      * @memberof AgentAgentPatch
      */
@@ -54,19 +54,19 @@ export interface AgentAgentPatch {
      */
     instructions?: string | null;
     /**
-     * Number of max step.
+     *
      * @type {number}
      * @memberof AgentAgentPatch
      */
     maxStepCount?: number | null;
     /**
-     * Stable identifier of the related model resource.
+     *
      * @type {string}
      * @memberof AgentAgentPatch
      */
     modelId?: string | null;
     /**
-     * Stable machine-readable name.
+     *
      * @type {string}
      * @memberof AgentAgentPatch
      */
@@ -80,7 +80,7 @@ export interface AgentAgentPatch {
      */
     publicUrl?: string | null;
     /**
-     * Value of the `tools` field.
+     *
      * @type {Array<GatewayToolRef>}
      * @memberof AgentAgentPatch
      */

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

@@ -13,19 +13,37 @@ import type { GatewayArtifactIdentityRevealView } from './GatewayArtifactIdentit
 import type { AgentAgentProviderType } from './AgentAgentProviderType';
 import type { RegistryRelationshipsView } from './RegistryRelationshipsView';
 /**
- * Published representation of AgentProviderArtifact.
+ *
  * @export
  * @interface AgentAgentProviderArtifactView
  */
 export interface AgentAgentProviderArtifactView {
     /**
-     * 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 AgentAgentProviderArtifactView
      */
     app?: string;
     /**
-     * Value of the `artifact_status` field.
+     *
      * @type {string}
      * @memberof AgentAgentProviderArtifactView
      */
@@ -37,31 +55,57 @@ export interface AgentAgentProviderArtifactView {
      */
     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 AgentAgentProviderArtifactView
      */
     contentHashHex?: string;
     /**
-     * Value of the `created_at` field.
+     *
      * @type {string}
      * @memberof AgentAgentProviderArtifactView
      */
     createdAt: string;
     /**
-     * Value of the `created_by` field.
+     *
      * @type {string}
      * @memberof AgentAgentProviderArtifactView
      */
     createdBy: string;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof AgentAgentProviderArtifactView
      */
     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 AgentAgentProviderArtifactView
      */
@@ -73,7 +117,7 @@ export interface AgentAgentProviderArtifactView {
      */
     id: string;
     /**
-     * Value of the `identity` field.
+     *
      * @type {GatewayArtifactIdentityRevealView}
      * @memberof AgentAgentProviderArtifactView
      */
@@ -85,7 +129,7 @@ export interface AgentAgentProviderArtifactView {
      */
     isLatest: boolean;
     /**
-     * Domain discriminator for this resource.
+     *
      * @type {string}
      * @memberof AgentAgentProviderArtifactView
      */
@@ -221,13 +265,13 @@ export interface AgentAgentProviderArtifactView {
      */
     sourceVersion?: string;
     /**
-     * Value of the `updated_at` field.
+     *
      * @type {string}
      * @memberof AgentAgentProviderArtifactView
      */
     updatedAt: string;
     /**
-     * Value of the `updated_by` field.
+     *
      * @type {string}
      * @memberof AgentAgentProviderArtifactView
      */
@@ -340,7 +384,22 @@ export interface AgentAgentProviderArtifactView {
      */
     providerType?: AgentAgentProviderType;
     /**
-     * Value of the `permissions` field.
+     *
+     * @type {any}
+     * @memberof AgentAgentProviderArtifactView
+     */
+    skillSync?: any | null;
+    /**
+     * 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 AgentAgentProviderArtifactView
      */
@@ -348,7 +407,7 @@ export interface AgentAgentProviderArtifactView {
         [key: string]: boolean;
     } | null;
     /**
-     * Value of the `relationships` field.
+     *
      * @type {RegistryRelationshipsView}
      * @memberof AgentAgentProviderArtifactView
      */

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

@@ -103,6 +103,7 @@ function AgentAgentProviderArtifactViewFromJSONTyped(json, ignoreDiscriminator)
         'logoUrl': json['logo_url'] === undefined ? undefined : json['logo_url'] === null ? null : json['logo_url'],
         'mcpUrl': json['mcp_url'] === undefined ? undefined : json['mcp_url'] === null ? null : json['mcp_url'],
         'providerType': json['provider_type'] == null ? undefined : (0, AgentAgentProviderType_1.AgentAgentProviderTypeFromJSON)(json['provider_type']),
+        'skillSync': json['skill_sync'] === undefined ? undefined : json['skill_sync'] === null ? null : json['skill_sync'],
         'permissions': json['permissions'] === undefined ? undefined : json['permissions'] === null ? null : json['permissions'],
         'relationships': json['relationships'] === undefined ? undefined : json['relationships'] === null ? null : (0, RegistryRelationshipsView_1.RegistryRelationshipsViewFromJSON)(json['relationships']),
     };
@@ -157,6 +158,7 @@ function AgentAgentProviderArtifactViewToJSONTyped(value, ignoreDiscriminator =
         'logo_url': value['logoUrl'],
         'mcp_url': value['mcpUrl'],
         'provider_type': (0, AgentAgentProviderType_1.AgentAgentProviderTypeToJSON)(value['providerType']),
+        'skill_sync': value['skillSync'],
         'permissions': value['permissions'],
         'relationships': (0, RegistryRelationshipsView_1.RegistryRelationshipsViewToJSON)(value['relationships']),
     };

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

@@ -13,10 +13,10 @@ import type { AgentAgentProviderType } from './AgentAgentProviderType';
 /**
  * The caller-writable surface of a new agent provider.
  *
- * `bootstrap_skill_sync` and `environment_sync` are deliberately absent: both are
- * hook-owned, and a caller
- * who could write it would make every agent pushed to this provider pin a skill
- * of their choosing.
+ * `bootstrap_skill_sync`, `environment_sync` and `skill_sync` are deliberately
+ * absent: all three are hook-owned caches of what this provider already holds,
+ * and a caller who could write one would make every agent pushed to this
+ * provider pin a skill or environment of their choosing.
  * @export
  * @interface AgentAgentProviderCreate
  */
@@ -86,7 +86,7 @@ export interface AgentAgentProviderCreate {
      */
     sourceVersion?: string;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof AgentAgentProviderCreate
      */

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

@@ -11,7 +11,34 @@
  */
 import type { AgentAgentProviderType } from './AgentAgentProviderType';
 /**
- * Published representation of AgentProviderMeta.
+ * The `agent_provider` kind — a customer-owned entry naming where their agents
+ * run, mirroring the secret extension's `secret_provider` and the model
+ * extension's `model_provider`.
+ *
+ * **The kind is catalog-first and delegation is opt-in, per row.** For a `local`
+ * or `custom` provider every field is display or reference material and nothing
+ * is dialed: the gateway catalogs a provider, the customer runs the agent. A
+ * `claude_managed` row is the exception it declares itself to be — it carries
+ * the two connection fields below, and the run-trigger dials it. Which shape a
+ * row has is read off `provider_type` and enforced by the write hook, so a
+ * catalog row can never acquire a credential by accident
+ * (agent-2026-09-15-claude-managed-restored).
+ *
+ * The connection fields are **typed columns**, not a JSON config bag, following
+ * `model_provider`, which promotes its own `secret_ref` and `base_url`.
+ *
+ * **A setting that belongs to one provider type and no other is not a column
+ * here.** A kind gets no JSON spillover under ADR-0035, so a per-runtime field at
+ * the top level is a NULL that `local`, `custom` and every future runtime carry in
+ * someone else's vocabulary. Anything of that shape — the Anthropic workspace a
+ * `claude_managed` key opens, an OpenAI project id — goes in the base row's
+ * `source_metadata`, the free-form bag every artifact already carries, where it is
+ * the customer's record and the gateway reads none of it
+ * (agent-2026-09-17-per-runtime-settings-ride-source-metadata).
+ *
+ * Nothing seeds a provider — which system a tenant runs on is tenant policy, and
+ * a delegating one additionally needs the customer's own API key — so there is
+ * no `system` flag and no system pin.
  * @export
  * @interface AgentAgentProviderMeta
  */
@@ -102,6 +129,12 @@ export interface AgentAgentProviderMeta {
      * @memberof AgentAgentProviderMeta
      */
     providerType: AgentAgentProviderType;
+    /**
+     *
+     * @type {any}
+     * @memberof AgentAgentProviderMeta
+     */
+    skillSync?: any | null;
 }
 /**
  * Check if a given object implements the AgentAgentProviderMeta interface.

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

@@ -44,6 +44,7 @@ function AgentAgentProviderMetaFromJSONTyped(json, ignoreDiscriminator) {
         'logoUrl': json['logo_url'] === undefined ? undefined : json['logo_url'] === null ? null : json['logo_url'],
         'mcpUrl': json['mcp_url'] === undefined ? undefined : json['mcp_url'] === null ? null : json['mcp_url'],
         'providerType': (0, AgentAgentProviderType_1.AgentAgentProviderTypeFromJSON)(json['provider_type']),
+        'skillSync': json['skill_sync'] === undefined ? undefined : json['skill_sync'] === null ? null : json['skill_sync'],
     };
 }
 function AgentAgentProviderMetaToJSON(json) {
@@ -63,5 +64,6 @@ function AgentAgentProviderMetaToJSONTyped(value, ignoreDiscriminator = false) {
         'logo_url': value['logoUrl'],
         'mcp_url': value['mcpUrl'],
         'provider_type': (0, AgentAgentProviderType_1.AgentAgentProviderTypeToJSON)(value['providerType']),
+        'skill_sync': value['skillSync'],
     };
 }

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

@@ -25,7 +25,7 @@ export interface AgentAgentProviderPatch {
      */
     apiKeySecretId?: string | null;
     /**
-     * Value of the `base_url` field.
+     *
      * @type {string}
      * @memberof AgentAgentProviderPatch
      */
@@ -37,25 +37,25 @@ export interface AgentAgentProviderPatch {
      */
     description?: string | null;
     /**
-     * Human-readable name.
+     *
      * @type {string}
      * @memberof AgentAgentProviderPatch
      */
     displayName?: string | null;
     /**
-     * Value of the `docs_url` field.
+     *
      * @type {string}
      * @memberof AgentAgentProviderPatch
      */
     docsUrl?: string | null;
     /**
-     * Value of the `homepage_url` field.
+     *
      * @type {string}
      * @memberof AgentAgentProviderPatch
      */
     homepageUrl?: string | null;
     /**
-     * Value of the `logo_url` field.
+     *
      * @type {string}
      * @memberof AgentAgentProviderPatch
      */
@@ -67,7 +67,7 @@ export interface AgentAgentProviderPatch {
      */
     mcpUrl?: string | null;
     /**
-     * Stable machine-readable name.
+     *
      * @type {string}
      * @memberof AgentAgentProviderPatch
      */

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

@@ -16,7 +16,7 @@
  */
 export interface AgentArtifactAggregateGroup {
     /**
-     * Value of the `key` field.
+     *
      * @type {{ [key: string]: any; }}
      * @memberof AgentArtifactAggregateGroup
      */
@@ -24,7 +24,7 @@ export interface AgentArtifactAggregateGroup {
         [key: string]: any;
     };
     /**
-     * Value of the `metrics` field.
+     *
      * @type {{ [key: string]: any; }}
      * @memberof AgentArtifactAggregateGroup
      */

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

@@ -25,7 +25,7 @@ export interface AgentArtifactAggregateRequest {
      */
     groupBy?: Array<AgentAggregateDimensionInput>;
     /**
-     * Maximum number of items to return.
+     *
      * @type {number}
      * @memberof AgentArtifactAggregateRequest
      */
@@ -37,7 +37,7 @@ export interface AgentArtifactAggregateRequest {
      */
     metrics?: Array<AgentAggregateMetricInput>;
     /**
-     * Number of items to skip before this page.
+     *
      * @type {number}
      * @memberof AgentArtifactAggregateRequest
      */
@@ -49,7 +49,7 @@ export interface AgentArtifactAggregateRequest {
      */
     sort?: Array<string>;
     /**
-     * Stable identifier of the related workspace resource.
+     *
      * @type {string}
      * @memberof AgentArtifactAggregateRequest
      */

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

@@ -18,7 +18,7 @@ import type { GatewayPageMeta } from './GatewayPageMeta';
  */
 export interface AgentArtifactAggregateResponse {
     /**
-     * Value of the `groups` field.
+     *
      * @type {Array<AgentArtifactAggregateGroup>}
      * @memberof AgentArtifactAggregateResponse
      */

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

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

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

@@ -24,13 +24,13 @@ export interface AgentArtifactSearchRequest {
      */
     cursor?: string | null;
     /**
-     * Maximum number of items to return.
+     *
      * @type {number}
      * @memberof AgentArtifactSearchRequest
      */
     limit?: number | null;
     /**
-     * Number of items to skip before this page.
+     *
      * @type {number}
      * @memberof AgentArtifactSearchRequest
      */

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

@@ -22,25 +22,25 @@ export interface AgentCreateAgentFramework400Response {
      */
     code: AgentCreateAgentFramework400ResponseCodeEnum;
     /**
-     * Value of the `detail` field.
+     *
      * @type {string}
      * @memberof AgentCreateAgentFramework400Response
      */
     detail: string;
     /**
-     * Current lifecycle state.
+     *
      * @type {number}
      * @memberof AgentCreateAgentFramework400Response
      */
     status: number;
     /**
-     * Value of the `title` field.
+     *
      * @type {string}
      * @memberof AgentCreateAgentFramework400Response
      */
     title: string;
     /**
-     * Stable identifier of the related trace resource.
+     *
      * @type {string}
      * @memberof AgentCreateAgentFramework400Response
      */

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

@@ -22,25 +22,25 @@ export interface AgentCreateAgentFramework409Response {
      */
     code: AgentCreateAgentFramework409ResponseCodeEnum;
     /**
-     * Value of the `detail` field.
+     *
      * @type {string}
      * @memberof AgentCreateAgentFramework409Response
      */
     detail: string;
     /**
-     * Current lifecycle state.
+     *
      * @type {number}
      * @memberof AgentCreateAgentFramework409Response
      */
     status: number;
     /**
-     * Value of the `title` field.
+     *
      * @type {string}
      * @memberof AgentCreateAgentFramework409Response
      */
     title: string;
     /**
-     * Stable identifier of the related trace resource.
+     *
      * @type {string}
      * @memberof AgentCreateAgentFramework409Response
      */

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

@@ -22,25 +22,25 @@ export interface 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
      */

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

@@ -22,25 +22,25 @@ export interface AgentCreateAgentFramework415Response {
      */
     code: AgentCreateAgentFramework415ResponseCodeEnum;
     /**
-     * Value of the `detail` field.
+     *
      * @type {string}
      * @memberof AgentCreateAgentFramework415Response
      */
     detail: string;
     /**
-     * Current lifecycle state.
+     *
      * @type {number}
      * @memberof AgentCreateAgentFramework415Response
      */
     status: number;
     /**
-     * Value of the `title` field.
+     *
      * @type {string}
      * @memberof AgentCreateAgentFramework415Response
      */
     title: string;
     /**
-     * Stable identifier of the related trace resource.
+     *
      * @type {string}
      * @memberof AgentCreateAgentFramework415Response
      */

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

@@ -22,25 +22,25 @@ export interface AgentCreateAgentFramework422Response {
      */
     code: AgentCreateAgentFramework422ResponseCodeEnum;
     /**
-     * Value of the `detail` field.
+     *
      * @type {string}
      * @memberof AgentCreateAgentFramework422Response
      */
     detail: string;
     /**
-     * Current lifecycle state.
+     *
      * @type {number}
      * @memberof AgentCreateAgentFramework422Response
      */
     status: number;
     /**
-     * Value of the `title` field.
+     *
      * @type {string}
      * @memberof AgentCreateAgentFramework422Response
      */
     title: string;
     /**
-     * Stable identifier of the related trace resource.
+     *
      * @type {string}
      * @memberof AgentCreateAgentFramework422Response
      */

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

@@ -22,25 +22,25 @@ export interface AgentDeleteAgentProfileImage422Response {
      */
     code: AgentDeleteAgentProfileImage422ResponseCodeEnum;
     /**
-     * Value of the `detail` field.
+     *
      * @type {string}
      * @memberof AgentDeleteAgentProfileImage422Response
      */
     detail: string;
     /**
-     * Current lifecycle state.
+     *
      * @type {number}
      * @memberof AgentDeleteAgentProfileImage422Response
      */
     status: number;
     /**
-     * Value of the `title` field.
+     *
      * @type {string}
      * @memberof AgentDeleteAgentProfileImage422Response
      */
     title: string;
     /**
-     * Stable identifier of the related trace resource.
+     *
      * @type {string}
      * @memberof AgentDeleteAgentProfileImage422Response
      */

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

@@ -20,31 +20,31 @@
 export interface AgentEnvironmentPackages {
     [key: string]: any | any;
     /**
-     * Value of the `apt` field.
+     *
      * @type {Array<string>}
      * @memberof AgentEnvironmentPackages
      */
     apt?: Array<string>;
     /**
-     * Value of the `cargo` field.
+     *
      * @type {Array<string>}
      * @memberof AgentEnvironmentPackages
      */
     cargo?: Array<string>;
     /**
-     * Value of the `gem` field.
+     *
      * @type {Array<string>}
      * @memberof AgentEnvironmentPackages
      */
     gem?: Array<string>;
     /**
-     * Value of the `go` field.
+     *
      * @type {Array<string>}
      * @memberof AgentEnvironmentPackages
      */
     go?: Array<string>;
     /**
-     * Value of the `npm` field.
+     *
      * @type {Array<string>}
      * @memberof AgentEnvironmentPackages
      */