@omni-commerce/sdk 0.1.1 → 0.2.0

package/dist/index.d.cts

@@ -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;
@@ -1998,94 +2188,342 @@ 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 */
-      createdAt: string;
-      /** Format: date-time */
-      updatedAt: 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[][];
+        };
+      }[];
+    };
+    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;
       /** Format: date-time */
       publishedAt: string | null;
       productCount: number;
@@ -3005,56 +3443,119 @@ 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;
-    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;
+    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;
-            /** @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;
           };
+          decisions?: {
+            /** @enum {string} */
+            action: "approve" | "reject";
+            reason?: string;
+          }[];
         };
       };
-      /** @description Invalid AOP configuration or request */
-      400: {
+    };
+    responses: {
+      /** @description The agent finished or is waiting for approval. */
+      200: {
         headers: {
           [name: string]: unknown;
         };
-        content?: never;
+        content: {
+          "application/json": {
+            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 agent request, unknown tool or model, or a decision count that does not match the pending approvals */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
       };
       /** @description Unauthorized */
       401: {
@@ -3070,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;
@@ -3160,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;
@@ -3183,40 +3756,110 @@ 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 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: {
+          "application/json": {
+            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 agent request, unknown tool or model, or a decision count that does not match the pending approvals */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
         };
+        content?: never;
+      };
+      /** @description Missing agents:invoke scope or Assistant access */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Agent run not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_aop_by_aopid_config: {
+    parameters: {
+      query?: {
+        organizationId?: string;
+      };
+      header?: never;
+      path: {
+        aopId: string;
       };
+      cookie?: never;
     };
+    requestBody?: never;
     responses: {
       /** @description Success */
       200: {
@@ -3224,42 +3867,1878 @@ interface operations {
           [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: {
+            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;
+          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;
+        };
+      };
+    };
+    responses: {
+      /** @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;
             };
-            conversation?: {
-              [key: string]: unknown;
+            /** @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 AOP configuration or request */
+      /** @description Invalid campaign payload or plan state. */
       400: {
         headers: {
           [name: string]: unknown;
@@ -3273,28 +5752,28 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Insufficient AI credits */
-      402: {
+      /** @description Forbidden: missing `promotions:write` scope, or a session member without organization-wide access */
+      403: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description Forbidden. Missing OAuth scope. */
-      403: {
+      /** @description Campaign not found for this organization */
+      404: {
         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;
@@ -3303,7 +5782,7 @@ interface operations {
       };
     };
   };
-  post_v1_aop_create: {
+  post_v1_campaigns_archive: {
     parameters: {
       query?: never;
       header?: never;
@@ -3312,54 +5791,74 @@ interface operations {
     };
     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;
-        };
+        "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 Success */
+      /** @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;
+              /** @enum {string} */
+              stage?:
+                | "draft"
+                | "approved"
+                | "running"
+                | "ending"
+                | "completed"
+                | "archived";
+              error?: string;
+            }[];
           };
         };
       };
-      /** @description Invalid AOP configuration or request */
+      /** @description Invalid campaign payload or plan state. */
       400: {
         headers: {
           [name: string]: unknown;
@@ -3373,28 +5872,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;
@@ -3403,7 +5895,7 @@ interface operations {
       };
     };
   };
-  post_v1_aop_retry: {
+  post_v1_campaigns_delete: {
     parameters: {
       query?: never;
       header?: never;
@@ -3413,33 +5905,60 @@ interface operations {
     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. */
+          /** @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 Success */
+      /** @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": {
-            /** @constant */
-            status: "started";
-            new_thread_id: string;
-            message: string;
+            /** @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;
@@ -3453,28 +5972,120 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Insufficient AI credits */
-      402: {
+      /** @description Forbidden: missing `promotions:write` scope, or a session member without organization-wide access */
+      403: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description Forbidden. Missing OAuth scope. */
+      /** @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_options: {
+    parameters: {
+      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?: never;
+    responses: {
+      /** @description Members and connected stores. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            /** @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 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 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;
@@ -12946,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);
@@ -13010,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);
@@ -13939,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;
@@ -13972,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;
@@ -14045,7 +16763,7 @@ declare function constructEvent(payload: string | Uint8Array, headers: WebhookHe
     toleranceInSeconds?: number;
 }): Promise<ConstructedWebhookEvent>;
 
-declare const SDK_VERSION = "0.1.1";
+declare const SDK_VERSION = "0.2.0";
 
 type ProductCreatedWebhookEvent = components["schemas"]["ProductCreatedWebhookEvent"];
 type ProductUpdatedWebhookEvent = components["schemas"]["ProductUpdatedWebhookEvent"];