@atlanai/sdk 0.2.4 → 0.3.1

package/dist/raw/registry/models/RegistryPageMeta.d.ts

@@ -10,7 +10,26 @@
  * Do not edit the class manually.
  */
 /**
- * Published representation of PageMeta.
+ * The window a list response was served under.
+ *
+ * `{items, page: {limit, offset, total}}` is the repo's one native-response envelope — ADR-0054
+ * and `0005#sdk-2026-06-30-native-response-envelope` — and every extension already returns it
+ * through `extension_sdk_http::http::Page`. This registry served a **flat** `{items, limit,
+ * offset, total}` instead, which no decision record ever chose: it was drift, and it made the
+ * registry the only surface in the process a generic client could not read.
+ *
+ * Named `registry::PageMeta` so a generated client sees the same component the Spanner registry
+ * published, and so this and the SDK's `gateway::PageMeta` stay distinguishable — they differ in
+ * exactly one way, below.
+ *
+ * **`total` is optional here and required in the SDK's.** This surface takes `count=false`, and
+ * "not counted" and "none" are different answers; an extension list has no such parameter. That
+ * one field is why this is a second type rather than a re-export.
+ *
+ * **There is no `next_cursor`.** The Spanner `PageMeta` carried one for `POST /search` alone;
+ * this stack removed that cursor in favour of `limit`/`offset`
+ * (`0006#search-2026-08-20-ranked-discovery-on-postgres`), so a field that would be `null` on
+ * every response of every surface is not carried.
  * @export
  * @interface RegistryPageMeta
  */

package/dist/raw/registry/models/RegistryQueryOrganisationTraceStats403Response.d.ts

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

package/dist/raw/registry/models/RegistryQueryOrganisationTraceStats503Response.d.ts

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

package/dist/raw/registry/models/RegistryRevokeOwnSessions400Response.d.ts

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

package/dist/raw/registry/models/RegistryRevokeOwnSessions415Response.d.ts

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

package/dist/raw/registry/models/RegistrySearch503Response.d.ts

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

package/dist/raw/registry/models/RegistryWhoami503Response.d.ts

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

package/dist/raw/registry/models/RegistryWorkspaceView.d.ts

@@ -11,7 +11,7 @@
  */
 import type { RegistryWorkspacePluginRef } from './RegistryWorkspacePluginRef';
 /**
- * Published representation of Workspace.
+ *
  * @export
  * @interface RegistryWorkspaceView
  */
@@ -43,37 +43,37 @@ export interface RegistryWorkspaceView {
         [key: string]: number;
     };
     /**
-     * Value of the `created_at` field.
+     *
      * @type {string}
      * @memberof RegistryWorkspaceView
      */
     createdAt: string;
     /**
-     * Value of the `created_by` field.
+     *
      * @type {string}
      * @memberof RegistryWorkspaceView
      */
     createdBy: string;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof RegistryWorkspaceView
      */
     description?: string | null;
     /**
-     * Human-readable name.
+     *
      * @type {string}
      * @memberof RegistryWorkspaceView
      */
     displayName: string;
     /**
-     * Stable identifier of this resource.
+     *
      * @type {string}
      * @memberof RegistryWorkspaceView
      */
     id: string;
     /**
-     * Domain discriminator for this resource.
+     *
      * @type {string}
      * @memberof RegistryWorkspaceView
      */
