@omni-commerce/sdk 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -231,6 +231,68 @@ interface paths {
     patch?: never;
     trace?: never;
   };
+  "/api/v1/agents/general/invoke": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Invoke the Omni agent
+     * @description Run the general Omni agent and wait until it completes, pauses for approval, or fails. Requires `agents:invoke`.
+     *
+     *     A waiting call can take several minutes; raise the client timeout. Send `decisions` with the same `thread_id` to approve or reject a paused run. Omit `config.enabled_tools` to use the organization's agent tools. Attach images on the latest user message as `{ type: "image", url }` HTTP(S) URLs.
+     */
+    post: operations["post_v1_agents_general_invoke"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/agents/general/runs": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Start an Omni agent run
+     * @description Queue the general Omni agent and return immediately with the run in `queued` state. Poll the URL in the `Location` header (`GET /api/v1/agents/general/runs/{runId}`), honoring `Retry-After`. Requires `agents:invoke`. The request body matches invoke.
+     */
+    post: operations["post_v1_agents_general_runs"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/agents/general/runs/{runId}": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get an Omni agent run
+     * @description Read a queued, running, completed, paused, or failed Omni agent run. Requires `agents:invoke`.
+     */
+    get: operations["get_v1_agents_general_runs_by_runid"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/v1/aop/{aopId}/config": {
     parameters: {
       query?: never;
@@ -315,6 +377,134 @@ interface paths {
     patch?: never;
     trace?: never;
   };
+  "/api/v1/campaigns": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List Campaigns
+     * @description List campaigns for the authenticated organization. `stage=all` is the workspace working set: draft and running. Requires `promotions:read`.
+     */
+    get: operations["get_v1_campaigns"];
+    put?: never;
+    /**
+     * Create Campaign
+     * @description Create a draft campaign. `ownerId` and `approverId` must be members of the organization, and every store must already be connected. Requires `promotions:write`.
+     */
+    post: operations["post_v1_campaigns"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/campaigns/{campaignId}": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get Campaign
+     * @description Read one campaign, including its plan, executions, audit, schedule, and progress. Requires `promotions:read`.
+     */
+    get: operations["get_v1_campaigns_by_campaignid"];
+    /**
+     * Update Campaign
+     * @description Replace a draft or approved plan, or propose one change to a running plan. Send `expectedRevision` from the last read. Requires `promotions:write`.
+     */
+    put: operations["put_v1_campaigns_by_campaignid"];
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/campaigns/{campaignId}/actions": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Act on Campaign
+     * @description Approve, start, end, resume, retry, or decide a proposed live change. Approve, run, resume, and approving a change must be called by the named approver. Requires `promotions:write`.
+     */
+    post: operations["post_v1_campaigns_by_campaignid_actions"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/campaigns/archive": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Archive Campaigns
+     * @description Archive campaigns, or restore archived campaigns by id or by the current archived list filters. Requires `promotions:write`.
+     */
+    post: operations["post_v1_campaigns_archive"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/campaigns/delete": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Delete Campaigns
+     * @description Permanently delete archived campaigns by explicit id or by archived list filters. Requires `promotions:write`.
+     */
+    post: operations["post_v1_campaigns_delete"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/campaigns/options": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get Campaign Options
+     * @description List the organization members and connected stores a campaign plan can name. Use a member `id` for `ownerId` and `approverId`. Requires `promotions:write`.
+     */
+    get: operations["get_v1_campaigns_options"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/v1/catalog/items": {
     parameters: {
       query?: never;
@@ -918,13 +1108,15 @@ interface paths {
     };
     /**
      * List Price Book Rules
-     * @description List marketplace price book rules for the authenticated organization. Rules apply markup percent to canonical list price at publish/catalog time by platform (and optional store/country). Requires `price_books:read`.
+     * @description List marketplace price book rules for the authenticated organization. A rule applies either a buyer formula or a markup percent to the catalog price at publish time, by platform and optional store/country. Requires `price_books:read`.
      */
     get: operations["get_v1_price_books"];
     put?: never;
     /**
      * Create Price Book Rule
-     * @description Create a marketplace price book rule for a platform (optional store, country, and source). A markup percent applies to list price. When `steps` is present it replaces that percent: the formula can start from list price or cost, convert, add fees or shipping, and round. Catalog prices stay unchanged. A payout formula is calculated and is not published as the customer price. Requires `price_books:write`.
+     * @description Create a marketplace price book rule for a platform (optional store and country). Does not change Omni product prices. Requires `price_books:write`.
+     *
+     *     `expression` is the buyer formula and replaces markup percent. `price` in that formula is the catalog price, not cost price. Without an expression, `marginValue` is the markup percent.
      */
     post: operations["post_v1_price_books"];
     delete?: never;
@@ -956,7 +1148,7 @@ interface paths {
     head?: never;
     /**
      * Update Price Book Rule
-     * @description Update store, country, source, markup, formula steps, rounding, currency, or enabled flag for a price book rule. Platform cannot be changed; create a new rule instead. Requires `price_books:write`.
+     * @description Update store, country, markup, buyer formula, rounding, currency, or enabled flag for a price book rule. Platform cannot be changed; create a new rule instead. Requires `price_books:write`.
      */
     patch: operations["patch_v1_price_books_by_ruleid"];
     trace?: never;
@@ -991,6 +1183,8 @@ interface paths {
     /**
      * List Products
      * @description List products for the authenticated organization with optional filters and pagination. Authenticate with an API key or OAuth bearer token. The organization is taken from that credential; do not send `organizationId`.
+     *
+     *     Rows are in `items`. Read catalog stock from `items[].stockQuantity`: parent rows already aggregate their non-deleted variants, and virtual bundles use component availability with any manual cap. Null means unknown, not zero. List rows do not contain `inventoryQuantity`, `inventory.quantity`, or an embedded `variants` array.
      */
     get: operations["get_v1_products"];
     put?: never;
@@ -1086,7 +1280,9 @@ interface paths {
     put?: never;
     /**
      * Delist Product
-     * @description Queue delist for one product on the marketplaces you name. `marketplaces` accepts one or more of shopee, lazada, tiktok, shopify, whatsapp, zalora, amazon, and ebay. Each named marketplace must already have a listing; other channels are left untouched. Omit `marketplaces` to delist every existing listing. This does not delete the OmniCommerce product. Poll GET /api/v1/jobs/{jobId} until data.status is succeeded, partial, or failed. Accepted means the job was queued, not that the marketplace has removed the listing.
+     * @description Queue delist for one product on the marketplaces you name. `marketplaces` accepts one or more of shopee, lazada, tiktok, shopify, whatsapp, zalora, amazon, and ebay. Each named marketplace must already have a listing; other channels are left untouched. Omit `marketplaces` to delist every existing listing. This does not delete the OmniCommerce product.
+     *
+     *     Poll GET /api/v1/jobs/{jobId} until data.status is succeeded, partial, or failed. Accepted means the job was queued, not that the marketplace has removed the listing.
      */
     post: operations["post_v1_products_by_productid_delist"];
     delete?: never;
@@ -1992,91 +2188,339 @@ interface components {
       | "za"
       | "zm"
       | "zw";
-    ProductEnrichmentWebhookSnapshot: {
-      jobId: string;
-      batchId: string | null;
-      /** @enum {string} */
-      workflow: "listing_copy" | "marketplace_taxonomy";
-      marketplace: string | null;
-      /** @enum {string} */
-      status: "running" | "pending_review" | "applied";
-    };
-    ProductWebhookSnapshot: {
-      id: string;
-      parentId: string | null;
-      /** @enum {string} */
-      type: "product" | "variant";
-      productFamilyId: string;
-      productFamilyName: string | null;
-      name: string | null;
-      description: string | null;
-      sku: string | null;
-      brand: string | null;
-      status: string | null;
-      /** @description Catalog price in the legacy product event contract. Use currency with this value. */
-      price: number | null;
-      /** @description Optional catalog sale price in the legacy product event contract. */
-      salePrice: number | null;
-      compareAtPrice: number | null;
-      costPrice: number | null;
-      costPriceCurrency: string | null;
-      mapPrice: number | null;
-      msrpPrice: number | null;
-      currency: string | null;
-      upc: string | null;
-      category: string | null;
-      tags: string[];
-      inventory: {
-        quantity?: number | null;
-      } & {
-        [key: string]: unknown;
-      };
-      images: unknown[];
-      variants: unknown[];
-      variationSchema: {
-        [key: string]: unknown;
-      };
-      marketplaces: {
-        [key: string]: unknown;
-      };
-      promotions: {
-        [key: string]: unknown;
+    CampaignPlan: {
+      brief: {
+        name: string;
+        /** @default  */
+        objective: string;
+        /** @default  */
+        brand: string;
+        ownerId: string;
+        approverId: string;
+        timezone: string;
+        /** @default [] */
+        stores: {
+          /** @enum {string} */
+          marketplace:
+            | "shopee"
+            | "lazada"
+            | "tiktok"
+            | "shopify"
+            | "whatsapp"
+            | "zalora"
+            | "amazon"
+            | "ebay";
+          country: string;
+          storeId: string;
+        }[];
+        /** @default  */
+        serviceRequest: string;
+        /**
+         * @default standard
+         * @enum {string}
+         */
+        priority: "standard" | "priority" | "super_priority";
+        /** @default [] */
+        documentIds: string[];
+        /** @default null */
+        reviewDueAt: string | null;
+        sourceCurrency?: string;
+        /** @enum {string} */
+        sourceMarketplace?:
+          | "shopee"
+          | "lazada"
+          | "tiktok"
+          | "shopify"
+          | "whatsapp"
+          | "zalora"
+          | "amazon"
+          | "ebay";
+        sourceCountry?: string;
+        /** @default  */
+        cleanupNotes: string;
+      };
+      /** @default [] */
+      windows: {
+        id: string;
+        name: string;
+        /**
+         * @description Preparation time: publish promotions with the future live start/end. Must be at or before startsAt.
+         * @default null
+         */
+        preparesAt: string | null;
+        startsAt: string | null;
+        endsAt: string | null;
+        /** @default  */
+        reviewNotes: string;
       }[];
-      /** Format: date-time */
-      updatedAt: string | null;
-      /** Format: date-time */
-      createdAt: string | null;
-    } & {
-      [key: string]: unknown;
-    };
-    LookProductWebhookSnapshot: {
-      id: string;
-      name: string;
-      sku: string | null;
-      brand: string | null;
-      price: number | null;
-      currency: string | null;
-      imageUrl: string | null;
-    } & {
-      [key: string]: unknown;
-    };
-    LookWebhookSnapshot: {
-      id: string;
-      organizationId: string;
-      title: string | null;
-      /** @enum {string} */
-      status: "draft" | "published";
-      subject: string | null;
-      style: string | null;
-      season: string | null;
-      timeOfDay: string | null;
-      city: string | null;
-      additionalNotes: string | null;
-      stylePrompt: string | null;
-      heroImageTagId: string | null;
-      heroImageUrl: string | null;
-      createdBy: string | null;
-      /** Format: date-time */
+      offers?: {
+        id: string;
+        windowId: string;
+        /**
+         * Format: uuid
+         * @description Existing draft promotion attached to this window; the campaign controls its live dates.
+         */
+        promotionId?: string;
+        promotion: {
+          name?: string;
+          description?: string | null;
+          /**
+           * @description Canonical OmniCommerce promotion mechanic: product discount, flash sale, voucher, gift with purchase, Buy-X-Get-Y, bundle deal, or Lazada-only free shipping and early bird price.
+           * @enum {string}
+           */
+          kind?:
+            | "product_discount"
+            | "flash_sale"
+            | "voucher"
+            | "gift_with_purchase"
+            | "buy_x_get_y"
+            | "bundle_deal"
+            | "free_shipping"
+            | "early_bird_price";
+          salesChannels?: ("pdp" | "live")[];
+          /** @enum {string} */
+          discountType?: "percentage" | "fixed_amount";
+          discountValue?: number;
+          /** @description Patch discount terms for exact target store keys; unnamed stores remain unchanged. Null discountValue restores shared campaign terms for that store. */
+          storeDiscounts?: {
+            storeKey: string;
+            /** @enum {string} */
+            discountType: "percentage" | "fixed_amount";
+            discountValue: number | null;
+          }[];
+          /** @description Up to 100 connected stores for create (required) or update. Copy marketplace, country, and storeId from get_promotions targetStores or find_products marketplaceDetails. Do not concatenate a storeKeys string. */
+          targetStores?: {
+            /** @enum {string} */
+            marketplace:
+              | "lazada"
+              | "shopee"
+              | "tiktok"
+              | "shopify"
+              | "amazon"
+              | "zalora"
+              | "ebay";
+            country: string;
+            storeId: string;
+          }[];
+          minSalePrice?: number | null;
+          maxDiscountAmount?: number | null;
+          minSpend?: number | null;
+          voucherCode?: string | null;
+          claimStartsAt?: string | null;
+          totalUsageLimit?: number | null;
+          perBuyerLimit?: number | null;
+          mechanicConfig?: {
+            /** @description Voucher subtype from get_promotions capabilities.voucherTypes. Browser AOP types (delivery=browser_aop) are writable Seller Center vouchers. Omit browserAutomation.aopId to use the built-in marketplace AOP. */
+            voucherType?:
+              | (
+                  | "shopee_shop"
+                  | "shopee_product"
+                  | "shopee_private"
+                  | "shopee_live"
+                  | "shopee_video"
+                  | "shopee_new_buyer"
+                  | "shopee_repeat_buyer"
+                  | "shopee_follow_prize"
+                  | "shopee_exclusive_streamer"
+                  | "shopee_welcome"
+                  | "shopee_member_repeat_buyer"
+                  | "shopee_exclusive"
+                  | "shopee_redemption"
+                  | "shopee_exclusive_creator"
+                  | "lazada_store_follower"
+                  | "lazada_regular"
+                  | "lazada_store_new_buyer"
+                  | "lazada_live"
+                  | "lazada_offline"
+                  | "lazada_co_funded"
+                  | "lazada_welcome"
+                  | "lazada_linked_member"
+                  | "lazada_new_member"
+                  | "lazada_member_exclusive"
+                  | "lazada_points_redeemable"
+                  | "tiktok_seller_coupon"
+                  | "shopify_discount_code"
+                  | "amazon_promotion_code"
+                  | "zalora_seller_voucher"
+                  | "ebay_coded_coupon"
+                )
+              | null;
+            browserAutomation?: {
+              aopId?: string;
+              variableValues?: {
+                [key: string]: string;
+              };
+              instructions?: string;
+            } | null;
+            /**
+             * @description shop = all products, products = selected assigned products. Repeat Buyer defaults to shop.
+             * @enum {string}
+             */
+            voucherScope?: "products" | "shop";
+            /**
+             * @description Seller Center reward type. coins_cashback is a percentage greater than 3 and does not reduce salePrice.
+             * @enum {string}
+             */
+            voucherReward?: "discount" | "coins_cashback";
+            /** @enum {string} */
+            voucherAudience?: "general" | "shop_follow";
+            /** @description Shopee Repeat Buyer: minimum completed shop orders, 1 or 2. Required for shopee_repeat_buyer. */
+            repeatPurchaseMinCount?: number;
+            /** @description Shopee Repeat Buyer: lookback window in days, one of 30, 90, 180 or 365. Required for shopee_repeat_buyer. */
+            repeatPurchaseLookbackDays?: number;
+            /** @description Shopee Smart Voucher toggle. Used by New Buyer and similar portal types. */
+            smartVoucher?: boolean;
+            /** @description Shopee Follow Prize: days after claim until expiry. Seller Center is 7. */
+            followPrizeExpiryDays?: number;
+            /**
+             * @description Shopee Video display: shopee_video = all Shopee Video; creator_video = targeted creator videos only.
+             * @enum {string}
+             */
+            videoDisplayMode?: "shopee_video" | "creator_video";
+            /** @description Exclusive Creator Voucher: up to 15 Shopee usernames. */
+            exclusiveCreatorUsernames?: string[];
+            /** @description Exclusive Streamer Voucher: up to 15 Shopee usernames. */
+            exclusiveStreamerUsernames?: string[];
+            /** @description Shopee display setting. ["all"] = display on all pages; [] = hidden/share by code. */
+            voucherDisplayChannels?: (
+              | "all"
+              | "feed"
+              | "live"
+              | "order_page"
+              | "followers"
+              | "offline"
+            )[];
+            /** @enum {string} */
+            bundlePriceType?: "discount" | "fixed_price";
+            bundleTiers?: {
+              minimumQuantity: number;
+              discountValue: number;
+            }[];
+            /** @enum {string} */
+            thresholdType?: "item_quantity" | "order_amount";
+            thresholdValue?: number;
+            /** @enum {string} */
+            giftType?: "gift" | "sample";
+            giftQuantity?: number;
+            gifts?: {
+              /** Format: uuid */
+              productId: string;
+              variantId?: string | null;
+              totalClaimLimit: number;
+            }[];
+            buyQuantity?: number;
+            getQuantity?: number;
+            benefitProductIds?: string[];
+            /** @enum {string} */
+            benefitType?: "free" | "percentage" | "fixed_amount";
+            benefitValue?: number;
+            maxApplicationsPerOrder?: number;
+            bundleMinimumQuantity?: number;
+            /** @description Free shipping delivery option. Lazada: STANDARD (default), ECONOMY, EXPRESS, SELLER_OWN_FLEET or P2P, as offered by the store. */
+            shippingDeliveryOption?: string;
+            /** @description Free shipping: total shipping subsidy budget in the store currency. Omit for an unlimited budget. */
+            shippingBudget?: number;
+          };
+        };
+        /** @default [] */
+        productIds: string[];
+        /** @default  */
+        reviewNotes: string;
+        /** @default  */
+        excludedReason: string;
+        source?: {
+          sheet: string;
+          rows: number[];
+          headers: string[];
+          values: string[][];
+        };
+      }[];
+    };
+    ProductEnrichmentWebhookSnapshot: {
+      jobId: string;
+      batchId: string | null;
+      /** @enum {string} */
+      workflow: "listing_copy" | "marketplace_taxonomy";
+      marketplace: string | null;
+      /** @enum {string} */
+      status: "running" | "pending_review" | "applied";
+    };
+    ProductWebhookSnapshot: {
+      id: string;
+      parentId: string | null;
+      /** @enum {string} */
+      type: "product" | "variant";
+      productFamilyId: string;
+      productFamilyName: string | null;
+      name: string | null;
+      description: string | null;
+      sku: string | null;
+      brand: string | null;
+      status: string | null;
+      /** @description Catalog price in the legacy product event contract. Use currency with this value. */
+      price: number | null;
+      /** @description Optional catalog sale price in the legacy product event contract. */
+      salePrice: number | null;
+      compareAtPrice: number | null;
+      costPrice: number | null;
+      costPriceCurrency: string | null;
+      mapPrice: number | null;
+      msrpPrice: number | null;
+      currency: string | null;
+      upc: string | null;
+      category: string | null;
+      tags: string[];
+      inventory: {
+        quantity?: number | null;
+      } & {
+        [key: string]: unknown;
+      };
+      images: unknown[];
+      variants: unknown[];
+      variationSchema: {
+        [key: string]: unknown;
+      };
+      marketplaces: {
+        [key: string]: unknown;
+      };
+      promotions: {
+        [key: string]: unknown;
+      }[];
+      /** Format: date-time */
+      updatedAt: string | null;
+      /** Format: date-time */
+      createdAt: string | null;
+    } & {
+      [key: string]: unknown;
+    };
+    LookProductWebhookSnapshot: {
+      id: string;
+      name: string;
+      sku: string | null;
+      brand: string | null;
+      price: number | null;
+      currency: string | null;
+      imageUrl: string | null;
+    } & {
+      [key: string]: unknown;
+    };
+    LookWebhookSnapshot: {
+      id: string;
+      organizationId: string;
+      title: string | null;
+      /** @enum {string} */
+      status: "draft" | "published";
+      subject: string | null;
+      style: string | null;
+      season: string | null;
+      timeOfDay: string | null;
+      city: string | null;
+      additionalNotes: string | null;
+      stylePrompt: string | null;
+      heroImageTagId: string | null;
+      heroImageUrl: string | null;
+      createdBy: string | null;
+      /** Format: date-time */
       createdAt: string;
       /** Format: date-time */
       updatedAt: string;
@@ -2087,6 +2531,33 @@ interface components {
     } & {
       [key: string]: unknown;
     };
+    ReviewWebhookSnapshot: {
+      id: string;
+      organizationId: string;
+      platform: string;
+      accountId: string | null;
+      productId: string | null;
+      orderId: string | null;
+      externalItemId: string | null;
+      externalReviewId: string;
+      externalOrderId: string | null;
+      /** @enum {string} */
+      kind: "product_review" | "solicitation";
+      /** @enum {string} */
+      status:
+        | "open"
+        | "replied"
+        | "hidden"
+        | "handoff"
+        | "solicited"
+        | "ineligible";
+      rating: number | null;
+      comment: string | null;
+      sellerReply: string | null;
+      canReply: boolean;
+      /** Format: date-time */
+      reviewedAt: string | null;
+    };
     ProductCreatedWebhookEvent: {
       /** @description Stable event ID and recipient idempotency key. */
       eventId: string;
@@ -2297,6 +2768,72 @@ interface components {
     } & {
       [key: string]: unknown;
     };
+    ReviewCreatedWebhookEvent: {
+      /** @description Stable event ID and recipient idempotency key. */
+      eventId: string;
+      /** @constant */
+      eventType: "review.created";
+      organizationId: string;
+      reviewId: string;
+      productId: string | null;
+      previousStatus?: string | null;
+      changedFields: string[];
+      /** Format: date-time */
+      occurredAt: string;
+      /** @description Internal OmniCommerce workflow provenance when supplied. */
+      source?: string | null;
+      data: {
+        review: components["schemas"]["ReviewWebhookSnapshot"];
+      } & {
+        [key: string]: unknown;
+      };
+    } & {
+      [key: string]: unknown;
+    };
+    ReviewUpdatedWebhookEvent: {
+      /** @description Stable event ID and recipient idempotency key. */
+      eventId: string;
+      /** @constant */
+      eventType: "review.updated";
+      organizationId: string;
+      reviewId: string;
+      productId: string | null;
+      previousStatus?: string | null;
+      changedFields: string[];
+      /** Format: date-time */
+      occurredAt: string;
+      /** @description Internal OmniCommerce workflow provenance when supplied. */
+      source?: string | null;
+      data: {
+        review: components["schemas"]["ReviewWebhookSnapshot"];
+      } & {
+        [key: string]: unknown;
+      };
+    } & {
+      [key: string]: unknown;
+    };
+    ReviewStatusChangedWebhookEvent: {
+      /** @description Stable event ID and recipient idempotency key. */
+      eventId: string;
+      /** @constant */
+      eventType: "review.status.changed";
+      organizationId: string;
+      reviewId: string;
+      productId: string | null;
+      previousStatus?: string | null;
+      changedFields: string[];
+      /** Format: date-time */
+      occurredAt: string;
+      /** @description Internal OmniCommerce workflow provenance when supplied. */
+      source?: string | null;
+      data: {
+        review: components["schemas"]["ReviewWebhookSnapshot"];
+      } & {
+        [key: string]: unknown;
+      };
+    } & {
+      [key: string]: unknown;
+    };
     WebhookMoney: {
       /** @description Decimal monetary amount encoded as a JSON string. */
       amount: string;
@@ -2906,51 +3443,114 @@ interface operations {
       };
     };
   };
-  get_v1_aop_by_aopid_config: {
+  post_v1_agents_general_invoke: {
     parameters: {
-      query?: {
-        organizationId?: string;
-      };
+      query?: never;
       header?: never;
-      path: {
-        aopId: string;
-      };
+      path?: never;
       cookie?: never;
     };
-    requestBody?: never;
+    requestBody: {
+      content: {
+        /**
+         * @example {
+         *       "messages": [
+         *         {
+         *           "role": "user",
+         *           "content": "How many products are missing a price?"
+         *         }
+         *       ]
+         *     }
+         */
+        "application/json": {
+          organizationId?: string;
+          thread_id?: string | null;
+          channel?: string;
+          messages?: {
+            /** @enum {string} */
+            role?: "user" | "assistant" | "system";
+            content:
+              | string
+              | (
+                  | {
+                      /** @constant */
+                      type: "text";
+                      text: string;
+                    }
+                  | {
+                      /** @constant */
+                      type: "image";
+                      url: string;
+                      filename?: string;
+                    }
+                )[];
+            id?: string;
+            name?: string;
+          }[];
+          config?: {
+            enabled_tools?: string[];
+            model?: string | null;
+            system_prompt?: string;
+            structured_output?: {
+              [key: string]: unknown;
+            } | null;
+          };
+          decisions?: {
+            /** @enum {string} */
+            action: "approve" | "reject";
+            reason?: string;
+          }[];
+        };
+      };
+    };
     responses: {
-      /** @description Success */
+      /** @description The agent finished or is waiting for approval. */
       200: {
         headers: {
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            aop_id: string;
-            title?: string | null;
-            prompt?: string;
-            description?: string;
-            agentId?: string | null;
-            /** @default ListTodo */
-            icon: string;
-            section?: string;
-            structured_output?: {
-              [key: string]: unknown;
-            } | null;
-            /** @description Computed JSON Schema for user_inputs, derived from [[ placeholder ]] tokens and declared variables. */
-            structured_inputs?: {
-              [key: string]: unknown;
-            } | null;
-            agent_config?: {
-              [key: string]: unknown;
-            } | null;
-            user_notification_configs?: {
+            run_id: string;
+            thread_id: string;
+            /** @enum {string} */
+            status:
+              | "queued"
+              | "running"
+              | "completed"
+              | "awaiting_approval"
+              | "failed";
+            messages: {
+              /** @enum {string} */
+              type: "human" | "ai" | "tool" | "system";
+              /** @enum {string} */
+              role: "user" | "assistant" | "tool" | "system";
+              content: string;
+              id?: string;
+              name?: string;
+              tool_calls?: {
+                id?: string;
+                name: string;
+                args: unknown;
+              }[];
+              tool_call_id?: string;
+            }[];
+            structured_output: {
               [key: string]: unknown;
             } | null;
+            approvals:
+              | {
+                  interrupt_instance_id: string;
+                  tool_name: string | null;
+                  tool_args: unknown;
+                  message: string;
+                }[]
+              | null;
+            error: string | null;
           };
         };
       };
-      /** @description Invalid AOP configuration or request */
+      /** @description Invalid agent request, unknown tool or model, or a decision count that does not match the pending approvals */
       400: {
         headers: {
           [name: string]: unknown;
@@ -2971,76 +3571,148 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Forbidden. Missing OAuth scope. */
+      /** @description Missing agents:invoke scope or Assistant access */
       403: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description AOP or thread not found */
-      404: {
+      /** @description The thread already has an active run, or decisions were sent for a thread with no run awaiting approval */
+      409: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description Internal server error */
+      /** @description The agent run failed. `data.run_id` identifies the stored run */
       500: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
+      /** @description The agent run timed out. `data.run_id` identifies the stored run */
+      504: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
     };
   };
-  put_v1_aop_by_aopid_config: {
+  post_v1_agents_general_runs: {
     parameters: {
       query?: never;
       header?: never;
-      path: {
-        aopId: string;
-      };
+      path?: never;
       cookie?: never;
     };
     requestBody: {
       content: {
+        /**
+         * @example {
+         *       "messages": [
+         *         {
+         *           "role": "user",
+         *           "content": "Summarize orders placed today."
+         *         }
+         *       ]
+         *     }
+         */
         "application/json": {
-          prompt?: string | null;
-          description?: string | null;
-          agentId?: string | null;
-          agent_config?: {
-            [key: string]: unknown;
-          } | null;
-          icon?: string | null;
-          section?: string | null;
-          structured_output?: {
-            [key: string]: unknown;
-          } | null;
-          user_notification_configs?: {
-            [key: string]: unknown;
-          } | null;
-          /** @description Required for session auth. Optional for API keys. */
           organizationId?: string;
+          thread_id?: string | null;
+          channel?: string;
+          messages?: {
+            /** @enum {string} */
+            role?: "user" | "assistant" | "system";
+            content:
+              | string
+              | (
+                  | {
+                      /** @constant */
+                      type: "text";
+                      text: string;
+                    }
+                  | {
+                      /** @constant */
+                      type: "image";
+                      url: string;
+                      filename?: string;
+                    }
+                )[];
+            id?: string;
+            name?: string;
+          }[];
+          config?: {
+            enabled_tools?: string[];
+            model?: string | null;
+            system_prompt?: string;
+            structured_output?: {
+              [key: string]: unknown;
+            } | null;
+          };
+          decisions?: {
+            /** @enum {string} */
+            action: "approve" | "reject";
+            reason?: string;
+          }[];
         };
       };
     };
     responses: {
-      /** @description Success */
-      200: {
+      /** @description The agent run was queued. */
+      202: {
         headers: {
+          /** @description The run to poll. */
+          Location?: string;
+          /** @description Seconds to wait before polling again. Sent while the run is queued or running. */
+          "Retry-After"?: number;
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            aop_id: string;
-            /** @default updated */
-            status: string;
-            message?: string;
+            run_id: string;
+            thread_id: string;
+            /** @enum {string} */
+            status:
+              | "queued"
+              | "running"
+              | "completed"
+              | "awaiting_approval"
+              | "failed";
+            messages: {
+              /** @enum {string} */
+              type: "human" | "ai" | "tool" | "system";
+              /** @enum {string} */
+              role: "user" | "assistant" | "tool" | "system";
+              content: string;
+              id?: string;
+              name?: string;
+              tool_calls?: {
+                id?: string;
+                name: string;
+                args: unknown;
+              }[];
+              tool_call_id?: string;
+            }[];
+            structured_output: {
+              [key: string]: unknown;
+            } | null;
+            approvals:
+              | {
+                  interrupt_instance_id: string;
+                  tool_name: string | null;
+                  tool_args: unknown;
+                  message: string;
+                }[]
+              | null;
+            error: string | null;
           };
         };
       };
-      /** @description Invalid AOP configuration or request */
+      /** @description Invalid agent request, unknown tool or model, or a decision count that does not match the pending approvals */
       400: {
         headers: {
           [name: string]: unknown;
@@ -3061,21 +3733,21 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Forbidden. Missing OAuth scope. */
+      /** @description Missing agents:invoke scope or Assistant access */
       403: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description AOP or thread not found */
-      404: {
+      /** @description The thread already has an active run, or decisions were sent for a thread with no run awaiting approval */
+      409: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description Internal server error */
+      /** @description The agent run failed. `data.run_id` identifies the stored run */
       500: {
         headers: {
           [name: string]: unknown;
@@ -3084,83 +3756,69 @@ interface operations {
       };
     };
   };
-  post_v1_aop_by_aopid_execute: {
+  get_v1_agents_general_runs_by_runid: {
     parameters: {
-      query?: never;
+      query?: {
+        /** @description Required for session auth. Optional for API keys, which already belong to one organization. */
+        organizationId?: string;
+      };
       header?: never;
       path: {
-        aopId: string;
+        runId: string;
       };
       cookie?: never;
     };
-    requestBody?: {
-      content: {
-        /**
-         * @example {
-         *       "user_inputs": {
-         *         "company": "Acme Corp",
-         *         "quarter": "Q1 2024"
-         *       }
-         *     }
-         */
-        "application/json": {
-          /**
-           * @description Execute as a Test run: the agent uses its real prompt, config, and read-only tools, but side-effectful tool calls are captured instead of executed.
-           * @default false
-           */
-          dry_run?: boolean;
-          /** @description Optional user inputs appended to the AOP prompt as key-value pairs. */
-          user_inputs?: {
-            [key: string]: string | number | boolean;
-          } | null;
-          /** @description Required for session auth. Optional for API keys. */
-          organizationId?: string;
-        };
-      };
-    };
+    requestBody?: never;
     responses: {
-      /** @description Success */
+      /** @description The agent run. */
       200: {
         headers: {
+          /** @description Seconds to wait before polling again. Sent while the run is queued or running. */
+          "Retry-After"?: number;
           [name: string]: unknown;
         };
         content: {
-          /**
-           * @example {
-           *       "status": "started",
-           *       "thread_id": "agent-aop-run_1",
-           *       "trigger_type": "api",
-           *       "message": "Task execution started successfully. Use the thread_id to track progress.",
-           *       "aop_id": "aop_1",
-           *       "aop_title": "Market Research Report Generator",
-           *       "base_prompt": "Generate a comprehensive market research report",
-           *       "final_prompt": "Generate a comprehensive market research report\n\n--- User Inputs ---\ncompany: Acme Corp\n",
-           *       "aop_config": {
-           *         "agentId": "research"
-           *       }
-           *     }
-           */
           "application/json": {
-            /** @example started */
-            status: string;
+            run_id: string;
             thread_id: string;
-            /** @constant */
-            trigger_type: "api";
-            message?: string;
-            aop_id: string;
-            aop_title: string;
-            base_prompt: string;
-            final_prompt: string;
-            aop_config: {
-              [key: string]: unknown;
-            };
-            conversation?: {
+            /** @enum {string} */
+            status:
+              | "queued"
+              | "running"
+              | "completed"
+              | "awaiting_approval"
+              | "failed";
+            messages: {
+              /** @enum {string} */
+              type: "human" | "ai" | "tool" | "system";
+              /** @enum {string} */
+              role: "user" | "assistant" | "tool" | "system";
+              content: string;
+              id?: string;
+              name?: string;
+              tool_calls?: {
+                id?: string;
+                name: string;
+                args: unknown;
+              }[];
+              tool_call_id?: string;
+            }[];
+            structured_output: {
               [key: string]: unknown;
-            };
+            } | null;
+            approvals:
+              | {
+                  interrupt_instance_id: string;
+                  tool_name: string | null;
+                  tool_args: unknown;
+                  message: string;
+                }[]
+              | null;
+            error: string | null;
           };
         };
       };
-      /** @description Invalid AOP configuration or request */
+      /** @description Invalid agent request, unknown tool or model, or a decision count that does not match the pending approvals */
       400: {
         headers: {
           [name: string]: unknown;
@@ -3174,58 +3832,126 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Insufficient AI credits */
-      402: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Forbidden. Missing OAuth scope. */
+      /** @description Missing agents:invoke scope or Assistant access */
       403: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description AOP or thread not found */
+      /** @description Agent run not found */
       404: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description Internal server error */
-      500: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
     };
   };
-  post_v1_aop_create: {
+  get_v1_aop_by_aopid_config: {
     parameters: {
-      query?: never;
+      query?: {
+        organizationId?: string;
+      };
       header?: never;
-      path?: never;
+      path: {
+        aopId: string;
+      };
       cookie?: never;
     };
-    requestBody: {
-      content: {
-        /**
-         * @example {
-         *       "title": "Market Research Report",
-         *       "prompt": "Generate a comprehensive market research report for [[ company ]]",
-         *       "agentId": "research"
-         *     }
-         */
-        "application/json": {
-          title?: string | null;
-          prompt?: string | null;
-          description?: string | null;
-          agentId?: string | null;
-          agent_config?: {
+    requestBody?: never;
+    responses: {
+      /** @description Success */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            aop_id: string;
+            title?: string | null;
+            prompt?: string;
+            description?: string;
+            agentId?: string | null;
+            /** @default ListTodo */
+            icon: string;
+            section?: string;
+            structured_output?: {
+              [key: string]: unknown;
+            } | null;
+            /** @description Computed JSON Schema for user_inputs, derived from [[ placeholder ]] tokens and declared variables. */
+            structured_inputs?: {
+              [key: string]: unknown;
+            } | null;
+            agent_config?: {
+              [key: string]: unknown;
+            } | null;
+            user_notification_configs?: {
+              [key: string]: unknown;
+            } | null;
+          };
+        };
+      };
+      /** @description Invalid AOP configuration or request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Insufficient AI credits */
+      402: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden. Missing OAuth scope. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description AOP or thread not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  put_v1_aop_by_aopid_config: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        aopId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          prompt?: string | null;
+          description?: string | null;
+          agentId?: string | null;
+          agent_config?: {
             [key: string]: unknown;
           } | null;
           icon?: string | null;
@@ -3236,31 +3962,2003 @@ interface operations {
           user_notification_configs?: {
             [key: string]: unknown;
           } | null;
-          /** @description Optional workstream ID. */
-          parent_folder_id?: string | null;
           /** @description Required for session auth. Optional for API keys. */
           organizationId?: string;
         };
       };
     };
     responses: {
-      /** @description Success */
+      /** @description Success */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            aop_id: string;
+            /** @default updated */
+            status: string;
+            message?: string;
+          };
+        };
+      };
+      /** @description Invalid AOP configuration or request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Insufficient AI credits */
+      402: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden. Missing OAuth scope. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description AOP or thread not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  post_v1_aop_by_aopid_execute: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        aopId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: {
+      content: {
+        /**
+         * @example {
+         *       "user_inputs": {
+         *         "company": "Acme Corp",
+         *         "quarter": "Q1 2024"
+         *       }
+         *     }
+         */
+        "application/json": {
+          /**
+           * @description Execute as a Test run: the agent uses its real prompt, config, and read-only tools, but side-effectful tool calls are captured instead of executed.
+           * @default false
+           */
+          dry_run?: boolean;
+          /** @description Optional user inputs appended to the AOP prompt as key-value pairs. */
+          user_inputs?: {
+            [key: string]: string | number | boolean;
+          } | null;
+          /** @description Required for session auth. Optional for API keys. */
+          organizationId?: string;
+        };
+      };
+    };
+    responses: {
+      /** @description Success */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          /**
+           * @example {
+           *       "status": "started",
+           *       "thread_id": "agent-aop-run_1",
+           *       "trigger_type": "api",
+           *       "message": "Task execution started successfully. Use the thread_id to track progress.",
+           *       "aop_id": "aop_1",
+           *       "aop_title": "Market Research Report Generator",
+           *       "base_prompt": "Generate a comprehensive market research report",
+           *       "final_prompt": "Generate a comprehensive market research report\n\n--- User Inputs ---\ncompany: Acme Corp\n",
+           *       "aop_config": {
+           *         "agentId": "research"
+           *       }
+           *     }
+           */
+          "application/json": {
+            /** @example started */
+            status: string;
+            thread_id: string;
+            /** @constant */
+            trigger_type: "api";
+            message?: string;
+            aop_id: string;
+            aop_title: string;
+            base_prompt: string;
+            final_prompt: string;
+            aop_config: {
+              [key: string]: unknown;
+            };
+            conversation?: {
+              [key: string]: unknown;
+            };
+          };
+        };
+      };
+      /** @description Invalid AOP configuration or request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Insufficient AI credits */
+      402: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden. Missing OAuth scope. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description AOP or thread not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  post_v1_aop_create: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        /**
+         * @example {
+         *       "title": "Market Research Report",
+         *       "prompt": "Generate a comprehensive market research report for [[ company ]]",
+         *       "agentId": "research"
+         *     }
+         */
+        "application/json": {
+          title?: string | null;
+          prompt?: string | null;
+          description?: string | null;
+          agentId?: string | null;
+          agent_config?: {
+            [key: string]: unknown;
+          } | null;
+          icon?: string | null;
+          section?: string | null;
+          structured_output?: {
+            [key: string]: unknown;
+          } | null;
+          user_notification_configs?: {
+            [key: string]: unknown;
+          } | null;
+          /** @description Optional workstream ID. */
+          parent_folder_id?: string | null;
+          /** @description Required for session auth. Optional for API keys. */
+          organizationId?: string;
+        };
+      };
+    };
+    responses: {
+      /** @description Success */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            aop_id: string;
+            title: string;
+            /** @default created */
+            status: string;
+            message?: string;
+            parent_folder_id?: string | null;
+          };
+        };
+      };
+      /** @description Invalid AOP configuration or request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Insufficient AI credits */
+      402: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden. Missing OAuth scope. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description AOP or thread not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  post_v1_aop_retry: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          /** @description Thread ID of the failed AOP execution to retry. */
+          thread_id: string;
+          /** @description Optional user inputs appended to the AOP prompt as key-value pairs. */
+          user_inputs?: {
+            [key: string]: string | number | boolean;
+          } | null;
+          /** @description Required for session auth. Optional for API keys. */
+          organizationId?: string;
+        };
+      };
+    };
+    responses: {
+      /** @description Success */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            /** @constant */
+            status: "started";
+            new_thread_id: string;
+            message: string;
+          };
+        };
+      };
+      /** @description Invalid AOP configuration or request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Insufficient AI credits */
+      402: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden. Missing OAuth scope. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description AOP or thread not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_campaigns: {
+    parameters: {
+      query?: {
+        /** @description Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token. */
+        organizationId?: string;
+        /** @description Search campaign name. */
+        q?: string;
+        /** @description `all` lists draft and running campaigns. Any other value lists that stage only. */
+        stage?:
+          | "all"
+          | "draft"
+          | "approved"
+          | "running"
+          | "ending"
+          | "completed"
+          | "archived";
+        offset?: number;
+        limit?: number;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Campaign page and stage summary. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            campaigns: {
+              id: string;
+              organizationId: string;
+              revision: number;
+              /** @enum {string} */
+              stage:
+                | "draft"
+                | "approved"
+                | "running"
+                | "ending"
+                | "completed"
+                | "archived";
+              approval: {
+                revision: number;
+                userId: string;
+                approvedAt: string;
+              } | null;
+              runId: string | null;
+              startedAt: string | null;
+              endedAt: string | null;
+              createdAt: string;
+              updatedAt: string;
+              name: string;
+              brand: string;
+              storeCount: number;
+              windowCount: number;
+              offerCount: number;
+              cleanupFailed?: boolean;
+            }[];
+            total: number;
+            hasMore: boolean;
+            nextOffset: number;
+            summary: {
+              /** @description Draft and running campaigns matching `q`. */
+              totalCount: number;
+              stageCounts: {
+                [key: string]: number;
+              };
+            };
+            pagination: {
+              offset: number;
+              limit: number;
+              total: number;
+              hasMore: boolean;
+              nextOffset: number | null;
+              maxLimit: number;
+              defaultLimit: number;
+            };
+          };
+        };
+      };
+      /** @description Invalid campaign payload or plan state. */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden: missing `promotions:read` scope, or a session member without organization-wide access */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  post_v1_campaigns: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          /** @description Required for session auth. Optional for an API key, which already identifies the organization. */
+          organizationId?: string;
+          plan: {
+            brief: {
+              name: string;
+              /** @default  */
+              objective?: string;
+              /** @default  */
+              brand?: string;
+              ownerId: string;
+              approverId: string;
+              timezone: string;
+              /** @default [] */
+              stores?: {
+                /** @enum {string} */
+                marketplace:
+                  | "shopee"
+                  | "lazada"
+                  | "tiktok"
+                  | "shopify"
+                  | "whatsapp"
+                  | "zalora"
+                  | "amazon"
+                  | "ebay";
+                country: string;
+                storeId: string;
+              }[];
+              /** @default  */
+              serviceRequest?: string;
+              /**
+               * @default standard
+               * @enum {string}
+               */
+              priority?: "standard" | "priority" | "super_priority";
+              /** @default [] */
+              documentIds?: string[];
+              /** @default null */
+              reviewDueAt?: string | null;
+              sourceCurrency?: string;
+              /** @enum {string} */
+              sourceMarketplace?:
+                | "shopee"
+                | "lazada"
+                | "tiktok"
+                | "shopify"
+                | "whatsapp"
+                | "zalora"
+                | "amazon"
+                | "ebay";
+              sourceCountry?: string;
+              /** @default  */
+              cleanupNotes?: string;
+            };
+            /** @default [] */
+            windows?: {
+              id: string;
+              name: string;
+              /**
+               * @description Preparation time: publish promotions with the future live start/end. Must be at or before startsAt.
+               * @default null
+               */
+              preparesAt?: string | null;
+              startsAt: string | null;
+              endsAt: string | null;
+              /** @default  */
+              reviewNotes?: string;
+            }[];
+            offers?: {
+              id: string;
+              windowId: string;
+              /**
+               * Format: uuid
+               * @description Existing draft promotion attached to this window; the campaign controls its live dates.
+               */
+              promotionId?: string;
+              promotion: {
+                name?: string;
+                description?: string | null;
+                /**
+                 * @description Canonical OmniCommerce promotion mechanic: product discount, flash sale, voucher, gift with purchase, Buy-X-Get-Y, bundle deal, or Lazada-only free shipping and early bird price.
+                 * @enum {string}
+                 */
+                kind?:
+                  | "product_discount"
+                  | "flash_sale"
+                  | "voucher"
+                  | "gift_with_purchase"
+                  | "buy_x_get_y"
+                  | "bundle_deal"
+                  | "free_shipping"
+                  | "early_bird_price";
+                salesChannels?: ("pdp" | "live")[];
+                /** @enum {string} */
+                discountType?: "percentage" | "fixed_amount";
+                discountValue?: number;
+                /** @description Patch discount terms for exact target store keys; unnamed stores remain unchanged. Null discountValue restores shared campaign terms for that store. */
+                storeDiscounts?: {
+                  storeKey: string;
+                  /** @enum {string} */
+                  discountType: "percentage" | "fixed_amount";
+                  discountValue: number | null;
+                }[];
+                /** @description Up to 100 connected stores for create (required) or update. Copy marketplace, country, and storeId from get_promotions targetStores or find_products marketplaceDetails. Do not concatenate a storeKeys string. */
+                targetStores?: {
+                  /** @enum {string} */
+                  marketplace:
+                    | "lazada"
+                    | "shopee"
+                    | "tiktok"
+                    | "shopify"
+                    | "amazon"
+                    | "zalora"
+                    | "ebay";
+                  country: string;
+                  storeId: string;
+                }[];
+                minSalePrice?: number | null;
+                maxDiscountAmount?: number | null;
+                minSpend?: number | null;
+                voucherCode?: string | null;
+                claimStartsAt?: string | null;
+                totalUsageLimit?: number | null;
+                perBuyerLimit?: number | null;
+                mechanicConfig?: {
+                  /** @description Voucher subtype from get_promotions capabilities.voucherTypes. Browser AOP types (delivery=browser_aop) are writable Seller Center vouchers. Omit browserAutomation.aopId to use the built-in marketplace AOP. */
+                  voucherType?:
+                    | (
+                        | "shopee_shop"
+                        | "shopee_product"
+                        | "shopee_private"
+                        | "shopee_live"
+                        | "shopee_video"
+                        | "shopee_new_buyer"
+                        | "shopee_repeat_buyer"
+                        | "shopee_follow_prize"
+                        | "shopee_exclusive_streamer"
+                        | "shopee_welcome"
+                        | "shopee_member_repeat_buyer"
+                        | "shopee_exclusive"
+                        | "shopee_redemption"
+                        | "shopee_exclusive_creator"
+                        | "lazada_store_follower"
+                        | "lazada_regular"
+                        | "lazada_store_new_buyer"
+                        | "lazada_live"
+                        | "lazada_offline"
+                        | "lazada_co_funded"
+                        | "lazada_welcome"
+                        | "lazada_linked_member"
+                        | "lazada_new_member"
+                        | "lazada_member_exclusive"
+                        | "lazada_points_redeemable"
+                        | "tiktok_seller_coupon"
+                        | "shopify_discount_code"
+                        | "amazon_promotion_code"
+                        | "zalora_seller_voucher"
+                        | "ebay_coded_coupon"
+                      )
+                    | null;
+                  browserAutomation?: {
+                    aopId?: string;
+                    variableValues?: {
+                      [key: string]: string;
+                    };
+                    instructions?: string;
+                  } | null;
+                  /**
+                   * @description shop = all products, products = selected assigned products. Repeat Buyer defaults to shop.
+                   * @enum {string}
+                   */
+                  voucherScope?: "products" | "shop";
+                  /**
+                   * @description Seller Center reward type. coins_cashback is a percentage greater than 3 and does not reduce salePrice.
+                   * @enum {string}
+                   */
+                  voucherReward?: "discount" | "coins_cashback";
+                  /** @enum {string} */
+                  voucherAudience?: "general" | "shop_follow";
+                  /** @description Shopee Repeat Buyer: minimum completed shop orders, 1 or 2. Required for shopee_repeat_buyer. */
+                  repeatPurchaseMinCount?: number;
+                  /** @description Shopee Repeat Buyer: lookback window in days, one of 30, 90, 180 or 365. Required for shopee_repeat_buyer. */
+                  repeatPurchaseLookbackDays?: number;
+                  /** @description Shopee Smart Voucher toggle. Used by New Buyer and similar portal types. */
+                  smartVoucher?: boolean;
+                  /** @description Shopee Follow Prize: days after claim until expiry. Seller Center is 7. */
+                  followPrizeExpiryDays?: number;
+                  /**
+                   * @description Shopee Video display: shopee_video = all Shopee Video; creator_video = targeted creator videos only.
+                   * @enum {string}
+                   */
+                  videoDisplayMode?: "shopee_video" | "creator_video";
+                  /** @description Exclusive Creator Voucher: up to 15 Shopee usernames. */
+                  exclusiveCreatorUsernames?: string[];
+                  /** @description Exclusive Streamer Voucher: up to 15 Shopee usernames. */
+                  exclusiveStreamerUsernames?: string[];
+                  /** @description Shopee display setting. ["all"] = display on all pages; [] = hidden/share by code. */
+                  voucherDisplayChannels?: (
+                    | "all"
+                    | "feed"
+                    | "live"
+                    | "order_page"
+                    | "followers"
+                    | "offline"
+                  )[];
+                  /** @enum {string} */
+                  bundlePriceType?: "discount" | "fixed_price";
+                  bundleTiers?: {
+                    minimumQuantity: number;
+                    discountValue: number;
+                  }[];
+                  /** @enum {string} */
+                  thresholdType?: "item_quantity" | "order_amount";
+                  thresholdValue?: number;
+                  /** @enum {string} */
+                  giftType?: "gift" | "sample";
+                  giftQuantity?: number;
+                  gifts?: {
+                    /** Format: uuid */
+                    productId: string;
+                    variantId?: string | null;
+                    totalClaimLimit: number;
+                  }[];
+                  buyQuantity?: number;
+                  getQuantity?: number;
+                  benefitProductIds?: string[];
+                  /** @enum {string} */
+                  benefitType?: "free" | "percentage" | "fixed_amount";
+                  benefitValue?: number;
+                  maxApplicationsPerOrder?: number;
+                  bundleMinimumQuantity?: number;
+                  /** @description Free shipping delivery option. Lazada: STANDARD (default), ECONOMY, EXPRESS, SELLER_OWN_FLEET or P2P, as offered by the store. */
+                  shippingDeliveryOption?: string;
+                  /** @description Free shipping: total shipping subsidy budget in the store currency. Omit for an unlimited budget. */
+                  shippingBudget?: number;
+                };
+              };
+              /** @default [] */
+              productIds?: string[];
+              /** @default  */
+              reviewNotes?: string;
+              /** @default  */
+              excludedReason?: string;
+              source?: {
+                sheet: string;
+                rows: number[];
+                headers: string[];
+                values: string[][];
+              };
+            }[];
+          };
+        };
+      };
+    };
+    responses: {
+      /** @description Campaign detail: plan, revision, executions, audit, schedule, and progress. */
+      201: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            campaign: {
+              id: string;
+              organizationId: string;
+              revision: number;
+              /** @enum {string} */
+              stage:
+                | "draft"
+                | "approved"
+                | "running"
+                | "ending"
+                | "completed"
+                | "archived";
+              approval: {
+                revision: number;
+                userId: string;
+                approvedAt: string;
+              } | null;
+              runId: string | null;
+              startedAt: string | null;
+              endedAt: string | null;
+              createdAt: string;
+              updatedAt: string;
+              plan: components["schemas"]["CampaignPlan"];
+              /** @description A running campaign's proposed plan, applied only when the approver approves it. */
+              pendingChange: {
+                version: number;
+                plan: components["schemas"]["CampaignPlan"];
+                proposedBy: string;
+                proposedAt: string;
+              } | null;
+            };
+            executions: {
+              offerId: string;
+              windowId: string;
+              promotionId: string | null;
+              /** @enum {string} */
+              state:
+                | "draft"
+                | "activating"
+                | "prepared"
+                | "active"
+                | "ending"
+                | "ended"
+                | "failed";
+              error: string | null;
+              evidence: unknown;
+              termsRevision: number | null;
+            }[];
+            audit: {
+              id: string;
+              action: string;
+              actorId: string | null;
+              actorName: string | null;
+              createdAt: string;
+              details: {
+                [key: string]: unknown;
+              };
+              summary?: string;
+              items?: {
+                /** @enum {string} */
+                kind: "brief" | "window" | "offer";
+                /** @enum {string} */
+                action: "add" | "update" | "remove";
+                id: string;
+                name: string;
+                changes: {
+                  field: string;
+                  label: string;
+                  from: string | null;
+                  to: string | null;
+                }[];
+              }[];
+              hiddenCount?: number;
+            }[];
+            /** @description Issues that block approving or running the current plan. */
+            readiness: string[];
+            /** @description Issues that block approving the proposed live change. */
+            pendingChangeIssues: string[];
+            pendingScheduleCount: number;
+            failedScheduleCount: number;
+            waitingBrowserJobCount: number;
+            scheduleIssues?: {
+              windowId: string;
+              /** @enum {string} */
+              phase: "prepare" | "live";
+              /** @enum {string} */
+              kind: "overdue" | "missed";
+            }[];
+            recovery?: {
+              windowId: string;
+              /** @enum {string} */
+              phase: "prepare" | "live" | "start" | "end" | "revise";
+              state: string;
+              attempt: number;
+              nextRetryAt: string;
+              error: string | null;
+            }[];
+            cleanupFailed?: boolean;
+            progress?: {
+              asOf: string;
+              title: string;
+              description: string;
+              total: number;
+              counts: {
+                waiting: number;
+                preparing: number;
+                prepared: number;
+                live: number;
+                ending: number;
+                ended: number;
+                cancelled: number;
+                failed: number;
+              };
+              issues: {
+                offerId: string;
+                name: string;
+                error: string;
+              }[];
+              scheduleIssues: {
+                windowId: string;
+                /** @enum {string} */
+                phase: "prepare" | "live";
+                /** @enum {string} */
+                kind: "overdue" | "missed";
+                name: string;
+                message: string;
+              }[];
+              blockers: string[];
+              nextWindow: {
+                id: string;
+                name: string;
+                preparesAt: string | null;
+                startsAt: string | null;
+                endsAt: string | null;
+              } | null;
+            };
+          };
+        };
+      };
+      /** @description Invalid campaign payload or plan state. */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden: missing `promotions:write` scope, or a session member without organization-wide access */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_campaigns_by_campaignid: {
+    parameters: {
+      query?: {
+        /** @description Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token. */
+        organizationId?: string;
+      };
+      header?: never;
+      path: {
+        campaignId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Campaign detail: plan, revision, executions, audit, schedule, and progress. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            campaign: {
+              id: string;
+              organizationId: string;
+              revision: number;
+              /** @enum {string} */
+              stage:
+                | "draft"
+                | "approved"
+                | "running"
+                | "ending"
+                | "completed"
+                | "archived";
+              approval: {
+                revision: number;
+                userId: string;
+                approvedAt: string;
+              } | null;
+              runId: string | null;
+              startedAt: string | null;
+              endedAt: string | null;
+              createdAt: string;
+              updatedAt: string;
+              plan: components["schemas"]["CampaignPlan"];
+              /** @description A running campaign's proposed plan, applied only when the approver approves it. */
+              pendingChange: {
+                version: number;
+                plan: components["schemas"]["CampaignPlan"];
+                proposedBy: string;
+                proposedAt: string;
+              } | null;
+            };
+            executions: {
+              offerId: string;
+              windowId: string;
+              promotionId: string | null;
+              /** @enum {string} */
+              state:
+                | "draft"
+                | "activating"
+                | "prepared"
+                | "active"
+                | "ending"
+                | "ended"
+                | "failed";
+              error: string | null;
+              evidence: unknown;
+              termsRevision: number | null;
+            }[];
+            audit: {
+              id: string;
+              action: string;
+              actorId: string | null;
+              actorName: string | null;
+              createdAt: string;
+              details: {
+                [key: string]: unknown;
+              };
+              summary?: string;
+              items?: {
+                /** @enum {string} */
+                kind: "brief" | "window" | "offer";
+                /** @enum {string} */
+                action: "add" | "update" | "remove";
+                id: string;
+                name: string;
+                changes: {
+                  field: string;
+                  label: string;
+                  from: string | null;
+                  to: string | null;
+                }[];
+              }[];
+              hiddenCount?: number;
+            }[];
+            /** @description Issues that block approving or running the current plan. */
+            readiness: string[];
+            /** @description Issues that block approving the proposed live change. */
+            pendingChangeIssues: string[];
+            pendingScheduleCount: number;
+            failedScheduleCount: number;
+            waitingBrowserJobCount: number;
+            scheduleIssues?: {
+              windowId: string;
+              /** @enum {string} */
+              phase: "prepare" | "live";
+              /** @enum {string} */
+              kind: "overdue" | "missed";
+            }[];
+            recovery?: {
+              windowId: string;
+              /** @enum {string} */
+              phase: "prepare" | "live" | "start" | "end" | "revise";
+              state: string;
+              attempt: number;
+              nextRetryAt: string;
+              error: string | null;
+            }[];
+            cleanupFailed?: boolean;
+            progress?: {
+              asOf: string;
+              title: string;
+              description: string;
+              total: number;
+              counts: {
+                waiting: number;
+                preparing: number;
+                prepared: number;
+                live: number;
+                ending: number;
+                ended: number;
+                cancelled: number;
+                failed: number;
+              };
+              issues: {
+                offerId: string;
+                name: string;
+                error: string;
+              }[];
+              scheduleIssues: {
+                windowId: string;
+                /** @enum {string} */
+                phase: "prepare" | "live";
+                /** @enum {string} */
+                kind: "overdue" | "missed";
+                name: string;
+                message: string;
+              }[];
+              blockers: string[];
+              nextWindow: {
+                id: string;
+                name: string;
+                preparesAt: string | null;
+                startsAt: string | null;
+                endsAt: string | null;
+              } | null;
+            };
+          };
+        };
+      };
+      /** @description Invalid campaign payload or plan state. */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden: missing `promotions:read` scope, or a session member without organization-wide access */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Campaign not found for this organization */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  put_v1_campaigns_by_campaignid: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        campaignId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          /** @description Required for session auth. Optional for an API key, which already identifies the organization. */
+          organizationId?: string;
+          expectedRevision: number;
+          /** @enum {string} */
+          expectedStage?: "draft" | "approved";
+          expectedPendingVersion?: number | null;
+          plan: {
+            brief: {
+              name: string;
+              /** @default  */
+              objective?: string;
+              /** @default  */
+              brand?: string;
+              ownerId: string;
+              approverId: string;
+              timezone: string;
+              /** @default [] */
+              stores?: {
+                /** @enum {string} */
+                marketplace:
+                  | "shopee"
+                  | "lazada"
+                  | "tiktok"
+                  | "shopify"
+                  | "whatsapp"
+                  | "zalora"
+                  | "amazon"
+                  | "ebay";
+                country: string;
+                storeId: string;
+              }[];
+              /** @default  */
+              serviceRequest?: string;
+              /**
+               * @default standard
+               * @enum {string}
+               */
+              priority?: "standard" | "priority" | "super_priority";
+              /** @default [] */
+              documentIds?: string[];
+              /** @default null */
+              reviewDueAt?: string | null;
+              sourceCurrency?: string;
+              /** @enum {string} */
+              sourceMarketplace?:
+                | "shopee"
+                | "lazada"
+                | "tiktok"
+                | "shopify"
+                | "whatsapp"
+                | "zalora"
+                | "amazon"
+                | "ebay";
+              sourceCountry?: string;
+              /** @default  */
+              cleanupNotes?: string;
+            };
+            /** @default [] */
+            windows?: {
+              id: string;
+              name: string;
+              /**
+               * @description Preparation time: publish promotions with the future live start/end. Must be at or before startsAt.
+               * @default null
+               */
+              preparesAt?: string | null;
+              startsAt: string | null;
+              endsAt: string | null;
+              /** @default  */
+              reviewNotes?: string;
+            }[];
+            offers?: {
+              id: string;
+              windowId: string;
+              /**
+               * Format: uuid
+               * @description Existing draft promotion attached to this window; the campaign controls its live dates.
+               */
+              promotionId?: string;
+              promotion: {
+                name?: string;
+                description?: string | null;
+                /**
+                 * @description Canonical OmniCommerce promotion mechanic: product discount, flash sale, voucher, gift with purchase, Buy-X-Get-Y, bundle deal, or Lazada-only free shipping and early bird price.
+                 * @enum {string}
+                 */
+                kind?:
+                  | "product_discount"
+                  | "flash_sale"
+                  | "voucher"
+                  | "gift_with_purchase"
+                  | "buy_x_get_y"
+                  | "bundle_deal"
+                  | "free_shipping"
+                  | "early_bird_price";
+                salesChannels?: ("pdp" | "live")[];
+                /** @enum {string} */
+                discountType?: "percentage" | "fixed_amount";
+                discountValue?: number;
+                /** @description Patch discount terms for exact target store keys; unnamed stores remain unchanged. Null discountValue restores shared campaign terms for that store. */
+                storeDiscounts?: {
+                  storeKey: string;
+                  /** @enum {string} */
+                  discountType: "percentage" | "fixed_amount";
+                  discountValue: number | null;
+                }[];
+                /** @description Up to 100 connected stores for create (required) or update. Copy marketplace, country, and storeId from get_promotions targetStores or find_products marketplaceDetails. Do not concatenate a storeKeys string. */
+                targetStores?: {
+                  /** @enum {string} */
+                  marketplace:
+                    | "lazada"
+                    | "shopee"
+                    | "tiktok"
+                    | "shopify"
+                    | "amazon"
+                    | "zalora"
+                    | "ebay";
+                  country: string;
+                  storeId: string;
+                }[];
+                minSalePrice?: number | null;
+                maxDiscountAmount?: number | null;
+                minSpend?: number | null;
+                voucherCode?: string | null;
+                claimStartsAt?: string | null;
+                totalUsageLimit?: number | null;
+                perBuyerLimit?: number | null;
+                mechanicConfig?: {
+                  /** @description Voucher subtype from get_promotions capabilities.voucherTypes. Browser AOP types (delivery=browser_aop) are writable Seller Center vouchers. Omit browserAutomation.aopId to use the built-in marketplace AOP. */
+                  voucherType?:
+                    | (
+                        | "shopee_shop"
+                        | "shopee_product"
+                        | "shopee_private"
+                        | "shopee_live"
+                        | "shopee_video"
+                        | "shopee_new_buyer"
+                        | "shopee_repeat_buyer"
+                        | "shopee_follow_prize"
+                        | "shopee_exclusive_streamer"
+                        | "shopee_welcome"
+                        | "shopee_member_repeat_buyer"
+                        | "shopee_exclusive"
+                        | "shopee_redemption"
+                        | "shopee_exclusive_creator"
+                        | "lazada_store_follower"
+                        | "lazada_regular"
+                        | "lazada_store_new_buyer"
+                        | "lazada_live"
+                        | "lazada_offline"
+                        | "lazada_co_funded"
+                        | "lazada_welcome"
+                        | "lazada_linked_member"
+                        | "lazada_new_member"
+                        | "lazada_member_exclusive"
+                        | "lazada_points_redeemable"
+                        | "tiktok_seller_coupon"
+                        | "shopify_discount_code"
+                        | "amazon_promotion_code"
+                        | "zalora_seller_voucher"
+                        | "ebay_coded_coupon"
+                      )
+                    | null;
+                  browserAutomation?: {
+                    aopId?: string;
+                    variableValues?: {
+                      [key: string]: string;
+                    };
+                    instructions?: string;
+                  } | null;
+                  /**
+                   * @description shop = all products, products = selected assigned products. Repeat Buyer defaults to shop.
+                   * @enum {string}
+                   */
+                  voucherScope?: "products" | "shop";
+                  /**
+                   * @description Seller Center reward type. coins_cashback is a percentage greater than 3 and does not reduce salePrice.
+                   * @enum {string}
+                   */
+                  voucherReward?: "discount" | "coins_cashback";
+                  /** @enum {string} */
+                  voucherAudience?: "general" | "shop_follow";
+                  /** @description Shopee Repeat Buyer: minimum completed shop orders, 1 or 2. Required for shopee_repeat_buyer. */
+                  repeatPurchaseMinCount?: number;
+                  /** @description Shopee Repeat Buyer: lookback window in days, one of 30, 90, 180 or 365. Required for shopee_repeat_buyer. */
+                  repeatPurchaseLookbackDays?: number;
+                  /** @description Shopee Smart Voucher toggle. Used by New Buyer and similar portal types. */
+                  smartVoucher?: boolean;
+                  /** @description Shopee Follow Prize: days after claim until expiry. Seller Center is 7. */
+                  followPrizeExpiryDays?: number;
+                  /**
+                   * @description Shopee Video display: shopee_video = all Shopee Video; creator_video = targeted creator videos only.
+                   * @enum {string}
+                   */
+                  videoDisplayMode?: "shopee_video" | "creator_video";
+                  /** @description Exclusive Creator Voucher: up to 15 Shopee usernames. */
+                  exclusiveCreatorUsernames?: string[];
+                  /** @description Exclusive Streamer Voucher: up to 15 Shopee usernames. */
+                  exclusiveStreamerUsernames?: string[];
+                  /** @description Shopee display setting. ["all"] = display on all pages; [] = hidden/share by code. */
+                  voucherDisplayChannels?: (
+                    | "all"
+                    | "feed"
+                    | "live"
+                    | "order_page"
+                    | "followers"
+                    | "offline"
+                  )[];
+                  /** @enum {string} */
+                  bundlePriceType?: "discount" | "fixed_price";
+                  bundleTiers?: {
+                    minimumQuantity: number;
+                    discountValue: number;
+                  }[];
+                  /** @enum {string} */
+                  thresholdType?: "item_quantity" | "order_amount";
+                  thresholdValue?: number;
+                  /** @enum {string} */
+                  giftType?: "gift" | "sample";
+                  giftQuantity?: number;
+                  gifts?: {
+                    /** Format: uuid */
+                    productId: string;
+                    variantId?: string | null;
+                    totalClaimLimit: number;
+                  }[];
+                  buyQuantity?: number;
+                  getQuantity?: number;
+                  benefitProductIds?: string[];
+                  /** @enum {string} */
+                  benefitType?: "free" | "percentage" | "fixed_amount";
+                  benefitValue?: number;
+                  maxApplicationsPerOrder?: number;
+                  bundleMinimumQuantity?: number;
+                  /** @description Free shipping delivery option. Lazada: STANDARD (default), ECONOMY, EXPRESS, SELLER_OWN_FLEET or P2P, as offered by the store. */
+                  shippingDeliveryOption?: string;
+                  /** @description Free shipping: total shipping subsidy budget in the store currency. Omit for an unlimited budget. */
+                  shippingBudget?: number;
+                };
+              };
+              /** @default [] */
+              productIds?: string[];
+              /** @default  */
+              reviewNotes?: string;
+              /** @default  */
+              excludedReason?: string;
+              source?: {
+                sheet: string;
+                rows: number[];
+                headers: string[];
+                values: string[][];
+              };
+            }[];
+          };
+        };
+      };
+    };
+    responses: {
+      /** @description Campaign detail: plan, revision, executions, audit, schedule, and progress. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            campaign: {
+              id: string;
+              organizationId: string;
+              revision: number;
+              /** @enum {string} */
+              stage:
+                | "draft"
+                | "approved"
+                | "running"
+                | "ending"
+                | "completed"
+                | "archived";
+              approval: {
+                revision: number;
+                userId: string;
+                approvedAt: string;
+              } | null;
+              runId: string | null;
+              startedAt: string | null;
+              endedAt: string | null;
+              createdAt: string;
+              updatedAt: string;
+              plan: components["schemas"]["CampaignPlan"];
+              /** @description A running campaign's proposed plan, applied only when the approver approves it. */
+              pendingChange: {
+                version: number;
+                plan: components["schemas"]["CampaignPlan"];
+                proposedBy: string;
+                proposedAt: string;
+              } | null;
+            };
+            executions: {
+              offerId: string;
+              windowId: string;
+              promotionId: string | null;
+              /** @enum {string} */
+              state:
+                | "draft"
+                | "activating"
+                | "prepared"
+                | "active"
+                | "ending"
+                | "ended"
+                | "failed";
+              error: string | null;
+              evidence: unknown;
+              termsRevision: number | null;
+            }[];
+            audit: {
+              id: string;
+              action: string;
+              actorId: string | null;
+              actorName: string | null;
+              createdAt: string;
+              details: {
+                [key: string]: unknown;
+              };
+              summary?: string;
+              items?: {
+                /** @enum {string} */
+                kind: "brief" | "window" | "offer";
+                /** @enum {string} */
+                action: "add" | "update" | "remove";
+                id: string;
+                name: string;
+                changes: {
+                  field: string;
+                  label: string;
+                  from: string | null;
+                  to: string | null;
+                }[];
+              }[];
+              hiddenCount?: number;
+            }[];
+            /** @description Issues that block approving or running the current plan. */
+            readiness: string[];
+            /** @description Issues that block approving the proposed live change. */
+            pendingChangeIssues: string[];
+            pendingScheduleCount: number;
+            failedScheduleCount: number;
+            waitingBrowserJobCount: number;
+            scheduleIssues?: {
+              windowId: string;
+              /** @enum {string} */
+              phase: "prepare" | "live";
+              /** @enum {string} */
+              kind: "overdue" | "missed";
+            }[];
+            recovery?: {
+              windowId: string;
+              /** @enum {string} */
+              phase: "prepare" | "live" | "start" | "end" | "revise";
+              state: string;
+              attempt: number;
+              nextRetryAt: string;
+              error: string | null;
+            }[];
+            cleanupFailed?: boolean;
+            progress?: {
+              asOf: string;
+              title: string;
+              description: string;
+              total: number;
+              counts: {
+                waiting: number;
+                preparing: number;
+                prepared: number;
+                live: number;
+                ending: number;
+                ended: number;
+                cancelled: number;
+                failed: number;
+              };
+              issues: {
+                offerId: string;
+                name: string;
+                error: string;
+              }[];
+              scheduleIssues: {
+                windowId: string;
+                /** @enum {string} */
+                phase: "prepare" | "live";
+                /** @enum {string} */
+                kind: "overdue" | "missed";
+                name: string;
+                message: string;
+              }[];
+              blockers: string[];
+              nextWindow: {
+                id: string;
+                name: string;
+                preparesAt: string | null;
+                startsAt: string | null;
+                endsAt: string | null;
+              } | null;
+            };
+          };
+        };
+      };
+      /** @description Invalid campaign payload or plan state. */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden: missing `promotions:write` scope, or a session member without organization-wide access */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Campaign not found for this organization */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  post_v1_campaigns_by_campaignid_actions: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        campaignId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          /** @enum {string} */
+          action:
+            | "approve"
+            | "run"
+            | "approve_and_run"
+            | "end"
+            | "resume"
+            | "retry"
+            | "approve_change"
+            | "discard_change";
+          expectedRevision: number;
+          expectedPendingVersion?: number;
+          /** @description Required for session auth. Optional for an API key, which already identifies the organization. */
+          organizationId?: string;
+        };
+      };
+    };
+    responses: {
+      /** @description Campaign detail after the action, plus the scheduling result. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            campaign: {
+              id: string;
+              organizationId: string;
+              revision: number;
+              /** @enum {string} */
+              stage:
+                | "draft"
+                | "approved"
+                | "running"
+                | "ending"
+                | "completed"
+                | "archived";
+              approval: {
+                revision: number;
+                userId: string;
+                approvedAt: string;
+              } | null;
+              runId: string | null;
+              startedAt: string | null;
+              endedAt: string | null;
+              createdAt: string;
+              updatedAt: string;
+              plan: components["schemas"]["CampaignPlan"];
+              /** @description A running campaign's proposed plan, applied only when the approver approves it. */
+              pendingChange: {
+                version: number;
+                plan: components["schemas"]["CampaignPlan"];
+                proposedBy: string;
+                proposedAt: string;
+              } | null;
+            };
+            executions: {
+              offerId: string;
+              windowId: string;
+              promotionId: string | null;
+              /** @enum {string} */
+              state:
+                | "draft"
+                | "activating"
+                | "prepared"
+                | "active"
+                | "ending"
+                | "ended"
+                | "failed";
+              error: string | null;
+              evidence: unknown;
+              termsRevision: number | null;
+            }[];
+            audit: {
+              id: string;
+              action: string;
+              actorId: string | null;
+              actorName: string | null;
+              createdAt: string;
+              details: {
+                [key: string]: unknown;
+              };
+              summary?: string;
+              items?: {
+                /** @enum {string} */
+                kind: "brief" | "window" | "offer";
+                /** @enum {string} */
+                action: "add" | "update" | "remove";
+                id: string;
+                name: string;
+                changes: {
+                  field: string;
+                  label: string;
+                  from: string | null;
+                  to: string | null;
+                }[];
+              }[];
+              hiddenCount?: number;
+            }[];
+            /** @description Issues that block approving or running the current plan. */
+            readiness: string[];
+            /** @description Issues that block approving the proposed live change. */
+            pendingChangeIssues: string[];
+            pendingScheduleCount: number;
+            failedScheduleCount: number;
+            waitingBrowserJobCount: number;
+            scheduleIssues?: {
+              windowId: string;
+              /** @enum {string} */
+              phase: "prepare" | "live";
+              /** @enum {string} */
+              kind: "overdue" | "missed";
+            }[];
+            recovery?: {
+              windowId: string;
+              /** @enum {string} */
+              phase: "prepare" | "live" | "start" | "end" | "revise";
+              state: string;
+              attempt: number;
+              nextRetryAt: string;
+              error: string | null;
+            }[];
+            cleanupFailed?: boolean;
+            progress?: {
+              asOf: string;
+              title: string;
+              description: string;
+              total: number;
+              counts: {
+                waiting: number;
+                preparing: number;
+                prepared: number;
+                live: number;
+                ending: number;
+                ended: number;
+                cancelled: number;
+                failed: number;
+              };
+              issues: {
+                offerId: string;
+                name: string;
+                error: string;
+              }[];
+              scheduleIssues: {
+                windowId: string;
+                /** @enum {string} */
+                phase: "prepare" | "live";
+                /** @enum {string} */
+                kind: "overdue" | "missed";
+                name: string;
+                message: string;
+              }[];
+              blockers: string[];
+              nextWindow: {
+                id: string;
+                name: string;
+                preparesAt: string | null;
+                startsAt: string | null;
+                endsAt: string | null;
+              } | null;
+            };
+            /** @description `pending` is true when the schedule was saved but not yet acknowledged; retry the action to confirm. */
+            scheduling: {
+              queued: number;
+              pending: boolean;
+            };
+          };
+        };
+      };
+      /** @description Invalid campaign payload or plan state. */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden: missing `promotions:write` scope, or a session member without organization-wide access */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Campaign not found for this organization */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  post_v1_campaigns_archive: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json":
+          | {
+              campaignIds: string[];
+              /** @enum {string} */
+              action: "archive" | "restore";
+              /** @description Required for session auth. Optional for an API key, which already identifies the organization. */
+              organizationId?: string;
+            }
+          | {
+              /** @constant */
+              action: "restore";
+              selection: {
+                /** @constant */
+                mode: "all_matching";
+                filters: {
+                  /** @default  */
+                  q?: string;
+                  /**
+                   * @default all
+                   * @enum {string}
+                   */
+                  stage?:
+                    | "all"
+                    | "draft"
+                    | "approved"
+                    | "running"
+                    | "ending"
+                    | "completed"
+                    | "archived";
+                };
+                /** @default [] */
+                excludedCampaignIds?: string[];
+              };
+              /** @description Required for session auth. Optional for an API key, which already identifies the organization. */
+              organizationId?: string;
+            };
+      };
+    };
+    responses: {
+      /** @description Aggregate result plus one result per campaign. `success` is true only when every requested campaign succeeds. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            /** @description True only when every requested campaign succeeds. */
+            success: boolean;
+            campaignIds: string[];
+            succeededCount: number;
+            failedCount: number;
+            results: {
+              success: boolean;
+              campaignId: string;
+              /** @enum {string} */
+              stage?:
+                | "draft"
+                | "approved"
+                | "running"
+                | "ending"
+                | "completed"
+                | "archived";
+              error?: string;
+            }[];
+          };
+        };
+      };
+      /** @description Invalid campaign payload or plan state. */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden: missing `promotions:write` scope, or a session member without organization-wide access */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  post_v1_campaigns_delete: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          /** @description Required for session auth. Optional for an API key, which already identifies the organization. */
+          organizationId?: string;
+          selection:
+            | {
+                /** @constant */
+                mode: "explicit";
+                campaignIds: string[];
+              }
+            | {
+                /** @constant */
+                mode: "all_matching";
+                filters: {
+                  /** @default  */
+                  q?: string;
+                  /**
+                   * @default all
+                   * @enum {string}
+                   */
+                  stage?:
+                    | "all"
+                    | "draft"
+                    | "approved"
+                    | "running"
+                    | "ending"
+                    | "completed"
+                    | "archived";
+                };
+                excludedCampaignIds?: string[];
+              };
+        };
+      };
+    };
+    responses: {
+      /** @description Aggregate result plus one result per campaign. `success` is true only when every requested campaign succeeds. */
       200: {
         headers: {
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            aop_id: string;
-            title: string;
-            /** @default created */
-            status: string;
-            message?: string;
-            parent_folder_id?: string | null;
+            /** @description True only when every requested campaign succeeds. */
+            success: boolean;
+            campaignIds: string[];
+            succeededCount: number;
+            failedCount: number;
+            results: {
+              success: boolean;
+              campaignId: string;
+              error?: string;
+            }[];
           };
         };
       };
