@reclaimprotocol/client 0.1.1 → 0.1.3

package/lib/types/openapi.gen.d.ts

@@ -51,17 +51,17 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Search verifications
-         * @description Search published Reclaim verifications by domain or data point. A verification is the recipe an end-user follows to prove something about themselves (e.g. "I have N followers on Twitter"). Returns a list of matches. Call this BEFORE `create_provider` — most popular domains already have a public verification you can reuse.
-         *     Catalog page listing all verifications. Returns a paginated list of verifications the caller can see. Public verifications are visible to everyone; private verifications are only visible to org members.
+         * Search providers
+         * @description Search published Reclaim providers by domain or data point. A provider is the recipe an end-user follows to prove something about themselves (e.g. "I have N followers on Twitter"). Returns a list of matches. Call this BEFORE `create_provider` — most popular domains already have a public provider you can reuse.
+         *     Catalog page listing all providers. Returns a paginated list of providers the caller can see. Public providers are visible to everyone; private providers are only visible to org members.
          */
         get: operations["Providers"];
         put?: never;
         /**
-         * Create a verification
-         * @description Create a new Reclaim verification. Use this only after `providers` returned nothing useful for the domain. The caller must be an active member of the target organization.
-         *     Creates a new verification in the specified organization. `visibility` is coerced to `PRIVATE` at creation regardless of what's sent; the author may toggle to `PUBLIC` later via `PATCH /providers/{id}`. While `PRIVATE`, versions go to the go live freely; once `PUBLIC`, non-admin versions need admin review. See `Provider.visibility`.
-         *     The server also seeds an initial `0.1.0` version on the `draft` branch in the same transaction so the verification is immediately editable. Its `initialUrl` defaults to `https://<domain>`; all other version fields fall back to their schema-declared defaults (structured verification, empty requests, empty web settings). `Provider.latestVersion` stays `null` until the draft is promoted to the live channel.
+         * Create a provider
+         * @description Create a new Reclaim provider. Use this only after `providers` returned nothing useful for the domain. The caller must be an active member of the target organization.
+         *     Creates a new provider in the specified organization. `visibility` is coerced to `PRIVATE` at creation regardless of what's sent; the author may toggle to `PUBLIC` later via `PATCH /providers/{id}`. While `PRIVATE`, versions go to the go live freely; once `PUBLIC`, non-admin versions need admin review. See `Provider.visibility`.
+         *     The server also seeds an initial `0.1.0` version on the `draft` branch in the same transaction so the provider is immediately editable. Its `initialUrl` defaults to `https://<domain>`; all other version fields fall back to their schema-declared defaults (a `structured` verificationType, empty requests, empty web settings). `Provider.latestVersion` stays `null` until the draft is promoted to the live channel.
          */
         post: operations["CreateProvider"];
         delete?: never;
