@atlanai/sdk 0.2.4 → 0.3.1

package/dist/raw/eval/models/EvalPatchDataset412Response.d.ts

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

package/dist/raw/eval/models/EvalRecordSource.d.ts

@@ -10,7 +10,20 @@
  * Do not edit the class manually.
  */
 /**
- * Published representation of RecordSource.
+ * Where a dataset record came from. Promoted to the `source_kind` `CHECK`
+ * column; doc-comment-free per variant.
+ *
+ * `session` resolves against the gateway's own `session` artifacts;
+ * `trace` names an OTel trace id, which is a ClickHouse row rather than a
+ * registry artifact — which is exactly why provenance is a column pair and not
+ * an edge (an edge cannot point at a non-artifact).
+ *
+ * `external` is the same shape one step further out: the row was curated in a
+ * system this gateway does not host, so `source_ref` is a URI naming it
+ * (`braintrust://<dataset_id>/<row_id>`) and nothing here can resolve it. It
+ * exists because the alternative is worse — an imported corpus filed as
+ * `manual` claims a human typed it here, which is the provenance question
+ * answered wrongly rather than left open.
  * @export
  * @enum {string}
  */

package/dist/raw/eval/models/EvalRecordSource.js

@@ -20,7 +20,20 @@ exports.EvalRecordSourceFromJSONTyped = EvalRecordSourceFromJSONTyped;
 exports.EvalRecordSourceToJSON = EvalRecordSourceToJSON;
 exports.EvalRecordSourceToJSONTyped = EvalRecordSourceToJSONTyped;
 /**
- * Published representation of RecordSource.
+ * Where a dataset record came from. Promoted to the `source_kind` `CHECK`
+ * column; doc-comment-free per variant.
+ *
+ * `session` resolves against the gateway's own `session` artifacts;
+ * `trace` names an OTel trace id, which is a ClickHouse row rather than a
+ * registry artifact — which is exactly why provenance is a column pair and not
+ * an edge (an edge cannot point at a non-artifact).
+ *
+ * `external` is the same shape one step further out: the row was curated in a
+ * system this gateway does not host, so `source_ref` is a URI naming it
+ * (`braintrust://<dataset_id>/<row_id>`) and nothing here can resolve it. It
+ * exists because the alternative is worse — an imported corpus filed as
+ * `manual` claims a human typed it here, which is the provenance question
+ * answered wrongly rather than left open.
  * @export
  * @enum {string}
  */

package/dist/raw/eval/models/EvalScorerArtifactView.d.ts

