@worldlabsai/client 0.2.0 → 0.4.0

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

@@ -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;
@@ -399,13 +416,24 @@ 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 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;
+            /**
+             * Url
+             * @description Unsigned content URL for the asset, ``baseUrl + contentPath``. It does not grant access by itself: the web app's read-prefix cookie authorizes it, and an API client appends ``?`` and a read prefix's ``signedQuery`` or uses ``assets/{asset}:createReadUrl`` instead. Null whenever ``contentPath`` is.
+             */
+            url?: string | null;
         };
         /**
          * AssetCreate
@@ -417,6 +445,11 @@ export interface components {
              * @description User-visible label.
              */
             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``.
@@ -445,6 +478,40 @@ export interface components {
              */
             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. ``atlasGenerate``.
+             */
+            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.
@@ -513,7 +580,7 @@ export interface components {
             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;
             /**
@@ -524,6 +591,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}
@@ -540,16 +617,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;
         };
@@ -558,11 +628,26 @@ 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.
+             * @description Posed depth frames, one per target camera and posed at it, in target order; each camera is 1280x720. Frames may also carry an imageAsset (the view's known pixels) and a maskAsset (8-bit grayscale, white where the frame's image and depth are known), each on every frame or on none: the model keeps the image where the mask is set and generates the rest, takes frames without masks as fully known, and conditions on the depth alone for frames without an image. Frames carry no depth confidenceAsset. Leave empty to generate from the prompt alone.
              */
             contextFrames?: components["schemas"]["PosedDepthAsset"][];
+            /**
+             * Sourceframes
+             * @description Posed RGB photographs of the scene, each an image and its camera in the targets' coordinate convention and scale. The generated views stay consistent with them: the servable feeds them to the model as views it has already committed, so a target that sees the same surfaces keeps their materials, colors, and lighting. Any cameras and any resolution; each is cover-resized and center-cropped onto 1280x720. Frames carry no maskAsset or depth. Together with contextFrames and targetCameras they fill at most 128 views of the servable's rollout, where a context frame costs 3 and a photograph or target one.
+             */
+            sourceFrames?: components["schemas"]["PosedRGBAsset"][];
             /**
              * Targetcameras
              * @description Pinhole cameras at 1280x720 for the views to generate, in output order, returned in `frames`. At most 32.
@@ -593,7 +678,7 @@ export interface components {
             modelParameters?: components["schemas"]["AtlasChiselModelParameters"];
             /**
              * Returndepth
-             * @description Return the generated frames as posed RGBD: they are reconstructed together so the depth lands in the request's own camera frame and scale, and every entry in `frames` then carries a `depth` buffer. The contextFrames' own depth is not reconstructed or returned. Needs at least two target cameras. Limitation: the depth scale is recovered from the target cameras' centres, so targets that share one centre (a pure-rotation rig) come back with a 0.0 or NaN scale and a success status.
+             * @description Return the generated frames as posed RGBD: they are reconstructed together so the depth lands in the request's own camera frame and scale, and every entry in `frames` then carries a `depth` buffer. The contextFrames' own depth is not reconstructed or returned. A source photograph joins the reconstruction as an anchor, and gets no depth back, only when its image is at the generated resolution and its camera's principal point is centered. Needs at least two target cameras. Limitation: the depth scale is recovered from the camera centers that joined, so targets that share one center (a pure-rotation rig) and no anchor come back with a 0.0 or NaN scale and a success status.
              * @default false
              */
             returnDepth?: boolean;
@@ -643,13 +728,11 @@ export interface components {
             } | null;
             /**
              * Done
-             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             * @description Whether the operation is terminal. When true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
              */
             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 ``AtlasChiselResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
-            response?: components["schemas"]["AtlasChiselResponse"] | null;
             /**
              * Expiresatsecs
              * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
@@ -660,6 +743,8 @@ export interface components {
              * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
+            /** @description ``AtlasChiselResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
+            response?: components["schemas"]["AtlasChiselResponse"] | null;
             /**
              * Name
              * @description Full resource name for the operation.
@@ -681,16 +766,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;
         };
@@ -699,9 +777,25 @@ 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;
+            /**
+             * Base64Outputs
+             * @description When a ?wait=true submission is answered inline, return each output file as base64 in that response rather than by assetId and url. This skips storing the files before the answer and the caller's download after it. Any other submission, and every later read of the operation, names the outputs by assetId and url.
+             * @default false
+             */
+            base64Outputs?: boolean;
             /**
              * 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.
+             * @description Posed RGBD context views: each an image, its depth buffer, and its camera, all required. All context cameras must declare the same width and height. 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.
              */
             contextFrames: components["schemas"]["PosedRGBDAsset"][];
             /**
@@ -722,7 +816,7 @@ export interface components {
             enhancePrompt?: boolean;
             /**
              * Returndepth
-             * @description Return the generated frames as posed RGBD: they are reconstructed together with the context frames so the depth lands in the request's own camera frame and scale, and every entry in `frames` then carries a `depth` buffer. A context frame joins that reconstruction only when its image is at the generated resolution and its camera's principal point is centered. The scale is recovered from the camera centres that joined, so a request whose joined cameras all share one centre (a pure-rotation rig) is rejected.
+             * @description Return the generated frames as posed RGBD: they are reconstructed together with the context frames so the depth lands in the request's own camera frame and scale, and every entry in `frames` then carries a `depth` buffer. The scale is recovered from camera centres, so a request whose cameras all share one centre (a pure-rotation rig) is rejected. On the hero base route, with more than 19 context frames, or with a masked context frame, a context frame joins the reconstruction only when its image is at the generated resolution and its camera's principal point is centered.
              * @default false
              */
             returnDepth?: boolean;
@@ -774,13 +868,11 @@ export interface components {
             } | null;
             /**
              * Done
-             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             * @description Whether the operation is terminal. When true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
              */
             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 ``AtlasGenerateResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
-            response?: components["schemas"]["AtlasGenerateResponse"] | null;
             /**
              * Expiresatsecs
              * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
@@ -791,6 +883,8 @@ export interface components {
              * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
+            /** @description ``AtlasGenerateResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
+            response?: components["schemas"]["AtlasGenerateResponse"] | null;
             /**
              * Name
              * @description Full resource name for the operation.
@@ -812,12 +906,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.
@@ -830,6 +918,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.
@@ -842,13 +940,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;
             /**
@@ -905,13 +1003,11 @@ export interface components {
             } | null;
             /**
              * Done
-             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             * @description Whether the operation is terminal. When true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
              */
             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 ``AtlasMaskedResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
-            response?: components["schemas"]["AtlasMaskedResponse"] | null;
             /**
              * Expiresatsecs
              * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
@@ -922,6 +1018,8 @@ export interface components {
              * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
+            /** @description ``AtlasMaskedResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
+            response?: components["schemas"]["AtlasMaskedResponse"] | null;
             /**
              * Name
              * @description Full resource name for the operation.
@@ -937,6 +1035,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.
@@ -958,11 +1066,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.
@@ -1025,13 +1128,11 @@ export interface components {
             } | null;
             /**
              * Done
-             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             * @description Whether the operation is terminal. When true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
              */
             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 ``AtlasTextToImageResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
-            response?: components["schemas"]["AtlasTextToImageResponse"] | null;
             /**
              * Expiresatsecs
              * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
@@ -1042,6 +1143,8 @@ export interface components {
              * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
+            /** @description ``AtlasTextToImageResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
+            response?: components["schemas"]["AtlasTextToImageResponse"] | null;
             /**
              * Name
              * @description Full resource name for the operation.
@@ -1254,13 +1357,24 @@ 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 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;
+            /**
+             * Url
+             * @description Unsigned content URL for the asset, ``baseUrl + contentPath``. It does not grant access by itself: the web app's read-prefix cookie authorizes it, and an API client appends ``?`` and a read prefix's ``signedQuery`` or uses ``assets/{asset}:createReadUrl`` instead. Null whenever ``contentPath`` is.
+             */
+            url?: string | null;
             /**
              * Uploads
              * @description One grant per declared part; empty for URL or inline ingestion.
@@ -1323,7 +1437,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;
         };
@@ -1438,6 +1552,22 @@ 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;
+            /**
+             * Base64Outputs
+             * @description When a ?wait=true submission is answered inline, return each output file as base64 in that response rather than by assetId and url. This skips storing the files before the answer and the caller's download after it. Any other submission, and every later read of the operation, names the outputs by assetId and url.
+             * @default false
+             */
+            base64Outputs?: boolean;
             /**
              * 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.
@@ -1461,6 +1591,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
@@ -1472,6 +1608,11 @@ export interface components {
              * @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.
+             */
+            poseRefinementAccepted?: boolean | null;
         };
         /**
          * Images2PosedRGBDResponseOperation
@@ -1497,13 +1638,11 @@ export interface components {
             } | null;
             /**
              * Done
-             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             * @description Whether the operation is terminal. When true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
              */
             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 ``Images2PosedRGBDResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
-            response?: components["schemas"]["Images2PosedRGBDResponse"] | null;
             /**
              * Expiresatsecs
              * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
@@ -1514,6 +1653,8 @@ export interface components {
              * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
+            /** @description ``Images2PosedRGBDResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
+            response?: components["schemas"]["Images2PosedRGBDResponse"] | null;
             /**
              * Name
              * @description Full resource name for the operation.
@@ -1536,14 +1677,24 @@ export interface components {
         };
         /**
          * ListAssetsResponse
-         * @description One page of non-deleted project assets.
+         * @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
-             * @description Assets in the selected page.
+             * @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.
@@ -1552,15 +1703,66 @@ export interface components {
             nextPageToken?: string;
         };
         /**
-         * ListOperationsResponse
+         * ListedOperation
+         * @description An operation summary with callback progress; GET it for the result.
+         */
+        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 true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
+             */
+            done: boolean;
+            /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
+            error?: components["schemas"]["OperationError"] | 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: {
+        ListedOperationsResponse: {
             /**
              * Operations
              * @description Operations ordered from newest to oldest.
              */
-            operations: components["schemas"]["Operation"][];
+            operations: components["schemas"]["ListedOperation"][];
             /**
              * Nextpagetoken
              * @description Token for the next page; absent when there are no more.
@@ -1589,7 +1791,7 @@ export interface components {
         };
         /**
          * Operation
-         * @description The common envelope used to track an asynchronous task.
+         * @description An operation with its result, available through singular reads.
          */
         Operation: {
             /**
@@ -1611,18 +1813,11 @@ export interface components {
             } | null;
             /**
              * Done
-             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             * @description Whether the operation is terminal. When true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
              */
             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.
@@ -1633,6 +1828,13 @@ export interface components {
              * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | 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;
             /**
              * Name
              * @description Full resource name for the operation.
@@ -1666,9 +1868,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 */
@@ -1677,14 +1889,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
@@ -1790,12 +2010,31 @@ 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``.
+             * @description The task that produced it, e.g. ``atlasGenerate``.
              */
             task?: string | null;
             /**
@@ -1823,8 +2062,8 @@ export interface components {
             renderHw?: number;
             /**
              * Renderhwsecondary
-             * @description Height and width of the secondary views, in pixels. The anchor strategies sample extra cameras around each anchor and render them here, covering what the main views miss. `exterior_sphere` and a supplied camera list render no secondary views and ignore this.
-             * @default 640
+             * @description Height and width of the secondary views, in pixels. The anchor strategies place extra cameras from the anchors and render them here, covering what the main views miss. `exterior_sphere` and a supplied camera list render no secondary views and ignore this.
+             * @default 256
              */
             renderHwSecondary?: number;
             /**
@@ -1834,6 +2073,13 @@ export interface components {
              * @enum {string}
              */
             normalSource?: "depth" | "render";
+            /**
+             * Depthsource
+             * @description Depth of the main views. `render` uses the splats' rendered depth; `stereo` measures it by stereo matching each view against a second render from a camera shifted sideways, which is sharper where the splats are fuzzy and slower to compute. Pixels stereo cannot match keep the rendered depth.
+             * @default render
+             * @enum {string}
+             */
+            depthSource?: "render" | "stereo";
             /**
              * Resolution
              * @description Resolution of the grid the implicit surface is built on, across the region's longest side. Powers of two only. This sets the finest detail the mesh can carry.
@@ -1886,6 +2132,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.
@@ -1965,13 +2221,11 @@ export interface components {
             } | null;
             /**
              * Done
-             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             * @description Whether the operation is terminal. When true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
              */
             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 ``Splats2MeshResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
-            response?: components["schemas"]["Splats2MeshResponse"] | null;
             /**
              * Expiresatsecs
              * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
@@ -1982,6 +2236,8 @@ export interface components {
              * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
+            /** @description ``Splats2MeshResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
+            response?: components["schemas"]["Splats2MeshResponse"] | null;
             /**
              * Name
              * @description Full resource name for the operation.
@@ -1999,7 +2255,9 @@ export interface components {
          *     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.
+         *     url is ignored. Inline base64 stands alone. A response returns it only
+         *     when a task is answered at submission; the stored operation names the
+         *     same output by id and url.
          */
         TaskAsset: {
             /**
@@ -2009,7 +2267,7 @@ 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. Input only: a task response never carries inline bytes.
+             * @description Base64-encoded media bytes, with or without a data URL prefix. Decoded size must be less than 10 MiB. A task response carries inline bytes only when it is returned from the submission; the stored operation names the same output by `assetId` and `url`.
              */
             base64?: string | null;
             /**
@@ -2076,6 +2334,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;
@@ -2085,8 +2451,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'];
@@ -2126,10 +2496,12 @@ export type Images2PosedRGBDResponse = components['schemas']['Images2PosedRGBDRe
 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 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'];
@@ -2148,6 +2520,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: {
@@ -2410,6 +2785,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;
             };
@@ -2425,7 +2808,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ListOperationsResponse"];
+                    "application/json": components["schemas"]["ListedOperationsResponse"];
                 };
             };
             /** @description Validation Error */
@@ -2540,6 +2923,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?: {
@@ -2580,6 +2994,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. `atlasGenerate`. */
+                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;
             };