@worldlabsai/client 0.1.0 → 0.2.0

package/src/generated/developer-api.gen.ts

@@ -30,7 +30,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Submit a atlasChisel task */
+        /** Submit the atlasChisel task */
         post: operations["submit_atlasChisel_api_v2_tasks_atlasChisel_post"];
         delete?: never;
         options?: never;
@@ -47,7 +47,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Submit a atlasGenerate task */
+        /** Submit the atlasGenerate task */
         post: operations["submit_atlasGenerate_api_v2_tasks_atlasGenerate_post"];
         delete?: never;
         options?: never;
@@ -64,7 +64,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Submit a atlasMasked task */
+        /** Submit the atlasMasked task */
         post: operations["submit_atlasMasked_api_v2_tasks_atlasMasked_post"];
         delete?: never;
         options?: never;
@@ -81,7 +81,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Submit a atlasTextToImage task */
+        /** Submit the atlasTextToImage task */
         post: operations["submit_atlasTextToImage_api_v2_tasks_atlasTextToImage_post"];
         delete?: never;
         options?: never;
@@ -98,7 +98,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Submit a images2PosedRGBD task */
+        /** Submit the images2PosedRGBD task */
         post: operations["submit_images2PosedRGBD_api_v2_tasks_images2PosedRGBD_post"];
         delete?: never;
         options?: never;
@@ -115,7 +115,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Submit a splats2Mesh task */
+        /** Submit the splats2Mesh task */
         post: operations["submit_splats2Mesh_api_v2_tasks_splats2Mesh_post"];
         delete?: never;
         options?: never;
@@ -347,13 +347,16 @@ export interface components {
              * Displayname
              * @description User-visible label.
              */
-            displayName: string;
+            displayName: string | null;
             /**
              * Mimetype
              * @description Media MIME type, e.g. ``image/png``.
              */
             mimeType: string;
-            /** @default CREATED */
+            /**
+             * @description Lifecycle state. Only ``READY`` assets can be read or used by a task.
+             * @default CREATED
+             */
             state?: components["schemas"]["AssetState"];
             /**
              * Width
@@ -372,7 +375,7 @@ export interface components {
             sizeBytes?: string | null;
             /**
              * Checksum
-             * @description Checksum the store reports, e.g. ``crc32c:...``.
+             * @description Checksum when available.
              */
             checksum?: string | null;
             /**
@@ -401,7 +404,7 @@ export interface components {
             producedBy?: components["schemas"]["ProducedBy"] | null;
             /**
              * Contentpath
-             * @description Where the asset's bytes sit under the project's content prefix, ``<class>/<asset>[/<role>]``, each segment percent-encoded as a URL path segment. Appended to a read prefix's ``baseUrl`` and followed by its ``signedQuery`` it addresses the bytes on the content edge; on its own it grants nothing. A read prefix is minted per project by ``:createReadPrefix`` (on the project for web sessions, on ``/assets`` for API keys); ``:createReadUrl`` stays the single-object download. Null until the bytes exist.
+             * @description Already percent-encoded path for the asset. Append it unchanged to ``baseUrl`` before ``?`` and ``signedQuery``. This path does not grant access by itself. Null until the asset is ``READY`` or when unavailable; use ``assets/{asset}:createReadUrl`` as a fallback.
              */
             contentPath?: string | null;
         };
