@reclaimprotocol/client 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -30,7 +30,10 @@ export interface paths {
30
30
  path?: never;
31
31
  cookie?: never;
32
32
  };
33
- /** Get the homepage */
33
+ /**
34
+ * Discover home — search a website to verify
35
+ * @description Default home page. A website-first search: the visitor types a website and picks one to continue to `/site/{domain}`, where they choose what data to prove. Renders popular websites below the search.
36
+ */
34
37
  get: operations["Index"];
35
38
  put?: never;
36
39
  post?: never;
@@ -101,6 +104,150 @@ export interface paths {
101
104
  patch?: never;
102
105
  trace?: never;
103
106
  };
107
+ "/discover/websites": {
108
+ parameters: {
109
+ query?: never;
110
+ header?: never;
111
+ path?: never;
112
+ cookie?: never;
113
+ };
114
+ /**
115
+ * Suggest websites for the Discover flow
116
+ * @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).
117
+ *
118
+ * HTML / HTMX callers receive a fragment list (swapped into the search dropdown); JSON / SDK callers receive the suggestions document.
119
+ */
120
+ get: operations["DiscoverWebsites"];
121
+ put?: never;
122
+ post?: never;
123
+ delete?: never;
124
+ options?: never;
125
+ head?: never;
126
+ patch?: never;
127
+ trace?: never;
128
+ };
129
+ "/site/{domain}": {
130
+ parameters: {
131
+ query?: never;
132
+ header?: never;
133
+ path?: never;
134
+ cookie?: never;
135
+ };
136
+ /**
137
+ * Website landing & data-point selection page
138
+ * @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.
139
+ *
140
+ * 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.
141
+ */
142
+ get: operations["SitePage"];
143
+ put?: never;
144
+ post?: never;
145
+ delete?: never;
146
+ options?: never;
147
+ head?: never;
148
+ patch?: never;
149
+ trace?: never;
150
+ };
151
+ "/site/{domain}/panel": {
152
+ parameters: {
153
+ query?: never;
154
+ header?: never;
155
+ path?: never;
156
+ cookie?: never;
157
+ };
158
+ /**
159
+ * Discover summary panel fragment (htmx)
160
+ * @description HTMX-only fragment for the Discover site page. The data-point form fires this on every selection change (checkbox / mode / source pin), carrying the whole selection in the query string. Returns the summary panel aside (the swap target) plus an out-of-band swap of the Advanced source picker.
161
+ */
162
+ get: operations["SitePanel"];
163
+ put?: never;
164
+ post?: never;
165
+ delete?: never;
166
+ options?: never;
167
+ head?: never;
168
+ patch?: never;
169
+ trace?: never;
170
+ };
171
+ "/site/{domain}/build": {
172
+ parameters: {
173
+ query?: never;
174
+ header?: never;
175
+ path?: never;
176
+ cookie?: never;
177
+ };
178
+ /**
179
+ * Build page — providers, try, and integration guide for a selection
180
+ * @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.
181
+ */
182
+ get: operations["SiteBuild"];
183
+ put?: never;
184
+ post?: never;
185
+ delete?: never;
186
+ options?: never;
187
+ head?: never;
188
+ patch?: never;
189
+ trace?: never;
190
+ };
191
+ "/site/{domain}/try": {
192
+ parameters: {
193
+ query?: never;
194
+ header?: never;
195
+ path?: never;
196
+ cookie?: never;
197
+ };
198
+ get?: never;
199
+ put?: never;
200
+ /**
201
+ * Mint a SANDBOX test verification session for the selection
202
+ * @description Creates a real SANDBOX verification session under the signed-in member's personal organization for the selected data points, so they can test the flow on `/v/{sessionId}` without registering a callback subscription. Requires a signed-in member (session cookie); the provider set is recomputed server-side from the selection.
203
+ */
204
+ post: operations["SiteBuildTry"];
205
+ delete?: never;
206
+ options?: never;
207
+ head?: never;
208
+ patch?: never;
209
+ trace?: never;
210
+ };
211
+ "/discover/teach": {
212
+ parameters: {
213
+ query?: never;
214
+ header?: never;
215
+ path?: never;
216
+ cookie?: never;
217
+ };
218
+ /**
219
+ * “Teach our agent” instructions for a missing website / data point
220
+ * @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).
221
+ */
222
+ get: operations["DiscoverTeachAgent"];
223
+ put?: never;
224
+ post?: never;
225
+ delete?: never;
226
+ options?: never;
227
+ head?: never;
228
+ patch?: never;
229
+ trace?: never;
230
+ };
231
+ "/discover/resolve": {
232
+ parameters: {
233
+ query?: never;
234
+ header?: never;
235
+ path?: never;
236
+ cookie?: never;
237
+ };
238
+ /**
239
+ * Resolve existing providers covering selected data points
240
+ * @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.
241
+ */
242
+ get: operations["DiscoverResolve"];
243
+ put?: never;
244
+ post?: never;
245
+ delete?: never;
246
+ options?: never;
247
+ head?: never;
248
+ patch?: never;
249
+ trace?: never;
250
+ };
104
251
  "/providers/{providerId}/preview.png": {
105
252
  parameters: {
106
253
  query?: never;
@@ -392,6 +539,26 @@ export interface paths {
392
539
  patch?: never;
393
540
  trace?: never;
394
541
  };
542
+ "/v/{sessionId}/dispose": {
543
+ parameters: {
544
+ query?: never;
545
+ header?: never;
546
+ path?: never;
547
+ cookie?: never;
548
+ };
549
+ get?: never;
550
+ put?: never;
551
+ /**
552
+ * Dispose the session's remote browser
553
+ * @description Tears down the Popcorn remote-browser session backing this verification and cancels any in-flight run. Called by the verification page's "close" button (and safe to call after a session is already terminal — the dispose is idempotent). Popcorn sessions are a scarce, expensive resource, so freeing them promptly rather than waiting for their TTL matters. Same model as the status fragment: possession of the session id; no body.
554
+ */
555
+ post: operations["DisposeVerificationSession"];
556
+ delete?: never;
557
+ options?: never;
558
+ head?: never;
559
+ patch?: never;
560
+ trace?: never;
561
+ };
395
562
  "/v/{sessionId}/sse": {
396
563
  parameters: {
397
564
  query?: never;
@@ -563,8 +730,7 @@ export interface paths {
563
730
  delete?: never;
564
731
  options?: never;
565
732
  head?: never;
566
- /** Update the authenticated user's profile */
567
- patch: operations["UpdateMe"];
733
+ patch?: never;
568
734
  trace?: never;
569
735
  };
570
736
  "/users/{userId}": {
@@ -640,7 +806,11 @@ export interface paths {
640
806
  path?: never;
641
807
  cookie?: never;
642
808
  };
643
- get?: never;
809
+ /**
810
+ * List organization members, optionally filtered by email
811
+ * @description Returns the organization's members, optionally filtered by an email substring (`q`). Renders the members-list fragment for the org page's live filter; same visibility as the org page.
812
+ */
813
+ get: operations["SearchOrgMembers"];
644
814
  put?: never;
645
815
  /**
646
816
  * Invite a member to an organization
@@ -738,7 +908,7 @@ export interface paths {
738
908
  patch: operations["UpdateTheme"];
739
909
  trace?: never;
740
910
  };
741
- "/orgs/{orgId}/credential": {
911
+ "/orgs/{orgId}/keypair": {
742
912
  parameters: {
743
913
  query?: never;
744
914
  header?: never;
@@ -746,21 +916,21 @@ export interface paths {
746
916
  cookie?: never;
747
917
  };
748
918
  /**
749
- * Get the organization's encryption credential
750
- * @description Returns the organization's single X25519 encryption credential — the public JWK the Builder uses to JWE-encrypt delivered results — or `404` when none is set (delivery is plaintext in that case). Authenticated by the org's `OrgToken` or a human `BearerAuth` session for an active member of the org.
919
+ * Get the organization's encryption keypair
920
+ * @description Returns the organization's single Ethereum (secp256k1) encryption keypair — its public JWK, derived eth address, and `canEncryptResult` flag — or `404` when none is set (the org is keyless ⇒ plaintext delivery). Authenticated by the org's `OrgToken` or a human `BearerAuth` session for an active member of the org.
751
921
  */
752
- get: operations["GetOrgCredential"];
922
+ get: operations["GetOrgKeypair"];
753
923
  /**
754
- * Set (or replace) the organization's encryption credential
755
- * @description Upserts the organization's single X25519 encryption credential. The body carries the org's **encryption public JWK** (`{kty:'OKP', crv:'X25519', x}`); the matching private key never leaves the consumer. Replacing overwrites the single row. Once set, terminal results are delivered as a compact JWE encrypted to this key; clear it to revert to plaintext delivery. Authenticated by the org's `OrgToken` or a human `BearerAuth` session for an active member of the org.
924
+ * Set (or rotate) the organization's encryption keypair
925
+ * @description Upserts the organization's single Ethereum (secp256k1) encryption keypair. The body carries the org's **eth public key** — as an uncompressed hex string (`0x04`+128 hex) or a secp256k1 public JWK (`{kty:'EC', crv:'secp256k1', x, y}`) — and `canEncryptResult`. The matching private key never leaves the consumer. Setting overwrites the single row (and creates it for a keyless org). When `canEncryptResult` is true, terminal results are delivered as an ECIES ciphertext encrypted to this key; otherwise plaintext. Authenticated by the org's `OrgToken` or a human `BearerAuth` session for an active member of the org.
756
926
  */
757
- put: operations["SetOrgCredential"];
927
+ put: operations["SetOrgKeypair"];
758
928
  post?: never;
759
929
  /**
760
- * Clear the organization's encryption credential
761
- * @description Removes the organization's encryption credential. After this, terminal results are delivered as plaintext until a new credential is set. Authenticated by the org's `OrgToken` or a human `BearerAuth` session for an active member of the org.
930
+ * Clear the organization's encryption keypair
931
+ * @description Removes the organization's encryption keypair (the org reverts to keyless ⇒ plaintext delivery, and loses its eth identity address) until a new keypair is set. Authenticated by the org's `OrgToken` or a human `BearerAuth` session for an active member of the org.
762
932
  */
763
- delete: operations["DeleteOrgCredential"];
933
+ delete: operations["DeleteOrgKeypair"];
764
934
  options?: never;
765
935
  head?: never;
766
936
  patch?: never;
@@ -878,6 +1048,26 @@ export interface paths {
878
1048
  patch?: never;
879
1049
  trace?: never;
880
1050
  };
1051
+ "/attach": {
1052
+ parameters: {
1053
+ query?: never;
1054
+ header?: never;
1055
+ path?: never;
1056
+ cookie?: never;
1057
+ };
1058
+ /**
1059
+ * Device-pairing landing page
1060
+ * @description Page where a user enters the 5-character pairing code shown by their CLI / MCP. Submitting the form (`?code=`) redirects to the canonical `/attach/{code}` page; an invalid code re-renders the form with an error.
1061
+ */
1062
+ get: operations["AttachLanding"];
1063
+ put?: never;
1064
+ post?: never;
1065
+ delete?: never;
1066
+ options?: never;
1067
+ head?: never;
1068
+ patch?: never;
1069
+ trace?: never;
1070
+ };
881
1071
  "/attach/{code}": {
882
1072
  parameters: {
883
1073
  query?: never;
@@ -1194,9 +1384,9 @@ export interface paths {
1194
1384
  * the presented `OrgToken` resolves to. The body is just `callbackUrl`
1195
1385
  * and `events`. At least one subscription must exist for the org before a
1196
1386
  * verification session can be created. Delivery is scoped by org: terminal
1197
- * results are encrypted as a compact JWE to the org's encryption
1198
- * credential when set (see `PUT /orgs/{orgId}/credential`), else delivered
1199
- * as plaintext.
1387
+ * results are ECIES-encrypted to the org's eth public key when its
1388
+ * `canEncryptResult` is enabled (see `PUT /orgs/{orgId}/keypair`), else
1389
+ * delivered as plaintext.
1200
1390
  */
1201
1391
  post: operations["CreateCallbackSubscription"];
1202
1392
  delete?: never;
@@ -1390,8 +1580,8 @@ export interface paths {
1390
1580
  cookie?: never;
1391
1581
  };
1392
1582
  /**
1393
- * Get the resolved provider recipe for a session
1394
- * @description Returns the resolved provider version's `initialUrl` + `requests` for this session — what the Verification Client needs to run it. Authorized for the Verification Client (`X-VC-Token` service token) or the session creator (authenticated by the consumer's `OrgToken`; the resolved org must match the session), so it works regardless of the provider's visibility (unlike `GetProvider`, which 404s on PRIVATE providers for non-members).
1583
+ * Get the resolved provider recipes for a session
1584
+ * @description Returns the session's resolved provider versions' recipes (`initialUrl` + `requests` per provider), in run order — what the Verification Client needs to run the session (each provider sequentially in one browser session). Authorized for the Verification Client (`X-VC-Token` service token) or the session creator (authenticated by the consumer's `OrgToken`; the resolved org must match the session), so it works regardless of the provider's visibility (unlike `GetProvider`, which 404s on PRIVATE providers for non-members).
1395
1585
  */
1396
1586
  get: operations["GetVerificationRecipe"];
1397
1587
  put?: never;
@@ -1500,7 +1690,7 @@ export interface paths {
1500
1690
  };
1501
1691
  /**
1502
1692
  * List callback encryption keys for a session
1503
- * @description Used by the Verification Client (X-VC-Token) after the terminal event: returns the session org's callback subscriptions that subscribe to that terminal event. Each item carries the org's `publicKeyJwk` (X25519) to JWE-encrypt the result to, or none (deliver plaintext).
1693
+ * @description Used by the Verification Client (X-VC-Token) after the terminal event: returns the session org's callback subscriptions that subscribe to that terminal event. Each item carries the org's `publicKeyJwk` (secp256k1) to ECIES-encrypt the result to when the org's `canEncryptResult` is enabled, or none (deliver plaintext).
1504
1694
  */
1505
1695
  get: operations["ListSessionCallbackKeys"];
1506
1696
  put?: never;
@@ -1526,7 +1716,7 @@ export interface paths {
1526
1716
  put?: never;
1527
1717
  /**
1528
1718
  * Submit the signed, encrypted verification result
1529
- * @description Used by the Verification Client (X-VC-Token) to submit the result after a terminal event. The VC signs the JWS and JWE-encrypts it (ECDH-ES + A256GCM over X25519) to the org's encryption key (from the callback-keys endpoint); it submits one payload per subscription. The Builder stores each payload, enqueues it for the delivery worker (retry → DLQ), and never sees the plaintext. The Verification Client does not contact the Consumer.
1719
+ * @description Used by the Verification Client (X-VC-Token) to submit the result after a terminal event. The VC signs the JWS and, when the org's `canEncryptResult` is enabled, ECIES-encrypts it to the org's eth public key (from the callback-keys endpoint); it submits one payload per subscription. The Builder stores each payload, enqueues it for the delivery worker (retry → DLQ), and never sees the plaintext. The Verification Client does not contact the Consumer.
1530
1720
  */
1531
1721
  post: operations["SubmitVerificationResult"];
1532
1722
  delete?: never;
@@ -1617,18 +1807,18 @@ export interface webhooks {
1617
1807
  * `timestamp` are *plaintext routing hints* so the consumer can
1618
1808
  * route and dedupe before doing any crypto. Everything derived
1619
1809
  * from the end-user (claims, extracted parameters, proofs,
1620
- * context) is inside `data`: a compact JWE wrapping the signed JWS
1621
- * result when the org has an encryption credential, else the
1810
+ * context) is inside `data`: an ECIES ciphertext wrapping the signed JWS
1811
+ * result when the org's `canEncryptResult` is enabled, else the
1622
1812
  * plaintext signed JWS. The envelope is **not authenticated** —
1623
1813
  * act only on the decrypted and signature-verified JWS contents,
1624
1814
  * and check that its `reclaimSessionId` matches the session you
1625
1815
  * expect.
1626
1816
  *
1627
- * **Decrypting `data`.** When the org has registered an encryption
1628
- * credential, `data` is a compact JWE (RFC 7516,
1629
- * `ECDH-ES+A256GCM` over X25519); decrypt it with the matching
1630
- * X25519 private key (e.g. `jose` `compactDecrypt`) to recover the
1631
- * inner JWS. When no credential is set, `data` is the JWS directly.
1817
+ * **Decrypting `data`.** When the org's `canEncryptResult` is enabled,
1818
+ * `data` is an ECIES ciphertext (base64url, secp256k1 + AES-256-GCM);
1819
+ * decrypt it with the matching eth private key to recover the inner
1820
+ * JWS. When the org is keyless or the flag is off, `data` is the JWS
1821
+ * directly.
1632
1822
  * The JWS is an RFC 7515 result in General JSON serialization
1633
1823
  * (`alg: ES256K`); verify it against
1634
1824
  * `GET /.well-known/jwks.json` (`kid` = the signer's ETH address).
@@ -1855,8 +2045,8 @@ export interface components {
1855
2045
  providers?: components["schemas"]["ProviderListItem"][];
1856
2046
  /** @description Themes owned by this organization. */
1857
2047
  themes?: components["schemas"]["Theme"][];
1858
- /** @description The organization's single X25519 encryption credential, if set. Only populated on the org-detail endpoint and only visible to active members. Absent ⇒ results are delivered as plaintext. */
1859
- credential?: components["schemas"]["OrgCredential"];
2048
+ /** @description The organization's single Ethereum (secp256k1) encryption keypair, if set. Only populated on the org-detail endpoint and only visible to active members. Absent ⇒ the org is keyless and results are delivered as plaintext. */
2049
+ keypair?: components["schemas"]["OrgKeypair"];
1860
2050
  /** @description Billing record attached to the org, if any. Owner-visible only; absent for members. Presence promotes the org to production mode. */
1861
2051
  billing?: components["schemas"]["OrgBilling"];
1862
2052
  createMetadata: components["schemas"]["ActorMetadata"];
@@ -1887,26 +2077,43 @@ export interface components {
1887
2077
  */
1888
2078
  status: components["schemas"]["EntityStatus"];
1889
2079
  };
1890
- /** @description An X25519 public key in JWK form (RFC 8037 OKP), used to JWE-encrypt delivered verification results. The matching private key never leaves the consumer. */
1891
- JwkX25519Public: {
2080
+ /** @description A secp256k1 (Ethereum) public key in JWK form (`{kty:'EC', crv:'secp256k1', x, y}`), used to ECIES-encrypt delivered verification results and to identify the org. The matching private key never leaves the consumer. Same shape published by the signing JWKS. */
2081
+ JwkSecp256k1Public: {
1892
2082
  /** @enum {string} */
1893
- kty: "OKP";
2083
+ kty: "EC";
1894
2084
  /** @enum {string} */
1895
- crv: "X25519";
1896
- /** @description base64url-encoded public key bytes. */
2085
+ crv: "secp256k1";
2086
+ /** @description base64url-encoded X coordinate (32 bytes). */
1897
2087
  x: string;
1898
- };
1899
- /** @description An organization's single encryption credential: the X25519 public JWK the Builder uses to JWE-encrypt delivered results. One per org, replaceable via `PUT /orgs/{orgId}/credential`. Absent ⇒ results are delivered as plaintext. */
1900
- OrgCredential: {
1901
- publicKeyJwk: components["schemas"]["JwkX25519Public"];
1902
- /** @description Optional human-readable label set when the credential was stored. */
2088
+ /** @description base64url-encoded Y coordinate (32 bytes). */
2089
+ y: string;
2090
+ };
2091
+ /** @description An organization's single Ethereum (secp256k1) encryption keypair: the public JWK, its derived eth address (which also identifies the org), and the `canEncryptResult` toggle. One per org, set/rotated via `PUT /orgs/{orgId}/keypair`. Absent ⇒ the org is keyless (plaintext delivery). */
2092
+ OrgKeypair: {
2093
+ publicKeyJwk: components["schemas"]["JwkSecp256k1Public"];
2094
+ /** @description Lowercase 0x eth address derived from the public key. */
2095
+ ethAddress: string;
2096
+ /** @description When true, terminal results are ECIES-encrypted to this key; when false (the default), they are delivered as plaintext. */
2097
+ canEncryptResult: boolean;
2098
+ /** @description Optional human-readable label set when the keypair was stored. */
1903
2099
  label?: string;
1904
2100
  createMetadata: components["schemas"]["ActorMetadata"];
1905
2101
  updateMetadata: components["schemas"]["ActorMetadata"];
1906
2102
  };
1907
- /** @description Body for `PUT /orgs/{orgId}/credential`. */
1908
- OrgCredentialRequest: {
1909
- publicKeyJwk: components["schemas"]["JwkX25519Public"];
2103
+ OrgKeypairRequest: components["schemas"]["OrgKeypairHexRequest"] | components["schemas"]["OrgKeypairJwkRequest"];
2104
+ /** @description Body for `PUT /orgs/{orgId}/keypair`. Carries the org's eth public key as an uncompressed hex string (`0x04` + 128 hex) — the eth-native form wallets/ethers emit. The matching private key never leaves the consumer. */
2105
+ OrgKeypairHexRequest: {
2106
+ /** @description Uncompressed secp256k1 public key, `0x04` + 128 hex. */
2107
+ publicKey: string;
2108
+ /** @default false */
2109
+ canEncryptResult: boolean;
2110
+ label?: string;
2111
+ };
2112
+ /** @description Body for `PUT /orgs/{orgId}/keypair`. Carries the org's eth public key as a secp256k1 public JWK. */
2113
+ OrgKeypairJwkRequest: {
2114
+ publicKeyJwk: components["schemas"]["JwkSecp256k1Public"];
2115
+ /** @default false */
2116
+ canEncryptResult: boolean;
1910
2117
  label?: string;
1911
2118
  };
1912
2119
  /** @description Response of `POST /orgs/{orgId}/token`. The plaintext `orgSecret` is shown **only once** here; the server stores only its HMAC. Use it as `Authorization: Bearer <orgSecret>` (the `OrgToken` scheme). */
@@ -1992,8 +2199,10 @@ export interface components {
1992
2199
  writeRedactionMode?: components["schemas"]["WriteRedactionMode"];
1993
2200
  /** @description Apply TLS configuration when creating the tunnel to the attestor. */
1994
2201
  additionalClientOptions?: components["schemas"]["AdditionalTlsClientOptions"];
1995
- /** @description A list of match conditions for the response. */
1996
- matches?: components["schemas"]["ResponseMatch"][];
2202
+ /** @description Conditions the (redacted) response must satisfy for the proof to be valid. Each runs against the union of the portions revealed by `responseRedactions` (or the whole response when there are none). Mirrors attestor-core `responseMatches`. */
2203
+ responseMatches?: components["schemas"]["ResponseMatch"][];
2204
+ /** @description Portions to select/reveal from the response, applied in order (xPath => jsonPath => regex). Done client-side; only the selected portions (plus the first response line) are sent to the attestor. An independent ordered list — NOT paired 1:1 with `responseMatches`. Mirrors attestor-core `responseRedactions`. */
2205
+ responseRedactions?: components["schemas"]["ResponseRedaction"][];
1997
2206
  };
1998
2207
  /** @description A template for selecting request */
1999
2208
  RequestSelectionTemplate: components["schemas"]["RequestSelection"] & {
@@ -2041,11 +2250,9 @@ export interface components {
2041
2250
  type: "regex" | "contains";
2042
2251
  /** @description The pattern or value to look for in the response. When `type` is 'contains', supports template variable declaration using `{{variable}}` syntax. When `type` is 'regex', can be used to extract variables using regex named groups. */
2043
2252
  value: string;
2044
- /** @description Optional extractor describing which portion of the response to pin to the proof. When absent, the match runs against the raw response body. */
2045
- extract?: components["schemas"]["ExtractDataSpecifier"];
2046
2253
  };
2047
2254
  /** @description Which portions to select from a response. These are selected in order, xpath => jsonPath => regex * These redactions are done client side and only the selected portions are sent to the attestor. The attestor will only be able to see the selected portions alongside the first line of the HTTP response (i.e. "HTTP/1.1 200 OK") */
2048
- ExtractDataSpecifier: {
2255
+ ResponseRedaction: {
2049
2256
  /** @description expect an HTML response, and to contain a certain xpath for eg. "/html/body/div.a1/div.a2/span.a5" */
2050
2257
  xPath?: string;
2051
2258
  /** @description expect a JSON response, retrieve the item at this path using dot notation for e.g. 'email.addresses.0' */
@@ -2221,6 +2428,43 @@ export interface components {
2221
2428
  primaryDataPoint?: string;
2222
2429
  dataPoints: string[];
2223
2430
  };
2431
+ /** @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. */
2432
+ WebsiteSuggestion: {
2433
+ /**
2434
+ * Format: hostname
2435
+ * @description Canonical root domain (e.g. `github.com`).
2436
+ */
2437
+ domain: string;
2438
+ /** @description Display name for the website (scraped site name or derived from the domain). */
2439
+ brandName: string;
2440
+ /**
2441
+ * Format: uri
2442
+ * @description Favicon URL for the website.
2443
+ */
2444
+ iconUrl?: string;
2445
+ /** @description Deduplicated names of every data point provable for this website. */
2446
+ dataPoints: string[];
2447
+ /** @description Number of verifications backing this website that the caller can see. */
2448
+ providerCount: number;
2449
+ };
2450
+ /** @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. */
2451
+ SiteBuildTryBody: {
2452
+ /** @description Input key → value the consumer's app supplies. */
2453
+ context?: {
2454
+ [key: string]: string;
2455
+ };
2456
+ };
2457
+ /** @description A single data point selectable on the `/site/{domain}` page, with how many visible verifications expose it and one example verification slug. */
2458
+ DataPointItem: {
2459
+ /** @description Data-point name (e.g. `username`, `followers_count`). */
2460
+ name: string;
2461
+ /** @description Human description of the data point, taken from the response match that declares it. Absent when no match supplies one. */
2462
+ description?: string;
2463
+ /** @description Number of visible verifications on the domain that expose this data point. */
2464
+ providerCount: number;
2465
+ /** @description Slug of one verification that exposes this data point. */
2466
+ exampleProviderSlug?: string;
2467
+ };
2224
2468
  InterceptorOptions: {
2225
2469
  /**
2226
2470
  * @description How traffic interception is implemented.
@@ -2411,12 +2655,16 @@ export interface components {
2411
2655
  /** @description Opaque bearer token. Send as `Authorization: Bearer <token>` on every authenticated request. */
2412
2656
  token: string;
2413
2657
  };
2414
- /** @description Caller-editable fields on the authenticated user. */
2415
- UpdateUserRequest: {
2416
- name?: string;
2417
- };
2658
+ /** @description Body for `POST /orgs`. Explicitly-created orgs must declare their Ethereum (secp256k1) encryption public key — it identifies the org and, when `canEncryptResult` is enabled, encrypts delivered results. */
2418
2659
  CreateOrgRequest: {
2419
2660
  name: string;
2661
+ /** @description The org's eth public key, uncompressed hex (`0x04` + 128 hex) — the eth-native form wallets/ethers emit. The matching private key never leaves the consumer. */
2662
+ publicKey: string;
2663
+ /**
2664
+ * @description When true, terminal results are ECIES-encrypted to this key; when false (the default), they are delivered as plaintext.
2665
+ * @default false
2666
+ */
2667
+ canEncryptResult: boolean;
2420
2668
  };
2421
2669
  UpdateOrgRequest: {
2422
2670
  name?: string;
@@ -2606,9 +2854,10 @@ export interface components {
2606
2854
  * @description Lifecycle event reported for a verification session. A healthy run
2607
2855
  * proceeds through these in order; reading the gaps locates where a
2608
2856
  * session stalled. Session-level terminal events trigger callback
2609
- * delivery; request-level events are progress pings carrying a
2610
- * `request_id` in their event data. New values may be added over time;
2611
- * clients MUST tolerate unknown values in responses.
2857
+ * delivery; provider-/request-level events are progress pings carrying a
2858
+ * `provider_id` (and `request_id` for request-level ones) in their event
2859
+ * data. New values may be added over time; clients MUST tolerate unknown
2860
+ * values in responses.
2612
2861
  *
2613
2862
  * - `session_pending`: Session created; awaiting the end-user.
2614
2863
  *
@@ -2617,6 +2866,10 @@ export interface components {
2617
2866
  *
2618
2867
  * - `verification_client_ready`: The client initialized.
2619
2868
  *
2869
+ * - `verification_provider_started`: The client began verifying a provider
2870
+ * (`provider_id`/`resolved_version`/`ordinal` in `eventData`). One per
2871
+ * provider, in run order, for multi-provider sessions.
2872
+ *
2620
2873
  * - `request_matched`: The target request was captured on the provider
2621
2874
  * site. Absent (after opened) ⇒ the user didn't complete the journey.
2622
2875
  *
@@ -2637,7 +2890,7 @@ export interface components {
2637
2890
  * - `session_expired`: `expiresAt` passed before a terminal event.
2638
2891
  * @enum {string}
2639
2892
  */
2640
- VerificationEvent: "session_pending" | "verification_client_opened" | "verification_client_ready" | "request_matched" | "request_claim_created" | "request_claim_completed" | "request_claim_rejected" | "request_claim_failed" | "verification_success" | "verification_rejected" | "verification_error" | "session_expired";
2893
+ VerificationEvent: "session_pending" | "verification_client_opened" | "verification_client_ready" | "verification_provider_started" | "request_matched" | "request_claim_created" | "request_claim_completed" | "request_claim_rejected" | "request_claim_failed" | "verification_success" | "verification_rejected" | "verification_error" | "session_expired";
2641
2894
  /**
2642
2895
  * @description Status of a verification session, derived from its events. New values
2643
2896
  * may be added over time; clients MUST tolerate unknown values in
@@ -2674,7 +2927,7 @@ export interface components {
2674
2927
  * @enum {string}
2675
2928
  */
2676
2929
  CallbackDeliveryStatus: "pending" | "delivered" | "attempt_failed" | "failed";
2677
- /** @description A pre-registered destination for verification results, owned by an organization. A session's results go to every subscription on the session's org whose `events` include the terminal event. At least one subscription must exist for the org before a session can be created. Terminal results are encrypted as a compact JWE to the org's encryption credential when set (see `OrgCredential`), else delivered as plaintext. */
2930
+ /** @description A pre-registered destination for verification results, owned by an organization. A session's results go to every subscription on the session's org whose `events` include the terminal event. At least one subscription must exist for the org before a session can be created. Terminal results are ECIES-encrypted to the org's eth public key when its `canEncryptResult` is enabled (see `OrgKeypair`), else delivered as plaintext. */
2678
2931
  CallbackSubscription: {
2679
2932
  /** Format: uuid */
2680
2933
  id: string;
@@ -2717,11 +2970,8 @@ export interface components {
2717
2970
  * @description UUID v7 session id (also echoed in context as `reclaimSessionId`).
2718
2971
  */
2719
2972
  id: string;
2720
- providerId: components["schemas"]["ProviderID"];
2721
- /** @description Version constraint requested by the Consumer (empty = latest). */
2722
- version?: string;
2723
- /** @description Exact version resolved at creation time. */
2724
- resolvedVersion: string;
2973
+ /** @description The providers this session verifies, in run order. The Verification Client runs each (sequentially, in one browser session) and submits one combined result; all are required. */
2974
+ providers: components["schemas"]["SessionProvider"][];
2725
2975
  /** @description The organization that owns this session. */
2726
2976
  orgId?: components["schemas"]["OrgID"];
2727
2977
  /**
@@ -2748,16 +2998,29 @@ export interface components {
2748
2998
  mode: components["schemas"]["CredentialMode"];
2749
2999
  sandboxLimits?: components["schemas"]["SandboxLimits"];
2750
3000
  };
2751
- /** @description Body for `POST /verifications/sessions`. Authenticated by the consumer's `OrgToken`. Carries no callback URLs — they come from the org's callback subscriptions. */
2752
- CreateVerificationSessionRequest: {
3001
+ /** @description One provider a session verifies, with its resolved version. */
3002
+ SessionProvider: {
3003
+ providerId: components["schemas"]["ProviderID"];
3004
+ /** @description Version constraint requested by the Consumer (empty = latest). */
3005
+ version?: string;
3006
+ /** @description Exact version resolved at creation time. */
3007
+ resolvedVersion: string;
3008
+ };
3009
+ /** @description A provider (+ optional version) to verify in a session. */
3010
+ SessionProviderInput: {
2753
3011
  providerId: components["schemas"]["ProviderID"];
2754
3012
  /** @description Semver constraint; empty resolves to the latest trunk version. */
2755
3013
  version?: string;
2756
- /** @description Consumer context. Validated against the resolved provider version's `requiredContext` JSON Schema (a 400 is returned on mismatch); extra fields are always allowed. Recipe requests reference these values as `{{context.<key>}}`. Echoed back (plus `reclaimSessionId`) in the result. */
3014
+ };
3015
+ /** @description Body for `POST /verifications/sessions`. Authenticated by the consumer's `OrgToken`. Carries no callback URLs — they come from the org's callback subscriptions. The one shared `context` is validated against every provider's `requiredContext`. */
3016
+ CreateVerificationSessionRequest: {
3017
+ /** @description Providers to verify, in run order. The Verification Client runs each sequentially in one browser session and submits one combined result; all are required. */
3018
+ providers: components["schemas"]["SessionProviderInput"][];
3019
+ /** @description Consumer context, shared by all providers. Validated against EACH resolved provider version's `requiredContext` JSON Schema (a 400 is returned on mismatch); extra fields are always allowed. Recipe requests reference these values as `{{context.<key>}}`. Echoed back (plus `reclaimSessionId`) in the result. */
2757
3020
  context: {
2758
3021
  [key: string]: unknown;
2759
3022
  };
2760
- /** @description Must contain a `{sessionId}` placeholder. */
3023
+ /** @description Must contain a `{sessionId}` placeholder. Must be an http(s) URL. */
2761
3024
  verificationClientUrl: string;
2762
3025
  };
2763
3026
  /** @description Body for `POST /verifications/sessions/{sessionId}/events`. Status ping only — never carries the proof (use the result endpoint for that). */
@@ -2801,7 +3064,7 @@ export interface components {
2801
3064
  /** @description The event that produced this delivery. */
2802
3065
  event: components["schemas"]["VerificationEvent"];
2803
3066
  timestamp: components["schemas"]["Timestamp"];
2804
- /** @description Payload interpreted per `event`. Terminal events: the signed result — a **compact JWE** (RFC 7516, `ECDH-ES+A256GCM` over X25519) wrapping the signed JWS when the org has an encryption credential (decrypt with the matching X25519 private key to recover the inner JWS), else the JWS directly; the inner JWS parses as the `Jws` schema with payload `VerificationResultPayload`. Non-terminal events: plaintext JSON `{ event, eventData }` (unsigned). */
3067
+ /** @description Payload interpreted per `event`. Terminal events: the signed result — an **ECIES ciphertext** (base64url, secp256k1 + AES-256-GCM) wrapping the signed JWS when the org's `canEncryptResult` is enabled (decrypt with the matching eth private key to recover the inner JWS), else the JWS directly; the inner JWS parses as the `Jws` schema with payload `VerificationResultPayload`. Non-terminal events: plaintext JSON `{ event, eventData }` (unsigned). */
2805
3068
  data: string;
2806
3069
  };
2807
3070
  /** @description The decoded JWS payload of a delivered verification result (the JWS itself is the `Jws` schema, signed ES256K by the key published at `/.well-known/jwks.json`). Consumers MUST check `reclaimSessionId` against the session they created and `verification_session.status` for the outcome. `results` is present on success; `problem` (RFC 9457 shape) is set when the run failed. */
@@ -2820,8 +3083,13 @@ export interface components {
2820
3083
  verification_session: {
2821
3084
  /** @enum {string} */
2822
3085
  status: "success" | "rejected" | "error";
2823
- provider_id: components["schemas"]["ProviderID"];
2824
- resolved_version: string;
3086
+ /** @description The providers verified in this session, in run order. */
3087
+ providers: ({
3088
+ provider_id: components["schemas"]["ProviderID"];
3089
+ resolved_version: string;
3090
+ } & {
3091
+ [key: string]: unknown;
3092
+ })[];
2825
3093
  /** Format: uuid */
2826
3094
  org_id?: string | null;
2827
3095
  /** Format: uuid */
@@ -2830,19 +3098,26 @@ export interface components {
2830
3098
  } & {
2831
3099
  [key: string]: unknown;
2832
3100
  };
2833
- /** @description One entry per proven request (success only). */
3101
+ /** @description One entry per verified provider (success only), in run order. Each carries that provider's proven requests. */
2834
3102
  results?: ({
2835
- request_id?: string;
2836
- url?: string;
2837
- method?: string;
2838
- extracted_parameters?: {
3103
+ provider_id: components["schemas"]["ProviderID"];
3104
+ resolved_version: string;
3105
+ /** @description One entry per proven request for this provider. */
3106
+ requests: ({
3107
+ request_id?: string;
3108
+ url?: string;
3109
+ method?: string;
3110
+ extracted_parameters?: {
3111
+ [key: string]: unknown;
3112
+ };
3113
+ content_hash?: string;
3114
+ identifier?: string;
3115
+ owner?: string;
3116
+ /** @description Base64url-encoded nested JWS (attestor proof). */
3117
+ proof?: unknown;
3118
+ } & {
2839
3119
  [key: string]: unknown;
2840
- };
2841
- content_hash?: string;
2842
- identifier?: string;
2843
- owner?: string;
2844
- /** @description Base64url-encoded nested JWS (attestor proof). */
2845
- proof?: unknown;
3120
+ })[];
2846
3121
  } & {
2847
3122
  [key: string]: unknown;
2848
3123
  })[];
@@ -2853,18 +3128,18 @@ export interface components {
2853
3128
  } & {
2854
3129
  [key: string]: unknown;
2855
3130
  };
2856
- /** @description A callback subscription's delivery key, returned to the Verification Client. When `publicKeyJwk` is present the VC JWE-encrypts the result (ECDH-ES + A256GCM over X25519) for that org; when absent the VC submits the plaintext signed JWS. */
3131
+ /** @description A callback subscription's delivery key, returned to the Verification Client. When `publicKeyJwk` is present the VC ECIES-encrypts the result for that org (its `canEncryptResult` is enabled); when absent the VC submits the plaintext signed JWS. */
2857
3132
  CallbackKey: {
2858
3133
  /** Format: uuid */
2859
3134
  subscriptionId: string;
2860
- /** @description X25519 public JWK to JWE-encrypt the result to. Absent ⇒ deliver plaintext. */
2861
- publicKeyJwk?: components["schemas"]["JwkX25519Public"];
3135
+ /** @description The org's secp256k1 (eth) public JWK to ECIES-encrypt the result to. Absent ⇒ deliver plaintext. */
3136
+ publicKeyJwk?: components["schemas"]["JwkSecp256k1Public"];
2862
3137
  };
2863
- /** @description One result payload for one callback subscription. The Verification Client signs the JWS and, when the org has an encryption credential, JWE-encrypts it (ECDH-ES + A256GCM over X25519); otherwise it submits the plaintext JWS. Either way the payload is carried in `payload` and the Builder stores + delivers it as a blind relay. */
3138
+ /** @description One result payload for one callback subscription. The Verification Client signs the JWS and, when the org's `canEncryptResult` is enabled, ECIES-encrypts it to the org's eth public key; otherwise it submits the plaintext JWS. Either way the payload is carried in `payload` and the Builder stores + delivers it as a blind relay. */
2864
3139
  CallbackDelivery: {
2865
3140
  /** Format: uuid */
2866
3141
  subscriptionId: string;
2867
- /** @description The signed result payload, as raw text (no base64) — a compact JWE (ECDH-ES + A256GCM over X25519) when the org has an encryption credential, otherwise the plaintext JWS JSON. Same raw form the callback envelope's `data` carries. */
3142
+ /** @description The signed result payload, as raw text — an ECIES ciphertext (base64url) when the org's `canEncryptResult` is enabled, otherwise the plaintext JWS JSON. Same raw form the callback envelope's `data` carries. */
2868
3143
  payload: string;
2869
3144
  };
2870
3145
  /** @description Body for `POST /verifications/sessions/{sessionId}/result`. The Verification Client signs the JWS, encrypts it per callback subscription (keys fetched from the callback-keys endpoint), and submits one ciphertext per subscription. The Builder stores + delivers them; it never sees the plaintext result. */
@@ -3003,7 +3278,7 @@ export interface operations {
3003
3278
  Providers: {
3004
3279
  parameters: {
3005
3280
  query?: {
3006
- /** @description Free-text search across `title`, `description`, `domain`, `primaryDataPoint`, `dataPoints`, and the latest version's `initialUrl`. Matched case-insensitively; returns results ranked by relevance (e.g., data point matches rank higher than description matches). */
3281
+ /** @description Free-text search across `title`, `description`, `domain`, `primaryDataPoint`, `dataPoints`, and the latest version's `initialUrl`. Matched case-insensitively; returns results ranked by relevance (e.g., data point matches rank higher than description matches). An empty value is treated as no query (the handler redirects to the bare catalog). */
3007
3282
  q?: string;
3008
3283
  /** @description Filter by tag. Repeat the parameter to OR multiple tags (a provider matching any of them is returned). Combined with `q` via AND. */
3009
3284
  tag?: components["schemas"]["Tag"][];
@@ -3088,6 +3363,263 @@ export interface operations {
3088
3363
  default: components["responses"]["ProblemResponse"];
3089
3364
  };
3090
3365
  };
3366
+ DiscoverWebsites: {
3367
+ parameters: {
3368
+ query?: {
3369
+ /** @description Free-text query matched against website domain, data points, brand title, and description. Omit for the popular-websites list. */
3370
+ q?: string;
3371
+ };
3372
+ header?: never;
3373
+ path?: never;
3374
+ cookie?: never;
3375
+ };
3376
+ requestBody?: never;
3377
+ responses: {
3378
+ /** @description Website suggestions. */
3379
+ 200: {
3380
+ headers: {
3381
+ [name: string]: unknown;
3382
+ };
3383
+ content: {
3384
+ "application/json": {
3385
+ items: components["schemas"]["WebsiteSuggestion"][];
3386
+ };
3387
+ "text/html": components["schemas"]["HtmlContent"];
3388
+ };
3389
+ };
3390
+ default: components["responses"]["ProblemResponse"];
3391
+ };
3392
+ };
3393
+ SitePage: {
3394
+ parameters: {
3395
+ query?: {
3396
+ /** @description Case-insensitive substring filter on data-point names. Empty = no filter, so clearing the box doesn't need a client workaround. */
3397
+ q?: string;
3398
+ /** @description Currently selected data-point names — from a deep-link (the provider page's "Use provider") or the form's own htmx round-trips. Repeat to pass several; renders the summary panel and pre-checks the boxes. */
3399
+ dataPoints?: string[];
3400
+ /** @description Resolution mode reflected in the Continue URL. */
3401
+ mode?: "list" | "combine";
3402
+ /** @description Source pins from the form: `pins[<dataPoint>]=id,id`. Maps each data-point name to a comma-joined list of preferred providerIds (empty = Auto). */
3403
+ pins?: {
3404
+ [key: string]: string;
3405
+ };
3406
+ };
3407
+ header?: never;
3408
+ path: {
3409
+ /** @description Website domain (e.g. `github.com`). Normalized server-side (scheme / `www.` / port / path stripped). */
3410
+ domain: string;
3411
+ };
3412
+ cookie?: never;
3413
+ };
3414
+ requestBody?: never;
3415
+ responses: {
3416
+ /** @description The website's provable data points. */
3417
+ 200: {
3418
+ headers: {
3419
+ [name: string]: unknown;
3420
+ };
3421
+ content: {
3422
+ "application/json": {
3423
+ /** Format: hostname */
3424
+ domain: string;
3425
+ brandName: string;
3426
+ /** Format: uri */
3427
+ iconUrl?: string;
3428
+ dataPoints: components["schemas"]["DataPointItem"][];
3429
+ };
3430
+ "text/html": components["schemas"]["HtmlContent"];
3431
+ };
3432
+ };
3433
+ 404: components["responses"]["ProblemResponse"];
3434
+ default: components["responses"]["ProblemResponse"];
3435
+ };
3436
+ };
3437
+ SitePanel: {
3438
+ parameters: {
3439
+ query?: {
3440
+ /** @description Selected data-point names. Repeat to pass several. */
3441
+ dataPoints?: string[];
3442
+ /** @description Resolution mode reflected in the Continue URL. */
3443
+ mode?: "list" | "combine";
3444
+ /** @description Source pins from the form: `pins[<dataPoint>]=id,id`. Maps each data-point name to a comma-joined list of preferred providerIds (empty = Auto). */
3445
+ pins?: {
3446
+ [key: string]: string;
3447
+ };
3448
+ /** @description The data-point filter input rides along in the form submit; accepted and ignored here (the panel doesn't filter). */
3449
+ q?: string;
3450
+ };
3451
+ header?: never;
3452
+ path: {
3453
+ /** @description Website domain (normalized server-side). */
3454
+ domain: string;
3455
+ };
3456
+ cookie?: never;
3457
+ };
3458
+ requestBody?: never;
3459
+ responses: {
3460
+ /** @description The summary-panel fragment. */
3461
+ 200: {
3462
+ headers: {
3463
+ [name: string]: unknown;
3464
+ };
3465
+ content: {
3466
+ "text/html": components["schemas"]["HtmlContent"];
3467
+ };
3468
+ };
3469
+ 404: components["responses"]["ProblemResponse"];
3470
+ default: components["responses"]["ProblemResponse"];
3471
+ };
3472
+ };
3473
+ SiteBuild: {
3474
+ parameters: {
3475
+ query: {
3476
+ /** @description Selected data-point names. Repeat to pass several. */
3477
+ dataPoints: string[];
3478
+ /** @description `combine` (default) minimizes to the fewest providers (set-cover); `list` uses one provider per data point. */
3479
+ mode?: "list" | "combine";
3480
+ /** @description Source pins: `pins[<dataPoint>]=id,id`. Maps each data-point name to a comma-joined list of preferred providerIds. Omit for Auto. */
3481
+ pins?: {
3482
+ [key: string]: string;
3483
+ };
3484
+ /** @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`. */
3485
+ provided?: string[];
3486
+ };
3487
+ header?: never;
3488
+ path: {
3489
+ /** @description Website domain (normalized server-side). */
3490
+ domain: string;
3491
+ };
3492
+ cookie?: never;
3493
+ };
3494
+ requestBody?: never;
3495
+ responses: {
3496
+ /** @description The build page. */
3497
+ 200: {
3498
+ headers: {
3499
+ [name: string]: unknown;
3500
+ };
3501
+ content: {
3502
+ "text/html": components["schemas"]["HtmlContent"];
3503
+ };
3504
+ };
3505
+ 404: components["responses"]["ProblemResponse"];
3506
+ default: components["responses"]["ProblemResponse"];
3507
+ };
3508
+ };
3509
+ SiteBuildTry: {
3510
+ parameters: {
3511
+ query: {
3512
+ /** @description Selected data-point names. Repeat to pass several. */
3513
+ dataPoints: string[];
3514
+ /** @description Resolution mode (`combine` default | `list`). */
3515
+ mode?: "list" | "combine";
3516
+ /** @description Source pins: `pins[<dataPoint>]=id,id`. Maps each data-point name to a comma-joined list of preferred providerIds. */
3517
+ pins?: {
3518
+ [key: string]: string;
3519
+ };
3520
+ /** @description Data-point names the consumer supplies themselves (as `context`) instead of proving. Repeat to pass several. Subset of `dataPoints`. */
3521
+ provided?: string[];
3522
+ };
3523
+ header?: never;
3524
+ path: {
3525
+ /** @description Website domain (normalized server-side). */
3526
+ domain: string;
3527
+ };
3528
+ cookie?: never;
3529
+ };
3530
+ /** @description The verification `context` — values for the resolved providers' requiredContext inputs (the build page's input fields). The selection itself travels in the query string. */
3531
+ requestBody?: {
3532
+ content: {
3533
+ "application/x-www-form-urlencoded": components["schemas"]["SiteBuildTryBody"];
3534
+ "application/json": components["schemas"]["SiteBuildTryBody"];
3535
+ };
3536
+ };
3537
+ responses: {
3538
+ /** @description Session created. */
3539
+ 201: {
3540
+ headers: {
3541
+ [name: string]: unknown;
3542
+ };
3543
+ content: {
3544
+ "application/json": components["schemas"]["VerificationSession"];
3545
+ };
3546
+ };
3547
+ 401: components["responses"]["ProblemResponse"];
3548
+ /** @description One or more selected data points are not covered by any provider. */
3549
+ 422: {
3550
+ headers: {
3551
+ [name: string]: unknown;
3552
+ };
3553
+ content: {
3554
+ "application/problem+json": components["schemas"]["Problem"];
3555
+ };
3556
+ };
3557
+ /** @description Sandbox verification quota exceeded. */
3558
+ 429: {
3559
+ headers: {
3560
+ [name: string]: unknown;
3561
+ };
3562
+ content: {
3563
+ "application/problem+json": components["schemas"]["Problem"];
3564
+ };
3565
+ };
3566
+ default: components["responses"]["ProblemResponse"];
3567
+ };
3568
+ };
3569
+ DiscoverTeachAgent: {
3570
+ parameters: {
3571
+ query?: {
3572
+ /** @description Website the user wanted to verify data from. */
3573
+ domain?: string;
3574
+ /** @description Specific data point the user could not find. */
3575
+ dataPoint?: string;
3576
+ };
3577
+ header?: never;
3578
+ path?: never;
3579
+ cookie?: never;
3580
+ };
3581
+ requestBody?: never;
3582
+ responses: {
3583
+ 200: components["responses"]["HTMLResponse"];
3584
+ default: components["responses"]["ProblemResponse"];
3585
+ };
3586
+ };
3587
+ DiscoverResolve: {
3588
+ parameters: {
3589
+ query: {
3590
+ /** @description Website domain (normalized server-side). */
3591
+ domain: string;
3592
+ /** @description Selected data-point names. Repeat to pass several. */
3593
+ dataPoints: string[];
3594
+ };
3595
+ header?: never;
3596
+ path?: never;
3597
+ cookie?: never;
3598
+ };
3599
+ requestBody?: never;
3600
+ responses: {
3601
+ /** @description Covering providers (possibly none). */
3602
+ 200: {
3603
+ headers: {
3604
+ [name: string]: unknown;
3605
+ };
3606
+ content: {
3607
+ "application/json": {
3608
+ /** @description The most specific covering provider's id, if any — a convenience for the common single-provider case. */
3609
+ providerId?: components["schemas"]["ProviderID"];
3610
+ /** @description True when no existing provider covers the full selection (a new one must be created/stitched). */
3611
+ needsCreation: boolean;
3612
+ providers: {
3613
+ providerId: components["schemas"]["ProviderID"];
3614
+ slug: string;
3615
+ dataPoints: string[];
3616
+ }[];
3617
+ };
3618
+ };
3619
+ };
3620
+ default: components["responses"]["ProblemResponse"];
3621
+ };
3622
+ };
3091
3623
  ProviderPreviewImage: {
3092
3624
  parameters: {
3093
3625
  query?: {
@@ -3475,6 +4007,27 @@ export interface operations {
3475
4007
  default: components["responses"]["ProblemResponse"];
3476
4008
  };
3477
4009
  };
4010
+ DisposeVerificationSession: {
4011
+ parameters: {
4012
+ query?: never;
4013
+ header?: never;
4014
+ path: {
4015
+ sessionId: components["schemas"]["SessionID"];
4016
+ };
4017
+ cookie?: never;
4018
+ };
4019
+ requestBody?: never;
4020
+ responses: {
4021
+ /** @description Dispose requested. */
4022
+ 204: {
4023
+ headers: {
4024
+ [name: string]: unknown;
4025
+ };
4026
+ content?: never;
4027
+ };
4028
+ default: components["responses"]["ProblemResponse"];
4029
+ };
4030
+ };
3478
4031
  VerificationSessionSse: {
3479
4032
  parameters: {
3480
4033
  query?: never;
@@ -3655,31 +4208,6 @@ export interface operations {
3655
4208
  default: components["responses"]["ProblemResponse"];
3656
4209
  };
3657
4210
  };
3658
- UpdateMe: {
3659
- parameters: {
3660
- query?: never;
3661
- header?: never;
3662
- path?: never;
3663
- cookie?: never;
3664
- };
3665
- requestBody: {
3666
- content: {
3667
- "application/json": components["schemas"]["UpdateUserRequest"];
3668
- };
3669
- };
3670
- responses: {
3671
- /** @description Updated */
3672
- 200: {
3673
- headers: {
3674
- [name: string]: unknown;
3675
- };
3676
- content: {
3677
- "application/json": components["schemas"]["User"];
3678
- };
3679
- };
3680
- default: components["responses"]["ProblemResponse"];
3681
- };
3682
- };
3683
4211
  GetUser: {
3684
4212
  parameters: {
3685
4213
  query?: never;
@@ -3759,7 +4287,10 @@ export interface operations {
3759
4287
  };
3760
4288
  GetOrg: {
3761
4289
  parameters: {
3762
- query?: never;
4290
+ query?: {
4291
+ /** @description Which section to show (server-rendered tab); unknown values fall back to the first. */
4292
+ tab?: "connect" | "providers" | "members" | "themes" | "sessions" | "billing";
4293
+ };
3763
4294
  header?: never;
3764
4295
  path: {
3765
4296
  orgId: components["schemas"]["OrgID"];
@@ -3832,6 +4363,32 @@ export interface operations {
3832
4363
  default: components["responses"]["ProblemResponse"];
3833
4364
  };
3834
4365
  };
4366
+ SearchOrgMembers: {
4367
+ parameters: {
4368
+ query?: {
4369
+ /** @description Case-insensitive email substring to filter by. */
4370
+ q?: string;
4371
+ };
4372
+ header?: never;
4373
+ path: {
4374
+ orgId: components["schemas"]["OrgID"];
4375
+ };
4376
+ cookie?: never;
4377
+ };
4378
+ requestBody?: never;
4379
+ responses: {
4380
+ /** @description The members-list fragment. */
4381
+ 200: {
4382
+ headers: {
4383
+ [name: string]: unknown;
4384
+ };
4385
+ content: {
4386
+ "text/html": components["schemas"]["HtmlContent"];
4387
+ };
4388
+ };
4389
+ default: components["responses"]["ProblemResponse"];
4390
+ };
4391
+ };
3835
4392
  AddOrgMember: {
3836
4393
  parameters: {
3837
4394
  query?: never;
@@ -4105,7 +4662,7 @@ export interface operations {
4105
4662
  default: components["responses"]["ProblemResponse"];
4106
4663
  };
4107
4664
  };
4108
- GetOrgCredential: {
4665
+ GetOrgKeypair: {
4109
4666
  parameters: {
4110
4667
  query?: never;
4111
4668
  header?: never;
@@ -4122,7 +4679,7 @@ export interface operations {
4122
4679
  [name: string]: unknown;
4123
4680
  };
4124
4681
  content: {
4125
- "application/json": components["schemas"]["OrgCredential"];
4682
+ "application/json": components["schemas"]["OrgKeypair"];
4126
4683
  };
4127
4684
  };
4128
4685
  403: components["responses"]["ForbiddenResponse"];
@@ -4130,7 +4687,7 @@ export interface operations {
4130
4687
  default: components["responses"]["ProblemResponse"];
4131
4688
  };
4132
4689
  };
4133
- SetOrgCredential: {
4690
+ SetOrgKeypair: {
4134
4691
  parameters: {
4135
4692
  query?: never;
4136
4693
  header?: never;
@@ -4141,7 +4698,7 @@ export interface operations {
4141
4698
  };
4142
4699
  requestBody: {
4143
4700
  content: {
4144
- "application/json": components["schemas"]["OrgCredentialRequest"];
4701
+ "application/json": components["schemas"]["OrgKeypairRequest"];
4145
4702
  };
4146
4703
  };
4147
4704
  responses: {
@@ -4151,7 +4708,7 @@ export interface operations {
4151
4708
  [name: string]: unknown;
4152
4709
  };
4153
4710
  content: {
4154
- "application/json": components["schemas"]["OrgCredential"];
4711
+ "application/json": components["schemas"]["OrgKeypair"];
4155
4712
  };
4156
4713
  };
4157
4714
  400: components["responses"]["ProblemResponse"];
@@ -4159,7 +4716,7 @@ export interface operations {
4159
4716
  default: components["responses"]["ProblemResponse"];
4160
4717
  };
4161
4718
  };
4162
- DeleteOrgCredential: {
4719
+ DeleteOrgKeypair: {
4163
4720
  parameters: {
4164
4721
  query?: never;
4165
4722
  header?: never;
@@ -4380,6 +4937,29 @@ export interface operations {
4380
4937
  default: components["responses"]["ProblemResponse"];
4381
4938
  };
4382
4939
  };
4940
+ AttachLanding: {
4941
+ parameters: {
4942
+ query?: {
4943
+ /** @description A submitted pairing code; redirects to `/attach/{code}`. */
4944
+ code?: string;
4945
+ };
4946
+ header?: never;
4947
+ path?: never;
4948
+ cookie?: never;
4949
+ };
4950
+ requestBody?: never;
4951
+ responses: {
4952
+ 200: components["responses"]["HTMLResponse"];
4953
+ /** @description Redirect to the canonical `/attach/{code}` URL. */
4954
+ 302: {
4955
+ headers: {
4956
+ [name: string]: unknown;
4957
+ };
4958
+ content?: never;
4959
+ };
4960
+ default: components["responses"]["ProblemResponse"];
4961
+ };
4962
+ };
4383
4963
  AttachPage: {
4384
4964
  parameters: {
4385
4965
  query?: never;
@@ -5237,9 +5817,18 @@ export interface operations {
5237
5817
  };
5238
5818
  content: {
5239
5819
  "application/json": {
5240
- initialUrl: string;
5241
- requests: {
5242
- [key: string]: unknown;
5820
+ /** @description One recipe per session provider, in run order. */
5821
+ recipes: {
5822
+ providerId: components["schemas"]["ProviderID"];
5823
+ resolvedVersion: string;
5824
+ initialUrl: string;
5825
+ /** @description The version's webSettings geoLocation template (`{{DYNAMIC_GEO}}` / '' / ISO code), applied to this provider's requests. */
5826
+ geoLocation?: string;
5827
+ /** @description The version's webSettings.jsUserScripts — page JavaScript the Verification Client installs to run before every page load (before navigating to initialUrl), to drive login/navigation so the target requests fire. */
5828
+ jsUserScripts?: string;
5829
+ requests: {
5830
+ [key: string]: unknown;
5831
+ }[];
5243
5832
  }[];
5244
5833
  };
5245
5834
  };
@@ -5383,7 +5972,7 @@ export interface operations {
5383
5972
  /** Format: uuid */
5384
5973
  subscriptionId: string;
5385
5974
  event: components["schemas"]["VerificationEvent"];
5386
- /** @description The result payload, as raw text (no base64): a compact JWE (RFC 7516, ECDH-ES+A256GCM over X25519) wrapping the signed result JWS when the org has an encryption credential, else the plaintext signed JWS JSON. */
5975
+ /** @description The result payload, as raw text: an ECIES ciphertext (base64url) wrapping the signed result JWS when the org's `canEncryptResult` is enabled, else the plaintext signed JWS JSON. */
5387
5976
  payload: string;
5388
5977
  deliveryStatus: components["schemas"]["CallbackDeliveryStatus"];
5389
5978
  createdAt: components["schemas"]["Timestamp"];