@worldlabsai/client 0.1.1 → 0.3.0

package/dist/generated/developer-api.gen.d.ts

@@ -29,7 +29,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;
@@ -46,7 +46,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;
@@ -63,7 +63,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;
@@ -80,7 +80,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;
@@ -97,7 +97,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;
@@ -114,7 +114,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;
@@ -190,6 +190,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v2/operations/{operation}/webhookDelivery": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get the webhook delivery record for an operation */
+        get: operations["get_webhook_delivery_api_v2_operations__operation__webhookDelivery_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v2/operations/{operation}": {
         parameters: {
             query?: never;
@@ -346,13 +363,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
@@ -371,7 +391,7 @@ export interface components {
             sizeBytes?: string | null;
             /**
              * Checksum
-             * @description Checksum the store reports, e.g. ``crc32c:...``.
+             * @description Checksum when available.
              */
             checksum?: string | null;
             /**
@@ -396,11 +416,17 @@ export interface components {
             structure?: {
                 [key: string]: unknown;
             } | null;
-            /** @description Set when a task produced the asset. */
+            /** @description How the asset came to exist, when that was recorded. */
             producedBy?: components["schemas"]["ProducedBy"] | null;
+            /**
+             * Transient
+             * @description True when the bytes are not retained: an upload made while the account does not retain content, or an output of an operation that purges. Both are deleted an hour after the last operation that names them finishes; an upload no operation consumes is deleted by age instead. ``contentPath`` is null for such an asset; read it through ``:createReadUrl``.
+             * @default false
+             */
+            transient?: boolean;
             /**
              * 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;
         };
@@ -413,7 +439,12 @@ export interface components {
              * Displayname
              * @description User-visible label.
              */
-            displayName: string;
+            displayName?: string | null;
+            /**
+             * Session
+             * @description The Web API session this upload belongs to. The session must be in the same project; the asset inherits its applet.
+             */
+            session?: 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``.
@@ -438,17 +469,47 @@ 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;
         };
+        /**
+         * AssetGroup
+         * @description The assets one Operation produced, in the page's order.
+         */
+        AssetGroup: {
+            /**
+             * Operation
+             * @description The Operation that produced them.
+             */
+            operation: string;
+            /**
+             * Task
+             * @description The task that produced them, e.g. ``image2DraftSplats``.
+             */
+            task?: string | null;
+            /** Assets */
+            assets?: components["schemas"]["Asset"][];
+        };
+        /**
+         * AssetGrouping
+         * @description What a listing collects its assets under.
+         * @enum {string}
+         */
+        AssetGrouping: "OPERATION";
+        /**
+         * AssetOrder
+         * @description How a listing orders its page.
+         *
+         *     A grouped page orders on each group's leading asset -- its newest running
+         *     newest-first, its oldest running the other way -- so a group sorts where
+         *     its nearest asset would have in the flat listing.
+         * @enum {string}
+         */
+        AssetOrder: "CREATE_TIME_DESC" | "CREATE_TIME_ASC";
         /**
          * 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: {
             /**
@@ -478,7 +539,7 @@ export interface components {
             sizeBytes?: string | null;
             /**
              * Checksum
-             * @description Checksum the store reports, e.g. ``crc32c:...``.
+             * @description Checksum when available.
              */
             checksum?: string | null;
             /**
@@ -498,17 +559,23 @@ 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
-             * @description Upload size in bytes, serialized on the wire as a string.
+             * @description Upload size in bytes, serialized on the wire as a string. Capped at 1 GiB.
              */
             contentLength: number;
             /**
@@ -519,6 +586,16 @@ export interface components {
                 [key: string]: unknown;
             } | null;
         };
+        /**
+         * AssetProducer
+         * @description The act that produced an asset.
+         *
+         *     A customer's own bytes are an UPLOAD however they arrived; bytes we
+         *     fetched from an address they gave us are an IMPORT; a task's output is a
+         *     TASK.
+         * @enum {string}
+         */
+        AssetProducer: "UPLOAD" | "IMPORT" | "TASK";
         /**
          * AssetState
          * @enum {string}
@@ -535,16 +612,9 @@ export interface components {
              * @default 42
              */
             seed?: number | null;
-            /**
-             * Cfg
-             * @description Classifier-free guidance scale.
-             * @default 2.5
-             */
-            cfg?: number | null;
             /**
              * Numsteps
-             * @description Diffusion step count.
-             * @default 50
+             * @description Diffusion step count. Unset uses the served model's own sampler.
              */
             numSteps?: number | null;
         };
@@ -553,6 +623,16 @@ export interface components {
          * @description Body of ``POST /api/v2/tasks:atlasChisel``.
          */
         AtlasChiselRequest: {
+            /**
+             * Webhookurl
+             * @description Where Marble POSTs one signed task.succeeded or task.failed event when this operation finishes; retried for 24 hours. Verify the signature with the public keys at /.well-known/webhooks/jwks.json. Cannot be combined with ?wait=true. https on port 443 only, no IP literals. Developer API only.
+             */
+            webhookUrl?: string | null;
+            /**
+             * Purgecontentonoperationcompletion
+             * @description Purge this operation's outputs and the transient uploads it consumed one hour after it finishes. Omitted, the account's setting applies; true raises it for this operation; false is refused when the account already purges. Uploads in the library are never purged by an operation.
+             */
+            purgeContentOnOperationCompletion?: boolean | null;
             /**
              * Contextframes
              * @description Posed depth frames, one per target camera and posed at it, in target order; each camera is 1280x720. Depth only: frames carry no imageAsset, maskAsset, or depth confidenceAsset. Leave empty to generate from the prompt alone.
@@ -614,35 +694,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;
         };
@@ -657,16 +756,9 @@ export interface components {
              * @default 42
              */
             seed?: number | null;
-            /**
-             * Cfg
-             * @description Classifier-free guidance scale.
-             * @default 2.5
-             */
-            cfg?: number | null;
             /**
              * Numsteps
-             * @description Diffusion step count.
-             * @default 50
+             * @description Diffusion step-count override.
              */
             numSteps?: number | null;
         };
@@ -675,6 +767,16 @@ export interface components {
          * @description Body of ``POST /api/v2/tasks:atlasGenerate``.
          */
         AtlasGenerateRequest: {
+            /**
+             * Webhookurl
+             * @description Where Marble POSTs one signed task.succeeded or task.failed event when this operation finishes; retried for 24 hours. Verify the signature with the public keys at /.well-known/webhooks/jwks.json. Cannot be combined with ?wait=true. https on port 443 only, no IP literals. Developer API only.
+             */
+            webhookUrl?: string | null;
+            /**
+             * Purgecontentonoperationcompletion
+             * @description Purge this operation's outputs and the transient uploads it consumed one hour after it finishes. Omitted, the account's setting applies; true raises it for this operation; false is refused when the account already purges. Uploads in the library are never purged by an operation.
+             */
+            purgeContentOnOperationCompletion?: boolean | null;
             /**
              * Contextframes
              * @description Posed RGBD context views: each an image, its depth buffer, and its camera, all required. On the reference-context warp route the depth conditions the generation geometrically, so the generated views stay consistent with the provided scene; the hero base checkpoint conditions on the posed images only and does not consume the depth.
@@ -726,35 +828,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;
         };
@@ -769,12 +890,6 @@ export interface components {
              * @default 42
              */
             seed?: number | null;
-            /**
-             * Cfg
-             * @description Classifier-free guidance scale.
-             * @default 2.5
-             */
-            cfg?: number | null;
             /**
              * Numsteps
              * @description Diffusion step count.
@@ -787,6 +902,16 @@ export interface components {
          * @description Body of ``POST /api/v2/tasks:atlasMasked``.
          */
         AtlasMaskedRequest: {
+            /**
+             * Webhookurl
+             * @description Where Marble POSTs one signed task.succeeded or task.failed event when this operation finishes; retried for 24 hours. Verify the signature with the public keys at /.well-known/webhooks/jwks.json. Cannot be combined with ?wait=true. https on port 443 only, no IP literals. Developer API only.
+             */
+            webhookUrl?: string | null;
+            /**
+             * Purgecontentonoperationcompletion
+             * @description Purge this operation's outputs and the transient uploads it consumed one hour after it finishes. Omitted, the account's setting applies; true raises it for this operation; false is refused when the account already purges. Uploads in the library are never purged by an operation.
+             */
+            purgeContentOnOperationCompletion?: boolean | null;
             /**
              * Contextframes
              * @description The views to complete, in output order: each an image, its alpha mask, and its camera. The mask is an 8-bit grayscale PNG on the image grid where 1 is kept -- those pixels are the observed image -- and 0 is what the model fills in. Each view is completed at its targetCameras entry of the same index.
@@ -799,13 +924,13 @@ export interface components {
             targetCameras: components["schemas"]["PinholeCamera"][];
             /**
              * Prompt
-             * @description Text prompt describing what belongs in the masked region.
+             * @description The edit to make. With enhancePrompt on (the default), write an instruction that names what to add, remove, replace, or restyle and where, such as 'replace the yellow car with a stone fountain in the middle of the courtyard'. The enhancer reads it with the original context images but not the masks. Without a prompt it describes the images as they are, which tends to restore masked objects, so state removals explicitly. With enhancePrompt false the model receives the text unchanged as a caption of the finished image, so describe the whole finished scene instead.
              */
             prompt?: string | null;
             /**
              * Enhanceprompt
-             * @description Enhance the prompt with the ViewGen preset before inference. Off by default: the observed pixels already describe the scene, so a completion usually wants the prompt it was given.
-             * @default false
+             * @description Rewrite the prompt before inference: the edit instruction and the context images become a detailed description of the finished scene, returned as promptUsed. Set false to send the prompt exactly as given.
+             * @default true
              */
             enhancePrompt?: boolean;
             /**
@@ -838,35 +963,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;
         };
@@ -875,6 +1019,16 @@ export interface components {
          * @description Body of ``POST /api/v2/tasks:atlasTextToImage``.
          */
         AtlasTextToImageRequest: {
+            /**
+             * Webhookurl
+             * @description Where Marble POSTs one signed task.succeeded or task.failed event when this operation finishes; retried for 24 hours. Verify the signature with the public keys at /.well-known/webhooks/jwks.json. Cannot be combined with ?wait=true. https on port 443 only, no IP literals. Developer API only.
+             */
+            webhookUrl?: string | null;
+            /**
+             * Purgecontentonoperationcompletion
+             * @description Purge this operation's outputs and the transient uploads it consumed one hour after it finishes. Omitted, the account's setting applies; true raises it for this operation; false is refused when the account already purges. Uploads in the library are never purged by an operation.
+             */
+            purgeContentOnOperationCompletion?: boolean | null;
             /**
              * Prompt
              * @description Text prompt to generate from.
@@ -896,11 +1050,6 @@ export interface components {
              * @description Optional RNG seed.
              */
             seed?: number | null;
-            /**
-             * Cfg
-             * @description Classifier-free guidance scale.
-             */
-            cfg?: number | null;
             /**
              * Numsteps
              * @description Diffusion step count.
@@ -913,7 +1062,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;
@@ -924,72 +1073,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;
         };
@@ -1067,7 +1213,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;
         };
@@ -1125,6 +1271,7 @@ export interface components {
              * @description Optional client-supplied resource id.
              */
             assetId?: string | null;
+            /** @description Asset metadata and ingestion source. */
             asset: components["schemas"]["AssetCreate"];
         };
         /**
@@ -1141,13 +1288,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
@@ -1166,7 +1316,7 @@ export interface components {
             sizeBytes?: string | null;
             /**
              * Checksum
-             * @description Checksum the store reports, e.g. ``crc32c:...``.
+             * @description Checksum when available.
              */
             checksum?: string | null;
             /**
@@ -1191,53 +1341,65 @@ export interface components {
             structure?: {
                 [key: string]: unknown;
             } | null;
-            /** @description Set when a task produced the asset. */
+            /** @description How the asset came to exist, when that was recorded. */
             producedBy?: components["schemas"]["ProducedBy"] | null;
+            /**
+             * Transient
+             * @description True when the bytes are not retained: an upload made while the account does not retain content, or an output of an operation that purges. Both are deleted an hour after the last operation that names them finishes; an upload no operation consumes is deleted by age instead. ``contentPath`` is null for such an asset; read it through ``:createReadUrl``.
+             * @default false
+             */
+            transient?: boolean;
             /**
              * 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;
         };
@@ -1254,7 +1416,7 @@ export interface components {
             contentType: string;
             /**
              * Contentlength
-             * @description Expected upload size in bytes, serialized on the wire as a string.
+             * @description Expected upload size in bytes, serialized on the wire as a string. Capped at 1 GiB.
              */
             contentLength: number;
         };
@@ -1263,7 +1425,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
@@ -1273,6 +1438,7 @@ export interface components {
             /**
              * Expiresat
              * Format: date-time
+             * @description When this upload grant expires; create a new one after.
              */
             expiresAt: string;
             /**
@@ -1290,13 +1456,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"][];
         };
         /**
@@ -1326,31 +1498,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.
@@ -1384,6 +1531,16 @@ export interface components {
          * @description Body of ``POST /api/v2/tasks:images2PosedRGBD``.
          */
         Images2PosedRGBDRequest: {
+            /**
+             * Webhookurl
+             * @description Where Marble POSTs one signed task.succeeded or task.failed event when this operation finishes; retried for 24 hours. Verify the signature with the public keys at /.well-known/webhooks/jwks.json. Cannot be combined with ?wait=true. https on port 443 only, no IP literals. Developer API only.
+             */
+            webhookUrl?: string | null;
+            /**
+             * Purgecontentonoperationcompletion
+             * @description Purge this operation's outputs and the transient uploads it consumed one hour after it finishes. Omitted, the account's setting applies; true raises it for this operation; false is refused when the account already purges. Uploads in the library are never purged by an operation.
+             */
+            purgeContentOnOperationCompletion?: boolean | null;
             /**
              * Frames
              * @description Ordered image inputs (min 1). A frame that carries a camera, a depth buffer or a mask is rejected rather than quietly ignored: none of them reaches the reconstruction.
@@ -1407,6 +1564,12 @@ export interface components {
                 number,
                 number
             ] | null;
+            /**
+             * Refineposes
+             * @description Bundle-adjust the estimated cameras against dense matches before answering. The backbone's poses are good to about half a degree, which is enough to reconstruct from and not enough to refine against: the residual shows up as blur wherever two views disagree. The solve anchors on the depth this task has just produced, so it costs a matcher pass and a solve rather than another reconstruction, and it needs two or more frames. A solve that moves the cameras further than the guards allow is thrown away and the unrefined reconstruction is returned, which is a success rather than an error.
+             * @default false
+             */
+            refinePoses?: boolean;
         };
         /**
          * Images2PosedRGBDResponse
@@ -1414,40 +1577,64 @@ export interface components {
          */
         Images2PosedRGBDResponse: {
             /**
-             * Results
-             * @description One result per input image.
+             * Frames
+             * @description One reconstructed frame per input image, in request order.
+             */
+            frames: components["schemas"]["Images2PosedRGBDPerImageResult"][];
+            /**
+             * Poserefinementaccepted
+             * @description When refinePoses was requested, whether the refined cameras were kept. False means the original reconstruction was returned; null means refinement was not requested.
              */
-            results: components["schemas"]["Images2PosedRGBDPerImageResult"][];
+            poseRefinementAccepted?: boolean | null;
         };
-        /** 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;
         };
@@ -1461,23 +1648,101 @@ 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 a project's assets, flat or grouped.
+         *
+         *     ``assets`` and ``groups`` are alternatives rather than a pair: a request
+         *     that named no ``groupBy`` fills the first and leaves the second empty, and
+         *     one that named a grouping does the reverse. The page token pages whichever
+         *     of the two was filled, so a grouped page counts groups.
+         */
         ListAssetsResponse: {
-            /** Assets */
+            /**
+             * Assets
+             * @description Assets in the selected page. Empty when the request named a grouping.
+             */
             assets?: components["schemas"]["Asset"][];
+            /**
+             * Groups
+             * @description Set only when the request named a grouping. An asset the grouping cannot place is absent - uploads and imports have no producing task - so list without a grouping to reach those.
+             */
+            groups?: components["schemas"]["AssetGroup"][];
             /**
              * Nextpagetoken
+             * @description Opaque token for the next page; empty on the final page.
              * @default
              */
             nextPageToken?: string;
         };
         /**
-         * ListOperationsResponse
+         * ListedOperation
+         * @description An Operation as the Marble API lists it: with its callback's progress.
+         */
+        ListedOperation: {
+            /**
+             * Id
+             * @description Short operation id used in ``/operations/{operation}`` paths.
+             */
+            id: string;
+            /**
+             * Ownerid
+             * @description Account that owns the operation.
+             */
+            ownerId: string;
+            /**
+             * 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
+             * @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
+             * @description Task-specific result when ``done`` is true and the task succeeded; null while running and after failure.
+             */
+            response?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * 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 accepted.
+             */
+            createdAtSecs?: number | null;
+            /** @description Set for an operation that asked for a callback (webhookUrl). Absent on a cancelled operation, which sends no event, and when the webhook service could not be read. GET the operation's webhookDelivery for the full record. */
+            webhookDelivery?: components["schemas"]["WebhookDeliverySummary"] | null;
+            /**
+             * Name
+             * @description Full resource name for the operation.
+             *
+             *     For project operations:
+             *     ``accounts/{account}/projects/{project}/operations/{operation}``.
+             *     Operation paths accept the short ``id``.
+             */
+            readonly name: string;
+        };
+        /**
+         * ListedOperationsResponse
          * @description A page of operations, newest first.
          */
-        ListOperationsResponse: {
-            /** Operations */
-            operations: components["schemas"]["Operation"][];
+        ListedOperationsResponse: {
+            /**
+             * Operations
+             * @description Operations ordered from newest to oldest.
+             */
+            operations: components["schemas"]["ListedOperation"][];
             /**
              * Nextpagetoken
              * @description Token for the next page; absent when there are no more.
@@ -1504,65 +1769,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;
         };
@@ -1589,9 +1848,19 @@ export interface components {
                 [key: string]: unknown;
             }[];
         };
+        /**
+         * OperationStatus
+         * @description Coarse outcome filter derived from ``done`` and ``error``.
+         *
+         *     FAILED is every done operation carrying an error, so cancelled and expired
+         *     operations count as failed; ``metadata.state`` keeps the finer lifecycle
+         *     value.
+         * @enum {string}
+         */
+        OperationStatus: "RUNNING" | "SUCCEEDED" | "FAILED";
         /**
          * OperationTrace
-         * @description Public request/response data without the internal task record or raw LRO.
+         * @description The caller's recorded request beside the Operation's own response and error.
          */
         OperationTrace: {
             /** Operationid */
@@ -1600,14 +1869,22 @@ export interface components {
             taskName: string;
             /** Taskversion */
             taskVersion: string;
-            /** Request */
-            request: {
+            /**
+             * Request
+             * @description The request as the caller sent it, projected through the task's current public schema when that schema still accepts it and as recorded otherwise. Null only for early operations that retained no caller-shaped request.
+             */
+            request?: {
                 [key: string]: unknown;
-            };
-            /** Response */
+            } | null;
+            /**
+             * Response
+             * @description The Operation's ``response``, served the same way.
+             */
             response?: {
                 [key: string]: unknown;
             } | null;
+            /** @description The Operation's ``error``, served the same way. */
+            error?: components["schemas"]["OperationError"] | null;
         };
         /**
          * PinholeCamera
@@ -1713,9 +1990,28 @@ export interface components {
         };
         /**
          * ProducedBy
-         * @description The task that produced this asset. Absent on an upload or import.
+         * @description How the asset came to exist.
+         *
+         *     Present on every asset whose provenance was recorded. ``producer`` says
+         *     which act made it, and the rest qualify that act: ``task`` and
+         *     ``operation`` are set only for ``TASK``, and ``applet`` and ``session``
+         *     only for work done through the Web API.
          */
         ProducedBy: {
+            /** @description The act that made the asset. */
+            producer: components["schemas"]["AssetProducer"];
+            /** @description The product surface the act came through. */
+            origin?: components["schemas"]["ResourceOrigin"] | null;
+            /**
+             * Applet
+             * @description The applet the asset came from, e.g. ``turntable``. Set for Web API work whose session named one.
+             */
+            applet?: string | null;
+            /**
+             * Session
+             * @description The Web API session the asset was made inside.
+             */
+            session?: string | null;
             /**
              * Task
              * @description The task that produced it, e.g. ``image2DraftSplats``.
@@ -1809,6 +2105,16 @@ export interface components {
          * @description Body of a splats2Mesh request.
          */
         Splats2MeshRequest: {
+            /**
+             * Webhookurl
+             * @description Where Marble POSTs one signed task.succeeded or task.failed event when this operation finishes; retried for 24 hours. Verify the signature with the public keys at /.well-known/webhooks/jwks.json. Cannot be combined with ?wait=true. https on port 443 only, no IP literals. Developer API only.
+             */
+            webhookUrl?: string | null;
+            /**
+             * Purgecontentonoperationcompletion
+             * @description Purge this operation's outputs and the transient uploads it consumed one hour after it finishes. Omitted, the account's setting applies; true raises it for this operation; false is refused when the account already purges. Uploads in the library are never purged by an operation.
+             */
+            purgeContentOnOperationCompletion?: boolean | null;
             /**
              * Cameras
              * @description Cameras the splats are rendered from. The surface is reconstructed from those renders, so geometry no camera sees is not meshed. Name a strategy -- `auto_anchors` (the default) finds viewpoints in the scene's free space, `manual_anchors` takes them from the request, `exterior_sphere` rings the scene from outside for an object or turntable capture -- or pass a list of cameras to render as given, at most 512, sharing one width and height between 64 and 1024 that becomes the render resolution.
@@ -1844,8 +2150,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.
@@ -1864,41 +2170,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: {
             /**
@@ -1908,28 +2238,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
@@ -1941,6 +2277,7 @@ export interface components {
             /**
              * Expiresat
              * Format: date-time
+             * @description When this upload grant expires; create a new one after.
              */
             expiresAt: string;
         };
@@ -1968,6 +2305,114 @@ export interface components {
              */
             timeoutSecs?: number | null;
         };
+        /**
+         * WebhookDelivery
+         * @description The callback record for one operation.
+         */
+        WebhookDelivery: {
+            /**
+             * Name
+             * @description `accounts/{account}/projects/{project}/operations/{operation}/webhookDelivery`.
+             */
+            name: string;
+            /**
+             * Deliveryid
+             * @description The value sent in the `webhook-id` header; absent while SCHEDULED or PUBLISH_FAILED.
+             */
+            deliveryId?: string | null;
+            /**
+             * Webhookurl
+             * @description The accepted webhookUrl; absent once the operation's content was purged, while the delivery record itself stays.
+             */
+            webhookUrl?: string | null;
+            /**
+             * State
+             * @description SCHEDULED until the operation is terminal and handed over; PUBLISH_FAILED when Marble could not hand the completion to its webhook service (poll the operation instead); then the delivery's own state: PENDING (waiting for the next attempt), IN_FLIGHT, DELIVERED, SUPPRESSED (the receiver answered 410), EXHAUSTED (the 24-hour window closed, or after one attempt when the webhookUrl host resolves to a private address). A cancelled operation sends no event and answers 404.
+             */
+            state: ("SCHEDULED" | "PUBLISH_FAILED") | ("PENDING" | "IN_FLIGHT" | "DELIVERED" | "SUPPRESSED" | "EXHAUSTED");
+            /**
+             * Event
+             * @description The exact event body sent, once the delivery exists.
+             */
+            event?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Attemptcount
+             * @description Sends attempted so far; a claim counts before its outcome.
+             * @default 0
+             */
+            attemptCount?: number;
+            /** Lastattempttime */
+            lastAttemptTime?: string | null;
+            lastAttempt?: components["schemas"]["WebhookDeliveryAttempt"] | null;
+            /**
+             * Nextattempttime
+             * @description Scheduled time of the next attempt while PENDING.
+             */
+            nextAttemptTime?: string | null;
+            /**
+             * Expiretime
+             * @description End of the 24-hour window.
+             */
+            expireTime?: string | null;
+            /**
+             * Finishtime
+             * @description Set when terminal.
+             */
+            finishTime?: string | null;
+            /**
+             * Purgetime
+             * @description Expires 90 days after the webhook service accepted the delivery.
+             */
+            purgeTime?: string | null;
+            /**
+             * Createtime
+             * Format: date-time
+             */
+            createTime: string;
+            /**
+             * Updatetime
+             * Format: date-time
+             */
+            updateTime: string;
+        };
+        /**
+         * WebhookDeliveryAttempt
+         * @description The latest send's outcome; never the receiver's body.
+         */
+        WebhookDeliveryAttempt: {
+            /**
+             * Httpstatus
+             * @description The receiver's status, if it answered.
+             */
+            httpStatus?: number | null;
+            /**
+             * Errorcategory
+             * @description Why the attempt did not get a status: a send that failed (timeout, connect_error, tls_error, internal, proxy_rejected:<reason> such as dns_error or private_address), or a close with no send (expired, purged, account_deleted); `publish_failed` while PUBLISH_FAILED.
+             */
+            errorCategory?: string | null;
+        };
+        /**
+         * WebhookDeliverySummary
+         * @description A listed operation's callback at a glance; its webhookDelivery has the
+         *     full record.
+         */
+        WebhookDeliverySummary: {
+            /**
+             * State
+             * @description The state its webhookDelivery answers.
+             */
+            state: ("SCHEDULED" | "PUBLISH_FAILED") | ("PENDING" | "IN_FLIGHT" | "DELIVERED" | "SUPPRESSED" | "EXHAUSTED");
+            /**
+             * Attemptcount
+             * @description Sends attempted so far; a claim counts before its outcome.
+             * @default 0
+             */
+            attemptCount?: number;
+            /** Lastattempttime */
+            lastAttemptTime?: string | null;
+        };
     };
     responses: never;
     parameters: never;
@@ -1977,8 +2422,12 @@ export interface components {
 }
 export type Asset = components['schemas']['Asset'];
 export type AssetCreate = components['schemas']['AssetCreate'];
+export type AssetGroup = components['schemas']['AssetGroup'];
+export type AssetGrouping = components['schemas']['AssetGrouping'];
+export type AssetOrder = components['schemas']['AssetOrder'];
 export type AssetPart = components['schemas']['AssetPart'];
 export type AssetPartDeclaration = components['schemas']['AssetPartDeclaration'];
+export type AssetProducer = components['schemas']['AssetProducer'];
 export type AssetState = components['schemas']['AssetState'];
 export type AtlasChiselModelParameters = components['schemas']['AtlasChiselModelParameters'];
 export type AtlasChiselRequest = components['schemas']['AtlasChiselRequest'];
@@ -2012,22 +2461,18 @@ 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'];
 export type Images2PosedRGBDResponseOperation = components['schemas']['Images2PosedRGBDResponseOperation'];
 export type LinearDepthBufferAsset = components['schemas']['LinearDepthBufferAsset'];
 export type ListAssetsResponse = components['schemas']['ListAssetsResponse'];
-export type ListOperationsResponse = components['schemas']['ListOperationsResponse'];
+export type ListedOperation = components['schemas']['ListedOperation'];
+export type ListedOperationsResponse = components['schemas']['ListedOperationsResponse'];
 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 OperationStatus = components['schemas']['OperationStatus'];
 export type OperationTrace = components['schemas']['OperationTrace'];
 export type PinholeCamera = components['schemas']['PinholeCamera'];
 export type PinholeCameraIntrinsics = components['schemas']['PinholeCameraIntrinsics'];
@@ -2046,6 +2491,9 @@ export type TaskAsset = components['schemas']['TaskAsset'];
 export type UploadGrant = components['schemas']['UploadGrant'];
 export type ValidationError = components['schemas']['ValidationError'];
 export type WaitOperationRequest = components['schemas']['WaitOperationRequest'];
+export type WebhookDelivery = components['schemas']['WebhookDelivery'];
+export type WebhookDeliveryAttempt = components['schemas']['WebhookDeliveryAttempt'];
+export type WebhookDeliverySummary = components['schemas']['WebhookDeliverySummary'];
 export type $defs = Record<string, never>;
 export interface operations {
     api_health_api_v2_health_get: {
@@ -2308,6 +2756,14 @@ export interface operations {
         parameters: {
             query?: {
                 origin?: components["schemas"]["ResourceOrigin"] | null;
+                /** @description Only operations of this task, as named in metadata.task. */
+                task?: string | null;
+                /** @description Only operations with this outcome. FAILED is every done operation carrying an error, including cancelled and expired ones. */
+                status?: components["schemas"]["OperationStatus"] | null;
+                /** @description Unix seconds; only operations accepted at or after this time. */
+                createdAfter?: number | null;
+                /** @description Unix seconds; only operations accepted before this time. */
+                createdBefore?: number | null;
                 pageSize?: number;
                 pageToken?: string | null;
             };
@@ -2323,7 +2779,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ListOperationsResponse"];
+                    "application/json": components["schemas"]["ListedOperationsResponse"];
                 };
             };
             /** @description Validation Error */
@@ -2438,6 +2894,37 @@ export interface operations {
             };
         };
     };
+    get_webhook_delivery_api_v2_operations__operation__webhookDelivery_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                operation: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookDelivery"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     get_operation_api_v2_operations__operation__get: {
         parameters: {
             query?: {
@@ -2478,6 +2965,22 @@ export interface operations {
                 origin?: components["schemas"]["ResourceOrigin"] | null;
                 /** @description Filter by state. Omit for all non-deleted states. */
                 state?: components["schemas"]["AssetState"] | null;
+                /** @description Only assets made inside this Web API session. */
+                session?: string | null;
+                /** @description Only assets that came from this applet. */
+                applet?: string | null;
+                /** @description Only assets of this media type. A trailing `/*`, as in `image/*`, matches every type in the family. */
+                mimeType?: string | null;
+                /** @description Only assets this Operation produced. */
+                operation?: string | null;
+                /** @description Only assets this task produced, e.g. `image2DraftSplats`. */
+                task?: string | null;
+                /** @description Only assets made this way, e.g. `UPLOAD` for the customer's own bytes. Assets recorded before the producer was stored match no value. */
+                producer?: components["schemas"]["AssetProducer"] | null;
+                /** @description Collect the assets under what produced them. The page then counts groups rather than assets. */
+                groupBy?: components["schemas"]["AssetGrouping"] | null;
+                /** @description Order of the page. A grouped page orders each group by its leading asset: its newest one descending, its oldest ascending. */
+                orderBy?: components["schemas"]["AssetOrder"];
                 pageSize?: number;
                 pageToken?: string | null;
             };