@@ -80,7 +80,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Suggest verification fields from a domain/URL scrape
+         * Suggest provider fields from a domain/URL scrape
          * @description Pre-flight for `POST /providers`. Accepts a URL or bare
          *     domain, scrapes the page head with a short timeout, and
          *     returns suggested values (`title`, `slug`, `iconUrl`, brand
@@ -89,7 +89,7 @@ export interface paths {
          *
          *     - HTML / HTMX callers receive the step-2 form HTML
          *       pre-filled with the suggestions (swapped into the
-         *       create-verification dialog body).
+         *       create-provider dialog body).
          *     - JSON / SDK / agent callers receive the same suggestions
          *       as a JSON document so they can build their own UI or
          *       submit the create request directly.
@@ -113,7 +113,7 @@ export interface paths {
         };
         /**
          * Suggest websites for the Discover flow
-         * @description Website-first autocomplete that backs the Discover home page (`/`). Returns the distinct websites (one entry per domain) that have at least one verification the caller can see, ranked by relevance to `q`. Each entry carries the aggregated list of data points provable for that website. With no `q`, returns popular websites (most verifications first).
+         * @description Website-first autocomplete that backs the Discover home page (`/`). Returns the distinct websites (one entry per domain) that have at least one provider the caller can see, ranked by relevance to `q`. Each entry carries the aggregated list of data points provable for that website. With no `q`, returns popular websites (most providers first).
          *
          *     HTML / HTMX callers receive a fragment list (swapped into the search dropdown); JSON / SDK callers receive the suggestions document.
          */
@@ -135,7 +135,7 @@ export interface paths {
         };
         /**
          * Website landing & data-point selection page
-         * @description SEO landing page for a website, and the data-point selection step of the Discover flow. Lists every data point Reclaim can currently prove for `{domain}` (aggregated across all verifications the caller can see) so a visitor can pick what to verify and continue. Organic search traffic ("verify github username") and the in-app `/` → website-select flow converge on this single canonical URL.
+         * @description SEO landing page for a website, and the data-point selection step of the Discover flow. Lists every data point Reclaim can currently prove for `{domain}` (aggregated across all providers the caller can see) so a visitor can pick what to verify and continue. Organic search traffic ("verify github username") and the in-app `/` → website-select flow converge on this single canonical URL.
          *
          *     HTML callers receive the full page; when `q` is present and the request is an HTMX request, only the filtered data-point list fragment is returned. JSON / SDK callers receive the website's data points as a document.
          */
@@ -177,7 +177,7 @@ export interface paths {
         };
         /**
          * Build page — providers, try, and integration guide for a selection
-         * @description The step after data-point selection on `/site/{domain}`. Given the selected data points (plus optional pinned sources, provided values, and a resolution `mode`), shows which existing verification providers cover the selection, a member-only "Try verification" action, and a ready-to-paste integration guide. The whole selection travels in the query string so the page is server-rendered and back-navigable.
+         * @description The step after data-point selection on `/site/{domain}`. Given the selected data points (plus optional pinned sources, provided values, and a resolution `mode`), shows which existing providers cover the selection, a member-only "Try verification" action, and a ready-to-paste integration guide. The whole selection travels in the query string so the page is server-rendered and back-navigable.
          */
         get: operations["SiteBuild"];
         put?: never;
@@ -208,6 +208,86 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/site/{domain}/repair": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Failure-aware "Repair with an AI coding agent" wizard fragment
+         * @description Body of the build page's repair dialog, lazy-loaded after a sandbox Try fails so the agent prompt includes the REAL failure (which provider(s) failed + the error reason, read from the session's event log) and the resolved provider set. HTML / HTMX fragment.
+         */
+        get: operations["SiteBuildRepair"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/site/{domain}/alternative": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Re-resolve excluding a failed provider, else hand off to repair
+         * @description After a sandbox Try fails, reads which provider(s) failed from the session analytics and re-resolves the selection with them excluded. If the rest still cover it, responds with an `HX-Redirect` to the build page (failed providers excluded — the alternative set). Otherwise emits an `openRepair` HX-Trigger so the client opens the repair wizard.
+         */
+        get: operations["SiteBuildAlternative"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/site/{domain}/ai-provider": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Author an AI (llm) provider and go to its build screen
+         * @description Creates an `llm`-verification provider under the signed-in member's personal org, seeded with an extraction prompt for the selected/missing data points (and carrying the working response matches from the resolved structured providers). If `fromProviderId` is an editable draft the viewer owns, it versions THAT instead. Returns the build page's AI dialog body (the editable prompt + "Try with AI"). HTML / HTMX fragment.
+         */
+        post: operations["SiteAiProvider"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/site/{domain}/try-ai": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Mint a SANDBOX test session for an AI (llm) provider
+         * @description Mints a sandbox verification session for the given AI provider's draft and opens it in the verification client. An edited `prompt` in the body is saved as a new draft build first (the "edit prompt / try again" loop). Requires a signed-in member.
+         */
+        post: operations["SiteTryAi"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/discover/teach": {
         parameters: {
             query?: never;
@@ -217,7 +297,7 @@ export interface paths {
         };
         /**
          * “Teach our agent” instructions for a missing website / data point
-         * @description Returns the "Teach our agent" panel shown when a website or data point a user wants does not exist yet: steps to install the Reclaim MCP server plus a ready-to-copy prompt, templated with the requested `domain` and (optionally) `dataPoint`, that instructs an agent to author the missing verification. HTML / HTMX only (a dialog fragment).
+         * @description Returns the "Teach our agent" panel shown when a website or data point a user wants does not exist yet: steps to install the Reclaim MCP server plus a ready-to-copy prompt, templated with the requested `domain` and (optionally) `dataPoint`, that instructs an agent to author the missing provider. HTML / HTMX only (a dialog fragment).
          */
         get: operations["DiscoverTeachAgent"];
         put?: never;
@@ -236,8 +316,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Resolve existing providers covering selected data points
-         * @description The "resolve" step behind the Discover CTAs. Given a website and the data points the user picked, returns the existing verifications on that domain whose data points COVER the whole selection (smallest / most specific first), so a caller can reuse one instead of building a new verification. When nothing covers the selection, `needsCreation` is `true` — synthesising a new provider by stitching is a later stage. JSON only.
+         * Resolve a website + data points to providers
+         * @description Provider resolution: given a website and the data points the user wants their users to prove, return the smallest set of existing providers whose data points COVER the selection (greedy combine), the `requiredContext` inputs the consumer must supply, and any `uncovered` points no provider exposes yet (`needsCreation` is true then — author a provider with the agent tools). When the chosen providers can be fused into one (same start page, no clashing page scripts) `merge.mergeable` is true.
+         *
+         *     Agent flow: pick a website (`GET /discover/data-points` lists what's verifiable there), confirm the data points with the user, call this to get the `providers` + `requiredContext`, collect those context values from the user, then `POST /verifications/sessions` with `providers` (pass every id) and `context` to mint a verification.
          */
         get: operations["DiscoverResolve"];
         put?: never;
@@ -248,6 +330,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/discover/data-points": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the verifiable data points on a website
+         * @description The data points existing providers can prove on a website — the menu to pick from before `GET /discover/resolve`. Optionally filter by `q`.
+         */
+        get: operations["DiscoverDataPoints"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/providers/{providerId}/preview.png": {
         parameters: {
             query?: never;
@@ -256,8 +358,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get the verification's OG preview image
-         * @description Returns the 1200x630 PNG used in `<meta property="og:image">` for this verification (`Provider.previewImageUrl` points at this route). Rendered server-side on first read, then cached by the standard HTTP cache. The URL is keyed off the verification's preview ETag so it changes whenever the image-affecting fields change (title, iconUrl, effective primaryDataPoint — see `Provider.previewImageUrl`).
+         * Get the provider's OG preview image
+         * @description Returns the 1200x630 PNG used in `<meta property="og:image">` for this provider (`Provider.previewImageUrl` points at this route). Rendered server-side on first read, then cached by the standard HTTP cache. The URL is keyed off the provider's preview ETag so it changes whenever the image-affecting fields change (title, iconUrl, effective primaryDataPoint — see `Provider.previewImageUrl`).
          */
         get: operations["ProviderPreviewImage"];
         put?: never;
@@ -316,8 +418,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * All verifications (admin-only)
-         * @description Admin only. Lists all verifications across all organizations. Supports filtering by visibility, status, and free-text search on title/domain/slug.
+         * All providers (admin-only)
+         * @description Admin only. Lists all providers across all organizations. Supports filtering by visibility, status, and free-text search on title/domain/slug.
          */
         get: operations["AdminProviders"];
         put?: never;
@@ -452,8 +554,8 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Transfer a verification to a different workspace
-         * @description Admin-only. Moves the verification's `orgId` to the supplied workspace; preserves slug, versions, members. SQL function `builder.transfer_provider` enforces the admin gate and target existence atomically.
+         * Transfer a provider to a different workspace
+         * @description Admin-only. Moves the provider's `orgId` to the supplied workspace; preserves slug, versions, members. SQL function `builder.transfer_provider` enforces the admin gate and target existence atomically.
          */
         post: operations["TransferProvider"];
         delete?: never;
@@ -1116,16 +1218,16 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get a verification
-         * @description Fetch a single Reclaim verification by id. Returns every field needed
+         * Get a provider
+         * @description Fetch a single Reclaim provider by id. Returns every field needed
          *     to integrate it into a flow: domain, the live version (initialUrl + requests),
          *     and the data points it can prove. Use `providers` first if you only
          *     have a query string.
          *
-         *     Returns the verification record.
+         *     Returns the provider record.
          *
          *     **Canonical URL.** For SEO and stable sharing, the canonical
-         *     HTML URL for a verification is `/providers/{providerId}/{slug}`
+         *     HTML URL for a provider is `/providers/{providerId}/{slug}`
          *     (see `GetProviderBySlug`). HTML callers (`Accept: text/html`)
          *     that hit this route — which omits the slug — receive a `301`
          *     redirect to the slugged URL. JSON callers
@@ -1136,16 +1238,16 @@ export interface paths {
         put?: never;
         post?: never;
         /**
-         * Delete a verification
-         * @description Owner of the verification's organization only. Soft-archives the verification (sets `status` to `ARCHIVED`) so historical references remain resolvable. Supports optimistic concurrency via `If-Match`.
+         * Delete a provider
+         * @description Owner of the provider's organization only. Soft-archives the provider (sets `status` to `ARCHIVED`) so historical references remain resolvable. Supports optimistic concurrency via `If-Match`.
          */
         delete: operations["DeleteProvider"];
         options?: never;
         head?: never;
         /**
-         * Update a verification
-         * @description Update a Reclaim verification's metadata. Partial PATCH — pass only fields you want to change. The caller must be an active member of the owning organization. To change the verification's recipe (initialUrl, requests, …) cut a new version via the dashboard. Use `seo` to control how the verification appears in search results and social shares; omit a subfield to keep the server default.
-         *     Caller must be a member of the verification's owning organization. `id`, `orgId`, and `slug` are immutable. Supports optimistic concurrency via `If-Match`.
+         * Update a provider
+         * @description Update a Reclaim provider's metadata. Partial PATCH — pass only fields you want to change. The caller must be an active member of the owning organization. To change the provider's recipe (initialUrl, requests, …) cut a new version via the dashboard. Use `seo` to control how the provider appears in search results and social shares; omit a subfield to keep the server default.
+         *     Caller must be a member of the provider's owning organization. `id`, `orgId`, and `slug` are immutable. Supports optimistic concurrency via `If-Match`.
          */
         patch: operations["UpdateProvider"];
         trace?: never;
@@ -1158,14 +1260,14 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get a verification (canonical slugged URL)
-         * @description Canonical HTML URL for a verification. The slug in the path is
+         * Get a provider (canonical slugged URL)
+         * @description Canonical HTML URL for a provider. The slug in the path is
          *     primarily an SEO and link-readability affordance — the
-         *     verification is resolved by `providerId`.
+         *     provider is resolved by `providerId`.
          *
-         *     - If `slug` matches the verification's current slug, returns the
+         *     - If `slug` matches the provider's current slug, returns the
          *       resource (HTML or JSON per `Accept`).
-         *     - If `slug` does not match (e.g. the verification was renamed since
+         *     - If `slug` does not match (e.g. the provider was renamed since
          *       the URL was minted), HTML callers receive a `301` redirect
          *       to this same route with the *current* slug. JSON callers
          *       receive the resource directly with `200` regardless of slug
@@ -1192,22 +1294,22 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * List a verification's versions
-         * @description Lists versions visible to the caller. Non-public branches (`ai`, `draft`, `in_review`, `rejected`) are only visible to members of the verification's owning organization.
+         * List a provider's versions
+         * @description Lists versions visible to the caller. Non-public branches (`ai`, `draft`, `in_review`, `rejected`) are only visible to members of the provider's owning organization.
          */
         get: operations["ListProviderVersions"];
         put?: never;
         /**
-         * Create a new verification version
-         * @description Creates a new version of the verification. The starting branch
-         *     depends on the verification's `visibility` and the caller's role:
+         * Create a new provider version
+         * @description Creates a new version of the provider. The starting branch
+         *     depends on the provider's `visibility` and the caller's role:
          *
-         *     - `PRIVATE` verification (any caller): the live channel (no review).
+         *     - `PRIVATE` provider (any caller): the live channel (no review).
          *
-         *     - `PUBLIC` verification, admin caller (Reclaim staff): the live channel
+         *     - `PUBLIC` provider, admin caller (Reclaim staff): the live channel
          *       (no review).
          *
-         *     - `PUBLIC` verification, non-admin caller: `draft` (or `ai` if
+         *     - `PUBLIC` provider, non-admin caller: `draft` (or `ai` if
          *       authored by the AI assistant). Must pass review (see
          *       `POST /providers/{id}/versions/{version}/review`) before
          *       reaching the live channel.
@@ -1226,20 +1328,20 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Get a specific verification version */
+        /** Get a specific provider version */
         get: operations["GetProviderVersion"];
         put?: never;
         post?: never;
         /**
-         * Delete a verification version
-         * @description Soft-archives a version on the `draft`, `ai`, or `rejected` branch — sets `status` to `ARCHIVED` so history is preserved. Trunk (live) and `in_review` versions cannot be archived this way; archive the parent verification instead. Supports optimistic concurrency via `If-Match`.
+         * Delete a provider version
+         * @description Soft-archives a version on the `draft`, `ai`, or `rejected` branch — sets `status` to `ARCHIVED` so history is preserved. Trunk (live) and `in_review` versions cannot be archived this way; archive the parent provider instead. Supports optimistic concurrency via `If-Match`.
          */
         delete: operations["DeleteProviderVersion"];
         options?: never;
         head?: never;
         /**
-         * Update a verification version
-         * @description Mutable only while the version is on the `draft` or `rejected` branch. Versions on `in_review` or the live channel reject all writes here. Caller must be a member of the verification's owning organization. Supports optimistic concurrency via `If-Match`.
+         * Update a provider version
+         * @description Mutable only while the version is on the `draft` or `rejected` branch. Versions on `in_review` or the live channel reject all writes here. Caller must be a member of the provider's owning organization. Supports optimistic concurrency via `If-Match`.
          */
         patch: operations["UpdateProviderVersion"];
         trace?: never;
@@ -1254,8 +1356,8 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Submit a verification version for review
-         * @description Submits a verification version (currently on the `draft` or `rejected` branch) for admin review. On success the version's branch transitions to `in_review`. Callable by any authenticated member of the verification's owning org. Meaningful only on `PUBLIC` verifications — on `PRIVATE` verifications new versions go to the live channel directly and never need review.
+         * Submit a provider version for review
+         * @description Submits a provider version (currently on the `draft` or `rejected` branch) for admin review. On success the version's branch transitions to `in_review`. Callable by any authenticated member of the provider's owning org. Meaningful only on `PUBLIC` providers — on `PRIVATE` providers new versions go to the live channel directly and never need review.
          */
         post: operations["SubmitProviderVersionForReview"];
         delete?: never;
@@ -1274,8 +1376,8 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Record a decision on a verification version review
-         * @description Admin only (Reclaim staff). Approves or rejects a verification version currently on the `in_review` branch. `APPROVED` clears the branch tag and promotes the version to the live channel; `REJECTED` moves it to the `rejected` branch where the author can address feedback and resubmit. A rejected version stays rejected — the author either fixes and resubmits, or abandons it.
+         * Record a decision on a provider version review
+         * @description Admin only (Reclaim staff). Approves or rejects a provider version currently on the `in_review` branch. `APPROVED` clears the branch tag and promotes the version to the live channel; `REJECTED` moves it to the `rejected` branch where the author can address feedback and resubmit. A rejected version stays rejected — the author either fixes and resubmits, or abandons it.
          *     Until RBAC is designed, "admin" is detected via the user's email domain (`@reclaimprotocol.org`). Non-admin callers receive a 403.
          */
         post: operations["DecideProviderVersionReview"];
@@ -1296,7 +1398,7 @@ export interface paths {
         put?: never;
         /**
          * Publish a draft version directly (PRIVATE providers only)
-         * @description Publishes a verification version on the `draft` branch directly to the live channel (trunk). Only allowed for PRIVATE providers — PUBLIC providers must use the review flow (`POST .../review` → admin decision). On success the version's branch transitions from `draft` to `null` (trunk/live).
+         * @description Publishes a provider version on the `draft` branch directly to the live channel (trunk). Only allowed for PRIVATE providers — PUBLIC providers must use the review flow (`POST .../review` → admin decision). On success the version's branch transitions from `draft` to `null` (trunk/live).
          */
         post: operations["PublishProviderVersion"];
         delete?: never;
@@ -2428,7 +2530,7 @@ export interface components {
             primaryDataPoint?: string;
             dataPoints: string[];
         };
-        /** @description One website (distinct domain) in the Discover search results. Aggregates, across every verification the caller can see on that domain, the brand display fields and the union of provable data points. */
+        /** @description One website (distinct domain) in the Discover search results. Aggregates, across every provider the caller can see on that domain, the brand display fields and the union of provable data points. */
         WebsiteSuggestion: {
             /**
              * Format: hostname
@@ -2444,7 +2546,7 @@ export interface components {
             iconUrl?: string;
             /** @description Deduplicated names of every data point provable for this website. */
             dataPoints: string[];
-            /** @description Number of verifications backing this website that the caller can see. */
+            /** @description Number of providers backing this website that the caller can see. */
             providerCount: number;
         };
         /** @description Body for `POST /site/{domain}/try`. Only the verification `context` (values for the resolved providers' `requiredContext` inputs). The selection (dataPoints / mode / pins) travels in the query string. */
@@ -2454,15 +2556,20 @@ export interface components {
                 [key: string]: string;
             };
         };
-        /** @description A single data point selectable on the `/site/{domain}` page, with how many visible verifications expose it and one example verification slug. */
+        /** @description Body for `POST /site/{domain}/try-ai`. An optional edited extraction prompt, saved as a new draft build before the sandbox session is minted. */
+        SiteTryAiBody: {
+            /** @description The edited extraction prompt for the AI provider. */
+            prompt?: string;
+        };
+        /** @description A single data point selectable on the `/site/{domain}` page, with how many visible providers expose it and one example provider slug. */
         DataPointItem: {
             /** @description Data-point name (e.g. `username`, `followers_count`). */
             name: string;
             /** @description Human description of the data point, taken from the response match that declares it. Absent when no match supplies one. */
             description?: string;
-            /** @description Number of visible verifications on the domain that expose this data point. */
+            /** @description Number of visible providers on the domain that expose this data point. */
             providerCount: number;
-            /** @description Slug of one verification that exposes this data point. */
+            /** @description Slug of one provider that exposes this data point. */
             exampleProviderSlug?: string;
         };
         InterceptorOptions: {
@@ -2635,9 +2742,9 @@ export interface components {
             /** @default [] */
             allowedJsRequests: components["schemas"]["RequestSelectionTemplate"][];
             /** @default structured */
-            readonly verificationType: components["schemas"]["VerificationType"];
+            verificationType: components["schemas"]["VerificationType"];
             /** @description The prompt used for LLM verification (only when verificationType is "llm"). */
-            readonly prompt?: string;
+            prompt?: string;
             webSettings: components["schemas"]["ProviderWebSettings"];
             requiredContext?: components["schemas"]["ProviderRequiredContext"];
         };
@@ -2729,7 +2836,7 @@ export interface components {
         };
         /** @description `title` is optional — when omitted the dashboard renders `seoSuggestions.title` (server-derived from the scrape result or `derive_brand_name(domain)`). */
         CreateProviderRequest: {
-            /** @description uuid identifier of the organization that will own the verification. */
+            /** @description uuid identifier of the organization that will own the provider. */
             orgId: components["schemas"]["OrgID"];
             /**
              * Format: hostname
@@ -2773,8 +2880,12 @@ export interface components {
             /** @description Author SEO fields. Send `null` for a subfield to clear that override and let `seoSuggestions` win again. */
             seo?: components["schemas"]["ProviderSeo"];
         };
-        /** @description Body for creating a new version of a provider. Every new version starts on the `draft` branch — see `CreateProviderVersion`. The request body never sets `branch` directly; going live is a separate, explicit step (publish for PRIVATE, submit-for-review → approve for PUBLIC). The version's `verificationType` is always `structured` and is not settable here; a `prompt` field is reserved for a future AI authoring flow and is also not accepted on this surface. */
+        /** @description Body for creating a new version of a provider. Every new version starts on the `draft` branch — see `CreateProviderVersion`. The request body never sets `branch` directly; going live is a separate, explicit step (publish for PRIVATE, submit-for-review → approve for PUBLIC). `verificationType` defaults to `structured`; pass `llm` with a `prompt` to author an AI-verification provider. */
         CreateProviderVersionRequest: {
+            /** @description Defaults to `structured` server-side when omitted; pass `llm` (with a `prompt`) to author an AI-verification provider. */
+            verificationType?: components["schemas"]["VerificationType"];
+            /** @description Extraction prompt, used (and required) when `verificationType` is `llm`. */
+            prompt?: string;
             /**
              * @description The version of this Provider upon creation. Clients typically omit this and let the dashboard's bump-suggestion compute it. When omitted, defaults to `0.1.0` for the very first version; otherwise the caller is expected to pass a value higher than the latest existing version.
              * @default {
@@ -2795,10 +2906,13 @@ export interface components {
             /** @description Free-form change note recorded on `createMetadata`. */
             notes?: string;
         };
-        /** @description Partial update of a provider version. Mutable only while the version is on the `draft` or `rejected` branch; versions on `in_review` or the live channel reject all writes here. The semver does not change on update — `build_number` increments instead, giving callers a monotonic revision counter without touching the (major, minor, patch) PK. `verificationType` / `prompt` are not accepted; see `ProviderVersion` for why. */
+        /** @description Partial update of a provider version. Mutable only while the version is on the `draft` or `rejected` branch; versions on `in_review` or the live channel reject all writes here. The semver does not change on update — `build_number` increments instead, giving callers a monotonic revision counter without touching the (major, minor, patch) PK. `verificationType` and `prompt` may be updated; omit either to carry the prior build's value forward. */
         UpdateProviderVersionRequest: {
             /** Format: uri */
             initialUrl?: string;
+            verificationType?: components["schemas"]["VerificationType"];
+            /** @description Extraction prompt, used when `verificationType` is `llm`. */
+            prompt?: string;
             requests?: components["schemas"]["RequestSelection"][];
             allowedJsRequests?: components["schemas"]["RequestSelectionTemplate"][];
             webSettings?: components["schemas"]["ProviderWebSettings"];
@@ -3472,17 +3586,23 @@ export interface operations {
     };
     SiteBuild: {
         parameters: {
-            query: {
-                /** @description Selected data-point names. Repeat to pass several. */
-                dataPoints: string[];
-                /** @description `combine` (default) minimizes to the fewest providers (set-cover); `list` uses one provider per data point. */
-                mode?: "list" | "combine";
+            query?: {
+                /** @description Selected data-point names. Repeat to pass several. Optional only so the "Build it with AI" entry can open the build page with just a missing `dataPoint`; the normal flow always passes ≥1. */
+                dataPoints?: string[];
+                /** @description When set, auto-opens the "Try with AI" dialog on load (the "Build it with AI" entry from the explore page). */
+                ai?: string;
+                /** @description A specific missing data point to seed the AI prompt with. */
+                dataPoint?: string;
+                /** @description `combine` (default) minimizes to the fewest providers (set-cover); `ai` is a forward-compat alias that currently resolves like combine. */
+                mode?: "combine" | "ai";
                 /** @description Source pins: `pins[<dataPoint>]=id,id`. Maps each data-point name to a comma-joined list of preferred providerIds. Omit for Auto. */
                 pins?: {
                     [key: string]: string;
                 };
                 /** @description Data-point names the consumer opts to SUPPLY themselves (as verification `context`) instead of having a provider prove — shrinks the provider set. Repeat to pass several. Only names that are a provider input are honoured. Subset of `dataPoints`. */
                 provided?: string[];
+                /** @description ProviderIds to EXCLUDE from resolution (set after a sandbox Try fails, so a different provider / merge is picked). Repeat to pass several. */
+                exclude?: components["schemas"]["ProviderID"][];
             };
             header?: never;
             path: {
@@ -3512,13 +3632,15 @@ export interface operations {
                 /** @description Selected data-point names. Repeat to pass several. */
                 dataPoints: string[];
                 /** @description Resolution mode (`combine` default | `list`). */
-                mode?: "list" | "combine";
+                mode?: "combine" | "ai";
                 /** @description Source pins: `pins[<dataPoint>]=id,id`. Maps each data-point name to a comma-joined list of preferred providerIds. */
                 pins?: {
                     [key: string]: string;
                 };
                 /** @description Data-point names the consumer supplies themselves (as `context`) instead of proving. Repeat to pass several. Subset of `dataPoints`. */
                 provided?: string[];
+                /** @description ProviderIds to exclude from resolution. Repeat to pass several. */
+                exclude?: components["schemas"]["ProviderID"][];
             };
             header?: never;
             path: {
@@ -3566,6 +3688,157 @@ export interface operations {
             default: components["responses"]["ProblemResponse"];
         };
     };
+    SiteBuildRepair: {
+        parameters: {
+            query: {
+                /** @description The failing sandbox session whose analytics seed the prompt. */
+                sessionId: components["schemas"]["SessionID"];
+                dataPoints?: string[];
+                mode?: "combine" | "ai";
+                provided?: string[];
+                pins?: {
+                    [key: string]: string;
+                };
+                exclude?: components["schemas"]["ProviderID"][];
+            };
+            header?: never;
+            path: {
+                domain: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The repair wizard fragment. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/html": components["schemas"]["HtmlContent"];
+                };
+            };
+            default: components["responses"]["ProblemResponse"];
+        };
+    };
+    SiteBuildAlternative: {
+        parameters: {
+            query: {
+                /** @description The failing sandbox session to analyze. */
+                sessionId: components["schemas"]["SessionID"];
+                dataPoints?: string[];
+                mode?: "combine" | "ai";
+                provided?: string[];
+                pins?: {
+                    [key: string]: string;
+                };
+                exclude?: components["schemas"]["ProviderID"][];
+            };
+            header?: never;
+            path: {
+                domain: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description No alternative — a fragment + `openRepair` HX-Trigger. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/html": components["schemas"]["HtmlContent"];
+                };
+            };
+            /** @description Alternative found — `HX-Redirect` to the build page. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            default: components["responses"]["ProblemResponse"];
+        };
+    };
+    SiteAiProvider: {
+        parameters: {
+            query?: {
+                /** @description A specific missing data point to name in the prompt. */
+                dataPoint?: string;
+                /** @description A failed sandbox session whose error seeds the prompt. */
+                sessionId?: components["schemas"]["SessionID"];
+                /** @description A provider to version (when owned + editable) instead of creating one. */
+                fromProviderId?: components["schemas"]["ProviderID"];
+                dataPoints?: string[];
+                mode?: "combine" | "ai";
+                provided?: string[];
+                pins?: {
+                    [key: string]: string;
+                };
+                exclude?: components["schemas"]["ProviderID"][];
+            };
+            header?: never;
+            path: {
+                domain: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The AI dialog body (editable prompt + Try with AI). */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/html": components["schemas"]["HtmlContent"];
+                };
+            };
+            default: components["responses"]["ProblemResponse"];
+        };
+    };
+    SiteTryAi: {
+        parameters: {
+            query: {
+                /** @description The AI provider to try. */
+                providerId: components["schemas"]["ProviderID"];
+            };
+            header?: never;
+            path: {
+                domain: string;
+            };
+            cookie?: never;
+        };
+        /** @description An optional edited extraction prompt to save before trying. */
+        requestBody?: {
+            content: {
+                "application/x-www-form-urlencoded": components["schemas"]["SiteTryAiBody"];
+                "application/json": components["schemas"]["SiteTryAiBody"];
+            };
+        };
+        responses: {
+            /** @description Session created. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VerificationSession"];
+                };
+            };
+            /** @description Sandbox verification quota exceeded. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+            default: components["responses"]["ProblemResponse"];
+        };
+    };
     DiscoverTeachAgent: {
         parameters: {
             query?: {
@@ -3591,6 +3864,8 @@ export interface operations {
                 domain: string;
                 /** @description Selected data-point names. Repeat to pass several. */
                 dataPoints: string[];
+                /** @description Resolution mode. `combine` (default) uses the fewest providers; `ai` is a forward-compat alias that resolves like combine for now. */
+                mode?: "combine" | "ai";
             };
             header?: never;
             path?: never;
@@ -3598,21 +3873,78 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Covering providers (possibly none). */
+            /** @description Resolved providers (possibly none). */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        /** @description The most specific covering provider's id, if any — a convenience for the common single-provider case. */
+                        /** @description The first resolved provider's id, if any — a convenience for the common single-provider case. */
                         providerId?: components["schemas"]["ProviderID"];
-                        /** @description True when no existing provider covers the full selection (a new one must be created/stitched). */
+                        /** @description True when some selected data point has no provider (see `uncovered`) — a new provider must be authored. */
                         needsCreation: boolean;
                         providers: {
                             providerId: components["schemas"]["ProviderID"];
                             slug: string;
+                            /** @description The selected data points this provider covers. */
                             dataPoints: string[];
+                            /** @description Recent verification health for this provider (last 30 days). Present only when there is enough history (a minimum number of attempts) to be meaningful; absent for new or rarely-used providers. Used to break ranking ties between providers covering the same data points. */
+                            reliability?: {
+                                /**
+                                 * Format: float
+                                 * @description Fraction of recent sessions that started this provider and completed its claim without failure.
+                                 */
+                                recentSuccessRate: number;
+                                /** @description Number of recent sessions that started this provider (the sample size behind `recentSuccessRate`). */
+                                attempts: number;
+                            };
+                        }[];
+                        /** @description Selected data points no existing provider exposes. */
+                        uncovered: string[];
+                        /** @description Inputs the consumer must supply at verification time (passed as session `context`). Collect these from the user. */
+                        requiredContext: {
+                            key: string;
+                            required: boolean;
+                            description?: string;
+                        }[];
+                        /** @description Whether the resolved providers fuse into one. Informational — `POST /verifications/sessions` already accepts the whole `providers` array. */
+                        merge: {
+                            mergeable: boolean;
+                            /** @description True when merging removes duplicate requests to the same endpoint (saved overfetch). */
+                            dedupedSomeRequests?: boolean;
+                        };
+                    };
+                };
+            };
+            default: components["responses"]["ProblemResponse"];
+        };
+    };
+    DiscoverDataPoints: {
+        parameters: {
+            query: {
+                /** @description Website domain (normalized server-side). */
+                domain: string;
+                /** @description Case-insensitive filter over data-point names. */
+                q?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Verifiable data points (possibly none). */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        dataPoints: {
+                            name: string;
+                            description?: string;
+                            providerCount: number;
                         }[];
                     };
                 };
@@ -5023,7 +5355,7 @@ export interface operations {
                 };
             };
             301: components["responses"]["CanonicalRedirectResponse"];
-            /** @description Verification not found, or it is `PRIVATE` and the caller is not authorized to see it. */
+            /** @description Provider not found, or it is `PRIVATE` and the caller is not authorized to see it. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -5059,7 +5391,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Precondition Failed. The supplied `If-Match` does not match the verification's current `ETag` — re-fetch and retry. */
+            /** @description Precondition Failed. The supplied `If-Match` does not match the provider's current `ETag` — re-fetch and retry. */
             412: {
                 headers: {
                     [name: string]: unknown;
@@ -5104,7 +5436,7 @@ export interface operations {
                 };
             };
             403: components["responses"]["ForbiddenResponse"];
-            /** @description Precondition Failed. The supplied `If-Match` does not match the verification's current `ETag` — re-fetch and retry. */
+            /** @description Precondition Failed. The supplied `If-Match` does not match the provider's current `ETag` — re-fetch and retry. */
             412: {
                 headers: {
                     [name: string]: unknown;
@@ -5120,7 +5452,7 @@ export interface operations {
             header?: never;
             path: {
                 providerId: components["schemas"]["ProviderID"];
-                /** @description Verification slug. URL-safe identifier; lowercase letters, digits, and hyphens only. If stale, HTML callers get a 301 to the current slug. */
+                /** @description Provider slug. URL-safe identifier; lowercase letters, digits, and hyphens only. If stale, HTML callers get a 301 to the current slug. */
                 slug: string;
             };
             cookie?: never;
@@ -5139,7 +5471,7 @@ export interface operations {
                 };
             };
             301: components["responses"]["CanonicalRedirectResponse"];
-            /** @description Verification not found, or it is `PRIVATE` and the caller is not authorized to see it. */
+            /** @description Provider not found, or it is `PRIVATE` and the caller is not authorized to see it. */
             404: {
                 headers: {
                     [name: string]: unknown;