@wevion/cli 1.0.3308 → 1.0.3324

package/openapi.json

@@ -120277,7 +120277,7 @@
           "creative-hub",
           "creative-generation"
         ],
-        "description": "Returns the deterministic credit estimate for a UGC generation request without starting a provider job. The estimate is computed from the SAME resolved billing input the generate endpoint charges from, so it accounts for the two effects that used to make the charge exceed the quote: a spoken script longer than the requested duration extends the billable duration (up to 15s, reported as duration_source), and a product photo adds a product-description line. Supply script_word_count and has_product_image to get the exact amount that will be charged; omitting them yields the floor of that amount.",
+        "description": "Returns the deterministic credit estimate for a UGC generation request without starting a provider job. The estimate is computed from the SAME resolved billing input the generate endpoint charges from, so it accounts for the two effects that used to make the charge exceed the quote: a spoken script longer than the requested duration extends the billable duration (up to 15s, reported as duration_source), and a product photo adds a product-description line. Supply script_word_count and has_product_image to get the exact amount that will be charged; omitting them yields the floor of that amount — and in that case credits_max is the ceiling the charge can never exceed for this request, so the guaranteed invariant is credits <= charged <= credits_max. script_word_count_declared says which of the two you are looking at.",
         "requestBody": {
           "required": true,
           "content": {
@@ -120380,6 +120380,8 @@
                   "type": "object",
                   "required": [
                     "credits",
+                    "credits_max",
+                    "script_word_count_declared",
                     "breakdown",
                     "billable_seconds",
                     "duration_source",
@@ -120391,6 +120393,14 @@
                       "description": "Total credits that will be held and charged.",
                       "type": "integer"
                     },
+                    "credits_max": {
+                      "description": "Upper bound of what generate can charge for this exact request. It folds the only two inputs this endpoint cannot see: a spoken script that stretches the billable duration to the 15s product cap, and an attached product photo. Equal to credits when neither can apply.",
+                      "type": "integer"
+                    },
+                    "script_word_count_declared": {
+                      "description": "False when script_word_count was omitted (or 0) on a mode that can be extended by the spoken script: the quote is then a floor, not the exact charge. Always true for mode=ai_script, where the script is written to fit the requested duration and never extends it.",
+                      "type": "boolean"
+                    },
                     "breakdown": {
                       "description": "Per catalog line contribution to the total.",
                       "type": "array",
@@ -123215,7 +123225,7 @@
           "creative-hub",
           "creative-generation"
         ],
-        "description": "Calculates character count, estimated credit cost and estimated duration for a single-voice or multi-voice voiceover request.",
+        "description": "Calculates character count, estimated credit cost and estimated duration for a single-voice or multi-voice voiceover request. The price is resolved from the provider of the selected voice (voice_id), which is the same provider the generation job will bill from — supplying a different voice can change the estimate by up to 6.6x.",
         "requestBody": {
           "required": true,
           "content": {
@@ -123342,6 +123352,56 @@
               }
             }
           },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "500": {
             "description": "Internal server error",
             "content": {
@@ -137868,6 +137928,16 @@
                         "cost_per_purchase",
                         "cost_per_lead",
                         "cost_per_complete_registration",
+                        "cost_per_add_to_cart",
+                        "cost_per_initiate_checkout",
+                        "cost_per_add_payment_info",
+                        "cost_per_subscribe",
+                        "cost_per_start_trial",
+                        "profit",
+                        "roi",
+                        "roas",
+                        "aov",
+                        "frequency",
                         "activeCount",
                         "pb_conversions",
                         "pb_revenue",
@@ -137955,6 +138025,36 @@
                         "cost_per_complete_registration": {
                           "type": "number"
                         },
+                        "cost_per_add_to_cart": {
+                          "type": "number"
+                        },
+                        "cost_per_initiate_checkout": {
+                          "type": "number"
+                        },
+                        "cost_per_add_payment_info": {
+                          "type": "number"
+                        },
+                        "cost_per_subscribe": {
+                          "type": "number"
+                        },
+                        "cost_per_start_trial": {
+                          "type": "number"
+                        },
+                        "profit": {
+                          "type": "number"
+                        },
+                        "roi": {
+                          "type": "number"
+                        },
+                        "roas": {
+                          "type": "number"
+                        },
+                        "aov": {
+                          "type": "number"
+                        },
+                        "frequency": {
+                          "type": "number"
+                        },
                         "activeCount": {
                           "type": "number"
                         },
@@ -138838,6 +138938,16 @@
                         "cost_per_purchase",
                         "cost_per_lead",
                         "cost_per_complete_registration",
+                        "cost_per_add_to_cart",
+                        "cost_per_initiate_checkout",
+                        "cost_per_add_payment_info",
+                        "cost_per_subscribe",
+                        "cost_per_start_trial",
+                        "profit",
+                        "roi",
+                        "roas",
+                        "aov",
+                        "frequency",
                         "activeCount",
                         "pb_conversions",
                         "pb_revenue",
@@ -138925,6 +139035,36 @@
                         "cost_per_complete_registration": {
                           "type": "number"
                         },
+                        "cost_per_add_to_cart": {
+                          "type": "number"
+                        },
+                        "cost_per_initiate_checkout": {
+                          "type": "number"
+                        },
+                        "cost_per_add_payment_info": {
+                          "type": "number"
+                        },
+                        "cost_per_subscribe": {
+                          "type": "number"
+                        },
+                        "cost_per_start_trial": {
+                          "type": "number"
+                        },
+                        "profit": {
+                          "type": "number"
+                        },
+                        "roi": {
+                          "type": "number"
+                        },
+                        "roas": {
+                          "type": "number"
+                        },
+                        "aov": {
+                          "type": "number"
+                        },
+                        "frequency": {
+                          "type": "number"
+                        },
                         "activeCount": {
                           "type": "number"
                         },
@@ -140136,6 +140276,16 @@
                         "cost_per_purchase",
                         "cost_per_lead",
                         "cost_per_complete_registration",
+                        "cost_per_add_to_cart",
+                        "cost_per_initiate_checkout",
+                        "cost_per_add_payment_info",
+                        "cost_per_subscribe",
+                        "cost_per_start_trial",
+                        "profit",
+                        "roi",
+                        "roas",
+                        "aov",
+                        "frequency",
                         "activeCount",
                         "pb_conversions",
                         "pb_revenue",
@@ -140223,6 +140373,36 @@
                         "cost_per_complete_registration": {
                           "type": "number"
                         },
+                        "cost_per_add_to_cart": {
+                          "type": "number"
+                        },
+                        "cost_per_initiate_checkout": {
+                          "type": "number"
+                        },
+                        "cost_per_add_payment_info": {
+                          "type": "number"
+                        },
+                        "cost_per_subscribe": {
+                          "type": "number"
+                        },
+                        "cost_per_start_trial": {
+                          "type": "number"
+                        },
+                        "profit": {
+                          "type": "number"
+                        },
+                        "roi": {
+                          "type": "number"
+                        },
+                        "roas": {
+                          "type": "number"
+                        },
+                        "aov": {
+                          "type": "number"
+                        },
+                        "frequency": {
+                          "type": "number"
+                        },
                         "activeCount": {
                           "type": "number"
                         },
@@ -154871,9 +155051,18 @@
             "schema": {
               "type": "string"
             },
+            "examples": {
+              "CRITICAL": {
+                "value": "CRITICAL"
+              },
+              "CRITICAL,ERROR": {
+                "value": "CRITICAL,ERROR"
+              }
+            },
             "in": "query",
             "name": "severity",
-            "required": false
+            "required": false,
+            "description": "One canonical severity (CRITICAL | ERROR | WARNING | INFO | SUCCESS) or a comma-separated list, e.g. \"CRITICAL,ERROR\". Values are normalised to the canonical UPPERCASE form server-side."
           },
           {
             "schema": {
@@ -156330,7 +156519,7 @@
                 "properties": {
                   "preferences": {
                     "minItems": 1,
-                    "maxItems": 40,
+                    "maxItems": 45,
                     "type": "array",
                     "items": {
                       "additionalProperties": false,
@@ -158063,7 +158252,7 @@
         "tags": [
           "partner"
         ],
-        "description": "Registra una candidatura al Programma Partner. ⚠️ Risponde 403 finché il commutatore `partner_track_b_enroll` è spento: la coda candidature è chiusa e NESSUNA pratica viene creata — il corpo del 403 è una costante che non dipende dai dati inviati. Rotta PUBBLICA e senza account: non crea alcuna user_session, alcuna organizzazione e alcuna email di verifica — l’account nasce solo all’approvazione. ★ Risponde SEMPRE 202 con lo stesso corpo, anche se l’email è già candidata o appartiene a un partner già approvato: nessun endpoint di questo programma conferma mai l’esistenza di un’email. Il link con cui seguire la pratica arriva per email, non nella risposta. Due limiti, due comportamenti diversi: 5/h per IP risponde 429; 3/h per identità email è applicato in silenzio, perché un 429 sull’email sarebbe esso stesso l’oracolo che questa rotta evita.",
+        "description": "Registra una candidatura al Programma Partner. ⚠️ Risponde 403 finché il commutatore `partner_track_b_enroll` è spento: la coda candidature è chiusa e NESSUNA pratica viene creata — il corpo del 403 è una costante che non dipende dai dati inviati. Rotta PUBBLICA e senza account: non crea alcuna user_session, alcuna organizzazione e alcuna email di verifica — l’account nasce solo all’approvazione. ★ Risponde SEMPRE 202 con lo stesso corpo, anche se l’email è già candidata o appartiene a un partner già approvato: nessun endpoint di questo programma conferma mai l’esistenza di un’email. Il link con cui seguire la pratica arriva per email, non nella risposta. Due limiti, due comportamenti diversi: 5/h per IP risponde 429; 3/h per identità email è applicato in silenzio, perché un 429 sull’email sarebbe esso stesso l’oracolo che questa rotta evita. ⚠️ `collection_mode: \"cash\"` esige `vat_number`: senza, la risposta è 400 e nessuna pratica viene creata. È lo stesso vincolo che l’approvazione applicherebbe (`vat_required`) e che il CHECK `ck_partner_cash_needs_vat` imporrebbe sull’anagrafica — anticiparlo qui evita una pratica che nasce già inapprovabile e un rifiuto che il candidato scopre mesi dopo. Il controllo dipende solo dal corpo inviato: non legge il database e non è un oracolo su alcuna identità.",
         "requestBody": {
           "required": true,
           "content": {
@@ -161294,7 +161483,7 @@
         "tags": [
           "partner"
         ],
-        "description": "Contatore per il badge «n nuovi eventi — aggiorna» e i tre timestamp di freschezza. `since` è l’ultimo istante già visto dal client: senza, il contatore è 0. Non esiste un `ack` lato server perché non esiste una colonna dove scriverlo — il contatore è derivato, quindi ricalcolabile.",
+        "description": "Contatore per il badge «n nuovi eventi — aggiorna» e i tre timestamp di freschezza. `since` è l’ultimo istante già visto dal client. ★ Senza `since` il contatore NON è più 0: si conta da `partner.pulse_seen_at`, il puntatore del lettore persistito sulla riga — prima il puntatore viveva solo nel client, e un dispositivo nuovo (o una navigazione privata, o i dati del sito svuotati) leggeva sempre «0 eventi nuovi» qualunque cosa fosse successa. Con `since` esplicito il puntatore avanza, e **solo in avanti**: due dispositivi che si alternano non si azzerano il badge a vicenda.",
         "parameters": [
           {
             "schema": {
@@ -161344,7 +161533,7 @@
                       "type": "string"
                     },
                     "new_events": {
-                      "description": "Eventi nuovi dopo `since`. 0 quando `since` non è passato.",
+                      "description": "Eventi nuovi dopo `since`, o dopo `partner.pulse_seen_at` quando `since` non è passato. 0 solo quando nessuno dei due esiste, cioè quando il partner non ha davvero mai guardato.",
                       "minimum": 0,
                       "type": "integer"
                     }
@@ -179107,7 +179296,7 @@
         "tags": [
           "reports"
         ],
-        "description": "Returns every active (non-deleted) report schedule visible to the caller: schedules stamped with one of the accessible team ids (workspace tenancy) plus the caller’s own legacy schedules without a team stamp. Includes template binding, recurrence configuration, recipients, and last/next run timestamps.",
+        "description": "Returns every active (non-deleted) report schedule visible to the caller: schedules stamped with one of the accessible team ids (workspace tenancy) plus the caller’s own legacy schedules without a team stamp. Includes template binding, recurrence configuration, recipients, and last/next run timestamps. Readable even when the scheduled-sends feature flag is off, so an owner can always find and stop the schedules they already have.",
         "parameters": [
           {
             "schema": {
@@ -179385,33 +179574,6 @@
                 }
               }
             }
-          },
-          "503": {
-            "description": "Scheduled reports are not enabled for this account.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "description": "Scheduled reports are not enabled for this account.",
-                  "type": "object",
-                  "required": [
-                    "error",
-                    "code"
-                  ],
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    },
-                    "code": {
-                      "type": "string",
-                      "enum": [
-                        "FEATURE_DISABLED"
-                      ]
-                    }
-                  }
-                }
-              }
-            }
           }
         }
       },
@@ -180098,7 +180260,7 @@
         "tags": [
           "reports"
         ],
-        "description": "Returns a single schedule by id. Scoped to the caller’s accessible workspaces (plus own legacy schedules) - returns 404 when outside that scope.",
+        "description": "Returns a single schedule by id. Scoped to the caller’s accessible workspaces (plus own legacy schedules) - returns 404 when outside that scope. Readable even when the scheduled-sends feature flag is off, so an owner can always find and stop the schedules they already have.",
         "parameters": [
           {
             "schema": {
@@ -180392,33 +180554,6 @@
                 }
               }
             }
-          },
-          "503": {
-            "description": "Scheduled reports are not enabled for this account.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "description": "Scheduled reports are not enabled for this account.",
-                  "type": "object",
-                  "required": [
-                    "error",
-                    "code"
-                  ],
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    },
-                    "code": {
-                      "type": "string",
-                      "enum": [
-                        "FEATURE_DISABLED"
-                      ]
-                    }
-                  }
-                }
-              }
-            }
           }
         }
       },
