weft-sdk 0.6.2 → 0.9.0

data/docs/MessageResponse.md

@@ -15,4 +15,3 @@ instance = Weft::MessageResponse.new(
   data: null
 )
 ```
-

data/docs/MessageResponseData.md

@@ -15,4 +15,3 @@ instance = Weft::MessageResponseData.new(
   message: null
 )
 ```
-

data/docs/Pagination.md

@@ -21,4 +21,3 @@ instance = Weft::Pagination.new(
   total_pages: null
 )
 ```
-

data/docs/PasswordResetRequest.md

@@ -15,4 +15,3 @@ instance = Weft::PasswordResetRequest.new(
   email: null
 )
 ```
-

data/docs/PasswordUpdateRequest.md

@@ -19,4 +19,3 @@ instance = Weft::PasswordUpdateRequest.new(
   password_confirmation: null
 )
 ```
-

data/docs/Payment.md

@@ -14,7 +14,6 @@
 | **network** | **String** | CAIP-2 chain identifier |  |
 | **resource_url** | **String** |  | [optional] |
 | **resource_host** | **String** |  | [optional] |
-| **fee_amount** | **Integer** |  | [optional] |
 | **settlement_latency_ms** | **Integer** |  | [optional] |
 | **settled_at** | **Time** |  |  |
 | **api_key_name** | **String** |  |  |
@@ -35,10 +34,8 @@ instance = Weft::Payment.new(
   network: null,
   resource_url: null,
   resource_host: null,
-  fee_amount: null,
   settlement_latency_ms: null,
   settled_at: null,
   api_key_name: null
 )
 ```
-

data/docs/PaymentListResponse.md

@@ -17,4 +17,3 @@ instance = Weft::PaymentListResponse.new(
   pagination: null
 )
 ```
-

data/docs/PaymentResponse.md

@@ -15,4 +15,3 @@ instance = Weft::PaymentResponse.new(
   data: null
 )
 ```
-

data/docs/PaymentsApi.md

@@ -144,4 +144,3 @@ end
 
 - **Content-Type**: Not defined
 - **Accept**: application/json
-

data/docs/PrincipalWallet.md

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

data/docs/PromoBalance.md

@@ -19,4 +19,3 @@ instance = Weft::PromoBalance.new(
   expires_at: null
 )
 ```
-

data/docs/Purchase.md

@@ -0,0 +1,43 @@
+# Weft::Purchase
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** |  |  |
+| **status** | **String** |  |  |
+| **amount_usd** | **String** | Exact decimal USD amount with up to six fractional digits. |  |
+| **recipient_address** | **String** |  |  |
+| **network** | **String** |  |  |
+| **protocol** | **String** |  |  |
+| **context** | **String** |  |  |
+| **tx_hash** | **String** |  |  |
+| **reject_reason** | **String** |  |  |
+| **failure_reason** | **String** |  |  |
+| **idempotency_key** | **String** |  |  |
+| **signed_at** | **Time** |  |  |
+| **settled_at** | **Time** |  |  |
+| **artifact** | [**PurchaseArtifact**](PurchaseArtifact.md) |  |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::Purchase.new(
+  id: null,
+  status: null,
+  amount_usd: null,
+  recipient_address: null,
+  network: null,
+  protocol: null,
+  context: null,
+  tx_hash: null,
+  reject_reason: null,
+  failure_reason: null,
+  idempotency_key: null,
+  signed_at: null,
+  settled_at: null,
+  artifact: null
+)
+```

data/docs/PurchaseArtifact.md

@@ -0,0 +1,23 @@
+# Weft::PurchaseArtifact
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** |  |  |
+| **merchant_url** | **String** |  |  |
+| **bytes** | **Integer** |  |  |
+| **mime** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::PurchaseArtifact.new(
+  id: null,
+  merchant_url: null,
+  bytes: null,
+  mime: null
+)
+```

data/docs/PurchaseListResponse.md

@@ -0,0 +1,19 @@
+# Weft::PurchaseListResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**Array<Purchase>**](Purchase.md) |  |  |
+| **pagination** | [**Pagination**](Pagination.md) |  |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::PurchaseListResponse.new(
+  data: null,
+  pagination: null
+)
+```

data/docs/PurchaseResponse.md

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

data/docs/PurchasesApi.md