@@ -91,7 +91,7 @@ export interface RegistryWorkspaceView {
      */
     memberCount?: number | null;
     /**
-     * Stable machine-readable name.
+     *
      * @type {string}
      * @memberof RegistryWorkspaceView
      */
@@ -116,7 +116,16 @@ export interface RegistryWorkspaceView {
      */
     parentId?: 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 RegistryWorkspaceView
      */
@@ -124,25 +133,25 @@ export interface RegistryWorkspaceView {
         [key: string]: boolean;
     } | null;
     /**
-     * Value of the `plugin` field.
+     *
      * @type {RegistryWorkspacePluginRef}
      * @memberof RegistryWorkspaceView
      */
     plugin?: RegistryWorkspacePluginRef | null;
     /**
-     * Stable identifier of the related root workspace resource.
+     *
      * @type {string}
      * @memberof RegistryWorkspaceView
      */
     rootWorkspaceId: string;
     /**
-     * Value of the `updated_at` field.
+     *
      * @type {string}
      * @memberof RegistryWorkspaceView
      */
     updatedAt: string;
     /**
-     * Value of the `updated_by` field.
+     *
      * @type {string}
      * @memberof RegistryWorkspaceView
      */

package/dist/raw/registry/models/RelationshipDto.d.ts

@@ -38,7 +38,7 @@ export interface RelationshipDto {
      */
     direction: string;
     /**
-     * Value of the `from` field.
+     *
      * @type {EdgeTarget}
      * @memberof RelationshipDto
      */
@@ -75,7 +75,7 @@ export interface RelationshipDto {
      */
     role?: string | null;
     /**
-     * Value of the `to` field.
+     *
      * @type {EdgeTarget}
      * @memberof RelationshipDto
      */

package/dist/raw/registry/models/ReleaseDto.d.ts

@@ -16,19 +16,19 @@
  */
 export interface ReleaseDto {
     /**
-     * Stable identifier of the related artifact resource.
+     *
      * @type {string}
      * @memberof ReleaseDto
      */
     artifactId: string;
     /**
-     * Value of the `channel` field.
+     *
      * @type {string}
      * @memberof ReleaseDto
      */
     channel: string;
     /**
-     * Value of the `content_hash` field.
+     *
      * @type {string}
      * @memberof ReleaseDto
      */
@@ -40,31 +40,31 @@ export interface ReleaseDto {
      */
     createdAt: string;
     /**
-     * Value of the `created_by` field.
+     *
      * @type {string}
      * @memberof ReleaseDto
      */
     createdBy: string;
     /**
-     * Whether current.
+     *
      * @type {boolean}
      * @memberof ReleaseDto
      */
     isCurrent: boolean;
     /**
-     * Domain discriminator for this resource.
+     *
      * @type {string}
      * @memberof ReleaseDto
      */
     kind: string;
     /**
-     * Value of the `notes` field.
+     *
      * @type {string}
      * @memberof ReleaseDto
      */
     notes?: string | null;
     /**
-     * Value of the `reason` field.
+     *
      * @type {string}
      * @memberof ReleaseDto
      */
@@ -76,7 +76,7 @@ export interface ReleaseDto {
      */
     releaseId: string;
     /**
-     * Value of the `release_status` field.
+     *
      * @type {string}
      * @memberof ReleaseDto
      */
@@ -101,13 +101,13 @@ export interface ReleaseDto {
      */
     versionOrdinal?: number | null;
     /**
-     * Value of the `visibility` field.
+     *
      * @type {string}
      * @memberof ReleaseDto
      */
     visibility: string;
     /**
-     * Stable identifier of the related workspace resource.
+     *
      * @type {string}
      * @memberof ReleaseDto
      */

package/dist/raw/registry/models/ReleasePage.d.ts

@@ -12,7 +12,7 @@
 import type { RegistryPageMeta } from './RegistryPageMeta';
 import type { ReleaseDto } from './ReleaseDto';
 /**
- * Paginated collection of Release resources.
+ *
  * @export
  * @interface ReleasePage
  */

package/dist/raw/registry/models/ReleasePolicyDto.d.ts

@@ -23,13 +23,13 @@ export interface ReleasePolicyDto {
      */
     allowPublic: boolean;
     /**
-     * Whether version override.
+     *
      * @type {boolean}
      * @memberof ReleasePolicyDto
      */
     allowVersionOverride: boolean;
     /**
-     * Value of the `channel` field.
+     *
      * @type {string}
      * @memberof ReleasePolicyDto
      */
@@ -47,7 +47,7 @@ export interface ReleasePolicyDto {
      */
     mode: string;
     /**
-     * Value of the `require_checks` field.
+     *
      * @type {boolean}
      * @memberof ReleasePolicyDto
      */
@@ -60,7 +60,7 @@ export interface ReleasePolicyDto {
      */
     resolvedFrom: string;
     /**
-     * Stable identifier of the related workspace resource.
+     *
      * @type {string}
      * @memberof ReleasePolicyDto
      */

package/dist/raw/registry/models/RepoDto.d.ts

@@ -24,37 +24,37 @@ export interface RepoDto {
      */
     createdAt: string;
     /**
-     * Value of the `created_by` field.
+     *
      * @type {string}
      * @memberof RepoDto
      */
     createdBy: string;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof RepoDto
      */
     description?: string | null;
     /**
-     * Human-readable name.
+     *
      * @type {string}
      * @memberof RepoDto
      */
     displayName: string;
     /**
-     * Stable identifier of this resource.
+     *
      * @type {string}
      * @memberof RepoDto
      */
     id: string;
     /**
-     * Stable machine-readable name.
+     *
      * @type {string}
      * @memberof RepoDto
      */
     name: string;
     /**
-     * Stable identifier of the related project resource.
+     *
      * @type {string}
      * @memberof RepoDto
      */
@@ -76,31 +76,31 @@ export interface RepoDto {
      */
     sourceMetadata?: object | null;
     /**
-     * Value of the `source_type` field.
+     *
      * @type {string}
      * @memberof RepoDto
      */
     sourceType: string;
     /**
-     * Value of the `source_uri` field.
+     *
      * @type {string}
      * @memberof RepoDto
      */
     sourceUri?: string | null;
     /**
-     * Value of the `updated_at` field.
+     *
      * @type {string}
      * @memberof RepoDto
      */
     updatedAt: string;
     /**
-     * Value of the `updated_by` field.
+     *
      * @type {string}
      * @memberof RepoDto
      */
     updatedBy: string;
     /**
-     * Stable identifier of the related workspace resource.
+     *
      * @type {string}
      * @memberof RepoDto
      */

package/dist/raw/registry/models/RepoListDto.d.ts

@@ -10,7 +10,27 @@
  * Do not edit the class manually.
  */
 /**
- * Published representation of RepoListDto.
+ * The **list** shape: `RepoDto` minus `source_metadata`.
+ *
+ * A separate type rather than a `skip_serializing_if` on the shared one, because the
+ * difference is a permission tier and utoipa reads the type — a conditional field would
+ * publish one schema for two surfaces and the OpenAPI document would not say which.
+ *
+ * `GET /repos` pages at `discover` ([authz-2026-08-31-discover-listings-carry-no-free-form-bag]),
+ * and `discover = read + discoverable_by->belong` with `discoverable_by@organization` on
+ * every workspace in the account's shared tree — so this body is readable by any member of
+ * the account, including on workspaces they hold no role on. `source_metadata` is the
+ * provenance bag exactly as the client sent it, and `ops::detected_user::contributors`
+ * reads `contributors[].email` out of it: it is the source of every `users_detected` row,
+ * the table `GET /detected-users` serves at `read`. Serving the bag one tier down handed
+ * the same addresses back.
+ *
+ * Stripping just the `contributors` key was rejected: the bag is free-form, so the next
+ * key holding an address would not be covered. The whole bag stays on the `read`-tier
+ * point read and the write echoes, which is where a caller that sent it can read it back.
+ *
+ * [authz-2026-08-31-discover-listings-carry-no-free-form-bag]:
+ * ../decisions/0004-identity-auth-tenancy-and-routing.md
  * @export
  * @interface RepoListDto
  */
@@ -22,37 +42,37 @@ export interface RepoListDto {
      */
     createdAt: string;
     /**
-     * Value of the `created_by` field.
+     *
      * @type {string}
      * @memberof RepoListDto
      */
     createdBy: string;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof RepoListDto
      */
     description?: string | null;
     /**
-     * Human-readable name.
+     *
      * @type {string}
      * @memberof RepoListDto
      */
     displayName: string;
     /**
-     * Stable identifier of this resource.
+     *
      * @type {string}
      * @memberof RepoListDto
      */
     id: string;
     /**
-     * Stable machine-readable name.
+     *
      * @type {string}
      * @memberof RepoListDto
      */
     name: string;
     /**
-     * Stable identifier of the related project resource.
+     *
      * @type {string}
      * @memberof RepoListDto
      */
@@ -64,31 +84,31 @@ export interface RepoListDto {
      */
     repoStatus: string;
     /**
-     * Value of the `source_type` field.
+     *
      * @type {string}
      * @memberof RepoListDto
      */
     sourceType: string;
     /**
-     * Value of the `source_uri` field.
+     *
      * @type {string}
      * @memberof RepoListDto
      */
     sourceUri?: string | null;
     /**
-     * Value of the `updated_at` field.
+     *
      * @type {string}
      * @memberof RepoListDto
      */
     updatedAt: string;
     /**
-     * Value of the `updated_by` field.
+     *
      * @type {string}
      * @memberof RepoListDto
      */
     updatedBy: string;
     /**
-     * Stable identifier of the related workspace resource.
+     *
      * @type {string}
      * @memberof RepoListDto
      */

package/dist/raw/registry/models/RepoSlot.d.ts

@@ -18,7 +18,7 @@ import type { SlotError } from './SlotError';
  */
 export interface RepoSlot {
     /**
-     * Error returned when the operation fails.
+     *
      * @type {SlotError}
      * @memberof RepoSlot
      */
@@ -32,7 +32,7 @@ export interface RepoSlot {
      */
     index: number;
     /**
-     * Value of the `repo` field.
+     *
      * @type {RepoDto}
      * @memberof RepoSlot
      */

package/dist/raw/registry/models/ReposPage.d.ts

@@ -12,7 +12,7 @@
 import type { RegistryPageMeta } from './RegistryPageMeta';
 import type { RepoListDto } from './RepoListDto';
 /**
- * Paginated collection of Repos resources.
+ *
  * @export
  * @interface ReposPage
  */