weft-sdk 0.9.1 → 0.14.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90961e9b0a274edab597a57dcccfa99ddb4be6d276dae6e9aaabdeae0637c05e
-  data.tar.gz: d8e4e02bbff40abbe6f05de86b790dece9a89694a1b1d0cf62b42c76c0ba3cf1
+  metadata.gz: f8f3c4ab682b8f77dcd1f610b4c57ba7afb7ab4e7dc6d1be4f2225b6efb45a92
+  data.tar.gz: 5b9582a8d977a9dadc4e8e37061b19eaaeb6fb343d93f3214c812a20764c9425
 SHA512:
-  metadata.gz: a9788d2dbb714a9518de4e884891e4f450a78d4477e164f790592b6be2a72acfde42f8322fc8cf6b579cd85701fe8236d2541f030eb436f1767dfbeab81dfdfd
-  data.tar.gz: 0ecf39370784d1bcb0a41a339aa3fac634a37024b052f6f1396bf92372c2513b8f7bad78df646ca2475936597b65607abf92b13ff66141d50ec22fe12c21a021
+  metadata.gz: 769a73ba75bb46b94dbfb0ed383dfc44d7a9ff707fe87ac58bb1a73fbca02c4dfc058a5b7db3209b6d04c575249be068b2896ae1bc0b69df50a93d0e585756ce
+  data.tar.gz: 3ffd63792808c022c9bcc2f2ff55003275880a144a2dd99f202acaed01c622d40c7baa0875e293e570c1167626b733eb25acedfff8b4fcc5d2b3a910974665df

data/docs/APIKeysApi.md

@@ -15,6 +15,8 @@ All URIs are relative to *https://weft.network*
 
 Create an API key
 
+Create an `ax_live_*` resource key for the authenticated seller Organization. Buyer `wk_*` keys are created in the buyer dashboard.
+
 ### Examples
 
 ```ruby
@@ -82,6 +84,8 @@ end
 
 List API keys
 
+List `ax_live_*` resource keys for the seller Organization.
+
 ### Examples
 
 ```ruby

data/docs/AccountApi.md

@@ -13,7 +13,7 @@ All URIs are relative to *https://weft.network*
 
 Get the current credential principal
 
-Returns the Organization represented by a resource API key, or the User represented by an account API key or OAuth access token. Branch on `data.principal_type`; existing Organization fields remain unchanged.
+Returns the seller Organization represented by an `ax_live_*` resource key, or the buyer User represented by a `wk_*` account key, OAuth access token, or claimed `wbt_*` bearer. Branch on `data.principal_type`.
 
 ### Examples
 

data/docs/AccountBootstrapApproval.md

@@ -0,0 +1,21 @@
+# Weft::AccountBootstrapApproval
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **method** | **String** |  |  |
+| **expires_in** | **Integer** |  |  |
+| **interval** | **Integer** | Minimum status polling interval in seconds. |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::AccountBootstrapApproval.new(
+  method: null,
+  expires_in: null,
+  interval: null
+)
+```

data/docs/AccountBootstrapCreated.md

@@ -0,0 +1,29 @@
+# Weft::AccountBootstrapCreated
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **status** | **String** |  |  |
+| **capabilities** | **Array<String>** |  |  |
+| **expires_at** | **Time** | Claim-window expiry. Null after the credential is promoted. |  |
+| **approval** | [**AccountBootstrapCreatedApproval**](AccountBootstrapCreatedApproval.md) |  |  |
+| **temporary_api_key** | **String** | Returned once. Store as a secret; it cannot be recovered. |  |
+| **device_code** | **String** | Transitional response field for older CLI releases that use OAuth device exchange. | [optional] |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::AccountBootstrapCreated.new(
+  id: null,
+  status: null,
+  capabilities: null,
+  expires_at: null,
+  approval: null,
+  temporary_api_key: null,
+  device_code: null
+)
+```

data/docs/AccountBootstrapCreatedApproval.md