@@ -0,0 +1,148 @@
+# Weft::PurchasesApi
+
+All URIs are relative to *https://weft.network*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**get_purchase**](PurchasesApi.md#get_purchase) | **GET** /api/v1/purchases/{id} | Get a buyer purchase |
+| [**list_purchases**](PurchasesApi.md#list_purchases) | **GET** /api/v1/purchases | List buyer purchases |
+
+
+## get_purchase
+
+> <PurchaseResponse> get_purchase(id)
+
+Get a buyer purchase
+
+### Examples
+
+```ruby
+require 'time'
+require 'weft-sdk'
+# setup authorization
+Weft.configure do |config|
+  # Configure Bearer authorization (APIKey): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Weft::PurchasesApi.new
+id = 56 # Integer | Purchase ID
+
+begin
+  # Get a buyer purchase
+  result = api_instance.get_purchase(id)
+  p result
+rescue Weft::ApiError => e
+  puts "Error when calling PurchasesApi->get_purchase: #{e}"
+end
+```
+
+#### Using the get_purchase_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<PurchaseResponse>, Integer, Hash)> get_purchase_with_http_info(id)
+
+```ruby
+begin
+  # Get a buyer purchase
+  data, status_code, headers = api_instance.get_purchase_with_http_info(id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <PurchaseResponse>
+rescue Weft::ApiError => e
+  puts "Error when calling PurchasesApi->get_purchase_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** | Purchase ID |  |
+
+### Return type
+
+[**PurchaseResponse**](PurchaseResponse.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_purchases
+
+> <PurchaseListResponse> list_purchases(opts)
+
+List buyer purchases
+
+Returns the authenticated buyer's signing and settlement ledger. Unlike `/api/v1/payments`, this endpoint is User-scoped and backed by `signed_events`, so rejected and pending attempts are included.  Scoped to the buyer's own merchant spend, matching the dashboard's Purchases page. Internal signings are excluded: the Tempo refill self-transfer (`rebalance`) and operator signings (`manual`) are not payments the buyer made and never appear here.
+
+### Examples
+
+```ruby
+require 'time'
+require 'weft-sdk'
+# setup authorization
+Weft.configure do |config|
+  # Configure Bearer authorization (APIKey): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Weft::PurchasesApi.new
+opts = {
+  page: 56, # Integer | Page number
+  per_page: 56 # Integer | Items per page
+}
+
+begin
+  # List buyer purchases
+  result = api_instance.list_purchases(opts)
+  p result
+rescue Weft::ApiError => e
+  puts "Error when calling PurchasesApi->list_purchases: #{e}"
+end
+```
+
+#### Using the list_purchases_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<PurchaseListResponse>, Integer, Hash)> list_purchases_with_http_info(opts)
+
+```ruby
+begin
+  # List buyer purchases
+  data, status_code, headers = api_instance.list_purchases_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <PurchaseListResponse>
+rescue Weft::ApiError => e
+  puts "Error when calling PurchasesApi->list_purchases_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **page** | **Integer** | Page number | [optional][default to 1] |
+| **per_page** | **Integer** | Items per page | [optional][default to 25] |
+
+### Return type
+
+[**PurchaseListResponse**](PurchaseListResponse.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json

data/docs/ResendConfirmationRequest.md

@@ -15,4 +15,3 @@ instance = Weft::ResendConfirmationRequest.new(
   email: null
 )
 ```
-

data/docs/ResourceEnrollmentRequest.md

@@ -0,0 +1,23 @@
+# Weft::ResourceEnrollmentRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **kind** | **String** | Resource kind. Must be one of the supported kinds (currently `agent`); an unknown value is rejected with a 422.  |  |
+| **name** | **String** | Human-readable name; the server derives the slug from it. |  |
+| **description** | **String** |  | [optional] |
+| **wallet_address** | **String** | Declared EVM wallet address for the ghost resource. Stored as a claim (unverified) until the resource is claimed.  | [optional] |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::ResourceEnrollmentRequest.new(
+  kind: agent,
+  name: Self-Enrolled Bot,
+  description: null,
+  wallet_address: null
+)
+```

data/docs/ResourceEnrollmentResponse.md

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

data/docs/ResourceStats.md

@@ -0,0 +1,29 @@
+# Weft::ResourceStats
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **total_paid** | **Integer** | Total atomic units paid out by this resource. |  |
+| **total_received** | **Integer** | Total atomic units received by this resource. |  |
+| **payments_made** | **Integer** |  |  |
+| **payments_received** | **Integer** |  |  |
+| **unique_counterparties** | **Integer** |  |  |
+| **first_seen** | **Time** |  |  |
+| **last_active** | **Time** |  |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::ResourceStats.new(
+  total_paid: null,
+  total_received: null,
+  payments_made: null,
+  payments_received: null,
+  unique_counterparties: null,
+  first_seen: null,
+  last_active: null
+)
+```

data/docs/ResourcesApi.md

@@ -0,0 +1,71 @@
+# Weft::ResourcesApi
+
+All URIs are relative to *https://weft.network*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**enroll_resource**](ResourcesApi.md#enroll_resource) | **POST** /api/v1/resources/enroll | Self-enroll a ghost resource (public, no auth) |
+
+
+## enroll_resource
+
+> <ResourceEnrollmentResponse> enroll_resource(resource_enrollment_request)
+
+Self-enroll a ghost resource (public, no auth)
+
+Lets an unauthenticated agent (or its operator) self-enroll a Resource as a \"ghost\" (no owning provider). The server generates the `slug` and a single-use `claim_token`; the response also carries a `claim_url` the agent hands to its human controller to claim the resource from the dashboard.  Client-supplied `slug` and `category` are silently ignored: slugs are server-generated from `name` (so callers cannot squat on reserved names), and `category` is a post-claim concern set by a real human.  Rate-limited to 10 enrollments/hour/IP.
+
+### Examples
+
+```ruby
+require 'time'
+require 'weft-sdk'
+
+api_instance = Weft::ResourcesApi.new
+resource_enrollment_request = Weft::ResourceEnrollmentRequest.new({kind: 'agent', name: 'Self-Enrolled Bot'}) # ResourceEnrollmentRequest |
+
+begin
+  # Self-enroll a ghost resource (public, no auth)
+  result = api_instance.enroll_resource(resource_enrollment_request)
+  p result
+rescue Weft::ApiError => e
+  puts "Error when calling ResourcesApi->enroll_resource: #{e}"
+end
+```
+
+#### Using the enroll_resource_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ResourceEnrollmentResponse>, Integer, Hash)> enroll_resource_with_http_info(resource_enrollment_request)
+
+```ruby
+begin
+  # Self-enroll a ghost resource (public, no auth)
+  data, status_code, headers = api_instance.enroll_resource_with_http_info(resource_enrollment_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ResourceEnrollmentResponse>
+rescue Weft::ApiError => e
+  puts "Error when calling ResourcesApi->enroll_resource_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **resource_enrollment_request** | [**ResourceEnrollmentRequest**](ResourceEnrollmentRequest.md) |  |  |
+
+### Return type
+
+[**ResourceEnrollmentResponse**](ResourceEnrollmentResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json

data/docs/SearchApi.md

@@ -13,7 +13,7 @@ All URIs are relative to *https://weft.network*
 
 Search the Weft index
 
-Semantic search over the Weft index of paid agent resources. The request body carries a free-text `query`, an optional `limit`, and an optional `filters` object that narrows by price band, payment protocol, agent protocol, or domain tag. Filters are applied as a post-filter after the embedding score is computed.  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 same 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.  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.
 
 ### Examples
 
@@ -27,7 +27,7 @@ Weft.configure do |config|
 end
 
 api_instance = Weft::SearchApi.new
-search_request = Weft::SearchRequest.new({query: 'send email from an agent'}) # SearchRequest | 
+search_request = Weft::SearchRequest.new({query: 'send email from an agent'}) # SearchRequest |
 
 begin
   # Search the Weft index
@@ -74,4 +74,3 @@ end
 
 - **Content-Type**: application/json
 - **Accept**: application/json, text/markdown
-

data/docs/SearchCapabilityRef.md

@@ -0,0 +1,19 @@
+# Weft::SearchCapabilityRef
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **capability_id** | **String** |  | [optional] |
+| **capability_type** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SearchCapabilityRef.new(
+  capability_id: null,
+  capability_type: null
+)
+```

data/docs/SearchEndpointCall.md

@@ -0,0 +1,23 @@
+# Weft::SearchEndpointCall
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **method** | **String** | The HTTP verb to send. Empty string when neither the index nor the provider's own 402 challenge / OpenAPI spec declares one.  | [optional] |
+| **input_schema** | **Object** | The provider's OWN structured declaration of the arguments this endpoint takes — the machine-usable form of what `usage_instructions` states in prose. Null when the provider declares nothing.  | [optional] |
+| **example_request** | **Object** | A worked set of arguments grouped by slot (`query` / `body` / `path`). Every value is one the PROVIDER published; never synthesized.  | [optional] |
+| **example_response** | **Object** |  | [optional] |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SearchEndpointCall.new(
+  method: null,
+  input_schema: null,
+  example_request: null,
+  example_response: null
+)
+```

data/docs/SearchEndpointHit.md

@@ -0,0 +1,41 @@
+# Weft::SearchEndpointHit
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **endpoint_id** | **String** |  | [optional] |
+| **url** | **String** |  | [optional] |
+| **resource_type** | **String** |  | [optional] |
+| **primary_protocol** | **String** |  | [optional] |
+| **call** | [**SearchEndpointCall**](SearchEndpointCall.md) |  | [optional] |
+| **price** | [**SearchEndpointPrice**](SearchEndpointPrice.md) |  | [optional] |
+| **payment** | [**Array<SearchPaymentOffer>**](SearchPaymentOffer.md) | The settlement routes this endpoint's own 402 challenge published — one entry per rail × network × asset × payee it accepts. Sibling of `call`: that block says how to shape the request, this says how to pay for it, so a caller can settle with its OWN x402/mpp SDK instead of guessing. A list because rails are irreducibly plural. Order is the provider's own preference order. Honest-empty when the pipeline observed no challenge.  | [optional] |
+| **operator_type** | **String** | Who you are actually paying. `first_party` = operated by the provider that makes the capability; `reseller` = resold, so the price carries someone else's margin. Null until the platform resolves the operator.  | [optional] |
+| **operated_by_id** | **String** |  | [optional] |
+| **settled_via_facilitator_id** | **String** |  | [optional] |
+| **settlements** | **Integer** | Count of payments observed settling against this endpoint by ANYONE (chain-indexed), not just by Weft — the reliability signal a caller can act on. Null when unknown.  | [optional] |
+| **last_verified_at** | **Time** | When Weft last CONFIRMED this endpoint answers — the most recent conclusive probe. Null when never probed, or when the latest probe errored: an endpoint we last failed to reach has no current verification.  | [optional] |
+| **latency_p50_ms** | **Integer** | Median time-to-first-byte in ms across the endpoint's probe call set. First-byte latency, not full-response time. Null when unmeasured (never 0).  | [optional] |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SearchEndpointHit.new(
+  endpoint_id: null,
+  url: null,
+  resource_type: null,
+  primary_protocol: null,
+  call: null,
+  price: null,
+  payment: null,
+  operator_type: null,
+  operated_by_id: null,
+  settled_via_facilitator_id: null,
+  settlements: null,
+  last_verified_at: null,
+  latency_p50_ms: null
+)
+```

data/docs/SearchEndpointPrice.md

@@ -0,0 +1,25 @@
+# Weft::SearchEndpointPrice
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **indexed_usd** | **String** | The indexed price in USD as a decimal string (e.g. \"0.008\") — the dollar value people and agents reason in. A decimal string, never a float; trailing zeros trimmed. Null when unpriced.  | [optional] |
+| **atomic** | **Integer** | The same price in integer micro-USD — the settlement grain, exact. Null exactly when `indexed_usd` is. Use this for settlement.  | [optional] |
+| **source** | **String** | Where the amount came from. `probe` = observed live in the endpoint's own 402 payment-required challenge — an observation, the strongest evidence we hold. `inferred` = derived from a spec (OpenAPI) or a resale edge by the extraction pipeline, so it can lag a provider's re-pricing. Null when the endpoint carries no price.  | [optional] |
+| **last_observed_at** | **Time** | When the amount was observed. Null when unrecorded. | [optional] |
+| **live_verified** | **Boolean** | Whether this amount was confirmed against a live 402 challenge for THIS response. Search does not issue a payment-required probe at query time, so this is `false` today — treat an unflagged price as indexed, not verified.  | [optional] |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SearchEndpointPrice.new(
+  indexed_usd: null,
+  atomic: null,
+  source: null,
+  last_observed_at: null,
+  live_verified: null
+)
+```

data/docs/SearchErrorResponse.md

@@ -17,4 +17,3 @@ instance = Weft::SearchErrorResponse.new(
   details: null
 )
 ```
-

data/docs/SearchFilterSpec.md

@@ -0,0 +1,23 @@
+# Weft::SearchFilterSpec
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **price** | [**SearchPriceUsdFilter**](SearchPriceUsdFilter.md) |  | [optional] |
+| **price_atomic** | [**SearchPriceAtomicFilter**](SearchPriceAtomicFilter.md) |  | [optional] |
+| **type** | [**SearchResourceTypeFilter**](SearchResourceTypeFilter.md) |  | [optional] |
+| **protocol** | [**SearchProtocolFilter**](SearchProtocolFilter.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SearchFilterSpec.new(
+  price: null,
+  price_atomic: null,
+  type: null,
+  protocol: null
+)
+```