@atlanai/sdk 0.2.4 → 0.3.1

package/dist/raw/registry/apis/WorkspacesApi.js

@@ -399,7 +399,7 @@ class WorkspacesApi extends runtime.BaseAPI {
         };
     }
     /**
-     * A page of the non-deleted workspaces the caller can discover. Supports the shared grammar: `filter[field][op]=`, `sort=`, `q=`, `limit`/`offset`, `count=false`. Fields: `name`, `display_name`, `description`, `kind`, `workspace_status`, `parent_id`, `created_at`, `updated_at`.  `include=member_count` attaches each row\'s roster size from one grouped read. It is **absent rather than zero** on a workspace the caller can discover but not read into: this list runs under `discover`, which reaches through `discoverable_by`, while the count is taken under `read` on the membership rows — so a headcount is not something discovery alone reveals.  `include=artifact_counts` attaches each row\'s `artifact_count` and its per-kind `artifact_count_by_kind` breakdown, from one grouped read — the pair the pre-Postgres stack served here and the cutover dropped. Unlike `member_count` it is present on **every** row of the page, including a workspace the caller can discover but has not joined, and a `0` therefore means zero: it is taken under the page\'s own `discover` receipt, because a count of artifacts identifies nobody. It counts what `POST /aggregate` counts — live heads, no system artifacts, no archived ones, discoverable kinds only — so the number does not change when the caller joins.  `include=permissions` attaches each row\'s advisory `can_*` capability matrix. Advisory only — a UI gates controls on it; it never authorizes a request.  `include=plugin` attaches each row\'s marketplace plugin — its catalogue name, plugin name, rendered `<name>@<marketplace>` install handle, and content `version` — so a client holding an installed plugin can tell whether it is current. It is **absent** rather than defaulted where the answer is not knowable: a workspace the caller can discover but not read is not packaged at all, a handle that slugs to nothing gets no plugin, and an assembly that degraded would yield a version no clone will serve. The embed re-runs the marketplace\'s own per-container assembly, so it costs materially more than the other two; ask for it on the interval a client checks for updates, not on every page.
+     * A page of the **active** workspaces the caller can discover. Archived rows are excluded **by default**, and `filter[workspace_status][eq]=archived` (or `[in]=active,archived`) is the only way to see them — there is no separate flag, so a status filter governs the page outright instead of fighting a default. `deleted` rows are never listed, however you filter.  Supports the shared grammar: `filter[field][op]=`, `sort=`, `q=`, `limit`/`offset`, `count=false`. Fields: `name`, `display_name`, `description`, `kind`, `workspace_status`, `parent_id`, `created_at`, `updated_at`. The bare spellings `workspace_status`, `status`, `kind`, `parent_id` and `name` are refused with a `400` naming the `filter[...][eq]=` form, rather than silently widening the page as they used to; any other unrecognised parameter is still ignored.  `include=member_count` attaches each row\'s roster size from one grouped read. It is **absent rather than zero** on a workspace the caller can discover but not read into: this list runs under `discover`, which reaches through `discoverable_by`, while the count is taken under `read` on the membership rows — so a headcount is not something discovery alone reveals.  `include=artifact_counts` attaches each row\'s `artifact_count` and its per-kind `artifact_count_by_kind` breakdown, from one grouped read — the pair the pre-Postgres stack served here and the cutover dropped. Unlike `member_count` it is present on **every** row of the page, including a workspace the caller can discover but has not joined, and a `0` therefore means zero: it is taken under the page\'s own `discover` receipt, because a count of artifacts identifies nobody. It counts what `POST /aggregate` counts — live heads, no system artifacts, no archived ones, discoverable kinds only — so the number does not change when the caller joins.  `include=permissions` attaches each row\'s advisory `can_*` capability matrix. Advisory only — a UI gates controls on it; it never authorizes a request.  `include=plugin` attaches each row\'s marketplace plugin — its catalogue name, plugin name, rendered `<name>@<marketplace>` install handle, and content `version` — so a client holding an installed plugin can tell whether it is current. It is **absent** rather than defaulted where the answer is not knowable: a workspace the caller can discover but not read is not packaged at all, a handle that slugs to nothing gets no plugin, and an assembly that degraded would yield a version no clone will serve. The embed re-runs the marketplace\'s own per-container assembly, so it costs materially more than the other two; ask for it on the interval a client checks for updates, not on every page.
      * List workspaces
      */
     async registryListWorkspacesRaw(requestParameters, initOverrides) {
@@ -408,7 +408,7 @@ class WorkspacesApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, WorkspacesPage_1.WorkspacesPageFromJSON)(jsonValue));
     }
     /**
-     * A page of the non-deleted workspaces the caller can discover. Supports the shared grammar: `filter[field][op]=`, `sort=`, `q=`, `limit`/`offset`, `count=false`. Fields: `name`, `display_name`, `description`, `kind`, `workspace_status`, `parent_id`, `created_at`, `updated_at`.  `include=member_count` attaches each row\'s roster size from one grouped read. It is **absent rather than zero** on a workspace the caller can discover but not read into: this list runs under `discover`, which reaches through `discoverable_by`, while the count is taken under `read` on the membership rows — so a headcount is not something discovery alone reveals.  `include=artifact_counts` attaches each row\'s `artifact_count` and its per-kind `artifact_count_by_kind` breakdown, from one grouped read — the pair the pre-Postgres stack served here and the cutover dropped. Unlike `member_count` it is present on **every** row of the page, including a workspace the caller can discover but has not joined, and a `0` therefore means zero: it is taken under the page\'s own `discover` receipt, because a count of artifacts identifies nobody. It counts what `POST /aggregate` counts — live heads, no system artifacts, no archived ones, discoverable kinds only — so the number does not change when the caller joins.  `include=permissions` attaches each row\'s advisory `can_*` capability matrix. Advisory only — a UI gates controls on it; it never authorizes a request.  `include=plugin` attaches each row\'s marketplace plugin — its catalogue name, plugin name, rendered `<name>@<marketplace>` install handle, and content `version` — so a client holding an installed plugin can tell whether it is current. It is **absent** rather than defaulted where the answer is not knowable: a workspace the caller can discover but not read is not packaged at all, a handle that slugs to nothing gets no plugin, and an assembly that degraded would yield a version no clone will serve. The embed re-runs the marketplace\'s own per-container assembly, so it costs materially more than the other two; ask for it on the interval a client checks for updates, not on every page.
+     * A page of the **active** workspaces the caller can discover. Archived rows are excluded **by default**, and `filter[workspace_status][eq]=archived` (or `[in]=active,archived`) is the only way to see them — there is no separate flag, so a status filter governs the page outright instead of fighting a default. `deleted` rows are never listed, however you filter.  Supports the shared grammar: `filter[field][op]=`, `sort=`, `q=`, `limit`/`offset`, `count=false`. Fields: `name`, `display_name`, `description`, `kind`, `workspace_status`, `parent_id`, `created_at`, `updated_at`. The bare spellings `workspace_status`, `status`, `kind`, `parent_id` and `name` are refused with a `400` naming the `filter[...][eq]=` form, rather than silently widening the page as they used to; any other unrecognised parameter is still ignored.  `include=member_count` attaches each row\'s roster size from one grouped read. It is **absent rather than zero** on a workspace the caller can discover but not read into: this list runs under `discover`, which reaches through `discoverable_by`, while the count is taken under `read` on the membership rows — so a headcount is not something discovery alone reveals.  `include=artifact_counts` attaches each row\'s `artifact_count` and its per-kind `artifact_count_by_kind` breakdown, from one grouped read — the pair the pre-Postgres stack served here and the cutover dropped. Unlike `member_count` it is present on **every** row of the page, including a workspace the caller can discover but has not joined, and a `0` therefore means zero: it is taken under the page\'s own `discover` receipt, because a count of artifacts identifies nobody. It counts what `POST /aggregate` counts — live heads, no system artifacts, no archived ones, discoverable kinds only — so the number does not change when the caller joins.  `include=permissions` attaches each row\'s advisory `can_*` capability matrix. Advisory only — a UI gates controls on it; it never authorizes a request.  `include=plugin` attaches each row\'s marketplace plugin — its catalogue name, plugin name, rendered `<name>@<marketplace>` install handle, and content `version` — so a client holding an installed plugin can tell whether it is current. It is **absent** rather than defaulted where the answer is not knowable: a workspace the caller can discover but not read is not packaged at all, a handle that slugs to nothing gets no plugin, and an assembly that degraded would yield a version no clone will serve. The embed re-runs the marketplace\'s own per-container assembly, so it costs materially more than the other two; ask for it on the interval a client checks for updates, not on every page.
      * List workspaces
      */
     async registryListWorkspaces(requestParameters = {}, initOverrides) {

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

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

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

@@ -16,19 +16,19 @@
  */
 export interface AppActionDto {
     /**
-     * Value of the `app` field.
+     *
      * @type {string}
      * @memberof AppActionDto
      */
     app: string;
     /**
-     * Value of the `config_schema` field.
+     *
      * @type {object}
      * @memberof AppActionDto
      */
     configSchema?: object | null;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof AppActionDto
      */
@@ -52,25 +52,25 @@ export interface AppActionDto {
      */
     jobId: string;
     /**
-     * Stable machine-readable name.
+     *
      * @type {string}
      * @memberof AppActionDto
      */
     name: string;
     /**
-     * Value of the `output_schema` field.
+     *
      * @type {object}
      * @memberof AppActionDto
      */
     outputSchema?: object | null;
     /**
-     * Value of the `release` field.
+     *
      * @type {string}
      * @memberof AppActionDto
      */
     release?: string | null;
     /**
-     * Value of the `updated_at` field.
+     *
      * @type {string}
      * @memberof AppActionDto
      */

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

@@ -12,7 +12,7 @@
 import type { RegistryPageMeta } from './RegistryPageMeta';
 import type { AppActionDto } from './AppActionDto';
 /**
- * Paginated collection of AppActions resources.
+ *
  * @export
  * @interface AppActionsPage
  */

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

@@ -28,7 +28,7 @@ export interface AppDto {
      */
     author?: string | null;
     /**
-     * Value of the `author_url` field.
+     *
      * @type {string}
      * @memberof AppDto
      */
@@ -41,25 +41,25 @@ export interface AppDto {
      */
     categories: Array<string>;
     /**
-     * Value of the `contract_version` field.
+     *
      * @type {number}
      * @memberof AppDto
      */
     contractVersion?: number | null;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof AppDto
      */
     description?: string | null;
     /**
-     * Human-readable name.
+     *
      * @type {string}
      * @memberof AppDto
      */
     displayName: string;
     /**
-     * Value of the `homepage_url` field.
+     *
      * @type {string}
      * @memberof AppDto
      */
@@ -83,13 +83,13 @@ export interface AppDto {
      */
     installStatus: string;
     /**
-     * Value of the `installed_at` field.
+     *
      * @type {string}
      * @memberof AppDto
      */
     installedAt: string;
     /**
-     * Value of the `installed_by` field.
+     *
      * @type {string}
      * @memberof AppDto
      */
@@ -103,49 +103,49 @@ export interface AppDto {
      */
     isInstalled: boolean;
     /**
-     * Whether pinned.
+     *
      * @type {boolean}
      * @memberof AppDto
      */
     isPinned: boolean;
     /**
-     * Value of the `license` field.
+     *
      * @type {string}
      * @memberof AppDto
      */
     license?: string | null;
     /**
-     * Value of the `readme_uri` field.
+     *
      * @type {string}
      * @memberof AppDto
      */
     readmeUri?: string | null;
     /**
-     * Value of the `release` field.
+     *
      * @type {string}
      * @memberof AppDto
      */
     release?: string | null;
     /**
-     * Value of the `repo_url` field.
+     *
      * @type {string}
      * @memberof AppDto
      */
     repoUrl?: string | null;
     /**
-     * Value of the `summary` field.
+     *
      * @type {string}
      * @memberof AppDto
      */
     summary?: string | null;
     /**
-     * Value of the `support_url` field.
+     *
      * @type {string}
      * @memberof AppDto
      */
     supportUrl?: string | null;
     /**
-     * Value of the `tags` field.
+     *
      * @type {Array<string>}
      * @memberof AppDto
      */
@@ -158,7 +158,7 @@ export interface AppDto {
      */
     uiPath?: string | null;
     /**
-     * Value of the `updated_at` field.
+     *
      * @type {string}
      * @memberof AppDto
      */

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

@@ -12,7 +12,7 @@
 import type { RegistryPageMeta } from './RegistryPageMeta';
 import type { AppDto } from './AppDto';
 /**
- * Paginated collection of Apps resources.
+ *
  * @export
  * @interface AppsPage
  */

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

@@ -23,7 +23,7 @@ export interface ArchiveAck {
      */
     changed: boolean;
     /**
-     * Stable identifier of this resource.
+     *
      * @type {string}
      * @memberof ArchiveAck
      */

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

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

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

@@ -51,7 +51,10 @@ export interface ArtifactView {
      */
     commitTs: string;
     /**
-     * Value of the `content_hash_hex` field.
+     * BLAKE3 of the canonicalised per-kind properties, hex. The `ETag`, and the `If-Match`
+     * precondition's subject. Named `_hex` for the shipped contract's sake; the algorithm is
+     * BLAKE3 here where Spanner used sha256, so a hash is comparable within a deployment and not
+     * across the cutover.
      * @type {string}
      * @memberof ArtifactView
      */
@@ -88,7 +91,7 @@ export interface ArtifactView {
      */
     id: string;
     /**
-     * Value of the `identity` field.
+     *
      * @type {GatewayArtifactIdentityRevealView}
      * @memberof ArtifactView
      */
@@ -162,7 +165,16 @@ export interface ArtifactView {
      */
     ownerId?: 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 ArtifactView
      */
@@ -176,7 +188,7 @@ export interface ArtifactView {
      */
     projectId?: string | null;
     /**
-     * Value of the `relationships` field.
+     *
      * @type {RelationshipsView}
      * @memberof ArtifactView
      */
@@ -202,62 +214,67 @@ export interface ArtifactView {
      */
     repoId?: string | null;
     /**
-     * Value of the `source_created_at` field.
+     *
      * @type {string}
      * @memberof ArtifactView
      */
     sourceCreatedAt?: string | null;
     /**
-     * Value of the `source_created_by` field.
+     *
      * @type {string}
      * @memberof ArtifactView
      */
     sourceCreatedBy?: string | null;
     /**
-     * Value of the `source_digest` field.
+     *
      * @type {string}
      * @memberof ArtifactView
      */
     sourceDigest?: string | null;
     /**
-     * Value of the `source_last_modified_at` field.
+     * The artifact's identifier in its source system.
+     * @type {string}
+     * @memberof ArtifactView
+     */
+    sourceId?: string | null;
+    /**
+     *
      * @type {string}
      * @memberof ArtifactView
      */
     sourceLastModifiedAt?: string | null;
     /**
-     * Value of the `source_last_modified_by` field.
+     *
      * @type {string}
      * @memberof ArtifactView
      */
     sourceLastModifiedBy?: string | null;
     /**
-     * Value of the `source_metadata` field.
+     *
      * @type {object}
      * @memberof ArtifactView
      */
     sourceMetadata?: object | null;
     /**
-     * Value of the `source_synced_at` field.
+     *
      * @type {string}
      * @memberof ArtifactView
      */
     sourceSyncedAt?: string | null;
     /**
-     * `git`, `atlan` or `local`. Fixed at creation, because a line's provenance is a property of the
-     * line.
+     * `git`, `atlan`, `local`, or `external`.
      * @type {string}
      * @memberof ArtifactView
      */
     sourceType: string;
     /**
-     * Value of the `source_uri` field.
+     *
      * @type {string}
      * @memberof ArtifactView
      */
     sourceUri?: string | null;
     /**
-     * Value of the `source_version` field.
+     *
      * @type {string}
      * @memberof ArtifactView
      */

package/dist/raw/registry/models/ArtifactView.js

@@ -92,6 +92,7 @@ function ArtifactViewFromJSONTyped(json, ignoreDiscriminator) {
         'sourceCreatedAt': json['source_created_at'] === undefined ? undefined : json['source_created_at'] === null ? null : json['source_created_at'],
         'sourceCreatedBy': json['source_created_by'] === undefined ? undefined : json['source_created_by'] === null ? null : json['source_created_by'],
         'sourceDigest': json['source_digest'] === undefined ? undefined : json['source_digest'] === null ? null : json['source_digest'],
+        'sourceId': json['source_id'] === undefined ? undefined : json['source_id'] === null ? null : json['source_id'],
         'sourceLastModifiedAt': json['source_last_modified_at'] === undefined ? undefined : json['source_last_modified_at'] === null ? null : json['source_last_modified_at'],
         'sourceLastModifiedBy': json['source_last_modified_by'] === undefined ? undefined : json['source_last_modified_by'] === null ? null : json['source_last_modified_by'],
         'sourceMetadata': json['source_metadata'] === undefined ? undefined : json['source_metadata'] === null ? null : json['source_metadata'],
@@ -141,6 +142,7 @@ function ArtifactViewToJSONTyped(value, ignoreDiscriminator = false) {
         'source_created_at': value['sourceCreatedAt'],
         'source_created_by': value['sourceCreatedBy'],
         'source_digest': value['sourceDigest'],
+        'source_id': value['sourceId'],
         'source_last_modified_at': value['sourceLastModifiedAt'],
         'source_last_modified_by': value['sourceLastModifiedBy'],
         'source_metadata': value['sourceMetadata'],

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

@@ -16,25 +16,25 @@
  */
 export interface CostView {
     /**
-     * Input cost in US dollars.
+     *
      * @type {number}
      * @memberof CostView
      */
     inputCostUsd: number;
     /**
-     * Output cost in US dollars.
+     *
      * @type {number}
      * @memberof CostView
      */
     outputCostUsd: number;
     /**
-     * Origin of this data.
+     *
      * @type {string}
      * @memberof CostView
      */
     source?: string | null;
     /**
-     * Total cost in US dollars.
+     *
      * @type {number}
      * @memberof CostView
      */

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

@@ -16,13 +16,13 @@
  */
 export interface CreateRepoBody {
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof CreateRepoBody
      */
     description?: string | null;
     /**
-     * Human-readable name.
+     *
      * @type {string}
      * @memberof CreateRepoBody
      */

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

@@ -28,7 +28,7 @@ export interface CreateServiceAccountBody {
      */
     credentialKind?: string | null;
     /**
-     * Human-readable name.
+     *
      * @type {string}
      * @memberof CreateServiceAccountBody
      */

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

@@ -16,7 +16,7 @@
  */
 export interface CreateWorkspaceBody {
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof CreateWorkspaceBody
      */

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

@@ -16,13 +16,13 @@
  */
 export interface CursorPage {
     /**
-     * Maximum number of items to return.
+     *
      * @type {number}
      * @memberof CursorPage
      */
     limit: number;
     /**
-     * Opaque pagination cursor.
+     *
      * @type {string}
      * @memberof CursorPage
      */

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

@@ -22,7 +22,7 @@ export interface CutReleaseBody {
      */
     channel?: string | null;
     /**
-     * Value of the `notes` field.
+     *
      * @type {string}
      * @memberof CutReleaseBody
      */

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

@@ -16,7 +16,7 @@
  */
 export interface GroupDto {
     /**
-     * Value of the `created_at` field.
+     *
      * @type {string}
      * @memberof GroupDto
      */
@@ -28,19 +28,19 @@ export interface GroupDto {
      */
     externalId?: string | null;
     /**
-     * Stable identifier of this resource.
+     *
      * @type {string}
      * @memberof GroupDto
      */
     id: string;
     /**
-     * Stable machine-readable name.
+     *
      * @type {string}
      * @memberof GroupDto
      */
     name?: string | null;
     /**
-     * Value of the `updated_at` field.
+     *
      * @type {string}
      * @memberof GroupDto
      */

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

@@ -16,13 +16,17 @@
  */
 export interface IntrospectedActor {
     /**
-     * Value of the `on_behalf_of` field.
+     * The human the agent is acting for.
+     *
+     * **Additive over the Spanner surface**, which carried only the actor's own subject and account
+     * — so a trail could see that delegation happened and not on whose behalf, which is the only
+     * interesting part.
      * @type {string}
      * @memberof IntrospectedActor
      */
     onBehalfOf: string;
     /**
-     * Stable identifier of the related org resource.
+     *
      * @type {string}
      * @memberof IntrospectedActor
      */

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

@@ -17,7 +17,7 @@ import type { IntrospectedActor } from './IntrospectedActor';
  */
 export interface IntrospectedIdentity {
     /**
-     * Value of the `act` field.
+     *
      * @type {IntrospectedActor}
      * @memberof IntrospectedIdentity
      */
@@ -30,7 +30,7 @@ export interface IntrospectedIdentity {
      */
     exp?: number | null;
     /**
-     * Stable identifier of the related org resource.
+     *
      * @type {string}
      * @memberof IntrospectedIdentity
      */
@@ -52,7 +52,7 @@ export interface IntrospectedIdentity {
      */
     role?: string | null;
     /**
-     * Value of the `scopes` field.
+     *
      * @type {Array<string>}
      * @memberof IntrospectedIdentity
      */