@atlanai/sdk 0.2.4 → 0.3.1

package/dist/raw/skill/models/SkillSkillAggregateRequest.d.ts

@@ -24,7 +24,7 @@ export interface SkillSkillAggregateRequest {
      */
     groupBy?: Array<SkillSkillAggregateDimension>;
     /**
-     * Maximum number of items to return.
+     *
      * @type {number}
      * @memberof SkillSkillAggregateRequest
      */
@@ -36,7 +36,7 @@ export interface SkillSkillAggregateRequest {
      */
     metrics?: Array<SkillSkillAggregateMetric>;
     /**
-     * Number of items to skip before this page.
+     *
      * @type {number}
      * @memberof SkillSkillAggregateRequest
      */
@@ -48,7 +48,7 @@ export interface SkillSkillAggregateRequest {
      */
     sort?: Array<string>;
     /**
-     * Stable identifier of the related workspace resource.
+     *
      * @type {string}
      * @memberof SkillSkillAggregateRequest
      */

package/dist/raw/skill/models/SkillSkillAggregateResponse.d.ts

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

package/dist/raw/skill/models/SkillSkillArtifactView.d.ts

@@ -14,19 +14,42 @@ import type { SkillLifecycle } from './SkillLifecycle';
 import type { FileEntry } from './FileEntry';
 import type { RegistryRelationshipsView } from './RegistryRelationshipsView';
 /**
- * Published representation of SkillArtifact.
+ * A skill artifact: the shared L1 envelope plus typed `skill` metadata.
+ *
+ * A concrete struct rather than an alias for `ArtifactView<SkillMeta>` because
+ * utoipa names a schema after its type ident and collapses generic instantiations
+ * onto one component (the reason the registry carries 15 `page_view!` newtypes).
+ * The fields mirror `ArtifactView` exactly, and `From` is the only constructor.
  * @export
  * @interface SkillSkillArtifactView
  */
 export interface SkillSkillArtifactView {
     /**
-     * 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 SkillSkillArtifactView
      */
     app?: string;
     /**
-     * Value of the `artifact_status` field.
+     *
      * @type {string}
      * @memberof SkillSkillArtifactView
      */
@@ -38,31 +61,57 @@ export interface SkillSkillArtifactView {
      */
     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 SkillSkillArtifactView
      */
     contentHashHex?: string;
     /**
-     * Value of the `created_at` field.
+     *
      * @type {string}
      * @memberof SkillSkillArtifactView
      */
     createdAt: string;
     /**
-     * Value of the `created_by` field.
+     *
      * @type {string}
      * @memberof SkillSkillArtifactView
      */
     createdBy: string;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof SkillSkillArtifactView
      */
     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 SkillSkillArtifactView
      */
@@ -74,7 +123,7 @@ export interface SkillSkillArtifactView {
      */
     id: string;
     /**
-     * Value of the `identity` field.
+     *
      * @type {GatewayArtifactIdentityRevealView}
      * @memberof SkillSkillArtifactView
      */
@@ -86,7 +135,7 @@ export interface SkillSkillArtifactView {
      */
     isLatest: boolean;
     /**
-     * Domain discriminator for this resource.
+     *
      * @type {string}
      * @memberof SkillSkillArtifactView
      */
@@ -222,13 +271,13 @@ export interface SkillSkillArtifactView {
      */
     sourceVersion?: string;
     /**
-     * Value of the `updated_at` field.
+     *
      * @type {string}
      * @memberof SkillSkillArtifactView
      */
     updatedAt: string;
     /**
-     * Value of the `updated_by` field.
+     *
      * @type {string}
      * @memberof SkillSkillArtifactView
      */
@@ -435,7 +484,16 @@ export interface SkillSkillArtifactView {
      */
     whenToUse?: string | null;
     /**
-     * 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 SkillSkillArtifactView
      */
@@ -443,7 +501,7 @@ export interface SkillSkillArtifactView {
         [key: string]: boolean;
     } | null;
     /**
-     * Value of the `relationships` field.
+     *
      * @type {RegistryRelationshipsView}
      * @memberof SkillSkillArtifactView
      */

package/dist/raw/skill/models/SkillSkillPatch.d.ts

@@ -17,6 +17,10 @@
  * (`summary`, `license`, the file counts, the digests), and the `files` manifest is
  * hook-owned — an update that touches it is rejected 422. Changing a skill's
  * content means uploading a new version, not patching metadata.
+ *
+ * Provenance fields are also editable when a client needs to bind an existing
+ * skill to a source. They are independent: the server stores exactly the fields
+ * supplied and does not infer a source type from a repository.
  * @export
  * @interface SkillSkillPatch
  */
@@ -34,6 +38,26 @@ export interface SkillSkillPatch {
      * @memberof SkillSkillPatch
      */
     name?: string | null;
+    /**
+     * Associate the current skill head with a repository artifact. The repository
+     * may represent any supported source; this field does not imply `git`.
+     * @type {string}
+     * @memberof SkillSkillPatch
+     */
+    repoId?: string | null;
+    /**
+     * The identity the source system knows this skill by. Omit to leave unchanged.
+     * @type {string}
+     * @memberof SkillSkillPatch
+     */
+    sourceId?: string | null;
+    /**
+     * The source system vocabulary (`git`, `atlan`, `local`, or `external`).
+     * Omit to leave it unchanged.
+     * @type {string}
+     * @memberof SkillSkillPatch
+     */
+    sourceType?: string | null;
 }
 /**
  * Check if a given object implements the SkillSkillPatch interface.

package/dist/raw/skill/models/SkillSkillPatch.js

@@ -34,6 +34,9 @@ function SkillSkillPatchFromJSONTyped(json, ignoreDiscriminator) {
     return {
         'description': json['description'] === undefined ? undefined : json['description'] === null ? null : json['description'],
         'name': json['name'] === undefined ? undefined : json['name'] === null ? null : json['name'],
+        'repoId': json['repo_id'] === undefined ? undefined : json['repo_id'] === null ? null : json['repo_id'],
+        'sourceId': json['source_id'] === undefined ? undefined : json['source_id'] === null ? null : json['source_id'],
+        'sourceType': json['source_type'] === undefined ? undefined : json['source_type'] === null ? null : json['source_type'],
     };
 }
 function SkillSkillPatchToJSON(json) {
@@ -46,5 +49,8 @@ function SkillSkillPatchToJSONTyped(value, ignoreDiscriminator = false) {
     return {
         'description': value['description'],
         'name': value['name'],
+        'repo_id': value['repoId'],
+        'source_id': value['sourceId'],
+        'source_type': value['sourceType'],
     };
 }

package/dist/raw/skill/models/SkillSkillSearchRequest.d.ts

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

package/dist/raw/skill/models/SpanListEnvelope.d.ts

@@ -18,7 +18,7 @@ import type { CursorPage } from './CursorPage';
  */
 export interface SpanListEnvelope {
     /**
-     * Items in this result.
+     *
      * @type {Array<SpanViewDto>}
      * @memberof SpanListEnvelope
      */

package/dist/raw/skill/models/SpanViewDto.d.ts

@@ -25,25 +25,25 @@ export interface SpanViewDto {
      */
     attributes?: any | null;
     /**
-     * Value of the `command_name` field.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
     commandName?: string | null;
     /**
-     * Value of the `cost` field.
+     *
      * @type {CostView}
      * @memberof SpanViewDto
      */
     cost?: CostView | null;
     /**
-     * Duration in milliseconds.
+     *
      * @type {number}
      * @memberof SpanViewDto
      */
     durationMs?: number | null;
     /**
-     * Ended at as Unix epoch seconds.
+     *
      * @type {number}
      * @memberof SpanViewDto
      */
@@ -68,7 +68,7 @@ export interface SpanViewDto {
      */
     input?: any | null;
     /**
-     * Value of the `mcp_server` field.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
@@ -80,13 +80,13 @@ export interface SpanViewDto {
      */
     metadata?: any | null;
     /**
-     * Value of the `model` field.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
     model?: string | null;
     /**
-     * Stable machine-readable name.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
@@ -98,13 +98,13 @@ export interface SpanViewDto {
      */
     output?: any | null;
     /**
-     * Stable identifier of the related parent span resource.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
     parentSpanId?: string | null;
     /**
-     * Value of the `provider` field.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
@@ -117,49 +117,49 @@ export interface SpanViewDto {
      */
     scoreName?: string | null;
     /**
-     * Value of the `score_value` field.
+     *
      * @type {number}
      * @memberof SpanViewDto
      */
     scoreValue?: number | null;
     /**
-     * Stable identifier of the related scorer resource.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
     scorerId?: string | null;
     /**
-     * Value of the `scorer_version` field.
+     *
      * @type {number}
      * @memberof SpanViewDto
      */
     scorerVersion?: number | null;
     /**
-     * Value of the `service_name` field.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
     serviceName?: string | null;
     /**
-     * Value of the `skill_name` field.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
     skillName?: string | null;
     /**
-     * Value of the `skill_version` field.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
     skillVersion?: string | null;
     /**
-     * Stable identifier of the related span resource.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
     spanId: string;
     /**
-     * Value of the `span_kind` field.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
@@ -171,37 +171,37 @@ export interface SpanViewDto {
      */
     spanStatus: TraceStatus;
     /**
-     * Value of the `span_type` field.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
     spanType: string;
     /**
-     * Started at as Unix epoch seconds.
+     *
      * @type {number}
      * @memberof SpanViewDto
      */
     startedAtUnixSeconds: number;
     /**
-     * Value of the `tool_name` field.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
     toolName?: string | null;
     /**
-     * Value of the `tool_type` field.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
     toolType?: string | null;
     /**
-     * Stable identifier of the related trace resource.
+     *
      * @type {string}
      * @memberof SpanViewDto
      */
     traceId: string;
     /**
-     * Value of the `usage` field.
+     *
      * @type {UsageView}
      * @memberof SpanViewDto
      */

package/dist/raw/skill/models/TraceDetailView.d.ts

@@ -27,25 +27,25 @@ export interface TraceDetailView {
      */
     attributes?: any | null;
     /**
-     * Duration in milliseconds.
+     *
      * @type {number}
      * @memberof TraceDetailView
      */
     durationMs?: number;
     /**
-     * Ended at as Unix epoch seconds.
+     *
      * @type {number}
      * @memberof TraceDetailView
      */
     endedAtUnixSeconds?: number;
     /**
-     * Whether complete.
+     *
      * @type {boolean}
      * @memberof TraceDetailView
      */
     isComplete: boolean;
     /**
-     * Value of the `match_confidence` field.
+     *
      * @type {string}
      * @memberof TraceDetailView
      */
@@ -57,43 +57,43 @@ export interface TraceDetailView {
      */
     metadata?: any | null;
     /**
-     * Value of the `models` field.
+     *
      * @type {Array<string>}
      * @memberof TraceDetailView
      */
     models?: Array<string>;
     /**
-     * Value of the `providers` field.
+     *
      * @type {Array<string>}
      * @memberof TraceDetailView
      */
     providers?: Array<string>;
     /**
-     * Stable identifier of the related root span resource.
+     *
      * @type {string}
      * @memberof TraceDetailView
      */
     rootSpanId?: string;
     /**
-     * Value of the `root_span_name` field.
+     *
      * @type {string}
      * @memberof TraceDetailView
      */
     rootSpanName?: string;
     /**
-     * Value of the `run_status` field.
+     *
      * @type {string}
      * @memberof TraceDetailView
      */
     runStatus?: string;
     /**
-     * Value of the `service_name` field.
+     *
      * @type {string}
      * @memberof TraceDetailView
      */
     serviceName?: string;
     /**
-     * Started at as Unix epoch seconds.
+     *
      * @type {number}
      * @memberof TraceDetailView
      */
@@ -105,13 +105,13 @@ export interface TraceDetailView {
      */
     summary: TraceSummaryStats;
     /**
-     * Value of the `title` field.
+     *
      * @type {string}
      * @memberof TraceDetailView
      */
     title?: string;
     /**
-     * Stable identifier of the related trace resource.
+     *
      * @type {string}
      * @memberof TraceDetailView
      */
@@ -123,7 +123,7 @@ export interface TraceDetailView {
      */
     traceStatus: TraceStatus;
     /**
-     * Stable identifier of the related user resource.
+     *
      * @type {string}
      * @memberof TraceDetailView
      */
@@ -170,7 +170,7 @@ export interface TraceDetailView {
      */
     output?: any | null;
     /**
-     * Value of the `parent` field.
+     *
      * @type {TraceParentView}
      * @memberof TraceDetailView
      */

package/dist/raw/skill/models/TraceLinks.d.ts

@@ -17,19 +17,19 @@
  */
 export interface TraceLinks {
     /**
-     * Value of the `logs` field.
+     *
      * @type {string}
      * @memberof TraceLinks
      */
     logs: string;
     /**
-     * Value of the `spans` field.
+     *
      * @type {string}
      * @memberof TraceLinks
      */
     spans: string;
     /**
-     * Value of the `timeline` field.
+     *
      * @type {string}
      * @memberof TraceLinks
      */

package/dist/raw/skill/models/TraceListEnvelope.d.ts

@@ -25,7 +25,7 @@ export interface TraceListEnvelope {
      */
     access: AccessView;
     /**
-     * Items in this result.
+     *
      * @type {Array<TraceSummaryView>}
      * @memberof TraceListEnvelope
      */

package/dist/raw/skill/models/TraceParentView.d.ts

@@ -16,43 +16,43 @@
  */
 export interface TraceParentView {
     /**
-     * Value of the `confidence` field.
+     *
      * @type {string}
      * @memberof TraceParentView
      */
     confidence?: string | null;
     /**
-     * Value of the `identity_version` field.
+     *
      * @type {string}
      * @memberof TraceParentView
      */
     identityVersion?: string | null;
     /**
-     * Whether available.
+     *
      * @type {boolean}
      * @memberof TraceParentView
      */
     isAvailable: boolean;
     /**
-     * Value of the `relationship` field.
+     *
      * @type {string}
      * @memberof TraceParentView
      */
     relationship?: string | null;
     /**
-     * Stable identifier of the related session resource.
+     *
      * @type {string}
      * @memberof TraceParentView
      */
     sessionId?: string | null;
     /**
-     * Stable identifier of the related trace resource.
+     *
      * @type {string}
      * @memberof TraceParentView
      */
     traceId: string;
     /**
-     * Stable identifier of the related workspace resource.
+     *
      * @type {string}
      * @memberof TraceParentView
      */