@@ -0,0 +1,23 @@
+# Weft::AccountBootstrapCreatedApproval
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **method** | **String** |  |  |
+| **expires_in** | **Integer** |  |  |
+| **interval** | **Integer** | Minimum status polling interval in seconds. |  |
+| **user_code** | **String** | Show this code to the human; approval requires a matching normalized code. |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::AccountBootstrapCreatedApproval.new(
+  method: null,
+  expires_in: null,
+  interval: null,
+  user_code: null
+)
+```

data/docs/AccountBootstrapCreatedResponse.md

@@ -0,0 +1,17 @@
+# Weft::AccountBootstrapCreatedResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**AccountBootstrapCreated**](AccountBootstrapCreated.md) |  |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::AccountBootstrapCreatedResponse.new(
+  data: null
+)
+```

data/docs/AccountBootstrapRequest.md

@@ -0,0 +1,27 @@
+# Weft::AccountBootstrapRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **email** | **String** |  |  |
+| **agent_name** | **String** |  |  |
+| **host_name** | **String** |  | [optional] |
+| **reason** | **String** |  | [optional] |
+| **oauth_client_id** | **String** | Transitional compatibility for older CLI releases that use OAuth device exchange. | [optional] |
+| **requested_scopes** | **Array<String>** | Transitional compatibility for older CLI releases that use OAuth device exchange. | [optional] |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::AccountBootstrapRequest.new(
+  email: null,
+  agent_name: null,
+  host_name: null,
+  reason: null,
+  oauth_client_id: null,
+  requested_scopes: null
+)
+```

data/docs/AccountBootstrapStatus.md

@@ -0,0 +1,25 @@
+# Weft::AccountBootstrapStatus
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **status** | **String** |  |  |
+| **capabilities** | **Array<String>** |  |  |
+| **expires_at** | **Time** | Claim-window expiry. Null after the credential is promoted. |  |
+| **approval** | [**AccountBootstrapApproval**](AccountBootstrapApproval.md) |  |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::AccountBootstrapStatus.new(
+  id: null,
+  status: null,
+  capabilities: null,
+  expires_at: null,
+  approval: null
+)
+```

data/docs/AccountBootstrapStatusResponse.md