-      /** @description Invalid AOP configuration or request */
+      /** @description Invalid campaign payload or plan state. */
       400: {
         headers: {
           [name: string]: unknown;
@@ -3274,28 +5972,21 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Insufficient AI credits */
-      402: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Forbidden. Missing OAuth scope. */
+      /** @description Forbidden: missing `promotions:write` scope, or a session member without organization-wide access */
       403: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description AOP or thread not found */
-      404: {
+      /** @description Rate limit exceeded */
+      429: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description Internal server error */
+      /** @description Internal Server Error */
       500: {
         headers: {
           [name: string]: unknown;
@@ -3304,43 +5995,69 @@ interface operations {
       };
     };
   };
-  post_v1_aop_retry: {
+  get_v1_campaigns_options: {
     parameters: {
-      query?: never;
+      query?: {
+        /** @description Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token. */
+        organizationId?: string;
+      };
       header?: never;
       path?: never;
       cookie?: never;
     };
-    requestBody: {
-      content: {
-        "application/json": {
-          /** @description Thread ID of the failed AOP execution to retry. */
-          thread_id: string;
-          /** @description Optional user inputs appended to the AOP prompt as key-value pairs. */
-          user_inputs?: {
-            [key: string]: string | number | boolean;
-          } | null;
-          /** @description Required for session auth. Optional for API keys. */
-          organizationId?: string;
-        };
-      };
-    };
+    requestBody?: never;
     responses: {
-      /** @description Success */
+      /** @description Members and connected stores. */
       200: {
         headers: {
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            /** @constant */
-            status: "started";
-            new_thread_id: string;
-            message: string;
+            /** @description Organization members. Use `id` for `ownerId` and `approverId`. */
+            members: {
+              id: string;
+              name: string;
+              email: string;
+            }[];
+            /** @description Connected stores for `brief.stores`. */
+            stores: {
+              /** @enum {string} */
+              marketplace:
+                | "shopify"
+                | "shopee"
+                | "lazada"
+                | "tiktok"
+                | "whatsapp"
+                | "zalora"
+                | "amazon"
+                | "ebay";
+              country: string;
+              storeId: string;
+              storeName: string;
+              isDefaultPublish?: boolean;
+              dbsHazmatApproved?: boolean;
+            }[];
+            /** @description Connected stores for offer `promotion.targetStores`. */
+            promotionStores: {
+              /** @enum {string} */
+              marketplace:
+                | "lazada"
+                | "shopee"
+                | "tiktok"
+                | "shopify"
+                | "amazon"
+                | "zalora"
+                | "ebay";
+              country: string;
+              storeId: string;
+              storeName?: string;
+              currency?: string | null;
+            }[];
           };
         };
       };
-      /** @description Invalid AOP configuration or request */
+      /** @description Invalid campaign payload or plan state. */
       400: {
         headers: {
           [name: string]: unknown;
@@ -3354,28 +6071,21 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Insufficient AI credits */
-      402: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Forbidden. Missing OAuth scope. */
+      /** @description Forbidden: missing `promotions:write` scope, or a session member without organization-wide access */
       403: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description AOP or thread not found */
-      404: {
+      /** @description Rate limit exceeded */
+      429: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description Internal server error */
+      /** @description Internal Server Error */
       500: {
         headers: {
           [name: string]: unknown;
@@ -6742,28 +9452,16 @@ interface operations {
           storeId?: string | null;
           /** @description Optional country scope (name or code). Null/omit applies to all countries. */
           country?: string | null;
-          /** @description Optional product source key. Null/omit matches every product. Compared case-insensitively. */
-          sourceKey?: string | null;
-          /**
-           * @description Starting amount for a formula. Ignored when `steps` is empty. Defaults to `list_price`.
-           * @enum {string}
-           */
-          base?: "list_price" | "cost";
-          /**
-           * @description `list_price` rewrites the shelf price. `payout` is calculated and not published. Defaults to `list_price`.
-           * @enum {string}
-           */
-          application?: "list_price" | "payout";
-          /** @description Ordered formula steps. When non-empty, these replace the percent markup. */
-          steps?: Record<string, never>[];
-          /** @description Markup percent applied to canonical list price. Ignored when `steps` is non-empty. */
+          /** @description Markup percent applied to the catalog price. Ignored when `expression` is set. */
           marginValue: number;
+          /** @description Buyer formula. `price` is the catalog price. Supports arithmetic, percentages, CEILING, IF, and CURRENCY(rate, "USD"). Replaces markup percent. */
+          expression?: string | null;
           /**
            * @description Defaults to `currency_minor` when omitted.
            * @enum {string}
            */
           rounding?: "none" | "currency_minor" | "nearest_0_05" | "nearest_1";
-          /** @description ISO 4217 currency. For a percent rule this selects minor-unit rounding. For a formula this is the starting currency. */
+          /** @description Optional ISO 4217 currency for `currency_minor` rounding. */
           currency?: string | null;
           /**
            * @description Whether the rule is active. Defaults to true.
@@ -6956,17 +9654,12 @@ interface operations {
           organizationId?: string;
           storeId?: string | null;
           country?: string | null;
-          sourceKey?: string | null;
-          /** @enum {string} */
-          base?: "list_price" | "cost";
-          /** @enum {string} */
-          application?: "list_price" | "payout";
-          /** @description Ordered formula steps. When non-empty, these replace the percent markup. */
-          steps?: Record<string, never>[];
           marginValue?: number;
           /** @enum {string} */
           rounding?: "none" | "currency_minor" | "nearest_0_05" | "nearest_1";
           currency?: string | null;
+          /** @description Buyer formula. `price` is the catalog price. Null clears the formula and markup percent applies again. */
+          expression?: string | null;
           enabled?: boolean;
         };
       };
@@ -7050,16 +9743,8 @@ interface operations {
             | "zalora"
             | "amazon"
             | "ebay";
-          /** @description Canonical list price, or the list-price starting amount for a formula. */
+          /** @description Canonical list price to mark up. */
           listPrice: number;
-          /** @description Cost used when the matching formula starts from cost. */
-          costPrice?: number;
-          costCurrency?: string | null;
-          sourceKey?: string | null;
-          /** @description Pricing category used by a shipping rate step. */
-          categoryKey?: string | null;
-          /** @enum {string} */
-          application?: "list_price" | "payout";
           storeId?: string | null;
           country?: string | null;
           currency?: string | null;
@@ -7085,12 +9770,18 @@ interface operations {
             /** @enum {string} */
             source: "price_book" | "canonical";
             markupPercent?: number;
+            /** @description Listed currency when known. A buyer formula with CURRENCY sets it. */
+            currency?: string;
+            /** @description Present and true when the buyer formula lists below the catalog price in the same currency. This is usually a payout formula, price * (1 - fees), used where the gross-up, price / (1 - fees), was meant. */
+            belowCatalogPrice?: boolean;
+            /** @description Set when the matched buyer formula cannot price this list price. Publish fails for that listing instead of using the catalog price. */
+            formulaError?: string;
             rule?: Record<string, never> | null;
             message?: string;
           };
         };
       };
-      /** @description Bad Request */
+      /** @description Bad Request, or the forced `ruleId` has a buyer formula that cannot price this list price */
       400: {
         headers: {
           [name: string]: unknown;
@@ -7172,6 +9863,18 @@ interface operations {
         content: {
           "application/json": {
             items?: {
+              /** Format: uuid */
+              id: string;
+              name: string;
+              sku: string | null;
+              /** Format: uuid */
+              parentId: string | null;
+              isVariant: boolean;
+              /** @description Catalog stock in whole units, matching the Products page. Parent rows aggregate non-deleted variants in the same organization; virtual bundles derive stock from components and any manual cap. Null means unknown: never substitute zero for missing or null stock. This is not a sum of marketplace inventory mirrors or a per-location available-to-promise balance. */
+              stockQuantity: number | null;
+              /** @description Whether the product has variants. The list row's stockQuantity already includes their stock; variants are not embedded in this response. */
+              hasVariants: boolean;
+              variantCount: number;
               status?: string;
               /** @description Read-only product-wide state. Lifecycle status and derived quality/error signals are independent; this field is recalculated from current product, marketplace QC, and review flags. */
               statusFacets?: {
@@ -7194,8 +9897,12 @@ interface operations {
             hasMore?: boolean;
             nextOffset?: number;
             summary?: {
+              /** @description All-tab count under the other filters, before applying the selected status. Use pagination.total for the matching result count. */
               totalCount?: number;
-              statusCounts?: Record<string, never>;
+              /** @description Counts by product status under the other selected filters. */
+              statusCounts?: {
+                [key: string]: number;
+              };
             };
             /** @description Echoes the offset/limit actually applied to the query (after clamping) plus discovery metadata for paging. */
             pagination?: {
@@ -8784,8 +11491,8 @@ interface operations {
             | "fail_job";
           autoApproveThreshold?: number | null;
           spendCeilingUsd?: number | null;
-          /** @description Connected store ID for each target marketplace. One store per marketplace, not an array of store IDs. */
-          marketplaceStoreSelections?: {
+          /** @description Required: select at least one connected store. One store per marketplace, not an array of store IDs. */
+          marketplaceStoreSelections: {
             /** @description Connected shopee store ID. */
             shopee?: string;
             /** @description Connected lazada store ID. */
@@ -8856,7 +11563,7 @@ interface operations {
           /** @description JSON object mapping CSV headers to import fields, e.g. `{"sku":"SKU","title":"Product Name"}`. */
           fieldMapping?: string;
           /** @description Connected store ID for each target marketplace. JSON requests send an object; multipart may send that object as a JSON string. */
-          marketplaceStoreSelections?:
+          marketplaceStoreSelections:
             | {
                 /** @description Connected shopee store ID. */
                 shopee?: string;
@@ -9904,6 +12611,12 @@ interface operations {
           variantSku?: string | null;
           /** @default 0 */
           priority?: number;
+          /** @description Optional per-product discount for product discounts and flash sales. Uses the campaign discount type. Null restores the shared discount. Shopee and TikTok publish the resulting price. Lazada vouchers and Shopify fail sync while any product has its own discount. */
+          productDiscounts?: {
+            /** Format: uuid */
+            productId: string;
+            discountValue: number | null;
+          }[];
         };
       };
     };
@@ -10990,6 +13703,9 @@ interface operations {
             | "order.status.changed"
             | "look.created"
             | "look.deleted"
+            | "review.created"
+            | "review.updated"
+            | "review.status.changed"
             | "settlement.created"
             | "settlement.updated"
             | "settlement.status.changed"
@@ -12444,6 +15160,90 @@ interface operations {
       };
     };
   };
+  review_created_webhook: {
+    parameters: {
+      query?: never;
+      header: {
+        "X-Omni-Event-Id": string;
+        "X-Omni-Event-Type": "review.created";
+        "X-Omni-Timestamp": string;
+        /** @description Hex HMAC-SHA256 of `{timestamp}.{rawBody}` using the subscription secret. */
+        "X-Omni-Signature": string;
+      };
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": components["schemas"]["ReviewCreatedWebhookEvent"];
+      };
+    };
+    responses: {
+      /** @description Event accepted. */
+      "2XX": {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  review_updated_webhook: {
+    parameters: {
+      query?: never;
+      header: {
+        "X-Omni-Event-Id": string;
+        "X-Omni-Event-Type": "review.updated";
+        "X-Omni-Timestamp": string;
+        /** @description Hex HMAC-SHA256 of `{timestamp}.{rawBody}` using the subscription secret. */
+        "X-Omni-Signature": string;
+      };
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": components["schemas"]["ReviewUpdatedWebhookEvent"];
+      };
+    };
+    responses: {
+      /** @description Event accepted. */
+      "2XX": {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  review_status_changed_webhook: {
+    parameters: {
+      query?: never;
+      header: {
+        "X-Omni-Event-Id": string;
+        "X-Omni-Event-Type": "review.status.changed";
+        "X-Omni-Timestamp": string;
+        /** @description Hex HMAC-SHA256 of `{timestamp}.{rawBody}` using the subscription secret. */
+        "X-Omni-Signature": string;
+      };
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": components["schemas"]["ReviewStatusChangedWebhookEvent"];
+      };
+    };
+    responses: {
+      /** @description Event accepted. */
+      "2XX": {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
   order_created_webhook: {
     parameters: {
       query?: never;
@@ -12757,6 +15557,41 @@ interface operations {
  * `get`/`list`/`create`-style names.
  */
 
+declare class AgentsGeneralClient {
+    protected readonly _http: OmniHttp;
+    constructor(_http: OmniHttp);
+    /**
+     * Invoke the Omni agent
+     *
+     * Run the general Omni agent and wait until it completes, pauses for approval, or fails. Requires `agents:invoke`.
+  
+  A waiting call can take several minutes; raise the client timeout. Send `decisions` with the same `thread_id` to approve or reject a paused run. Omit `config.enabled_tools` to use the organization's agent tools. Attach images on the latest user message as `{ type: "image", url }` HTTP(S) URLs.
+     *
+     * `POST /api/v1/agents/general/invoke`
+     */
+    invoke(request: OperationBody<operations["post_v1_agents_general_invoke"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["post_v1_agents_general_invoke"]>>;
+    /**
+     * Start an Omni agent run
+     *
+     * Queue the general Omni agent and return immediately with the run in `queued` state. Poll the URL in the `Location` header (`GET /api/v1/agents/general/runs/{runId}`), honoring `Retry-After`. Requires `agents:invoke`. The request body matches invoke.
+     *
+     * `POST /api/v1/agents/general/runs`
+     */
+    start(request: OperationBody<operations["post_v1_agents_general_runs"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["post_v1_agents_general_runs"]>>;
+    /**
+     * Get an Omni agent run
+     *
+     * Read a queued, running, completed, paused, or failed Omni agent run. Requires `agents:invoke`.
+     *
+     * `GET /api/v1/agents/general/runs/{runId}`
+     */
+    getRun(request: OperationPath<operations["get_v1_agents_general_runs_by_runid"]> & OperationQuery<operations["get_v1_agents_general_runs_by_runid"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_agents_general_runs_by_runid"]>>;
+}
+declare class AgentsClient {
+    protected readonly _http: OmniHttp;
+    readonly general: AgentsGeneralClient;
+    constructor(_http: OmniHttp);
+}
 declare class AopClient {
     protected readonly _http: OmniHttp;
     constructor(_http: OmniHttp);
@@ -12821,6 +15656,74 @@ declare class ApiClient {
      */
     v1(requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1"]>>;
 }
+declare class CampaignsClient {
+    protected readonly _http: OmniHttp;
+    constructor(_http: OmniHttp);
+    /**
+     * List Campaigns
+     *
+     * List campaigns for the authenticated organization. `stage=all` is the workspace working set: draft and running. Requires `promotions:read`.
+     *
+     * `GET /api/v1/campaigns`
+     */
+    list(request?: OperationQuery<operations["get_v1_campaigns"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_campaigns"]>>;
+    /**
+     * Create Campaign
+     *
+     * Create a draft campaign. `ownerId` and `approverId` must be members of the organization, and every store must already be connected. Requires `promotions:write`.
+     *
+     * `POST /api/v1/campaigns`
+     */
+    create(request: OperationBody<operations["post_v1_campaigns"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["post_v1_campaigns"]>>;
+    /**
+     * Get Campaign
+     *
+     * Read one campaign, including its plan, executions, audit, schedule, and progress. Requires `promotions:read`.
+     *
+     * `GET /api/v1/campaigns/{campaignId}`
+     */
+    get(request: OperationPath<operations["get_v1_campaigns_by_campaignid"]> & OperationQuery<operations["get_v1_campaigns_by_campaignid"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_campaigns_by_campaignid"]>>;
+    /**
+     * Update Campaign
+     *
+     * Replace a draft or approved plan, or propose one change to a running plan. Send `expectedRevision` from the last read. Requires `promotions:write`.
+     *
+     * `PUT /api/v1/campaigns/{campaignId}`
+     */
+    replace(request: OperationPath<operations["put_v1_campaigns_by_campaignid"]> & OperationBody<operations["put_v1_campaigns_by_campaignid"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["put_v1_campaigns_by_campaignid"]>>;
+    /**
+     * Act on Campaign
+     *
+     * Approve, start, end, resume, retry, or decide a proposed live change. Approve, run, resume, and approving a change must be called by the named approver. Requires `promotions:write`.
+     *
+     * `POST /api/v1/campaigns/{campaignId}/actions`
+     */
+    actions(request: OperationPath<operations["post_v1_campaigns_by_campaignid_actions"]> & OperationBody<operations["post_v1_campaigns_by_campaignid_actions"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["post_v1_campaigns_by_campaignid_actions"]>>;
+    /**
+     * Archive Campaigns
+     *
+     * Archive campaigns, or restore archived campaigns by id or by the current archived list filters. Requires `promotions:write`.
+     *
+     * `POST /api/v1/campaigns/archive`
+     */
+    archive(request: OperationBody<operations["post_v1_campaigns_archive"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["post_v1_campaigns_archive"]>>;
+    /**
+     * Delete Campaigns
+     *
+     * Permanently delete archived campaigns by explicit id or by archived list filters. Requires `promotions:write`.
+     *
+     * `POST /api/v1/campaigns/delete`
+     */
+    delete(request: OperationBody<operations["post_v1_campaigns_delete"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["post_v1_campaigns_delete"]>>;
+    /**
+     * Get Campaign Options
+     *
+     * List the organization members and connected stores a campaign plan can name. Use a member `id` for `ownerId` and `approverId`. Requires `promotions:write`.
+     *
+     * `GET /api/v1/campaigns/options`
+     */
+    getOptions(request?: OperationQuery<operations["get_v1_campaigns_options"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_campaigns_options"]>>;
+}
 declare class CatalogClient {
     protected readonly _http: OmniHttp;
     constructor(_http: OmniHttp);
@@ -13260,6 +16163,8 @@ declare class ProductsClient {
      * List Products
      *
      * List products for the authenticated organization with optional filters and pagination. Authenticate with an API key or OAuth bearer token. The organization is taken from that credential; do not send `organizationId`.
+  
+  Rows are in `items`. Read catalog stock from `items[].stockQuantity`: parent rows already aggregate their non-deleted variants, and virtual bundles use component availability with any manual cap. Null means unknown, not zero. List rows do not contain `inventoryQuantity`, `inventory.quantity`, or an embedded `variants` array.
      *
      * `GET /api/v1/products`
      */
@@ -13329,7 +16234,9 @@ declare class ProductsClient {
     /**
      * Delist Product
      *
-     * Queue delist for one product on the marketplaces you name. `marketplaces` accepts one or more of shopee, lazada, tiktok, shopify, whatsapp, zalora, amazon, and ebay. Each named marketplace must already have a listing; other channels are left untouched. Omit `marketplaces` to delist every existing listing. This does not delete the OmniCommerce product. Poll GET /api/v1/jobs/{jobId} until data.status is succeeded, partial, or failed. Accepted means the job was queued, not that the marketplace has removed the listing.
+     * Queue delist for one product on the marketplaces you name. `marketplaces` accepts one or more of shopee, lazada, tiktok, shopify, whatsapp, zalora, amazon, and ebay. Each named marketplace must already have a listing; other channels are left untouched. Omit `marketplaces` to delist every existing listing. This does not delete the OmniCommerce product.
+  
+  Poll GET /api/v1/jobs/{jobId} until data.status is succeeded, partial, or failed. Accepted means the job was queued, not that the marketplace has removed the listing.
      *
      * `POST /api/v1/products/{productId}/delist`
      */
@@ -13746,8 +16653,10 @@ declare class ZaloraClient {
 }
 declare class OmniGeneratedClient {
     protected readonly _http: OmniHttp;
+    readonly agents: AgentsClient;
     readonly aop: AopClient;
     readonly api: ApiClient;
+    readonly campaigns: CampaignsClient;
     readonly catalog: CatalogClient;
     readonly checkoutSessions: CheckoutSessionsClient;
     readonly compare: CompareClient;
@@ -13779,8 +16688,10 @@ declare class OmniGeneratedClient {
     constructor(_http: OmniHttp);
 }
 type OmniResources = {
+    agents: AgentsClient;
     aop: AopClient;
     api: ApiClient;
+    campaigns: CampaignsClient;
     catalog: CatalogClient;
     checkoutSessions: CheckoutSessionsClient;
     compare: CompareClient;
@@ -13852,7 +16763,7 @@ declare function constructEvent(payload: string | Uint8Array, headers: WebhookHe
     toleranceInSeconds?: number;
 }): Promise<ConstructedWebhookEvent>;
 
-declare const SDK_VERSION = "0.1.0";
+declare const SDK_VERSION = "0.2.0";
 
 type ProductCreatedWebhookEvent = components["schemas"]["ProductCreatedWebhookEvent"];
 type ProductUpdatedWebhookEvent = components["schemas"]["ProductUpdatedWebhookEvent"];