@@ -14,19 +14,37 @@ import type { EvalScorerKind } from './EvalScorerKind';
 import type { EvalScorerScope } from './EvalScorerScope';
 import type { RegistryRelationshipsView } from './RegistryRelationshipsView';
 /**
- * Published representation of ScorerArtifact.
+ *
  * @export
  * @interface EvalScorerArtifactView
  */
 export interface EvalScorerArtifactView {
     /**
-     * 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 EvalScorerArtifactView
      */
     app?: string;
     /**
-     * Value of the `artifact_status` field.
+     *
      * @type {string}
      * @memberof EvalScorerArtifactView
      */
@@ -38,31 +56,57 @@ export interface EvalScorerArtifactView {
      */
     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 EvalScorerArtifactView
      */
     contentHashHex?: string;
     /**
-     * Value of the `created_at` field.
+     *
      * @type {string}
      * @memberof EvalScorerArtifactView
      */
     createdAt: string;
     /**
-     * Value of the `created_by` field.
+     *
      * @type {string}
      * @memberof EvalScorerArtifactView
      */
     createdBy: string;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof EvalScorerArtifactView
      */
     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 EvalScorerArtifactView
      */
@@ -74,7 +118,7 @@ export interface EvalScorerArtifactView {
      */
     id: string;
     /**
-     * Value of the `identity` field.
+     *
      * @type {GatewayArtifactIdentityRevealView}
      * @memberof EvalScorerArtifactView
      */
@@ -86,7 +130,7 @@ export interface EvalScorerArtifactView {
      */
     isLatest: boolean;
     /**
-     * Domain discriminator for this resource.
+     *
      * @type {string}
      * @memberof EvalScorerArtifactView
      */
@@ -222,13 +266,13 @@ export interface EvalScorerArtifactView {
      */
     sourceVersion?: string;
     /**
-     * Value of the `updated_at` field.
+     *
      * @type {string}
      * @memberof EvalScorerArtifactView
      */
     updatedAt: string;
     /**
-     * Value of the `updated_by` field.
+     *
      * @type {string}
      * @memberof EvalScorerArtifactView
      */
@@ -289,7 +333,16 @@ export interface EvalScorerArtifactView {
         [key: string]: any;
     } | 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 EvalScorerArtifactView
      */
@@ -297,7 +350,7 @@ export interface EvalScorerArtifactView {
         [key: string]: boolean;
     } | null;
     /**
-     * Value of the `relationships` field.
+     *
      * @type {RegistryRelationshipsView}
      * @memberof EvalScorerArtifactView
      */

package/dist/raw/eval/models/EvalScorerCreate.d.ts

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

package/dist/raw/eval/models/EvalScorerPatch.d.ts

@@ -16,15 +16,10 @@
  * identity, and changing them on the same line would reinterpret every score
  * citing it (the update hook pins them regardless).
  *
- * **Editing `spec`/`outputs` does not currently mint a version.** The plane's
- * PATCH edits the head in place — `version_ordinal` stays where it was, and
- * only source-reconcile appends versions today — so a rubric edit silently
- * changes what every score pinned to that ordinal actually cited. The pin is
- * therefore honest about *which ordinal* judged, but that ordinal's content is
- * mutable, which is not the guarantee this kind is supposed to give. Until
- * update-mints-version lands, treat a material rubric change as a **new
- * scorer**, not a patch. Tracked as an ADR; the alternative fix is to refuse
- * `spec`/`outputs` edits outright.
+ * A scorer PATCH appends an immutable version. Existing score spans continue
+ * to resolve the exact ordinal they cite, while new evaluations use the new
+ * head. This applies to display-only edits too: one write has one unambiguous
+ * historical meaning.
  * @export
  * @interface EvalScorerPatch
  */
@@ -36,13 +31,13 @@ export interface EvalScorerPatch {
      */
     description?: string | null;
     /**
-     * Human-readable name.
+     *
      * @type {string}
      * @memberof EvalScorerPatch
      */
     displayName?: string | null;
     /**
-     * Stable machine-readable name.
+     *
      * @type {string}
      * @memberof EvalScorerPatch
      */

package/dist/raw/eval/models/GatewayArtifactBase.d.ts

@@ -11,19 +11,44 @@
  */
 import type { GatewayArtifactIdentityRevealView } from './GatewayArtifactIdentityRevealView';
 /**
- * Published representation of ArtifactBase.
+ * The generic L1 artifact envelope — every field the registry stores about an
+ * artifact independent of its kind. Composed into a typed per-kind view with
+ * `#[serde(flatten)]`; see [`ArtifactView`].
+ *
+ * Null-vs-omitted behaviour is normative and mirrors what the registry's write
+ * and read paths already emit: `description` always serializes (as `null` when
+ * unset), every other optional is omitted when unset. Changing one of these
+ * attributes changes the wire contract of every kind at once.
  * @export
  * @interface GatewayArtifactBase
  */
 export interface GatewayArtifactBase {
     /**
-     * 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 GatewayArtifactBase
      */
     app?: string;
     /**
-     * Value of the `artifact_status` field.
+     *
      * @type {string}
      * @memberof GatewayArtifactBase
      */
@@ -35,31 +60,57 @@ export interface GatewayArtifactBase {
      */
     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 GatewayArtifactBase
      */
     contentHashHex?: string | null;
     /**
-     * Value of the `created_at` field.
+     *
      * @type {string}
      * @memberof GatewayArtifactBase
      */
     createdAt: string;
     /**
-     * Value of the `created_by` field.
+     *
      * @type {string}
      * @memberof GatewayArtifactBase
      */
     createdBy: string;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof GatewayArtifactBase
      */
     description?: string | null;
     /**
-     * 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 GatewayArtifactBase
      */
@@ -71,7 +122,7 @@ export interface GatewayArtifactBase {
      */
     id: string;
     /**
-     * Value of the `identity` field.
+     *
      * @type {GatewayArtifactIdentityRevealView}
      * @memberof GatewayArtifactBase
      */
@@ -83,7 +134,7 @@ export interface GatewayArtifactBase {
      */
     isLatest: boolean;
     /**
-     * Domain discriminator for this resource.
+     *
      * @type {string}
      * @memberof GatewayArtifactBase
      */
@@ -219,13 +270,13 @@ export interface GatewayArtifactBase {
      */
     sourceVersion?: string | null;
     /**
-     * Value of the `updated_at` field.
+     *
      * @type {string}
      * @memberof GatewayArtifactBase
      */
     updatedAt: string;
     /**
-     * Value of the `updated_by` field.
+     *
      * @type {string}
      * @memberof GatewayArtifactBase
      */

package/dist/raw/eval/models/GatewayPageMeta.d.ts

@@ -18,19 +18,19 @@
  */
 export interface GatewayPageMeta {
     /**
-     * Maximum number of items to return.
+     *
      * @type {number}
      * @memberof GatewayPageMeta
      */
     limit: number;
     /**
-     * Number of items to skip before this page.
+     *
      * @type {number}
      * @memberof GatewayPageMeta
      */
     offset: number;
     /**
-     * Value of the `total` field.
+     *
      * @type {number}
      * @memberof GatewayPageMeta
      */

package/dist/raw/eval/models/GatewayTraceStatsDataOneOf.d.ts

@@ -17,13 +17,13 @@ import type { GatewayTraceStatsScalarResult } from './GatewayTraceStatsScalarRes
  */
 export interface GatewayTraceStatsDataOneOf {
     /**
-     * Value of the `request_type` field.
+     *
      * @type {GatewayTraceStatsDataOneOfRequestTypeEnum}
      * @memberof GatewayTraceStatsDataOneOf
      */
     requestType: GatewayTraceStatsDataOneOfRequestTypeEnum;
     /**
-     * Value of the `results` field.
+     *
      * @type {Array<GatewayTraceStatsScalarResult>}
      * @memberof GatewayTraceStatsDataOneOf
      */

package/dist/raw/eval/models/GatewayTraceStatsDataOneOf1.d.ts

@@ -18,19 +18,19 @@ import type { GatewayTraceStatsTableRow } from './GatewayTraceStatsTableRow';
  */
 export interface GatewayTraceStatsDataOneOf1 {
     /**
-     * Value of the `columns` field.
+     *
      * @type {Array<GatewayTraceStatsTableColumn>}
      * @memberof GatewayTraceStatsDataOneOf1
      */
     columns: Array<GatewayTraceStatsTableColumn>;
     /**
-     * Value of the `request_type` field.
+     *
      * @type {GatewayTraceStatsDataOneOf1RequestTypeEnum}
      * @memberof GatewayTraceStatsDataOneOf1
      */
     requestType: GatewayTraceStatsDataOneOf1RequestTypeEnum;
     /**
-     * Value of the `rows` field.
+     *
      * @type {Array<GatewayTraceStatsTableRow>}
      * @memberof GatewayTraceStatsDataOneOf1
      */

package/dist/raw/eval/models/GatewayTraceStatsDataOneOf2.d.ts

@@ -17,13 +17,13 @@ import type { GatewayTraceStatsSeries } from './GatewayTraceStatsSeries';
  */
 export interface GatewayTraceStatsDataOneOf2 {
     /**
-     * Value of the `request_type` field.
+     *
      * @type {GatewayTraceStatsDataOneOf2RequestTypeEnum}
      * @memberof GatewayTraceStatsDataOneOf2
      */
     requestType: GatewayTraceStatsDataOneOf2RequestTypeEnum;
     /**
-     * Value of the `series` field.
+     *
      * @type {Array<GatewayTraceStatsSeries>}
      * @memberof GatewayTraceStatsDataOneOf2
      */

package/dist/raw/eval/models/GatewayTraceStatsEnvelope.d.ts

@@ -22,7 +22,7 @@ import type { GatewayTraceStatsComparison } from './GatewayTraceStatsComparison'
  */
 export interface GatewayTraceStatsEnvelope {
     /**
-     * Value of the `comparison` field.
+     *
      * @type {GatewayTraceStatsComparison}
      * @memberof GatewayTraceStatsEnvelope
      */

package/dist/raw/eval/models/GatewayTraceStatsMeta.d.ts

@@ -27,13 +27,13 @@ export interface GatewayTraceStatsMeta {
      */
     asOfUnixSeconds?: number | null;
     /**
-     * Non-fatal warnings produced while serving the request.
+     *
      * @type {Array<string>}
      * @memberof GatewayTraceStatsMeta
      */
     warnings?: Array<string>;
     /**
-     * Value of the `window` field.
+     *
      * @type {GatewayTraceStatsWindow}
      * @memberof GatewayTraceStatsMeta
      */

package/dist/raw/eval/models/GatewayTraceStatsPanelQuery.d.ts

@@ -21,7 +21,7 @@ import type { GatewayTraceStatsGroupBy } from './GatewayTraceStatsGroupBy';
  */
 export interface GatewayTraceStatsPanelQuery {
     /**
-     * Predicates used to restrict the returned data.
+     *
      * @type {Array<GatewayTraceStatsFilter>}
      * @memberof GatewayTraceStatsPanelQuery
      */
@@ -34,7 +34,7 @@ export interface GatewayTraceStatsPanelQuery {
      */
     groupBy?: Array<GatewayTraceStatsGroupBy>;
     /**
-     * Maximum number of items to return.
+     *
      * @type {number}
      * @memberof GatewayTraceStatsPanelQuery
      */
@@ -53,7 +53,7 @@ export interface GatewayTraceStatsPanelQuery {
      */
     name: string;
     /**
-     * Value of the `order` field.
+     *
      * @type {GatewayTraceStatsOrder}
      * @memberof GatewayTraceStatsPanelQuery
      */

package/dist/raw/eval/models/GatewayTraceStatsRequest.d.ts

@@ -24,13 +24,13 @@ import type { GatewayTraceStatsRequestType } from './GatewayTraceStatsRequestTyp
  */
 export interface GatewayTraceStatsRequest {
     /**
-     * Value of the `bucket` field.
+     *
      * @type {GatewayTraceStatsBucket}
      * @memberof GatewayTraceStatsRequest
      */
     bucket?: GatewayTraceStatsBucket | null;
     /**
-     * Value of the `compare` field.
+     *
      * @type {GatewayTraceStatsCompareMode}
      * @memberof GatewayTraceStatsRequest
      */

package/dist/raw/eval/models/GatewayTraceStatsScalarResult.d.ts

@@ -23,13 +23,13 @@ export interface GatewayTraceStatsScalarResult {
      */
     measure: GatewayTraceStatsMeasure;
     /**
-     * Value of the `query_name` field.
+     *
      * @type {string}
      * @memberof GatewayTraceStatsScalarResult
      */
     queryName: string;
     /**
-     * Value of the `unit` field.
+     *
      * @type {string}
      * @memberof GatewayTraceStatsScalarResult
      */

package/dist/raw/eval/models/GatewayTraceStatsSeries.d.ts

@@ -24,19 +24,19 @@ export interface GatewayTraceStatsSeries {
      */
     measure: GatewayTraceStatsMeasure;
     /**
-     * Value of the `points` field.
+     *
      * @type {Array<GatewayTraceStatsSeriesPoint>}
      * @memberof GatewayTraceStatsSeries
      */
     points: Array<GatewayTraceStatsSeriesPoint>;
     /**
-     * Value of the `query_name` field.
+     *
      * @type {string}
      * @memberof GatewayTraceStatsSeries
      */
     queryName: string;
     /**
-     * Value of the `unit` field.
+     *
      * @type {string}
      * @memberof GatewayTraceStatsSeries
      */

package/dist/raw/eval/models/GatewayTraceStatsSeriesPoint.d.ts

@@ -16,13 +16,13 @@
  */
 export interface GatewayTraceStatsSeriesPoint {
     /**
-     * Timestamp as Unix epoch seconds.
+     *
      * @type {number}
      * @memberof GatewayTraceStatsSeriesPoint
      */
     timestampUnixSeconds: number;
     /**
-     * Value carried by this entry.
+     *
      * @type {number}
      * @memberof GatewayTraceStatsSeriesPoint
      */

package/dist/raw/eval/models/GatewayTraceStatsTableColumn.d.ts

@@ -23,13 +23,13 @@ export interface GatewayTraceStatsTableColumn {
      */
     columnType: GatewayTraceStatsTableColumnType;
     /**
-     * Stable machine-readable name.
+     *
      * @type {string}
      * @memberof GatewayTraceStatsTableColumn
      */
     name: string;
     /**
-     * Value of the `unit` field.
+     *
      * @type {string}
      * @memberof GatewayTraceStatsTableColumn
      */