@whop/cli 0.8.0 → 0.8.1

package/dist/index.js

@@ -6316,7 +6316,7 @@ var native_spec_default = {
       "x-whop-summary": "Turn a plan into a shareable, prefilled checkout link."
     },
     {
-      description: "The Referrals API covers your Whop partner activity: the users you referred onto Whop, the businesses you referred and the earnings generated from their processing volume, and the partner leaderboard.\n\nUse it to enroll as a Whop partner, list the users you referred, list your referred businesses and review their earnings, and see the partner leaderboard.\n",
+      description: "The Partners API covers your Whop partner activity: the users you referred onto Whop, the businesses you referred and the earnings generated from their processing volume, and the partner leaderboard.\n\nUse it to enroll as a Whop partner, list the users you referred, list your referred businesses and review their earnings, and see the partner leaderboard.\n",
       name: "Partners",
       "x-whop-summary": "The users and businesses you referred to Whop, and what you earn from them."
     },
@@ -6407,7 +6407,7 @@ var native_spec_default = {
     },
     {
       description: "Refer users and businesses to Whop and track what you earn.",
-      name: "Referrals",
+      name: "Partners",
       tags: [
         "Partners"
       ]
@@ -8559,7 +8559,7 @@ var native_spec_default = {
                     type: "string"
                   },
                   placements: {
-                    description: "'automatic' (Advantage+) or a list of { platform, positions }."
+                    description: "'automatic' (Advantage+) or a list of { platform, positions }. Omit positions to target all of a platform's.\n\nValid positions per platform:\n\n- `facebook`: `feed`, `right_hand_column`, `marketplace`, `search`, `profile_feed`, `notification`, `story`, `instream_video`, `facebook_reels`, `facebook_reels_overlay`, `biz_disco_feed`\n- `instagram`: `stream`, `story`, `explore`, `explore_home`, `reels`, `profile_feed`, `profile_reels`, `ig_search`\n- `messenger`: `story`\n- `audience_network`: `classic`, `rewarded_video`\n- `threads`: `threads_stream`\n- `whatsapp`: `status`"
                   },
                   regions: {
                     description: "Geo targeting: { include / exclude: { countries (ISO 3166-1), regions (states/provinces as ISO 3166-2, e.g. US-CA), cities (keyed), zips } }.",
@@ -8849,7 +8849,7 @@ var native_spec_default = {
                     type: "string"
                   },
                   placements: {
-                    description: "'automatic' (Advantage+) or a list of { platform, positions }."
+                    description: "'automatic' (Advantage+) or a list of { platform, positions }. Omit positions to target all of a platform's.\n\nValid positions per platform:\n\n- `facebook`: `feed`, `right_hand_column`, `marketplace`, `search`, `profile_feed`, `notification`, `story`, `instream_video`, `facebook_reels`, `facebook_reels_overlay`, `biz_disco_feed`\n- `instagram`: `stream`, `story`, `explore`, `explore_home`, `reels`, `profile_feed`, `profile_reels`, `ig_search`\n- `messenger`: `story`\n- `audience_network`: `classic`, `rewarded_video`\n- `threads`: `threads_stream`\n- `whatsapp`: `status`"
                   },
                   regions: {
                     description: "Geo targeting: { include / exclude: { countries (ISO 3166-1), regions (states/provinces as ISO 3166-2, e.g. US-CA), cities (keyed), zips } }.",
@@ -15170,7 +15170,7 @@ var native_spec_default = {
     },
     "/partners": {
       post: {
-        description: "Enrolls the calling user in the Whop partner program, making their business referrals eligible for earnings. Idempotent \u2014 enrolling again keeps the original enrollment time.",
+        description: "Enrolls the calling user in the Whop partner program, making their partner businesses eligible for earnings. Idempotent \u2014 enrolling again keeps the original enrollment time.",
         operationId: "create",
         responses: {
           "200": {
@@ -15257,7 +15257,7 @@ var native_spec_default = {
             }
           },
           {
-            description: "Number of business referrals to return from the start of the window.",
+            description: "Number of partner businesses to return from the start of the window.",
             in: "query",
             name: "first",
             required: false,
@@ -15277,7 +15277,7 @@ var native_spec_default = {
             }
           },
           {
-            description: "Number of business referrals to return from the end of the window.",
+            description: "Number of partner businesses to return from the end of the window.",
             in: "query",
             name: "last",
             required: false,
@@ -15296,7 +15296,7 @@ var native_spec_default = {
             }
           },
           {
-            description: "The field to sort business referrals by.",
+            description: "The field to sort partner businesses by.",
             in: "query",
             name: "order",
             required: false,
@@ -15328,7 +15328,7 @@ var native_spec_default = {
             }
           },
           {
-            description: "Only return business referrals created before this timestamp.",
+            description: "Only return partner businesses created before this timestamp.",
             in: "query",
             name: "created_before",
             required: false,
@@ -15337,7 +15337,7 @@ var native_spec_default = {
             }
           },
           {
-            description: "Only return business referrals created after this timestamp.",
+            description: "Only return partner businesses created after this timestamp.",
             in: "query",
             name: "created_after",
             required: false,
@@ -15421,7 +15421,7 @@ var native_spec_default = {
                             ]
                           },
                           created_at: {
-                            description: "When the business referral was created.",
+                            description: "When the partner business was created.",
                             format: "date-time",
                             type: "string"
                           },
@@ -15491,7 +15491,7 @@ var native_spec_default = {
                             ]
                           },
                           id: {
-                            description: "Business referral ID.",
+                            description: "Partner business ID.",
                             type: "string"
                           },
                           my_partner_tier: {
@@ -15504,7 +15504,7 @@ var native_spec_default = {
                           },
                           object: {
                             enum: [
-                              "business_referral"
+                              "partner_business"
                             ],
                             type: "string"
                           },
@@ -15661,7 +15661,7 @@ var native_spec_default = {
                 }
               }
             },
-            description: "business referrals listed"
+            description: "partner businesses listed"
           },
           "400": {
             $ref: "#/components/responses/InvalidParameters",
@@ -15683,7 +15683,7 @@ var native_spec_default = {
             ]
           }
         ],
-        summary: "List partner business referrals",
+        summary: "List a partner's referred businesses",
         tags: [
           "Partners"
         ]
@@ -15761,7 +15761,7 @@ var native_spec_default = {
                       ]
                     },
                     created_at: {
-                      description: "When the business referral was created.",
+                      description: "When the partner business was created.",
                       format: "date-time",
                       type: "string"
                     },
@@ -15831,7 +15831,7 @@ var native_spec_default = {
                       ]
                     },
                     id: {
-                      description: "Business referral ID.",
+                      description: "Partner business ID.",
                       type: "string"
                     },
                     my_partner_tier: {
@@ -15844,7 +15844,7 @@ var native_spec_default = {
                     },
                     object: {
                       enum: [
-                        "business_referral"
+                        "partner_business"
                       ],
                       type: "string"
                     },
@@ -15962,11 +15962,11 @@ var native_spec_default = {
                 }
               }
             },
-            description: "business referral retrieved"
+            description: "partner business retrieved"
           },
           "404": {
             $ref: "#/components/responses/NotFound",
-            description: "no such business referral is visible to the credential"
+            description: "no such partner business is visible to the credential"
           }
         },
         security: [
@@ -15976,7 +15976,7 @@ var native_spec_default = {
             ]
           }
         ],
-        summary: "Retrieve a partner business referral",
+        summary: "Retrieve a referred business",
         tags: [
           "Partners"
         ],
@@ -15985,7 +15985,7 @@ var native_spec_default = {
             $ref: "#/components/parameters/ApiVersionDate"
           },
           {
-            description: "The business referral ID (a coma_ identifier).",
+            description: "The partner business ID (a coma_ identifier).",
             in: "path",
             name: "id",
             required: true,
@@ -16005,7 +16005,7 @@ var native_spec_default = {
             $ref: "#/components/parameters/ApiVersionDate"
           },
           {
-            description: "The business referral ID (a coma_ identifier).",
+            description: "The partner business ID (a coma_ identifier).",
             in: "path",
             name: "id",
             required: true,
@@ -16237,7 +16237,7 @@ var native_spec_default = {
                           },
                           object: {
                             enum: [
-                              "business_referral_earning"
+                              "partner_business_earning"
                             ],
                             type: "string"
                           },
@@ -16459,7 +16459,7 @@ var native_spec_default = {
             ]
           }
         ],