@@ -181242,7 +181377,7 @@
         "tags": [
           "reports"
         ],
-        "description": "Enqueues a one-off GENERATE_SCHEDULED_REPORT job for the given schedule, bypassing the cron cadence. The job emails the artifact to the schedule recipients and records a manual-trigger audit event. Returns the canonical async-job envelope (worker_run_id mirrored as job_id). Rate limited to 5 calls per 1 hour per user: one call is a PDF render plus an email fan-out, not a download.",
+        "description": "Enqueues a one-off GENERATE_SCHEDULED_REPORT job for the given schedule, bypassing the cron cadence. The job emails the artifact to the schedule recipients and records a manual-trigger audit event. Returns the canonical async-job envelope (worker_run_id mirrored as job_id). A PAUSED schedule is refused with 409 SCHEDULED_REPORT_PAUSED: pausing is the customer's only brake on an outbound relay, so it binds this endpoint exactly as it binds the cron. Rate limited to 5 calls per 1 hour per user: one call is a PDF render plus an email fan-out, not a download.",
         "parameters": [
           {
             "schema": {
@@ -181439,6 +181574,41 @@
               }
             }
           },
+          "409": {
+            "description": "The schedule is paused. Resume it before triggering an immediate send.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "The schedule is paused. Resume it before triggering an immediate send.",
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message",
+                    "code"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string",
+                      "enum": [
+                        "SCHEDULED_REPORT_PAUSED"
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
           "429": {
             "description": "Too many requests - rate limit exceeded",
             "content": {
@@ -299642,14 +299812,12 @@
           },
           {
             "schema": {
-              "minimum": 0,
-              "maximum": 1000000,
-              "type": "number"
+              "type": "string"
             },
             "in": "query",
             "name": "payout",
             "required": true,
-            "description": "The payout amount for the conversion (0 to 1,000,000)."
+            "description": "The payout amount for the conversion, as a decimal string. Values outside 0 to 1,000,000 are rejected; a value that is not a number (e.g. an unsubstituted tracker macro) is accepted and stored without an amount."
           },
           {
             "schema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wevion/cli",
-  "version": "1.0.3308",
+  "version": "1.0.3324",
   "description": "Wevion API command-line interface — generated from the public OpenAPI spec",
   "type": "module",
   "bin": {