@@ -414,7 +417,7 @@ export interface components {
              * Displayname
              * @description User-visible label.
              */
-            displayName: string;
+            displayName?: string | null;
             /**
              * Type
              * @description Asset type, e.g. ``image``. Decides which part roles the asset may carry and what each may hold. Omit for a single untyped object uploaded through ``:createUploadUrl``.
@@ -439,17 +442,13 @@ export interface components {
             base64?: string | null;
             /**
              * Url
-             * @description A URL the platform fetches. The asset comes back ``READY``. The address is opened by a sandboxed workload, never by the API.
+             * @description A public URL the platform fetches. The asset comes back ``READY``.
              */
             url?: string | null;
         };
         /**
          * AssetPart
          * @description One media file belonging to an asset.
-         *
-         *     Every field but the role is what the store and the bytes reported at
-         *     ``:completeUpload``; nothing here is echoed back from the request that
-         *     declared the part.
          */
         AssetPart: {
             /**
@@ -479,7 +478,7 @@ export interface components {
             sizeBytes?: string | null;
             /**
              * Checksum
-             * @description Checksum the store reports, e.g. ``crc32c:...``.
+             * @description Checksum when available.
              */
             checksum?: string | null;
             /**
@@ -499,13 +498,19 @@ export interface components {
          * AssetPartDeclaration
          * @description A part the client intends to upload.
          *
-         *     The content type and length are signed into the upload URL, so they bound
-         *     what may be sent rather than describing what the asset is.
+         *     The upload must use the declared content type and contain exactly the
+         *     declared number of bytes.
          */
         AssetPartDeclaration: {
-            /** Role */
+            /**
+             * Role
+             * @description Role this file fills in the asset type, e.g. ``rgb``, ``mask`` or ``depth``.
+             */
             role: string;
-            /** Contenttype */
+            /**
+             * Contenttype
+             * @description MIME type that will be sent with the upload, e.g. ``image/png``.
+             */
             contentType: string;
             /**
              * Contentlength
@@ -615,35 +620,54 @@ export interface components {
              */
             requestId?: string | null;
         };
-        /** AtlasChiselResponseOperation */
+        /**
+         * AtlasChiselResponseOperation
+         * @description Long-running operation whose successful terminal ``response`` has type ``AtlasChiselResponse``. This is the common Operation envelope with a task-specific response type, not a separate operation resource.
+         */
         AtlasChiselResponseOperation: {
-            /** Id */
+            /**
+             * Id
+             * @description Short operation id used in ``/operations/{operation}`` paths.
+             */
             id: string;
-            /** Ownerid */
+            /**
+             * Ownerid
+             * @description Account that owns the operation.
+             */
             ownerId: string;
-            /** Metadata */
+            /**
+             * Metadata
+             * @description Task information and optional progress details. Use ``metadata.task`` to interpret a generic operation response, and use ``done`` to determine completion.
+             */
             metadata?: {
                 [key: string]: unknown;
             } | null;
-            /** Done */
+            /**
+             * Done
+             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             */
             done: boolean;
+            /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
             error?: components["schemas"]["OperationError"] | null;
-            /** @description Task response payload when the operation is done. */
+            /** @description ``AtlasChiselResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
             response?: components["schemas"]["AtlasChiselResponse"] | null;
-            /** Expiresatsecs */
+            /**
+             * Expiresatsecs
+             * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
+             */
             expiresAtSecs?: number | null;
             /**
              * Createdatsecs
-             * @description Unix seconds when the operation was created (output-only).
+             * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
             /**
              * Name
-             * @description Canonical resource name ``accounts/{account}/operations/{operation}``.
+             * @description Full resource name for the operation.
              *
-             *     ``owner_id`` is the owning account, so the public name is derived, not
-             *     stored. Output-only: serialized for clients (AIP-style), and harmlessly
-             *     ignored when the LRO client deserializes a service response.
+             *     For project operations:
+             *     ``accounts/{account}/projects/{project}/operations/{operation}``.
+             *     Operation paths accept the short ``id``.
              */
             readonly name: string;
         };
@@ -727,35 +751,54 @@ export interface components {
              */
             requestId?: string | null;
         };
-        /** AtlasGenerateResponseOperation */
+        /**
+         * AtlasGenerateResponseOperation
+         * @description Long-running operation whose successful terminal ``response`` has type ``AtlasGenerateResponse``. This is the common Operation envelope with a task-specific response type, not a separate operation resource.
+         */
         AtlasGenerateResponseOperation: {
-            /** Id */
+            /**
+             * Id
+             * @description Short operation id used in ``/operations/{operation}`` paths.
+             */
             id: string;
-            /** Ownerid */
+            /**
+             * Ownerid
+             * @description Account that owns the operation.
+             */
             ownerId: string;
-            /** Metadata */
+            /**
+             * Metadata
+             * @description Task information and optional progress details. Use ``metadata.task`` to interpret a generic operation response, and use ``done`` to determine completion.
+             */
             metadata?: {
                 [key: string]: unknown;
             } | null;
-            /** Done */
+            /**
+             * Done
+             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             */
             done: boolean;
+            /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
             error?: components["schemas"]["OperationError"] | null;
-            /** @description Task response payload when the operation is done. */
+            /** @description ``AtlasGenerateResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
             response?: components["schemas"]["AtlasGenerateResponse"] | null;
-            /** Expiresatsecs */
+            /**
+             * Expiresatsecs
+             * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
+             */
             expiresAtSecs?: number | null;
             /**
              * Createdatsecs
-             * @description Unix seconds when the operation was created (output-only).
+             * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
             /**
              * Name
-             * @description Canonical resource name ``accounts/{account}/operations/{operation}``.
+             * @description Full resource name for the operation.
              *
-             *     ``owner_id`` is the owning account, so the public name is derived, not
-             *     stored. Output-only: serialized for clients (AIP-style), and harmlessly
-             *     ignored when the LRO client deserializes a service response.
+             *     For project operations:
+             *     ``accounts/{account}/projects/{project}/operations/{operation}``.
+             *     Operation paths accept the short ``id``.
              */
             readonly name: string;
         };
@@ -839,35 +882,54 @@ export interface components {
              */
             requestId?: string | null;
         };
-        /** AtlasMaskedResponseOperation */
+        /**
+         * AtlasMaskedResponseOperation
+         * @description Long-running operation whose successful terminal ``response`` has type ``AtlasMaskedResponse``. This is the common Operation envelope with a task-specific response type, not a separate operation resource.
+         */
         AtlasMaskedResponseOperation: {
-            /** Id */
+            /**
+             * Id
+             * @description Short operation id used in ``/operations/{operation}`` paths.
+             */
             id: string;
-            /** Ownerid */
+            /**
+             * Ownerid
+             * @description Account that owns the operation.
+             */
             ownerId: string;
-            /** Metadata */
+            /**
+             * Metadata
+             * @description Task information and optional progress details. Use ``metadata.task`` to interpret a generic operation response, and use ``done`` to determine completion.
+             */
             metadata?: {
                 [key: string]: unknown;
             } | null;
-            /** Done */
+            /**
+             * Done
+             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             */
             done: boolean;
+            /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
             error?: components["schemas"]["OperationError"] | null;
-            /** @description Task response payload when the operation is done. */
+            /** @description ``AtlasMaskedResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
             response?: components["schemas"]["AtlasMaskedResponse"] | null;
-            /** Expiresatsecs */
+            /**
+             * Expiresatsecs
+             * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
+             */
             expiresAtSecs?: number | null;
             /**
              * Createdatsecs
-             * @description Unix seconds when the operation was created (output-only).
+             * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
             /**
              * Name
-             * @description Canonical resource name ``accounts/{account}/operations/{operation}``.
+             * @description Full resource name for the operation.
              *
-             *     ``owner_id`` is the owning account, so the public name is derived, not
-             *     stored. Output-only: serialized for clients (AIP-style), and harmlessly
-             *     ignored when the LRO client deserializes a service response.
+             *     For project operations:
+             *     ``accounts/{account}/projects/{project}/operations/{operation}``.
+             *     Operation paths accept the short ``id``.
              */
             readonly name: string;
         };
@@ -914,7 +976,7 @@ export interface components {
             numSamples?: number | null;
             /**
              * Returndepth
-             * @description Also return each image as a posed RGBD frame in `frames`: depth is estimated per image (metric, single-view) along with the camera it was estimated under.
+             * @description Also estimate depth per image (metric, single-view): every frame in `frames` then carries a `depth` buffer and the camera it was estimated under.
              * @default false
              */
             returnDepth?: boolean;
@@ -925,72 +987,69 @@ export interface components {
          */
         AtlasTextToImageResponse: {
             /**
-             * Generationid
-             * @description Stable id for this generation run.
-             */
-            generationId: string;
-            /**
-             * Imageurls
-             * @description Public URLs of generated PNG images.
-             */
-            imageUrls: string[];
-            /** @description Task outputs using the shared output URL contract. */
-            assetOutput?: components["schemas"]["ImageCollectionAssetOutput"] | null;
-            /**
-             * Enhancedprompt
-             * @description Prompt after enhancement, if any.
-             */
-            enhancedPrompt?: string | null;
-            /**
-             * Prompt
-             * @description Original prompt submitted by the caller.
+             * Frames
+             * @description Generated images, one frame per sample in generation order. Every frame also carries its estimated camera and a `depth` buffer when the request set returnDepth.
              */
-            prompt?: string | null;
+            frames: components["schemas"]["FrameRGBAsset"][];
             /**
-             * Modelname
-             * @description Resolved model display name or slug.
+             * Promptused
+             * @description Final prompt supplied to inference, if any.
              */
-            modelName?: string | null;
+            promptUsed?: string | null;
             /**
              * Aspectratio
              * @description Resolved width-to-height ratio used for generation.
              */
             aspectRatio?: ("16:9" | "9:16" | "4:3" | "3:4" | "1:1") | null;
-            /**
-             * Frames
-             * @description Only with returnDepth: one posed RGBD frame per image, in imageUrls order, carrying the estimated camera and a `depth` buffer.
-             */
-            frames?: components["schemas"]["PosedRGBAsset"][] | null;
         };
-        /** AtlasTextToImageResponseOperation */
+        /**
+         * AtlasTextToImageResponseOperation
+         * @description Long-running operation whose successful terminal ``response`` has type ``AtlasTextToImageResponse``. This is the common Operation envelope with a task-specific response type, not a separate operation resource.
+         */
         AtlasTextToImageResponseOperation: {
-            /** Id */
+            /**
+             * Id
+             * @description Short operation id used in ``/operations/{operation}`` paths.
+             */
             id: string;
-            /** Ownerid */
+            /**
+             * Ownerid
+             * @description Account that owns the operation.
+             */
             ownerId: string;
-            /** Metadata */
+            /**
+             * Metadata
+             * @description Task information and optional progress details. Use ``metadata.task`` to interpret a generic operation response, and use ``done`` to determine completion.
+             */
             metadata?: {
                 [key: string]: unknown;
             } | null;
-            /** Done */
+            /**
+             * Done
+             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             */
             done: boolean;
+            /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
             error?: components["schemas"]["OperationError"] | null;
-            /** @description Task response payload when the operation is done. */
+            /** @description ``AtlasTextToImageResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
             response?: components["schemas"]["AtlasTextToImageResponse"] | null;
-            /** Expiresatsecs */
+            /**
+             * Expiresatsecs
+             * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
+             */
             expiresAtSecs?: number | null;
             /**
              * Createdatsecs
-             * @description Unix seconds when the operation was created (output-only).
+             * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
             /**
              * Name
-             * @description Canonical resource name ``accounts/{account}/operations/{operation}``.
+             * @description Full resource name for the operation.
              *
-             *     ``owner_id`` is the owning account, so the public name is derived, not
-             *     stored. Output-only: serialized for clients (AIP-style), and harmlessly
-             *     ignored when the LRO client deserializes a service response.
+             *     For project operations:
+             *     ``accounts/{account}/projects/{project}/operations/{operation}``.
+             *     Operation paths accept the short ``id``.
              */
             readonly name: string;
         };
@@ -1068,7 +1127,7 @@ export interface components {
             reason?: string | null;
             /**
              * Requestid
-             * @description Stable cancellation request id; supply to make retries idempotent. Server generates one if omitted.
+             * @description Cancellation idempotency key, at most 36 characters; supply to make retries idempotent. Server generates one if omitted.
              */
             requestId?: string | null;
         };
@@ -1126,6 +1185,7 @@ export interface components {
              * @description Optional client-supplied resource id.
              */
             assetId?: string | null;
+            /** @description Asset metadata and ingestion source. */
             asset: components["schemas"]["AssetCreate"];
         };
         /**
@@ -1142,13 +1202,16 @@ export interface components {
              * Displayname
              * @description User-visible label.
              */
-            displayName: string;
+            displayName: string | null;
             /**
              * Mimetype
              * @description Media MIME type, e.g. ``image/png``.
              */
             mimeType: string;
-            /** @default CREATED */
+            /**
+             * @description Lifecycle state. Only ``READY`` assets can be read or used by a task.
+             * @default CREATED
+             */
             state?: components["schemas"]["AssetState"];
             /**
              * Width
@@ -1167,7 +1230,7 @@ export interface components {
             sizeBytes?: string | null;
             /**
              * Checksum
-             * @description Checksum the store reports, e.g. ``crc32c:...``.
+             * @description Checksum when available.
              */
             checksum?: string | null;
             /**
@@ -1196,49 +1259,55 @@ export interface components {
             producedBy?: components["schemas"]["ProducedBy"] | null;
             /**
              * Contentpath
-             * @description Where the asset's bytes sit under the project's content prefix, ``<class>/<asset>[/<role>]``, each segment percent-encoded as a URL path segment. Appended to a read prefix's ``baseUrl`` and followed by its ``signedQuery`` it addresses the bytes on the content edge; on its own it grants nothing. A read prefix is minted per project by ``:createReadPrefix`` (on the project for web sessions, on ``/assets`` for API keys); ``:createReadUrl`` stays the single-object download. Null until the bytes exist.
+             * @description Already percent-encoded path for the asset. Append it unchanged to ``baseUrl`` before ``?`` and ``signedQuery``. This path does not grant access by itself. Null until the asset is ``READY`` or when unavailable; use ``assets/{asset}:createReadUrl`` as a fallback.
              */
             contentPath?: string | null;
-            /** Uploads */
+            /**
+             * Uploads
+             * @description One grant per declared part; empty for URL or inline ingestion.
+             */
             uploads?: components["schemas"]["UploadGrant"][];
         };
         /**
          * CreateReadPrefixResponse
-         * @description One credential for a project's whole library on the content edge.
+         * @description A short-lived credential for a project's whole asset library.
          *
-         *     A Cloud CDN prefix-signed URL: append an asset's ``contentPath`` to
-         *     ``baseUrl`` and then ``?`` plus ``signedQuery`` to address its bytes.
-         *     The same ``signedQuery`` serves every asset of the project until
-         *     ``expiresAt``; the edge validates it on every request.
+         *     Build one download URL as ``baseUrl + contentPath + "?" + signedQuery``.
+         *     The same credential serves every ready asset in the project until
+         *     ``expiresAt``. Treat it as a secret because it grants that broad access.
          */
         CreateReadPrefixResponse: {
             /**
              * Baseurl
-             * @description The project's content prefix on the edge, ending in ``/``. Append an asset's ``contentPath`` to address its bytes.
+             * @description Project content prefix, ending in ``/``. Append an asset's already encoded ``contentPath`` unchanged.
              */
             baseUrl: string;
             /**
              * Signedquery
-             * @description Query string (without the leading ``?``) authorizing every URL under ``baseUrl``: ``URLPrefix``, ``Expires``, ``KeyName`` and ``Signature`` as Cloud CDN defines them. Knowledge of it grants read access to the project's library until it expires; mint a fresh one rather than persisting this.
+             * @description Opaque, already encoded query string without the leading ``?``. Append it unchanged after ``baseUrl + contentPath``; do not parse or edit it.
              */
             signedQuery: string;
             /**
              * Expiresat
              * Format: date-time
-             * @description When the signature stops admitting reads; mint again after.
+             * @description When this read credential expires; create a new one after.
              */
             expiresAt: string;
         };
-        /** CreateReadUrlResponse */
+        /**
+         * CreateReadUrlResponse
+         * @description A short-lived credential for downloading one asset.
+         */
         CreateReadUrlResponse: {
             /**
              * Readurl
-             * @description Short-lived signed URL for the asset's bytes. Knowledge of the URL grants read access until it expires; mint a fresh one rather than persisting this.
+             * @description Short-lived download URL for the asset's bytes. Anyone with the URL can read the asset until it expires; create a fresh one rather than persisting this.
              */
             readUrl: string;
             /**
              * Expiresat
              * Format: date-time
+             * @description When ``readUrl`` stops authorizing the download.
              */
             expiresAt: string;
         };
@@ -1264,7 +1333,10 @@ export interface components {
          * @description Upload ticket for a project-owned Asset.
          */
         CreateUploadUrlResponse: {
-            /** Uploadurl */
+            /**
+             * Uploadurl
+             * @description Short-lived upload URL. Send the bytes here without the World Labs API key.
+             */
             uploadUrl: string;
             /**
              * Method
@@ -1274,6 +1346,7 @@ export interface components {
             /**
              * Expiresat
              * Format: date-time
+             * @description When this upload grant expires; create a new one after.
              */
             expiresAt: string;
             /**
@@ -1291,13 +1364,19 @@ export interface components {
         CreateUploadUrlsRequest: {
             /**
              * Roles
-             * @description Parts to re-mint. Empty grants every declared part.
+             * @description Parts that need new upload grants. Empty selects every declared part.
              */
             roles?: string[];
         };
-        /** CreateUploadUrlsResponse */
+        /**
+         * CreateUploadUrlsResponse
+         * @description New upload grants for the requested asset parts.
+         */
         CreateUploadUrlsResponse: {
-            /** Uploads */
+            /**
+             * Uploads
+             * @description One new upload grant per requested part role.
+             */
             uploads?: components["schemas"]["UploadGrant"][];
         };
         /**
@@ -1327,31 +1406,6 @@ export interface components {
             /** Detail */
             detail?: components["schemas"]["ValidationError"][];
         };
-        /**
-         * ImageCollectionAssetOutput
-         * @description Asset output for tasks that return `files.images.images`.
-         */
-        ImageCollectionAssetOutput: {
-            files: components["schemas"]["ImageCollectionAssetOutputFiles"];
-        };
-        /**
-         * ImageCollectionAssetOutputFiles
-         * @description Asset output files for tasks that return an image collection.
-         */
-        ImageCollectionAssetOutputFiles: {
-            images: components["schemas"]["ImageCollectionFiles"];
-        };
-        /**
-         * ImageCollectionFiles
-         * @description Image family containing the image collection role.
-         */
-        ImageCollectionFiles: {
-            /**
-             * Images
-             * @description Generated image files.
-             */
-            images: string[];
-        };
         /**
          * Images2PosedRGBDPerImageResult
          * @description Per-image reconstruction output.
@@ -1415,40 +1469,59 @@ export interface components {
          */
         Images2PosedRGBDResponse: {
             /**
-             * Results
-             * @description One result per input image.
+             * Frames
+             * @description One reconstructed frame per input image, in request order.
              */
-            results: components["schemas"]["Images2PosedRGBDPerImageResult"][];
+            frames: components["schemas"]["Images2PosedRGBDPerImageResult"][];
         };
-        /** Images2PosedRGBDResponseOperation */
+        /**
+         * Images2PosedRGBDResponseOperation
+         * @description Long-running operation whose successful terminal ``response`` has type ``Images2PosedRGBDResponse``. This is the common Operation envelope with a task-specific response type, not a separate operation resource.
+         */
         Images2PosedRGBDResponseOperation: {
-            /** Id */
+            /**
+             * Id
+             * @description Short operation id used in ``/operations/{operation}`` paths.
+             */
             id: string;
-            /** Ownerid */
+            /**
+             * Ownerid
+             * @description Account that owns the operation.
+             */
             ownerId: string;
-            /** Metadata */
+            /**
+             * Metadata
+             * @description Task information and optional progress details. Use ``metadata.task`` to interpret a generic operation response, and use ``done`` to determine completion.
+             */
             metadata?: {
                 [key: string]: unknown;
             } | null;
-            /** Done */
+            /**
+             * Done
+             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             */
             done: boolean;
+            /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
             error?: components["schemas"]["OperationError"] | null;
-            /** @description Task response payload when the operation is done. */
+            /** @description ``Images2PosedRGBDResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
             response?: components["schemas"]["Images2PosedRGBDResponse"] | null;
-            /** Expiresatsecs */
+            /**
+             * Expiresatsecs
+             * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
+             */
             expiresAtSecs?: number | null;
             /**
              * Createdatsecs
-             * @description Unix seconds when the operation was created (output-only).
+             * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
             /**
              * Name
-             * @description Canonical resource name ``accounts/{account}/operations/{operation}``.
+             * @description Full resource name for the operation.
              *
-             *     ``owner_id`` is the owning account, so the public name is derived, not
-             *     stored. Output-only: serialized for clients (AIP-style), and harmlessly
-             *     ignored when the LRO client deserializes a service response.
+             *     For project operations:
+             *     ``accounts/{account}/projects/{project}/operations/{operation}``.
+             *     Operation paths accept the short ``id``.
              */
             readonly name: string;
         };
@@ -1462,12 +1535,19 @@ export interface components {
             /** @description EXR of linear depth in world units, as a URL or inline asset. */
             depthAsset: components["schemas"]["TaskAsset"];
         };
-        /** ListAssetsResponse */
+        /**
+         * ListAssetsResponse
+         * @description One page of non-deleted project assets.
+         */
         ListAssetsResponse: {
-            /** Assets */
+            /**
+             * Assets
+             * @description Assets in the selected page.
+             */
             assets?: components["schemas"]["Asset"][];
             /**
              * Nextpagetoken
+             * @description Opaque token for the next page; empty on the final page.
              * @default
              */
             nextPageToken?: string;
@@ -1477,7 +1557,10 @@ export interface components {
          * @description A page of operations, newest first.
          */
         ListOperationsResponse: {
-            /** Operations */
+            /**
+             * Operations
+             * @description Operations ordered from newest to oldest.
+             */
             operations: components["schemas"]["Operation"][];
             /**
              * Nextpagetoken
@@ -1505,65 +1588,59 @@ export interface components {
              */
             zMax: number;
         };
-        /**
-         * MeshAssetOutput
-         * @description Asset output for tasks that return `files.meshes.mesh`.
-         */
-        MeshAssetOutput: {
-            files: components["schemas"]["MeshAssetOutputFiles"];
-        };
-        /**
-         * MeshAssetOutputFiles
-         * @description Asset output files for mesh tasks.
-         */
-        MeshAssetOutputFiles: {
-            meshes: components["schemas"]["MeshFiles"];
-        };
-        /**
-         * MeshFiles
-         * @description Mesh family containing the generic mesh role.
-         */
-        MeshFiles: {
-            /**
-             * Mesh
-             * @description Generated mesh files.
-             */
-            mesh: string[];
-        };
         /**
          * Operation
-         * @description An asynchronous long-running task operation.
+         * @description The common envelope used to track an asynchronous task.
          */
         Operation: {
-            /** Id */
+            /**
+             * Id
+             * @description Short operation id used in ``/operations/{operation}`` paths.
+             */
             id: string;
-            /** Ownerid */
+            /**
+             * Ownerid
+             * @description Account that owns the operation.
+             */
             ownerId: string;
-            /** Metadata */
+            /**
+             * Metadata
+             * @description Task information and optional progress details. Use ``metadata.task`` to interpret a generic operation response, and use ``done`` to determine completion.
+             */
             metadata?: {
                 [key: string]: unknown;
             } | null;
-            /** Done */
+            /**
+             * Done
+             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             */
             done: boolean;
+            /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
             error?: components["schemas"]["OperationError"] | null;
-            /** Response */
+            /**
+             * Response
+             * @description Task-specific result when ``done`` is true and the task succeeded; null while running and after failure.
+             */
             response?: {
                 [key: string]: unknown;
             } | null;
-            /** Expiresatsecs */
+            /**
+             * Expiresatsecs
+             * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
+             */
             expiresAtSecs?: number | null;
             /**
              * Createdatsecs
-             * @description Unix seconds when the operation was created (output-only).
+             * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
             /**
              * Name
-             * @description Canonical resource name ``accounts/{account}/operations/{operation}``.
+             * @description Full resource name for the operation.
              *
-             *     ``owner_id`` is the owning account, so the public name is derived, not
-             *     stored. Output-only: serialized for clients (AIP-style), and harmlessly
-             *     ignored when the LRO client deserializes a service response.
+             *     For project operations:
+             *     ``accounts/{account}/projects/{project}/operations/{operation}``.
+             *     Operation paths accept the short ``id``.
              */
             readonly name: string;
         };
@@ -1845,8 +1922,8 @@ export interface components {
          * @description Public response projected into the completed Operation.
          */
         Splats2MeshResponse: {
-            /** @description The generated mesh. The GLB is at `files.meshes.mesh`. */
-            assetOutput?: components["schemas"]["MeshAssetOutput"] | null;
+            /** @description The generated GLB mesh. */
+            mesh: components["schemas"]["TaskAsset"];
             /**
              * Anchorpositions
              * @description Anchor positions the cameras were generated from, in Three.js coordinates. Null when no anchors were used: cameras were supplied directly, or `exterior_sphere` was chosen.
@@ -1865,41 +1942,65 @@ export interface components {
                 [key: string]: string;
             };
         };
-        /** Splats2MeshResponseOperation */
+        /**
+         * Splats2MeshResponseOperation
+         * @description Long-running operation whose successful terminal ``response`` has type ``Splats2MeshResponse``. This is the common Operation envelope with a task-specific response type, not a separate operation resource.
+         */
         Splats2MeshResponseOperation: {
-            /** Id */
+            /**
+             * Id
+             * @description Short operation id used in ``/operations/{operation}`` paths.
+             */
             id: string;
-            /** Ownerid */
+            /**
+             * Ownerid
+             * @description Account that owns the operation.
+             */
             ownerId: string;
-            /** Metadata */
+            /**
+             * Metadata
+             * @description Task information and optional progress details. Use ``metadata.task`` to interpret a generic operation response, and use ``done`` to determine completion.
+             */
             metadata?: {
                 [key: string]: unknown;
             } | null;
-            /** Done */
+            /**
+             * Done
+             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             */
             done: boolean;
+            /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
             error?: components["schemas"]["OperationError"] | null;
-            /** @description Task response payload when the operation is done. */
+            /** @description ``Splats2MeshResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
             response?: components["schemas"]["Splats2MeshResponse"] | null;
-            /** Expiresatsecs */
+            /**
+             * Expiresatsecs
+             * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
+             */
             expiresAtSecs?: number | null;
             /**
              * Createdatsecs
-             * @description Unix seconds when the operation was created (output-only).
+             * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
             /**
              * Name
-             * @description Canonical resource name ``accounts/{account}/operations/{operation}``.
+             * @description Full resource name for the operation.
              *
-             *     ``owner_id`` is the owning account, so the public name is derived, not
-             *     stored. Output-only: serialized for clients (AIP-style), and harmlessly
-             *     ignored when the LRO client deserializes a service response.
+             *     For project operations:
+             *     ``accounts/{account}/projects/{project}/operations/{operation}``.
+             *     Operation paths accept the short ``id``.
              */
             readonly name: string;
         };
         /**
          * TaskAsset
-         * @description Media input supplied by asset id, inline base64, or public URL.
+         * @description Media named by asset id, inline base64, or public URL.
+         *
+         *     A task response names each output by id and url together: the url expires,
+         *     the id does not. The pair is accepted as input as well, so a response can
+         *     be handed straight back to the next task; the id names the media and the
+         *     url is ignored. Inline base64 is an input form only, and stands alone.
          */
         TaskAsset: {
             /**
@@ -1909,28 +2010,34 @@ export interface components {
             assetId?: string | null;
             /**
              * Base64
-             * @description Base64-encoded media bytes, with or without a data URL prefix. Decoded size must be less than 10 MiB.
+             * @description Base64-encoded media bytes, with or without a data URL prefix. Decoded size must be less than 10 MiB. Input only: a task response never carries inline bytes.
              */
             base64?: string | null;
             /**
              * Url
-             * @description Public HTTP(S) URL containing the media.
+             * @description Public HTTP(S) URL containing the media. On a task response this is a read URL for `assetId` and it expires; mint a fresh one with `assets/{asset}:createReadUrl`.
              */
             url?: string | null;
         };
         /**
          * UploadGrant
-         * @description Permission to upload one part's bytes, straight to the store.
+         * @description Permission to upload one asset part.
          */
         UploadGrant: {
-            /** Role */
+            /**
+             * Role
+             * @description Declared asset-part role this upload fills.
+             */
             role: string;
             /**
              * Method
              * @description HTTP verb to use for the upload, e.g. PUT.
              */
             method: string;
-            /** Url */
+            /**
+             * Url
+             * @description Short-lived upload URL. Send the bytes here without the World Labs API key.
+             */
             url: string;
             /**
              * Headers
@@ -1942,6 +2049,7 @@ export interface components {
             /**
              * Expiresat
              * Format: date-time
+             * @description When this upload grant expires; create a new one after.
              */
             expiresAt: string;
         };
@@ -2013,9 +2121,6 @@ export type CreateUploadUrlsResponse = components['schemas']['CreateUploadUrlsRe
 export type Empty = components['schemas']['Empty'];
 export type FrameRGBAsset = components['schemas']['FrameRGBAsset'];
 export type HTTPValidationError = components['schemas']['HTTPValidationError'];
-export type ImageCollectionAssetOutput = components['schemas']['ImageCollectionAssetOutput'];
-export type ImageCollectionAssetOutputFiles = components['schemas']['ImageCollectionAssetOutputFiles'];
-export type ImageCollectionFiles = components['schemas']['ImageCollectionFiles'];
 export type Images2PosedRGBDPerImageResult = components['schemas']['Images2PosedRGBDPerImageResult'];
 export type Images2PosedRGBDRequest = components['schemas']['Images2PosedRGBDRequest'];
 export type Images2PosedRGBDResponse = components['schemas']['Images2PosedRGBDResponse'];
@@ -2024,9 +2129,6 @@ export type LinearDepthBufferAsset = components['schemas']['LinearDepthBufferAss
 export type ListAssetsResponse = components['schemas']['ListAssetsResponse'];
 export type ListOperationsResponse = components['schemas']['ListOperationsResponse'];
 export type LogDepthBufferAsset = components['schemas']['LogDepthBufferAsset'];
-export type MeshAssetOutput = components['schemas']['MeshAssetOutput'];
-export type MeshAssetOutputFiles = components['schemas']['MeshAssetOutputFiles'];
-export type MeshFiles = components['schemas']['MeshFiles'];
 export type Operation = components['schemas']['Operation'];
 export type OperationError = components['schemas']['OperationError'];
 export type OperationTrace = components['schemas']['OperationTrace'];
@@ -2477,6 +2579,8 @@ export interface operations {
         parameters: {
             query?: {
                 origin?: components["schemas"]["ResourceOrigin"] | null;
+                /** @description Filter by state. Omit for all non-deleted states. */
+                state?: components["schemas"]["AssetState"] | null;
                 pageSize?: number;
                 pageToken?: string | null;
             };