-        summary: "List a partner business referral's earnings",
+        summary: "List a partner's referred business earnings",
         tags: [
           "Partners"
         ]
@@ -16467,7 +16467,7 @@ var native_spec_default = {
     },
     "/partners/leaderboard": {
       get: {
-        description: "Ranks referrers by business referral earnings \u2014 all-time by default, or over the current day, month, year, or trailing 30 days \u2014 and includes the caller's own standing.",
+        description: "Ranks referrers by partner business earnings \u2014 all-time by default, or over the current day, month, year, or trailing 30 days \u2014 and includes the caller's own standing.",
         operationId: "leaderboard",
         parameters: [
           {
@@ -16502,7 +16502,7 @@ var native_spec_default = {
                       items: {
                         properties: {
                           first_referral_started_at: {
-                            description: "When the referrer's earliest business referral became active.",
+                            description: "When the referrer's earliest partner business became active.",
                             format: "date-time",
                             type: "string"
                           },
@@ -16590,7 +16590,7 @@ var native_spec_default = {
                       description: "The caller's own standing; null when the caller has no referral earnings.",
                       properties: {
                         first_referral_started_at: {
-                          description: "When the referrer's earliest business referral became active.",
+                          description: "When the referrer's earliest partner business became active.",
                           format: "date-time",
                           type: "string"
                         },
@@ -23142,6 +23142,66 @@ var native_spec_default = {
         ]
       }
     },
+    "/users/{id}/recommend_actions": {
+      get: {
+        description: "Lists the recommended actions computed for the user: personal suggestions (e.g. start a business or become an affiliate) pooled with the highest-impact actions across the accounts the user owns. Business actions are tagged with their `account_id`/`account_name`; personal actions leave those `null`. Self-only: `id` must be `me` or the authenticated user's own tag/username.",
+        operationId: "recommend_actions",
+        responses: {
+          "200": {
+            content: {
+              "application/json": {
+                schema: {
+                  properties: {
+                    data: {
+                      items: {
+                        $ref: "#/components/schemas/UserRecommendedAction"
+                      },
+                      type: "array"
+                    }
+                  },
+                  required: [
+                    "data"
+                  ],
+                  type: "object"
+                }
+              }
+            },
+            description: "recommended actions listed"
+          },
+          "401": {
+            $ref: "#/components/responses/Unauthorized",
+            description: "missing or invalid authentication"
+          },
+          "403": {
+            $ref: "#/components/responses/Forbidden",
+            description: "reading another user's recommended actions"
+          }
+        },
+        security: [
+          {
+            bearerAuth: []
+          }
+        ],
+        summary: "List Recommended Actions",
+        tags: [
+          "Users"
+        ],
+        parameters: [
+          {
+            $ref: "#/components/parameters/ApiVersionDate"
+          },
+          {
+            description: "`me`, or the authenticated user's own `user_` tag or username.",
+            in: "path",
+            name: "id",
+            required: true,
+            schema: {
+              type: "string"
+            }
+          }
+        ]
+      }
+    },
     "/verifications": {
       get: {
         description: "Returns verifications for an account, including their status and any required actions.",
@@ -23419,10 +23479,11 @@ var native_spec_default = {
                             ]
                           },
                           status: {
-                            description: "Current verification state. `not_started` before any session has been created; `pending` while a session is in progress; `action_required` when items in `requested_information` need answers before review can continue; `approved` once verification succeeds; `rejected` if it fails. Call the Create Verification endpoint again to start a new session.",
+                            description: "Current verification state. `not_started` before any session has been created; `pending` while a session is in progress and needs the user's input; `processing` while the provider reviews submitted documents \u2014 nothing to do but wait; `action_required` when items in `requested_information` need answers before review can continue; `approved` once verification succeeds; `rejected` if it fails. Call the Create Verification endpoint again to start a new session.",
                             enum: [
                               "not_started",
                               "pending",
+                              "processing",
                               "approved",
                               "rejected",
                               "action_required"
@@ -23534,6 +23595,10 @@ var native_spec_default = {
                         description: "Entity type for sole proprietors, such as `single_member_llc`. Supported values vary by country of incorporation \u2014 see [Business structures](/developer/verification/business-structures).",
                         type: "string"
                       },
+                      business_tax_identification_number: {
+                        description: "The business ID number of the company, as appropriate for the company's country. Examples are an Employer Identification Number (EIN) in the US, a Business Number in Canada, or a Company Number in the UK.",
+                        type: "string"
+                      },
                       business_website: {
                         description: "Business website URL. Whop store pages are not accepted.",
                         type: "string"
@@ -23580,7 +23645,7 @@ var native_spec_default = {
                         type: "string"
                       },
                       tax_identification_number: {
-                        description: "SSN or ITIN. Tokenized in transit and never stored raw.",
+                        description: "The government-issued ID number of the person being verified \u2014 the individual for a KYC verification, or the business representative for a KYB verification \u2014 as appropriate for their country. Examples are a Social Security Number (SSN) in the US, or a Social Insurance Number in Canada.",
                         type: "string"
                       }
                     },
@@ -23626,6 +23691,10 @@ var native_spec_default = {
                         description: "Legal entity structure of the business, such as `private_corporation` or `sole_proprietorship`. Supported values vary by country of incorporation \u2014 see [Business structures](/developer/verification/business-structures).",
                         type: "string"
                       },
+                      business_tax_identification_number: {
+                        description: "The business ID number of the company, as appropriate for the company's country. Examples are an Employer Identification Number (EIN) in the US, a Business Number in Canada, or a Company Number in the UK.",
+                        type: "string"
+                      },
                       business_website: {
                         description: "Business website URL. Whop store pages are not accepted.",
                         type: "string"
@@ -23646,7 +23715,7 @@ var native_spec_default = {
                         type: "string"
                       },
                       tax_identification_number: {
-                        description: "EIN. Tokenized in transit and never stored raw.",
+                        description: "The government-issued ID number of the person being verified \u2014 the individual for a KYC verification, or the business representative for a KYB verification \u2014 as appropriate for their country. Examples are a Social Security Number (SSN) in the US, or a Social Insurance Number in Canada.",
                         type: "string"
                       }
                     },
@@ -23886,10 +23955,11 @@ var native_spec_default = {
                       ]
                     },
                     status: {
-                      description: "Current verification state. `not_started` before any session has been created; `pending` while a session is in progress; `action_required` when items in `requested_information` need answers before review can continue; `approved` once verification succeeds; `rejected` if it fails. Call the Create Verification endpoint again to start a new session.",
+                      description: "Current verification state. `not_started` before any session has been created; `pending` while a session is in progress and needs the user's input; `processing` while the provider reviews submitted documents \u2014 nothing to do but wait; `action_required` when items in `requested_information` need answers before review can continue; `approved` once verification succeeds; `rejected` if it fails. Call the Create Verification endpoint again to start a new session.",
                       enum: [
                         "not_started",
                         "pending",
+                        "processing",
                         "approved",
                         "rejected",
                         "action_required"
@@ -24134,10 +24204,11 @@ var native_spec_default = {
                       ]
                     },
                     status: {
-                      description: "Current verification state. `not_started` before any session has been created; `pending` while a session is in progress; `action_required` when items in `requested_information` need answers before review can continue; `approved` once verification succeeds; `rejected` if it fails. Call the Create Verification endpoint again to start a new session.",
+                      description: "Current verification state. `not_started` before any session has been created; `pending` while a session is in progress and needs the user's input; `processing` while the provider reviews submitted documents \u2014 nothing to do but wait; `action_required` when items in `requested_information` need answers before review can continue; `approved` once verification succeeds; `rejected` if it fails. Call the Create Verification endpoint again to start a new session.",
                       enum: [
                         "not_started",
                         "pending",
+                        "processing",
                         "approved",
                         "rejected",
                         "action_required"
@@ -24431,10 +24502,11 @@ var native_spec_default = {
                       ]
                     },
                     status: {
-                      description: "Current verification state. `not_started` before any session has been created; `pending` while a session is in progress; `action_required` when items in `requested_information` need answers before review can continue; `approved` once verification succeeds; `rejected` if it fails. Call the Create Verification endpoint again to start a new session.",
+                      description: "Current verification state. `not_started` before any session has been created; `pending` while a session is in progress and needs the user's input; `processing` while the provider reviews submitted documents \u2014 nothing to do but wait; `action_required` when items in `requested_information` need answers before review can continue; `approved` once verification succeeds; `rejected` if it fails. Call the Create Verification endpoint again to start a new session.",
                       enum: [
                         "not_started",
                         "pending",
+                        "processing",
                         "approved",
                         "rejected",
                         "action_required"
@@ -24527,6 +24599,10 @@ var native_spec_default = {
                   {
                     description: "Fields that can be updated on an individual (KYC) verification. At least one field is required.",
                     properties: {
+                      business_tax_identification_number: {
+                        description: "The business ID number of the company, as appropriate for the company's country. Examples are an Employer Identification Number (EIN) in the US, a Business Number in Canada, or a Company Number in the UK.",
+                        type: "string"
+                      },
                       country: {
                         description: "Two-letter ISO 3166-1 country code, for example `US`, `DE`, or `GB`.",
                         type: "string"
@@ -24651,6 +24727,10 @@ var native_spec_default = {
                           type: "object"
                         },
                         type: "array"
+                      },
+                      tax_identification_number: {
+                        description: "The government-issued ID number of the person being verified \u2014 the individual for a KYC verification, or the business representative for a KYB verification \u2014 as appropriate for their country. Examples are a Social Security Number (SSN) in the US, or a Social Insurance Number in Canada.",
+                        type: "string"
                       }
                     },
                     title: "UpdateIndividualVerification",
@@ -24696,6 +24776,10 @@ var native_spec_default = {
                         description: "Legal entity structure of the business, such as `private_corporation` or `sole_proprietorship`. Supported values vary by country of incorporation \u2014 see [Business structures](/developer/verification/business-structures).",
                         type: "string"
                       },
+                      business_tax_identification_number: {
+                        description: "The business ID number of the company, as appropriate for the company's country. Examples are an Employer Identification Number (EIN) in the US, a Business Number in Canada, or a Company Number in the UK.",
+                        type: "string"
+                      },
                       country: {
                         description: "Two-letter ISO 3166-1 country code, for example `US`, `DE`, or `GB`.",
                         type: "string"
@@ -24781,6 +24865,10 @@ var native_spec_default = {
                           type: "object"
                         },
                         type: "array"
+                      },
+                      tax_identification_number: {
+                        description: "The government-issued ID number of the person being verified \u2014 the individual for a KYC verification, or the business representative for a KYB verification \u2014 as appropriate for their country. Examples are a Social Security Number (SSN) in the US, or a Social Insurance Number in Canada.",
+                        type: "string"
                       }
                     },
                     title: "UpdateBusinessVerification",
@@ -25020,10 +25108,11 @@ var native_spec_default = {
                       ]
                     },
                     status: {
-                      description: "Current verification state. `not_started` before any session has been created; `pending` while a session is in progress; `action_required` when items in `requested_information` need answers before review can continue; `approved` once verification succeeds; `rejected` if it fails. Call the Create Verification endpoint again to start a new session.",
+                      description: "Current verification state. `not_started` before any session has been created; `pending` while a session is in progress and needs the user's input; `processing` while the provider reviews submitted documents \u2014 nothing to do but wait; `action_required` when items in `requested_information` need answers before review can continue; `approved` once verification succeeds; `rejected` if it fails. Call the Create Verification endpoint again to start a new session.",
                       enum: [
                         "not_started",
                         "pending",
+                        "processing",
                         "approved",
                         "rejected",
                         "action_required"
@@ -25945,14 +26034,14 @@ var native_spec_default = {
             ]
           },
           impact_score: {
-            description: "Estimated revenue impact from 0-100, comparable across accounts, or `null` when not ranked",
+            description: "Estimated impact from 0-100, or `null` when not ranked",
             type: [
               "integer",
               "null"
             ]
           },
           reasoning: {
-            description: "Why this action was recommended for this account, or `null`",
+            description: "Why this action was recommended, or `null`",
             type: [
               "string",
               "null"
@@ -26298,6 +26387,10 @@ var native_spec_default = {
             description: "Whop pixel-attributed custom (merchant-defined) conversion events, last-click, across all custom event names.",
             type: "number"
           },
+          custom_event_counts: {
+            description: "Whop pixel-attributed custom conversions broken out by merchant-defined event name, last-click, as a { event_name => count } map over the stats window. Empty when no named custom events are attributed. Custom events fired without a name are counted in custom_conversions but omitted here, so these values sum to at most custom_conversions.",
+            type: "object"
+          },
           delivery_status: {
             description: "The current delivery state, mirroring the Delivery column in the ads dashboard. When several states apply at once, the highest-precedence one is returned.",
             enum: [
@@ -26454,6 +26547,13 @@ var native_spec_default = {
               "null"
             ]
           },
+          results: {
+            description: "The Whop pixel-attributed count behind result_event. When a campaign's ad groups optimize different goals there is no single result_event (it is null), and this is instead the sum of each ad group's own attributed results. Null when nothing Whop-attributable is being optimized for.",
+            type: [
+              "number",
+              "null"
+            ]
+          },
           return_on_ad_spend: {
             description: "Purchase value divided by spend, both in USD (a currency-neutral ratio); 0 when there is no spend.",
             type: "number"
@@ -26555,6 +26655,7 @@ var native_spec_default = {
           "reach",
           "result_event",
           "result_event_name",
+          "results",
           "return_on_ad_spend",
           "spend",
           "spend_currency",
@@ -26567,6 +26668,7 @@ var native_spec_default = {
           "viewed_contents",
           "added_to_carts",
           "custom_conversions",
+          "custom_event_counts",
           "id",
           "title",
           "status",
@@ -26742,6 +26844,10 @@ var native_spec_default = {
             description: "Whop pixel-attributed custom (merchant-defined) conversion events, last-click, across all custom event names.",
             type: "number"
           },
+          custom_event_counts: {
+            description: "Whop pixel-attributed custom conversions broken out by merchant-defined event name, last-click, as a { event_name => count } map over the stats window. Empty when no named custom events are attributed. Custom events fired without a name are counted in custom_conversions but omitted here, so these values sum to at most custom_conversions.",
+            type: "object"
+          },
           delivery_status: {
             description: "The current delivery state, mirroring the Delivery column in the ads dashboard. When several states apply at once, the highest-precedence one is returned.",
             enum: [
@@ -26857,6 +26963,13 @@ var native_spec_default = {
               "null"
             ]
           },
+          results: {
+            description: "The Whop pixel-attributed count behind result_event. When a campaign's ad groups optimize different goals there is no single result_event (it is null), and this is instead the sum of each ad group's own attributed results. Null when nothing Whop-attributable is being optimized for.",
+            type: [
+              "number",
+              "null"
+            ]
+          },
           return_on_ad_spend: {
             description: "Purchase value divided by spend, both in USD (a currency-neutral ratio); 0 when there is no spend.",
             type: "number"
@@ -26958,6 +27071,7 @@ var native_spec_default = {
           "reach",
           "result_event",
           "result_event_name",
+          "results",
           "return_on_ad_spend",
           "spend",
           "spend_currency",
@@ -26970,6 +27084,7 @@ var native_spec_default = {
           "viewed_contents",
           "added_to_carts",
           "custom_conversions",
+          "custom_event_counts",
           "id",
           "title",
           "status",
@@ -27246,6 +27361,10 @@ var native_spec_default = {
             description: "Whop pixel-attributed custom (merchant-defined) conversion events, last-click, across all custom event names.",
             type: "number"
           },
+          custom_event_counts: {
+            description: "Whop pixel-attributed custom conversions broken out by merchant-defined event name, last-click, as a { event_name => count } map over the stats window. Empty when no named custom events are attributed. Custom events fired without a name are counted in custom_conversions but omitted here, so these values sum to at most custom_conversions.",
+            type: "object"
+          },
           delivery_status: {
             description: "The current delivery state, mirroring the Delivery column in the ads dashboard. When several states apply at once, the highest-precedence one is returned.",
             enum: [
@@ -27404,6 +27523,13 @@ var native_spec_default = {
               "null"
             ]
           },
+          results: {
+            description: "The Whop pixel-attributed count behind result_event. When a campaign's ad groups optimize different goals there is no single result_event (it is null), and this is instead the sum of each ad group's own attributed results. Null when nothing Whop-attributable is being optimized for.",
+            type: [
+              "number",
+              "null"
+            ]
+          },
           return_on_ad_spend: {
             description: "Purchase value divided by spend, both in USD (a currency-neutral ratio); 0 when there is no spend.",
             type: "number"
@@ -27493,6 +27619,7 @@ var native_spec_default = {
           "reach",
           "result_event",
           "result_event_name",
+          "results",
           "return_on_ad_spend",
           "spend",
           "spend_currency",
@@ -27505,6 +27632,7 @@ var native_spec_default = {
           "viewed_contents",
           "added_to_carts",
           "custom_conversions",
+          "custom_event_counts",
           "id",
           "title",
           "status",
@@ -27574,8 +27702,8 @@ var native_spec_default = {
       Audience: {
         properties: {
           created_at: {
-            description: "Unix timestamp when the audience was created.",
-            type: "number"
+            description: "When the audience was created, as an ISO 8601 timestamp.",
+            type: "string"
           },
           error_message: {
             description: "Processing error message. `null` unless processing is partial or failed.",
@@ -27588,6 +27716,13 @@ var native_spec_default = {
             description: "Audience ID, prefixed `adaud_`.",
             type: "string"
           },
+          match_rates: {
+            items: {
+              $ref: "#/components/schemas/AudienceMatchRate",
+              description: "Estimated match rates by ad platform. Empty when the audience was not sent to a supported platform."
+            },
+            type: "array"
+          },
           matched_rows: {
             description: "Rows successfully uploaded to connected ad accounts.",
             type: "number"
@@ -27628,8 +27763,8 @@ var native_spec_default = {
             type: "number"
           },
           updated_at: {
-            description: "Unix timestamp when the audience was last updated.",
-            type: "number"
+            description: "When the audience was last updated, as an ISO 8601 timestamp.",
+            type: "string"
           }
         },
         required: [
@@ -27643,7 +27778,55 @@ var native_spec_default = {
           "error_message",
           "platform_audience_ids",
           "created_at",
-          "updated_at"
+          "updated_at",
+          "match_rates"
+        ],
+        type: "object"
+      },
+      AudienceMatchRate: {
+        properties: {
+          lower_bound: {
+            description: "Lower bound of the estimated match rate percentage. `null` until available.",
+            type: [
+              "number",
+              "null"
+            ]
+          },
+          platform: {
+            description: "The ad platform that provided the match-rate estimate.",
+            enum: [
+              "meta"
+            ],
+            example: "meta",
+            type: "string"
+          },
+          status: {
+            description: "Availability of the estimated match rate.",
+            enum: [
+              "calculating",
+              "available",
+              "unavailable",
+              null
+            ],
+            example: "calculating",
+            type: [
+              "string",
+              "null"
+            ]
+          },
+          upper_bound: {
+            description: "Upper bound of the estimated match rate percentage. `null` until available.",
+            type: [
+              "number",
+              "null"
+            ]
+          }
+        },
+        required: [
+          "platform",
+          "status",
+          "lower_bound",
+          "upper_bound"
         ],
         type: "object"
       },
@@ -29355,6 +29538,14 @@ var native_spec_default = {
             items: {
               description: "Represents an image attachment",
               properties: {
+                content_type: {
+                  description: "Uploaded file MIME type, such as image/jpeg, video/mp4, or audio/mpeg.",
+                  example: "image/jpeg",
+                  type: [
+                    "string",
+                    "null"
+                  ]
+                },
                 id: {
                   description: 'Represents a unique identifier that is Base64 obfuscated. It is often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `"VXNlci0xMA=="`) or integer (such as `4`) input value will be accepted as an ID.',
                   type: "string"
@@ -29370,7 +29561,8 @@ var native_spec_default = {
               },
               required: [
                 "id",
-                "url"
+                "url",
+                "content_type"
               ],
               type: "object"
             },
@@ -29526,6 +29718,7 @@ var native_spec_default = {
           "published_reviews_count",
           "external_identifier",
           "metadata",
+          "gallery_images",
           "description",
           "custom_cta",
           "custom_cta_url",
@@ -29534,7 +29727,6 @@ var native_spec_default = {
           "global_affiliate_status",
           "member_affiliate_percentage",
           "member_affiliate_status",
-          "gallery_images",
           "product_tax_code",
           "owner_user",
           "company"
@@ -29558,6 +29750,41 @@ var native_spec_default = {
               "null"
             ]
           },
+          gallery_images: {
+            description: "The gallery images for this product, ordered by position.",
+            items: {
+              description: "Represents an image attachment",
+              properties: {
+                content_type: {
+                  description: "Uploaded file MIME type, such as image/jpeg, video/mp4, or audio/mpeg.",
+                  example: "image/jpeg",
+                  type: [
+                    "string",
+                    "null"
+                  ]
+                },
+                id: {
+                  description: 'Represents a unique identifier that is Base64 obfuscated. It is often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `"VXNlci0xMA=="`) or integer (such as `4`) input value will be accepted as an ID.',
+                  type: "string"
+                },
+                url: {
+                  description: "A pre-optimized URL for rendering this attachment on the client. This should be used for displaying attachments in apps.",
+                  example: "https://media.whop.com/abc123/optimized.jpg",
+                  type: [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              required: [
+                "id",
+                "url",
+                "content_type"
+              ],
+              type: "object"
+            },
+            type: "array"
+          },
           headline: {
             description: "A short marketing headline displayed prominently on the product's product page.",
             example: "Real-time data analytics for creators",
@@ -29626,7 +29853,8 @@ var native_spec_default = {
           "route",
           "published_reviews_count",
           "external_identifier",
-          "metadata"
+          "metadata",
+          "gallery_images"
         ],
         type: "object"
       },
@@ -29686,12 +29914,18 @@ var native_spec_default = {
             type: "array"
           },
           url: {
-            description: "The URL where the social account can be accessed on the platform.",
-            type: "string"
+            description: "The URL where the social account can be accessed on the platform. Null while a Whop-owned page is still being provisioned.",
+            type: [
+              "string",
+              "null"
+            ]
           },
           username: {
-            description: "The username of the social account on the platform.",
-            type: "string"
+            description: "The username of the social account on the platform. Null while a Whop-owned page is still being provisioned.",
+            type: [
+              "string",
+              "null"
+            ]
           },
           verified: {
             description: "Whether the social account is verified on the platform.",
@@ -29861,6 +30095,13 @@ var native_spec_default = {
           verification: {
             description: "Identity verification status for the user's `individual` (KYC) and `business` (KYB) profiles. Each is `null` until created, otherwise a `status` of `not_started`, `pending`, `approved`, or `rejected`.",
             type: "object"
+          },
+          whop_partner_enabled_at: {
+            description: "When the user became an enrolled Whop Partner, as an ISO 8601 timestamp. `null` if never enrolled.",
+            type: [
+              "string",
+              "null"
+            ]
           }
         },
         required: [
@@ -29873,7 +30114,8 @@ var native_spec_default = {
           "balance",
           "earnings_usd",
           "balance_history",
-          "verification"
+          "verification",
+          "whop_partner_enabled_at"
         ],
         type: "object"
       },
@@ -30170,56 +30412,165 @@ var native_spec_default = {
         ],
         type: "object"
       },
-      UserSummary: {
+      UserRecommendedAction: {
         properties: {
-          id: {
-            description: "User ID, prefixed `user_`.",
-            type: "string"
-          },
-          name: {
-            description: "Display name.",
+          account_id: {
+            description: "The account (`biz_`) a business recommendation is for, or `null` for personal recommendations",
             type: [
               "string",
               "null"
             ]
           },
-          profile_picture: {
-            $ref: "#/components/schemas/UserProfilePicture",
-            description: "Avatar wrapper; its `url` is always present, using a generated placeholder when the user set no picture."
+          account_name: {
+            description: "The account's display name, or `null`",
+            type: [
+              "string",
+              "null"
+            ]
           },
-          username: {
-            description: "Public username.",
+          action: {
+            description: "The recommendation; new values may be added, so handle unknown actions gracefully",
+            enum: [
+              "create_business",
+              "become_affiliate",
+              "theme_business",
+              "create_product",
+              "create_plan",
+              "verify_identity",
+              "connect_affiliate_program",
+              "create_promotion",
+              "setup_tracking_pixel",
+              "migrate_from_stripe",
+              "accept_first_payment",
+              "launch_first_ad",
+              "invite_team_member",
+              "enable_tax_collection",
+              "create_card",
+              "join_whop_university",
+              "apply_for_financing"
+            ],
+            example: "create_business",
             type: "string"
-          }
-        },
-        required: [
-          "id",
-          "username",
-          "name",
-          "profile_picture"
-        ],
-        type: "object"
-      },
-      V1ErrorResponse: {
-        properties: {
-          error: {
-            properties: {
-              message: {
-                description: "Human-readable error message.",
-                type: "string"
-              },
-              type: {
-                description: "Machine-readable error code.",
-                type: "string"
-              }
+          },
+          blocked_capabilities: {
+            items: {
+              description: "Capabilities this would unlock, or empty",
+              type: "string"
             },
-            required: [
-              "type",
-              "message"
-            ],
-            type: "object"
-          }
-        },
+            type: "array"
+          },
+          cta: {
+            description: "The URL the call-to-action links to",
+            type: "string"
+          },
+          cta_label: {
+            description: "Button label",
+            type: "string"
+          },
+          description: {
+            description: "Supporting copy, or empty",
+            type: "string"
+          },
+          icon_url: {
+            description: "Illustration icon URL, or `null`",
+            type: [
+              "string",
+              "null"
+            ]
+          },
+          impact_score: {
+            description: "Estimated impact from 0-100, or `null` when not ranked",
+            type: [
+              "integer",
+              "null"
+            ]
+          },
+          reasoning: {
+            description: "Why this action was recommended, or `null`",
+            type: [
+              "string",
+              "null"
+            ]
+          },
+          status: {
+            description: "Always optional \u2014 never blocking",
+            enum: [
+              "optional"
+            ],
+            example: "optional",
+            type: "string"
+          },
+          title: {
+            description: "Headline for the recommendation",
+            type: "string"
+          }
+        },
+        required: [
+          "action",
+          "status",
+          "title",
+          "description",
+          "cta_label",
+          "cta",
+          "icon_url",
+          "blocked_capabilities",
+          "reasoning",
+          "impact_score",
+          "account_id",
+          "account_name"
+        ],
+        type: "object"
+      },
+      UserSummary: {
+        properties: {
+          id: {
+            description: "User ID, prefixed `user_`.",
+            type: "string"
+          },
+          name: {
+            description: "Display name.",
+            type: [
+              "string",
+              "null"
+            ]
+          },
+          profile_picture: {
+            $ref: "#/components/schemas/UserProfilePicture",
+            description: "Avatar wrapper; its `url` is always present, using a generated placeholder when the user set no picture."
+          },
+          username: {
+            description: "Public username.",
+            type: "string"
+          }
+        },
+        required: [
+          "id",
+          "username",
+          "name",
+          "profile_picture"
+        ],
+        type: "object"
+      },
+      V1ErrorResponse: {
+        properties: {
+          error: {
+            properties: {
+              message: {
+                description: "Human-readable error message.",
+                type: "string"
+              },
+              type: {
+                description: "Machine-readable error code.",
+                type: "string"
+              }
+            },
+            required: [
+              "type",
+              "message"
+            ],
+            type: "object"
+          }
+        },
         required: [
           "error"
         ],
@@ -35312,7 +35663,7 @@ import { createRequire as createRequire2 } from "module";
 // src/lib/build-info.ts
 var buildChannel = true ? "npm" : "dev";
 var buildTarget = typeof WHOP_CLI_TARGET === "string" ? WHOP_CLI_TARGET : null;
-var buildVersion = true ? "0.8.0" : null;
+var buildVersion = true ? "0.8.1" : null;
 function isHomebrewPath(execPath, env = process.env) {
   if (/[/\\](Cellar|homebrew|linuxbrew)[/\\]/.test(execPath)) return true;
   const prefix = env.HOMEBREW_PREFIX?.trim();
@@ -35550,59 +35901,84 @@ function errorHtml(error) {
 // src/auth/callback-server.ts
 var CALLBACK_PORT = 13337;
 var LOOPBACK_HOSTS = ["127.0.0.1", "::1"];
-function startCallbackServer(expectedState) {
-  return new Promise((resolve5, reject) => {
-    const servers = [];
-    let settled = false;
-    let bindFailures = 0;
-    const settle = (run) => {
-      if (settled) return;
-      settled = true;
-      clearTimeout(timeout);
-      for (const server of servers) {
-        server.close();
-        server.closeAllConnections();
+async function startCallbackServer(expectedState, options = {}) {
+  const servers = [];
+  let settled = false;
+  const result = Promise.withResolvers();
+  const ready = Promise.withResolvers();
+  const closeServers = () => {
+    for (const server of servers) {
+      server.close();
+      server.closeAllConnections();
+    }
+  };
+  let timeout;
+  const settle = (run) => {
+    if (settled) return;
+    settled = true;
+    clearTimeout(timeout);
+    closeServers();
+    run();
+  };
+  let listening = 0;
+  let bindFailures = 0;
+  const hosts = options.hosts ?? LOOPBACK_HOSTS;
+  for (const host of hosts) {
+    const server = createServer((req, res) => {
+      const url = new URL(req.url ?? "/", "http://localhost");
+      if (url.pathname !== "/callback") {
+        res.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
+        res.end("Not found");
+        return;
       }
-      run();
-    };
-    const timeout = setTimeout(
-      () => settle(
-        () => reject(new Error("Timed out waiting for OAuth callback (5 min)."))
-      ),
-      5 * 60 * 1e3
-    );
-    for (const host of LOOPBACK_HOSTS) {
-      const server = createServer((req, res) => {
-        const url = new URL(req.url ?? "/", "http://localhost");
-        if (url.pathname !== "/callback") {
-          res.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
-          res.end("Not found");
-          return;
-        }
-        if (url.searchParams.get("state") !== expectedState) {
-          res.writeHead(400, { "Content-Type": "text/plain; charset=utf-8" });
-          res.end("Invalid OAuth state");
-          return;
-        }
-        const code = url.searchParams.get("code");
-        const error = url.searchParams.get("error");
-        res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
-        res.end(code ? successHtml : errorHtml(error), () => {
-          settle(() => {
-            if (code) resolve5(code);
-            else
-              reject(new Error(`OAuth error: ${error ?? "no code returned"}`));
-          });
+      if (url.searchParams.get("state") !== expectedState) {
+        res.writeHead(400, { "Content-Type": "text/plain; charset=utf-8" });
+        res.end("Invalid OAuth state");
+        return;
+      }
+      const code = url.searchParams.get("code");
+      const error = url.searchParams.get("error");
+      res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+      res.end(code ? successHtml : errorHtml(error), () => {
+        settle(() => {
+          if (code) result.resolve(code);
+          else
+            result.reject(
+              new Error(`OAuth error: ${error ?? "no code returned"}`)
+            );
         });
       });
-      server.on("error", (err) => {
-        bindFailures += 1;
-        if (bindFailures === LOOPBACK_HOSTS.length) settle(() => reject(err));
+    });
+    server.on("listening", () => {
+      listening += 1;
+      if (listening === 1) ready.resolve();
+    });
+    server.on("error", (error) => {
+      bindFailures += 1;
+      if (bindFailures === hosts.length && listening === 0) {
+        settle(() => ready.reject(error));
+      }
+    });
+    server.listen(options.port ?? CALLBACK_PORT, host);
+    servers.push(server);
+  }
+  await ready.promise;
+  timeout = setTimeout(
+    () => settle(
+      () => result.reject(
+        new Error("Timed out waiting for OAuth callback (5 min).")
+      )
+    ),
+    options.timeoutMs ?? 5 * 60 * 1e3
+  );
+  return {
+    result: result.promise,
+    close: () => settle(() => {
+      result.promise.catch(() => {
       });
-      server.listen(CALLBACK_PORT, host);
-      servers.push(server);
-    }
-  });
+      result.reject(new Error("OAuth callback listener closed."));
+    })
+  };
 }
 
 // src/auth/prompts.ts
@@ -35930,6 +36306,18 @@ var OAuthError = class extends Error {
     this.name = "OAuthError";
   }
 };
+var defaultOAuthLoginDependencies = {
+  startCallbackServer,
+  exchangeCode,
+  fetch,
+  listOAuthAccounts,
+  listProfiles,
+  upsertProfile,
+  deriveProfileName,
+  openBrowser,
+  startSpinner,
+  printInfo
+};
 async function listOAuthAccounts(accessToken, opts = {}) {
   const whop = new Whop2({ apiKey: accessToken, baseURL: apiBaseUrl() });
   const MAX_ACCOUNTS = 1e3;
@@ -35945,11 +36333,11 @@ async function listOAuthAccounts(accessToken, opts = {}) {
   }
   return accounts;
 }
-async function resolveOAuthAccount(accessToken, opts) {
-  const s = opts.agent ? null : startSpinner("Loading your business accounts\u2026");
+async function resolveOAuthAccount(accessToken, opts, dependencies) {
+  const s = opts.agent ? null : dependencies.startSpinner("Loading your business accounts\u2026");
   let accounts;
   try {
-    accounts = await listOAuthAccounts(accessToken, {
+    accounts = await dependencies.listOAuthAccounts(accessToken, {
       stopAtId: opts.accountId
     });
   } catch {
@@ -35983,86 +36371,104 @@ async function resolveOAuthAccount(accessToken, opts) {
     s?.stop(`Using ${accounts[0].title}.`);
     return accounts[0];
   }
-  if (opts.agent) {
-    s?.stop("");
-    throw new OAuthError(
-      "MULTIPLE_ACCOUNTS",
-      `You can manage ${accounts.length} business accounts \u2014 pass --account-id to choose one: ${accounts.map((account) => `${account.id} (${account.title})`).join(", ")}.`
-    );
-  }
+  if (opts.agent) return null;
   s?.stop(`Found ${accounts.length} business accounts.`);
   return selectAccount(accounts);
 }
-async function performOAuthLogin(input) {
+async function prepareOAuthLogin(input, dependencies = defaultOAuthLoginDependencies) {
   const { verifier, challenge } = generatePKCE();
   const state = generateState();
   const nonce = generateNonce();
-  const authUrl = buildAuthUrl(challenge, state, nonce);
-  const s = startSpinner("Opening browser\u2026");
-  openBrowser(authUrl);
-  s.stop("Waiting for authorization in your browser\u2026");
-  printInfo(`If your browser didn't open, visit:
-${authUrl}`);
-  let code;
+  const authorizationUrl = buildAuthUrl(challenge, state, nonce);
+  let callback;
   try {
-    code = await startCallbackServer(state);
-  } catch (err) {
+    callback = await dependencies.startCallbackServer(state);
+  } catch (error) {
     throw new OAuthError(
       "OAUTH_CALLBACK_FAILED",
-      err instanceof Error ? err.message : "OAuth callback failed."
-    );
-  }
-  const s2 = startSpinner("Exchanging authorization code\u2026");
-  let tokens;
-  try {
-    tokens = await exchangeCode(code, verifier);
-    s2.stop("Authorized.");
-  } catch (err) {
-    s2.stop("Token exchange failed.");
-    throw new OAuthError(
-      "TOKEN_EXCHANGE_FAILED",
-      err instanceof Error ? err.message : "Token exchange failed."
+      error instanceof Error ? error.message : "OAuth callback failed."
     );
   }
-  const base = oauthBaseUrl();
-  let identity = {};
-  let accountIdentity = null;
-  try {
-    const res = await fetch(`${base}/oauth/userinfo`, {
-      headers: { Authorization: `Bearer ${tokens.accessToken}` }
-    });
-    if (res.ok) {
-      const info = await res.json();
-      identity = { id: info.sub, title: info.name, email: info.email };
-    }
-  } catch {
-  }
-  if (!input.deferAccountSelection) {
-    accountIdentity = await resolveOAuthAccount(tokens.accessToken, {
-      agent: input.agent ?? false,
-      accountId: input.accountId
-    });
-  }
-  const name = input.profile ?? deriveProfileName(identity);
-  const existed = listProfiles().some((p) => p.name === name);
-  const tokenExpiresAt = new Date(
-    Date.now() + tokens.expiresIn * 1e3
-  ).toISOString();
-  const profile = upsertProfile({
-    name,
-    method: "oauth",
-    secret: tokens.refreshToken,
-    identity,
-    accountIdentity: accountIdentity ?? void 0,
-    accessToken: tokens.accessToken,
-    tokenExpiresAt
-  });
   return {
-    profileName: profile.name,
-    identity,
-    existed
+    authorizationUrl,
+    complete: async () => {
+      let code;
+      try {
+        code = await callback.result;
+      } catch (error) {
+        throw new OAuthError(
+          "OAUTH_CALLBACK_FAILED",
+          error instanceof Error ? error.message : "OAuth callback failed."
+        );
+      }
+      const spinner4 = input.interactive ? dependencies.startSpinner("Exchanging authorization code\u2026") : null;
+      let tokens;
+      try {
+        tokens = await dependencies.exchangeCode(code, verifier);
+        spinner4?.stop("Authorized.");
+      } catch (error) {
+        spinner4?.stop("Token exchange failed.");
+        throw new OAuthError(
+          "TOKEN_EXCHANGE_FAILED",
+          error instanceof Error ? error.message : "Token exchange failed."
+        );
+      }
+      const base = oauthBaseUrl();
+      let identity = {};
+      let accountIdentity = null;
+      try {
+        const response = await dependencies.fetch(`${base}/oauth/userinfo`, {
+          headers: { Authorization: `Bearer ${tokens.accessToken}` }
+        });
+        if (response.ok) {
+          const info = await response.json();
+          identity = { id: info.sub, title: info.name, email: info.email };
+        }
+      } catch {
+      }
+      if (!input.deferAccountSelection) {
+        accountIdentity = await resolveOAuthAccount(
+          tokens.accessToken,
+          { agent: !input.interactive, accountId: input.accountId },
+          dependencies
+        );
+      }
+      const name = input.profile ?? dependencies.deriveProfileName(identity);
+      const existed = dependencies.listProfiles().some((profile2) => profile2.name === name);
+      const tokenExpiresAt = new Date(
+        Date.now() + tokens.expiresIn * 1e3
+      ).toISOString();
+      const profile = dependencies.upsertProfile({
+        name,
+        method: "oauth",
+        secret: tokens.refreshToken,
+        identity,
+        accountIdentity: accountIdentity ?? void 0,
+        accessToken: tokens.accessToken,
+        tokenExpiresAt
+      });
+      return {
+        profileName: profile.name,
+        identity,
+        existed
+      };
+    }
   };
 }
+async function performOAuthLogin(input, dependencies = defaultOAuthLoginDependencies) {
+  const login = await prepareOAuthLogin(
+    { ...input, interactive: true },
+    dependencies
+  );
+  const spinner4 = dependencies.startSpinner("Opening browser\u2026");
+  dependencies.openBrowser(login.authorizationUrl);
+  spinner4.stop("Waiting for authorization in your browser\u2026");
+  dependencies.printInfo(
+    `If your browser didn't open, visit:
+${login.authorizationUrl}`
+  );
+  return login.complete();
+}
 
 // src/auth/profiles.ts
 var EXPIRY_BUFFER_MS = 6e4;
@@ -36132,7 +36538,12 @@ function upsertProfile(input, env = process.env) {
     (profile2) => profile2.name === input.name
   );
   const isOauth = input.method === "oauth";
-  const account = isOauth ? input.accountIdentity : input.identity;
+  const preservedAccount = existing?.method === "oauth" && existing.accountId && existing.userId === input.identity.id ? {
+    id: existing.accountId,
+    title: existing.accountTitle,
+    route: existing.accountRoute
+  } : void 0;
+  const account = isOauth ? input.accountIdentity ?? preservedAccount : input.identity;
   const profile = {
     name: input.name,
     method: input.method,
@@ -36572,7 +36983,7 @@ var groups_default = [
     name: "partners",
     tag: "Partners",
     description: "The users and businesses you referred to Whop, and what you earn from them.",
-    group: "Referrals"
+    group: "Partners"
   },
   {
     name: "workforce-bounties",
@@ -36636,8 +37047,10 @@ var groups_default = [
   }
 ];
 
-// src/auth/commands.ts
+// src/auth/login.ts
+var LoginMethod = external_exports.enum(["oauth", "api-key"]);
 var loginOptions = external_exports.object({
+  method: LoginMethod.optional().describe("Authentication method to use"),
   apiKey: external_exports.string().optional().describe("API key for non-interactive login (skips the prompt)"),
   profile: external_exports.string().optional().describe("Name for this profile (defaults to the account route)"),
   accountId: external_exports.string().optional().describe(
@@ -36649,104 +37062,78 @@ var loginEnv = external_exports.object({
   WHOP_API_BASE_URL: external_exports.string().optional().describe("Override the Whop API base URL"),
   WHOP_CONFIG_DIR: external_exports.string().optional().describe("Override the CLI config directory")
 });
-var loginOutput = external_exports.object({
+var authenticatedLoginOutput = external_exports.object({
   profile: external_exports.string().describe("The profile name"),
   active: external_exports.boolean().describe("Whether this profile is now the active one"),
   method: AuthMethod.describe("The authentication method"),
   identity: Identity.describe("The authenticated account or user identity")
 });
-var logoutOptions = external_exports.object({
-  profile: external_exports.string().optional().describe("Profile to remove (defaults to the active profile)"),
-  all: external_exports.boolean().optional().describe("Remove every profile and its stored secret (full reset)")
-});
-var logoutOutput = external_exports.object({
-  removed: external_exports.array(external_exports.string()).describe("The removed profile name(s)"),
-  newActive: external_exports.string().nullable().describe("The profile that is now active, if any")
-});
-var statusOutput = external_exports.object({
-  loggedIn: external_exports.boolean().describe("Whether the active profile has a usable stored credential"),
-  profile: external_exports.string().nullable(),
-  method: AuthMethod.nullable(),
-  identity: Identity.nullable().describe(
-    "The logged-in user (OAuth) or the account (API key)"
-  ),
-  account: Identity.nullable().describe(
-    "The account auto-filled for scoped commands (account_id/company_id)"
-  ),
-  hasSecret: external_exports.boolean().describe("Whether a secret was found in the OS keychain for this profile")
-});
-var listOutput = external_exports.object({
-  active: external_exports.string().nullable(),
-  profiles: external_exports.array(Profile)
-});
-var switchArgs = external_exports.object({
-  name: external_exports.string().optional().describe("Profile to switch to (interactive picker if omitted)")
-});
-var switchOutput = external_exports.object({
-  active: external_exports.string().describe("The newly active profile")
-});
-var accountArgs = external_exports.object({
-  id: external_exports.string().optional().describe(
-    "Business account to make the default \u2014 id (biz_xxx) or route (interactive picker if omitted)"
-  )
-});
-var accountOptions2 = external_exports.object({
-  list: external_exports.boolean().optional().describe(
-    "List the business accounts you can manage without changing the default"
-  )
-});
-var accountListItem = external_exports.object({
-  id: external_exports.string(),
-  title: external_exports.string(),
-  route: external_exports.string(),
-  active: external_exports.boolean().describe("Whether this is the profile's default business account")
-});
-var accountOutput = external_exports.object({
-  profile: external_exports.string().describe("The active profile"),
-  account: Identity.nullable().describe(
-    "The default business account passed to scoped commands"
-  ),
-  accounts: external_exports.array(accountListItem).describe("Business accounts this user can manage")
+var authorizationRequiredOutput = external_exports.object({
+  type: external_exports.literal("authorization_required"),
+  authorizationUrl: external_exports.string().describe("Open this URL in the user's browser to authorize the CLI")
 });
+var loginOutput = external_exports.union([
+  authorizationRequiredOutput,
+  authenticatedLoginOutput
+]);
 var loginExamples = [
   { description: "Interactive login" },
   {
-    options: { apiKey: "whop_xxx" },
-    description: "Non-interactive login (CI / agents)"
+    options: { method: "oauth" },
+    description: "Open a browser for OAuth login"
+  },
+  {
+    options: { method: "api-key", apiKey: "whop_xxx" },
+    description: "Non-interactive API-key login"
   },
   {
-    options: { apiKey: "whop_xxx", profile: "prod" },
+    options: { method: "api-key", apiKey: "whop_xxx", profile: "prod" },
     description: "Log in and name the profile"
   }
 ];
-var loginHint = "Agents / CI: pass --api-key or set WHOP_API_KEY to skip the prompt.";
+var loginHint = "Agents: run `login --method oauth --format jsonl` in the background with stdout redirected to a file (pipes like `| head` can buffer past the URL). The first line is an authorization_required event \u2014 open its authorizationUrl in the user's browser yourself (e.g. `open <url>` on macOS, `xdg-open` on Linux). The URL is several KB long, so pass it programmatically and NEVER retype, truncate, or summarize it: a mangled scope list fails with invalid_scope. Then wait for the process to exit; the final done event means the login saved. If the user manages multiple businesses the login still succeeds without one \u2014 set it afterwards with `auth account <biz_id>` (use `auth account --list` to enumerate). For unattended use, pass --api-key or set WHOP_API_KEY instead.";
+function oauthSuccess(result) {
+  return {
+    ok: true,
+    existed: result.existed,
+    underscoped: false,
+    output: {
+      profile: result.profileName,
+      active: true,
+      method: "oauth",
+      identity: result.identity
+    }
+  };
+}
+function oauthFailure(error) {
+  if (error instanceof OAuthError) {
+    return { ok: false, code: error.code, message: error.message };
+  }
+  throw error;
+}
 async function performLogin(input) {
-  let method = "api_key";
-  if (!input.agent && !input.apiKey) method = await chooseAuthMethod();
+  let method = input.method === "oauth" ? "oauth" : "api_key";
+  if (!input.method && !input.agent && !input.apiKey) {
+    method = await chooseAuthMethod();
+  }
   if (method === "oauth") {
-    try {
-      const { profileName, identity: identity2, existed: existed2 } = await performOAuthLogin({
-        profile: input.profile,
-        agent: input.agent,
-        accountId: input.accountId,
-        deferAccountSelection: input.deferAccountSelection
-      });
+    if (input.agent) {
       return {
-        ok: true,
-        existed: existed2,
-        underscoped: false,
-        output: {
-          profile: profileName,
-          active: true,
-          method: "oauth",
-          identity: identity2
-        }
+        ok: false,
+        code: "OAUTH_STREAMING_REQUIRED",
+        message: "OAuth login in agent mode must stream the authorization URL \u2014 use `login --method oauth --format jsonl`."
       };
-    } catch (err) {
-      if (err instanceof OAuthError) {
-        return { ok: false, code: err.code, message: err.message };
-      }
-      throw err;
+    }
+    try {
+      return oauthSuccess(
+        await performOAuthLogin({
+          profile: input.profile,
+          accountId: input.accountId,
+          deferAccountSelection: input.deferAccountSelection
+        })
+      );
+    } catch (error) {
+      return oauthFailure(error);
     }
   }
   let apiKey = input.apiKey;
@@ -36791,11 +37178,80 @@ async function performLogin(input) {
     output: { profile: profile.name, active: true, method, identity }
   };
 }
-async function loginAdapter(c2) {
+function loginSuccessMeta(result) {
+  if (!getActiveProfile()?.accountId) {
+    return {
+      cta: {
+        description: "You're logged in. Choose or create the business the CLI should use:",
+        commands: [
+          {
+            command: "auth account",
+            description: "Set the default business account (--list to see them)"
+          },
+          {
+            command: "quickstart",
+            description: "Choose or create a business account"
+          }
+        ]
+      }
+    };
+  }
+  return {
+    cta: {
+      description: result.existed ? "Updated and switched to this profile:" : "You're logged in:",
+      commands: [
+        { command: "auth status", description: "Show the active identity" },
+        {
+          command: "quickstart",
+          description: "Choose or create a business account"
+        }
+      ]
+    }
+  };
+}
+function failLogin(c2, result) {
+  let cta;
+  if (result.code === "API_KEY_REQUIRED") {
+    cta = {
+      description: "Choose a non-interactive login method:",
+      commands: [
+        {
+          command: "auth login",
+          options: { method: "oauth" },
+          description: "Use OAuth (add --format jsonl for agents)"
+        },
+        {
+          command: "auth login",
+          options: { method: "api-key", apiKey: true },
+          description: "Pass --api-key <key>"
+        }
+      ]
+    };
+  } else if (result.code === "ACCOUNT_NOT_FOUND") {
+    cta = {
+      description: "Choose which business account to use:",
+      commands: [
+        {
+          command: "auth login",
+          options: { method: "oauth", accountId: true },
+          description: "Pass --account-id biz_xxx"
+        }
+      ]
+    };
+  }
+  return c2.error({
+    code: result.code,
+    message: result.message,
+    retryable: result.code !== "INVALID_API_KEY",
+    cta
+  });
+}
+async function standardLoginAdapter(c2) {
   let result;
   try {
     result = await performLogin({
       agent: c2.agent,
+      method: c2.options.method,
       apiKey: c2.options.apiKey ?? c2.env.WHOP_API_KEY,
       profile: c2.options.profile,
       accountId: c2.options.accountId
@@ -36810,65 +37266,114 @@ async function loginAdapter(c2) {
     }
     throw error;
   }
-  if (!result.ok) {
-    let cta;
-    if (result.code === "API_KEY_REQUIRED") {
-      cta = {
-        description: "Provide a key non-interactively:",
-        commands: [
-          {
-            command: "auth login",
-            options: { apiKey: true },
-            description: "Pass --api-key <key>"
-          }
-        ]
-      };
-    } else if (result.code === "MULTIPLE_ACCOUNTS" || result.code === "ACCOUNT_NOT_FOUND") {
-      cta = {
-        description: "Choose which business account to use:",
-        commands: [
-          {
-            command: "auth login",
-            options: { accountId: true },
-            description: "Pass --account-id biz_xxx"
-          }
-        ]
-      };
-    }
-    return c2.error({
-      code: result.code,
-      message: result.message,
-      retryable: result.code !== "INVALID_API_KEY",
-      cta
-    });
+  if (!result.ok) return failLogin(c2, result);
+  return c2.ok(result.output, loginSuccessMeta(result));
+}
+async function* streamingOAuthLoginAdapter(c2, oauthDependencies) {
+  let login;
+  try {
+    login = await prepareOAuthLogin(
+      {
+        profile: c2.options.profile,
+        interactive: false,
+        accountId: c2.options.accountId
+      },
+      oauthDependencies
+    );
+  } catch (error) {
+    return failLogin(c2, oauthFailure(error));
   }
-  const accountId = getActiveProfile()?.accountId;
-  if (!accountId) {
-    return c2.ok(result.output, {
-      cta: {
-        description: "You're logged in. Choose or create the business the CLI should use:",
-        commands: [
-          {
-            command: "quickstart",
-            description: "Choose or create a business account"
-          }
-        ]
-      }
+  yield {
+    type: "authorization_required",
+    authorizationUrl: login.authorizationUrl
+  };
+  let result;
+  try {
+    result = oauthSuccess(await login.complete());
+  } catch (error) {
+    return failLogin(c2, oauthFailure(error));
+  }
+  yield result.output;
+  return c2.ok(result.output, loginSuccessMeta(result));
+}
+function loginAdapter(c2, oauthDependencies) {
+  if (c2.options.method === "oauth" && c2.options.apiKey) {
+    return c2.error({
+      code: "CONFLICTING_OPTIONS",
+      message: "--method oauth cannot be combined with --api-key.",
+      retryable: true
     });
   }
-  return c2.ok(result.output, {
-    cta: {
-      description: result.existed ? "Updated and switched to this profile:" : "You're logged in:",
-      commands: [
-        { command: "auth status", description: "Show the active identity" },
-        {
-          command: "quickstart",
-          description: "Choose or create a business account"
+  if (c2.options.method === "oauth" && (c2.agent || c2.format === "jsonl")) {
+    if (c2.formatExplicit && c2.format !== "jsonl") {
+      return c2.error({
+        code: "OAUTH_STREAMING_FORMAT_REQUIRED",
+        message: "OAuth login requires --format jsonl so the authorization URL is shown before the callback wait.",
+        retryable: true,
+        cta: {
+          commands: ["auth login --method oauth --format jsonl"]
         }
-      ]
+      });
     }
-  });
+    return streamingOAuthLoginAdapter(c2, oauthDependencies);
+  }
+  return standardLoginAdapter(c2);
 }
+
+// src/auth/commands.ts
+var logoutOptions = external_exports.object({
+  profile: external_exports.string().optional().describe("Profile to remove (defaults to the active profile)"),
+  all: external_exports.boolean().optional().describe("Remove every profile and its stored secret (full reset)")
+});
+var logoutOutput = external_exports.object({
+  removed: external_exports.array(external_exports.string()).describe("The removed profile name(s)"),
+  newActive: external_exports.string().nullable().describe("The profile that is now active, if any")
+});
+var statusOutput = external_exports.object({
+  loggedIn: external_exports.boolean().describe("Whether the active profile has a usable stored credential"),
+  profile: external_exports.string().nullable(),
+  method: AuthMethod.nullable(),
+  identity: Identity.nullable().describe(
+    "The logged-in user (OAuth) or the account (API key)"
+  ),
+  account: Identity.nullable().describe(
+    "The account auto-filled for scoped commands (account_id/company_id)"
+  ),
+  hasSecret: external_exports.boolean().describe("Whether a secret was found in the OS keychain for this profile")
+});
+var listOutput = external_exports.object({
+  active: external_exports.string().nullable(),
+  profiles: external_exports.array(Profile)
+});
+var switchArgs = external_exports.object({
+  name: external_exports.string().optional().describe("Profile to switch to (interactive picker if omitted)")
+});
+var switchOutput = external_exports.object({
+  active: external_exports.string().describe("The newly active profile")
+});
+var accountArgs = external_exports.object({
+  id: external_exports.string().optional().describe(
+    "Business account to make the default \u2014 id (biz_xxx) or route (interactive picker if omitted)"
+  )
+});
+var accountOptions2 = external_exports.object({
+  list: external_exports.boolean().optional().describe(
+    "List the business accounts you can manage without changing the default"
+  )
+});
+var accountListItem = external_exports.object({
+  id: external_exports.string(),
+  title: external_exports.string(),
+  route: external_exports.string(),
+  active: external_exports.boolean().describe("Whether this is the profile's default business account")
+});
+var accountOutput = external_exports.object({
+  profile: external_exports.string().describe("The active profile"),
+  account: Identity.nullable().describe(
+    "The default business account passed to scoped commands"
+  ),
+  accounts: external_exports.array(accountListItem).describe("Business accounts this user can manage")
+});
 function logoutAdapter(c2) {
   if (c2.options.all) {
     if (c2.options.profile) {
@@ -38961,7 +39466,7 @@ ${c.success("\u2713")} ${action} business account ${chalk3.bold(`"${title}"`)} $
 // package.json
 var package_default = {
   name: "@whop/cli",
-  version: "0.8.0",
+  version: "0.8.1",
   description: "The Whop CLI \u2014 build and manage Whop apps from your terminal. Human and agent friendly.",
   keywords: [
     "agent",