@@ -0,0 +1,17 @@
+# Weft::AccountBootstrapStatusResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**AccountBootstrapStatus**](AccountBootstrapStatus.md) |  |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::AccountBootstrapStatusResponse.new(
+  data: null
+)
+```

data/docs/AgentBootstrapApi.md

@@ -0,0 +1,209 @@
+# Weft::AgentBootstrapApi
+
+All URIs are relative to *https://weft.network*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**cancel_account_bootstrap**](AgentBootstrapApi.md#cancel_account_bootstrap) | **DELETE** /api/v1/account_bootstraps/{id} | Cancel or revoke a bootstrap credential |
+| [**create_account_bootstrap**](AgentBootstrapApi.md#create_account_bootstrap) | **POST** /api/v1/account_bootstraps | Create a temporary agent bootstrap |
+| [**get_account_bootstrap**](AgentBootstrapApi.md#get_account_bootstrap) | **GET** /api/v1/account_bootstraps/{id} | Read bootstrap lifecycle status |
+
+
+## cancel_account_bootstrap
+
+> <AccountBootstrapStatusResponse> cancel_account_bootstrap(id)
+
+Cancel or revoke a bootstrap credential
+
+A pending bootstrap becomes rejected. A claimed promoted credential becomes revoked and fails every subsequent request immediately.
+
+### Examples
+
+```ruby
+require 'time'
+require 'weft-sdk'
+# setup authorization
+Weft.configure do |config|
+  # Configure Bearer authorization (BootstrapToken): bootstrapAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Weft::AgentBootstrapApi.new
+id = 'id_example' # String |
+
+begin
+  # Cancel or revoke a bootstrap credential
+  result = api_instance.cancel_account_bootstrap(id)
+  p result
+rescue Weft::ApiError => e
+  puts "Error when calling AgentBootstrapApi->cancel_account_bootstrap: #{e}"
+end
+```
+
+#### Using the cancel_account_bootstrap_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<AccountBootstrapStatusResponse>, Integer, Hash)> cancel_account_bootstrap_with_http_info(id)
+
+```ruby
+begin
+  # Cancel or revoke a bootstrap credential
+  data, status_code, headers = api_instance.cancel_account_bootstrap_with_http_info(id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <AccountBootstrapStatusResponse>
+rescue Weft::ApiError => e
+  puts "Error when calling AgentBootstrapApi->cancel_account_bootstrap_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+
+### Return type
+
+[**AccountBootstrapStatusResponse**](AccountBootstrapStatusResponse.md)
+
+### Authorization
+
+[bootstrapAuth](../README.md#bootstrapAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## create_account_bootstrap
+
+> <AccountBootstrapCreatedResponse> create_account_bootstrap(account_bootstrap_request)
+
+Create a temporary agent bootstrap
+
+Creates a 30-minute, search-only bootstrap and emails a separate claim link to the supplied address. Human approval binds the same `wbt_*` bearer to the account and promotes it to the fixed durable capability set. The response is deliberately identical for new and existing account emails and never contains the claim token. Rate limits apply per IP and normalized email; request bodies over 4 KiB are rejected before parsing. The bootstrap row and one-time credentials are committed only after the mail relay accepts the claim email. A retryable 503 leaves no bootstrap row behind.
+
+### Examples
+
+```ruby
+require 'time'
+require 'weft-sdk'
+
+api_instance = Weft::AgentBootstrapApi.new
+account_bootstrap_request = Weft::AccountBootstrapRequest.new({email: 'email_example', agent_name: 'agent_name_example'}) # AccountBootstrapRequest |
+
+begin
+  # Create a temporary agent bootstrap
+  result = api_instance.create_account_bootstrap(account_bootstrap_request)
+  p result
+rescue Weft::ApiError => e
+  puts "Error when calling AgentBootstrapApi->create_account_bootstrap: #{e}"
+end
+```
+
+#### Using the create_account_bootstrap_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<AccountBootstrapCreatedResponse>, Integer, Hash)> create_account_bootstrap_with_http_info(account_bootstrap_request)
+
+```ruby
+begin
+  # Create a temporary agent bootstrap
+  data, status_code, headers = api_instance.create_account_bootstrap_with_http_info(account_bootstrap_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <AccountBootstrapCreatedResponse>
+rescue Weft::ApiError => e
+  puts "Error when calling AgentBootstrapApi->create_account_bootstrap_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_bootstrap_request** | [**AccountBootstrapRequest**](AccountBootstrapRequest.md) |  |  |
+
+### Return type
+
+[**AccountBootstrapCreatedResponse**](AccountBootstrapCreatedResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## get_account_bootstrap
+
+> <AccountBootstrapStatusResponse> get_account_bootstrap(id)
+
+Read bootstrap lifecycle status
+
+### Examples
+
+```ruby
+require 'time'
+require 'weft-sdk'
+# setup authorization
+Weft.configure do |config|
+  # Configure Bearer authorization (BootstrapToken): bootstrapAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Weft::AgentBootstrapApi.new
+id = 'id_example' # String |
+
+begin
+  # Read bootstrap lifecycle status
+  result = api_instance.get_account_bootstrap(id)
+  p result
+rescue Weft::ApiError => e
+  puts "Error when calling AgentBootstrapApi->get_account_bootstrap: #{e}"
+end
+```
+
+#### Using the get_account_bootstrap_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<AccountBootstrapStatusResponse>, Integer, Hash)> get_account_bootstrap_with_http_info(id)
+
+```ruby
+begin
+  # Read bootstrap lifecycle status
+  data, status_code, headers = api_instance.get_account_bootstrap_with_http_info(id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <AccountBootstrapStatusResponse>
+rescue Weft::ApiError => e
+  puts "Error when calling AgentBootstrapApi->get_account_bootstrap_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+
+### Return type
+
+[**AccountBootstrapStatusResponse**](AccountBootstrapStatusResponse.md)
+
+### Authorization
+
+[bootstrapAuth](../README.md#bootstrapAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json

data/docs/BalanceApi.md

@@ -13,7 +13,7 @@ All URIs are relative to *https://weft.network*
 
 Get wallet, spending policy, and current-window spend
 
-Read-only snapshot for the buyer behind the bearer token. The response always includes a `promo` block — values are zero in v1 and fill in once the freemium promo ledger ships, without a shape change. `wallet.balance_usdc` is fetched live from Privy; if Privy is unreachable the field returns `\"0.00\"` rather than erroring the whole call.  Account-scoped: the bearer must be a buyer-scoped API key.
+Read-only snapshot for the buyer behind the bearer token. The response always includes a `promo` block — values are zero in v1 and fill in once the freemium promo ledger ships, without a shape change. Base USDC and Tempo balances are fetched server-side through Crossmint. If Crossmint is unreachable, the balance fields are `null`; consumers must not interpret that as zero.  Account-scoped: the bearer must be a buyer-scoped API key, an OAuth access token carrying `balance`, or a claimed `wbt_*` bearer.
 
 ### Examples
 

data/docs/CuratedMarketplaceContract.md

@@ -0,0 +1,31 @@
+# Weft::CuratedMarketplaceContract
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **schema_version** | **Integer** |  |  |
+| **snapshot** | **Hash<String, Object>** |  |  |
+| **provider** | **Hash<String, Object>** |  |  |
+| **service** | **Hash<String, Object>** |  |  |
+| **operation** | **Hash<String, Object>** |  |  |
+| **request** | **Hash<String, Object>** |  |  |
+| **access_methods** | **Array<Hash<String, Object>>** |  |  |
+| **evidence** | **Array<Hash<String, Object>>** |  |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::CuratedMarketplaceContract.new(
+  schema_version: null,
+  snapshot: null,
+  provider: null,
+  service: null,
+  operation: null,
+  request: null,
+  access_methods: null,
+  evidence: null
+)
+```

data/docs/FetchApi.md

@@ -13,7 +13,7 @@ All URIs are relative to *https://weft.network*
 
 Pay-and-fetch any URL (x402 proxy)
 
-Universal x402 fetch proxy. The caller provides a target `url`, a hard `max_cost_usd` ceiling, and optional `method` / `body` / `headers`. Weft:    1. Issues the request.   2. On `402 Payment Required`, parses the merchant's challenge.   3. Compares the asking price to `max_cost_usd` and the      buyer's policy (`max_tx_usd`, daily/weekly limits).   4. Signs an EIP-3009 transfer from the buyer's wallet.   5. Replays the request with the `X-Payment` header.   6. Streams the upstream artifact back, base64-encoded under      `body_base64`, with `paid_usd`, `held_usd`, `payment_status`,      `tx_hash`, and the merchant's reputation snapshot. `paid_usd`      is \"0.00\" until the charge is CONFIRMED settled — a signed-but-      unsettled hold (the common case for x402, which settles      asynchronously) reports its amount in `held_usd` instead, never      in `paid_usd`.  Errors are structured with a stable `error` code, and each error response carries the buyer's `policy`, `balance`, and a `dashboard_url` so a CLI can render an actionable message without a second round-trip.  Account-scoped: the bearer must be a buyer-scoped API key.  **Forwarded headers:** the caller's `headers` are passed through to the upstream, except a denylist of hop-by-hop and Weft-internal headers (`host`, `authorization`, `cookie`, `proxy-authorization`, `x-forwarded-*`, `x-real-ip`, `x-payment`, `connection`, `upgrade`). Up to 32 headers, 4 KB of combined value bytes.
+Universal x402 fetch proxy. The caller provides a target `url`, a hard `max_cost_usd` ceiling, and optional `method` / `body` / `headers`. Weft:    1. Issues the request.   2. On `402 Payment Required`, parses the merchant's challenge.   3. Compares the asking price to `max_cost_usd` and the      buyer's policy (`max_tx_usd`, daily/weekly limits).   4. Signs an EIP-3009 transfer from the buyer's wallet.   5. Replays the request with the `X-Payment` header.   6. Streams the upstream artifact back, base64-encoded under      `body_base64`, with `paid_usd`, `held_usd`, `payment_status`,      `tx_hash`, and the merchant's reputation snapshot. `paid_usd`      is \"0.00\" until the charge is CONFIRMED settled — a signed-but-      unsettled hold (the common case for x402, which settles      asynchronously) reports its amount in `held_usd` instead, never      in `paid_usd`.  Errors are structured with a stable `error` code, and each error response carries the buyer's `policy`, `balance`, and a `dashboard_url` so a CLI can render an actionable message without a second round-trip.  Account-scoped: the bearer must be a buyer-scoped API key, an OAuth access token carrying `fetch`, or a claimed `wbt_*` bearer.  **Forwarded headers:** the caller's `headers` are passed through to the upstream, except a denylist of hop-by-hop and Weft-internal headers (`host`, `authorization`, `cookie`, `proxy-authorization`, `x-forwarded-*`, `x-real-ip`, `x-payment`, `connection`, `upgrade`). Up to 32 headers, 4 KB of combined value bytes.
 
 ### Examples
 

data/docs/FetchBalanceSnapshot.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **promo_usd** | **String** |  |  |
-| **wallet_usdc** | **String** | Live Base USDC balance. |  |
+| **wallet_usdc** | **String** | Live Base USDC balance read server-side through Crossmint. Null when Crossmint is unavailable; never treat null as zero.  |  |
 | **tempo_usd** | **String** | Aggregated USD of allowlisted Tempo dollar tokens, exact to the micro-dollar. `null` when UNKNOWN (RPC read failed or no token allowlisted for the paired chain) — never \"0.00\" for an unread component.  |  |
 | **total_usd** | **String** | Aggregated USD balance = Base USDC + Tempo dollar tokens, exact to the micro-dollar. Equals `wallet_usdc` alone when `tempo_usd` is null. Null when the Base USDC provider is unreachable.  |  |
 | **spent_today_usd** | **String** |  |  |

data/docs/FetchRequest.md

@@ -9,6 +9,9 @@
 | **method** | **String** | HTTP method to use against the upstream. | [optional][default to 'GET'] |
 | **body** | [**FetchRequestBody**](FetchRequestBody.md) |  | [optional] |
 | **headers** | **Hash<String, String>** | Headers forwarded to the upstream. Up to 32 headers, 4 KB total. The following are silently stripped: `host`, `authorization`, `cookie`, `proxy-authorization`, `x-forwarded-*`, `x-real-ip`, `x-payment`, `connection`, `upgrade`.  | [optional] |
+| **search_id** | **String** | The `query_trace_id` from the `POST /api/v1/search` response that surfaced this URL. Optional and advisory: it attributes the purchase to the search that found it, and is used only for measurement.  It never affects payment, authorization, idempotency, or the response body — the buyer is always resolved from the credential, never from this field. A value that is not a well-formed handle is ignored rather than rejected, so an analytics mistake can never cost a fetch.  | [optional] |
+| **operation_id** | **String** | Advisory operation id returned by search. | [optional] |
+| **access_method_id** | **String** | Advisory access-method id returned by search. | [optional] |
 
 ## Example
 
@@ -20,6 +23,9 @@ instance = Weft::FetchRequest.new(
   max_cost_usd: 0.05,
   method: null,
   body: null,
-  headers: {Accept=application/json, User-Agent=my-agent/1.0}
+  headers: {Accept=application/json, User-Agent=my-agent/1.0},
+  search_id: 11111111-1111-4111-8111-111111111111,
+  operation_id: null,
+  access_method_id: null
 )
 ```

data/docs/RateLimitResponse.md

@@ -0,0 +1,19 @@
+# Weft::RateLimitResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **error** | **String** |  |  |
+| **error_description** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::RateLimitResponse.new(
+  error: null,
+  error_description: null
+)
+```

data/docs/SearchAccessMethod.md

@@ -0,0 +1,37 @@
+# Weft::SearchAccessMethod
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **access_method_id** | **String** |  |  |
+| **protocol** | **String** |  |  |
+| **scheme** | **String** |  | [optional] |
+| **network** | **String** |  | [optional] |
+| **asset** | **String** |  | [optional] |
+| **asset_decimals** | **Integer** |  | [optional] |
+| **price** | **Object** |  |  |
+| **merchant** | **Object** |  | [optional] |
+| **terms** | **Object** |  | [optional] |
+| **status** | **String** |  | [optional] |
+| **weft_fetch** | [**SearchWeftFetchCompatibility**](SearchWeftFetchCompatibility.md) |  |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SearchAccessMethod.new(
+  access_method_id: null,
+  protocol: null,
+  scheme: null,
+  network: null,
+  asset: null,
+  asset_decimals: null,
+  price: null,
+  merchant: null,
+  terms: null,
+  status: null,
+  weft_fetch: null
+)
+```

data/docs/SearchApi.md

@@ -4,16 +4,83 @@ All URIs are relative to *https://weft.network*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**get_curated_marketplace_contract**](SearchApi.md#get_curated_marketplace_contract) | **GET** /contracts/curated-marketplace/{digest}/{operation_id}.json | Get a curated marketplace operation contract |
 | [**search**](SearchApi.md#search) | **POST** /api/v1/search | Search the Weft index |
 
 
+## get_curated_marketplace_contract
+
+> <CuratedMarketplaceContract> get_curated_marketplace_contract(digest, operation_id)
+
+Get a curated marketplace operation contract
+
+Public, content-addressed detail document linked from compact hosted-MCP search results. A matching document is cacheable for one year and immutable. The digest is the SHA-256 of the canonical JSON document. Every reviewed endpoint includes its request and response evidence; asynchronous endpoints also include the authored submit-and-poll lifecycle, identity-header reuse, terminal states, and known gaps.
+
+### Examples
+
+```ruby
+require 'time'
+require 'weft-sdk'
+
+api_instance = Weft::SearchApi.new
+digest = 'digest_example' # String |
+operation_id = 'operation_id_example' # String |
+
+begin
+  # Get a curated marketplace operation contract
+  result = api_instance.get_curated_marketplace_contract(digest, operation_id)
+  p result
+rescue Weft::ApiError => e
+  puts "Error when calling SearchApi->get_curated_marketplace_contract: #{e}"
+end
+```
+
+#### Using the get_curated_marketplace_contract_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<CuratedMarketplaceContract>, Integer, Hash)> get_curated_marketplace_contract_with_http_info(digest, operation_id)
+
+```ruby
+begin
+  # Get a curated marketplace operation contract
+  data, status_code, headers = api_instance.get_curated_marketplace_contract_with_http_info(digest, operation_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <CuratedMarketplaceContract>
+rescue Weft::ApiError => e
+  puts "Error when calling SearchApi->get_curated_marketplace_contract_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **digest** | **String** |  |  |
+| **operation_id** | **String** |  |  |
+
+### Return type
+
+[**CuratedMarketplaceContract**](CuratedMarketplaceContract.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## search
 
 > <SearchResponse> search(search_request)
 
 Search the Weft index
 
-Semantic search over the Weft index of paid agent resources. The request body is the weft-search-platform `/v1/search` contract: a free-text `query`, optional `max_results`, and optional structured `filters` (price / price_atomic / type / protocol — the canonical FilterSpec v1 vocabulary, vendored verbatim from the platform). Price is a dual representation of one constraint: `price` in USD decimal strings (the reasoning form) XOR `price_atomic` in integer micro-USD (the settlement form) — mutually exclusive, set at most one.  Backend selection is server-side via the `SEARCH_BACKEND` env var: `mock` (default, reads YAML fixtures and sets `_mock: true` in the response) or `platform` (proxies to the upstream search service). Both backends return the platform `SearchResponse` envelope.  Account-scoped: the bearer token must be a buyer-scoped API key. Free for authenticated buyers in v1; billing is planned for a later release.  Response negotiation: `Accept: application/json` (default) returns the structured envelope; `Accept: text/markdown` returns a rendered Markdown digest of the same results — useful for piping into a chat UI or LLM prompt.
+Semantic search over the Weft index of paid agent resources. The request body is the weft-search-platform `/v1/search` contract: a free-text `query`, optional `max_results`, and optional structured `filters` (price / price_atomic / type / protocol — the canonical FilterSpec v1 vocabulary, vendored verbatim from the platform). Price is a dual representation of one constraint: `price` in USD decimal strings (the reasoning form) XOR `price_atomic` in integer micro-USD (the settlement form) — mutually exclusive, set at most one.  Account-scoped: the bearer token must be a buyer-scoped API key, an OAuth token carrying `search`, or a pending or claimed `wbt_*` bootstrap bearer. Pending bootstrap access uses an anonymous bootstrap identity; after claim, the promoted bearer uses its bound User. Rejection, cancellation, expiry, and revocation end bootstrap search. Bootstrap search is limited to 60 requests per credential and 120 per IP each hour before native credential promotion.  Response negotiation: `Accept: application/json` (default) returns the structured envelope; `Accept: text/markdown` returns a rendered Markdown digest of the same results — useful for piping into a chat UI or LLM prompt.
 
 ### Examples
 

data/docs/SearchCuratedCallability.md

@@ -0,0 +1,19 @@
+# Weft::SearchCuratedCallability
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **state** | **String** |  |  |
+| **missing** | **Array<String>** |  |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SearchCuratedCallability.new(
+  state: null,
+  missing: null
+)
+```