weft-sdk 0.3.0 → 0.5.0

data/docs/SearchFilters.md

@@ -0,0 +1,26 @@
+# Weft::SearchFilters
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **min_price_usd** | **String** | Decimal USD floor; agent must have at least one skill priced at or above this. | [optional] |
+| **max_price_usd** | **String** | Decimal USD ceiling; agent must have at least one skill priced at or below this. | [optional] |
+| **payment_protocol** | **String** | Payment protocol the agent settles on. | [optional] |
+| **agent_protocol** | **String** | Agent protocol surface (Agent-to-Agent, MCP, or raw OpenAPI). | [optional] |
+| **domain** | **String** | Substring match against any of the agent's declared domain tags (e.g. `email`, `sales`, `enrichment`).  | [optional] |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SearchFilters.new(
+  min_price_usd: 0.01,
+  max_price_usd: 0.10,
+  payment_protocol: null,
+  agent_protocol: null,
+  domain: null
+)
+```
+

data/docs/SearchPricing.md

@@ -0,0 +1,24 @@
+# Weft::SearchPricing
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **protocol** | **String** |  | [optional] |
+| **scheme** | **String** |  | [optional] |
+| **amount_usd** | **String** | Default per-call amount; individual skills may override via `price_usd`. | [optional] |
+| **network** | **String** | Settlement network (e.g. `base-sepolia`). | [optional] |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SearchPricing.new(
+  protocol: null,
+  scheme: per_call,
+  amount_usd: null,
+  network: null
+)
+```
+

data/docs/SearchRanking.md

@@ -0,0 +1,26 @@
+# Weft::SearchRanking
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **popularity_score** | **Float** |  | [optional] |
+| **settlement_count_30d** | **Integer** |  | [optional] |
+| **success_rate_30d** | **Float** |  | [optional] |
+| **p50_latency_ms** | **Integer** |  | [optional] |
+| **first_seen_at** | **Time** |  | [optional] |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SearchRanking.new(
+  popularity_score: null,
+  settlement_count_30d: null,
+  success_rate_30d: null,
+  p50_latency_ms: null,
+  first_seen_at: null
+)
+```
+

data/docs/SearchRequest.md

@@ -0,0 +1,22 @@
+# Weft::SearchRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **query** | **String** | Free-text query. Required and non-empty. |  |
+| **limit** | **Integer** | Max number of hits to return. Clamped to [1, 50]. | [optional][default to 10] |
+| **filters** | [**SearchFilters**](SearchFilters.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SearchRequest.new(
+  query: send email from an agent,
+  limit: null,
+  filters: null
+)
+```
+

data/docs/SearchResponse.md

@@ -0,0 +1,26 @@
+# Weft::SearchResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **results** | [**Array<SearchResult>**](SearchResult.md) |  |  |
+| **paid_usd** | **String** | Always `null` in v1. | [optional] |
+| **tx_hash** | **String** | Always `null` in v1. | [optional] |
+| **artifact_id** | **String** | Always `null` in v1. | [optional] |
+| **_mock** | **Boolean** | Present and `true` only when served by the mock backend. | [optional] |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SearchResponse.new(
+  results: null,
+  paid_usd: null,
+  tx_hash: null,
+  artifact_id: null,
+  _mock: null
+)
+```
+

data/docs/SearchResult.md

@@ -0,0 +1,36 @@
+# Weft::SearchResult
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | Stable agent identifier (e.g. `weft:agent:agentmail`). |  |
+| **score** | **Float** | Cosine similarity score, clipped to [0, 1]. |  |
+| **protocol** | **String** | Agent protocol surface. |  |
+| **domain** | **Array<String>** | Domain tags declared by the agent. |  |
+| **reseller** | **String** | Reseller slug if this agent is fronted by an aggregator (e.g. `locus`). | [optional] |
+| **upstream** | **String** | Upstream provider hostname when fronted by a reseller. | [optional] |
+| **agent_card** | [**SearchAgentCard**](SearchAgentCard.md) |  |  |
+| **pricing** | [**SearchPricing**](SearchPricing.md) |  |  |
+| **ranking** | [**SearchRanking**](SearchRanking.md) |  |  |
+| **endpoints** | [**SearchEndpoints**](SearchEndpoints.md) |  |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SearchResult.new(
+  id: null,
+  score: null,
+  protocol: null,
+  domain: null,
+  reseller: null,
+  upstream: null,
+  agent_card: null,
+  pricing: null,
+  ranking: null,
+  endpoints: null
+)
+```
+

data/docs/SearchSkill.md

@@ -0,0 +1,36 @@
+# Weft::SearchSkill
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  | [optional] |
+| **name** | **String** |  | [optional] |
+| **description** | **String** |  | [optional] |
+| **tags** | **Array<String>** |  | [optional] |
+| **examples** | **Array<String>** |  | [optional] |
+| **input_modes** | **Array<String>** |  | [optional] |
+| **output_modes** | **Array<String>** |  | [optional] |
+| **streaming** | **Boolean** | True for skills that require streaming transport (e.g. websockets). Streaming skills are filtered out of results by default so non-streaming clients only see callable skills.  | [optional] |
+| **endpoint** | [**SearchSkillEndpoint**](SearchSkillEndpoint.md) |  | [optional] |
+| **price_usd** | **String** | Per-call price in USD for this individual skill. | [optional] |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SearchSkill.new(
+  id: null,
+  name: null,
+  description: null,
+  tags: null,
+  examples: null,
+  input_modes: null,
+  output_modes: null,
+  streaming: null,
+  endpoint: null,
+  price_usd: null
+)
+```
+

data/docs/SearchSkillEndpoint.md

@@ -0,0 +1,20 @@
+# Weft::SearchSkillEndpoint
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **method** | **String** | HTTP method or `WEBSOCKET` for streaming skills. | [optional] |
+| **path** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SearchSkillEndpoint.new(
+  method: null,
+  path: null
+)
+```
+

data/docs/SpendingPolicy.md

@@ -0,0 +1,22 @@
+# Weft::SpendingPolicy
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **max_tx_usd** | **String** | Maximum USD per single transaction. |  |
+| **daily_limit_usd** | **String** | Maximum USD spent in a 24-hour window. |  |
+| **weekly_limit_usd** | **String** | Maximum USD spent in a 7-day window. |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::SpendingPolicy.new(
+  max_tx_usd: 1.00,
+  daily_limit_usd: 10.00,
+  weekly_limit_usd: 50.00
+)
+```
+

data/docs/Wallet.md

@@ -0,0 +1,22 @@
+# Weft::Wallet
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **address** | **String** | EVM address of the buyer's Privy-managed wallet. Null if no wallet provisioned. |  |
+| **balance_usdc** | **String** | Live USDC balance, 2dp. Returns \"0.00\" if the upstream wallet provider is unreachable. |  |
+| **network** | **String** | Wallet network (e.g. `base-sepolia`). |  |
+
+## Example
+
+```ruby
+require 'weft-sdk'
+
+instance = Weft::Wallet.new(
+  address: null,
+  balance_usdc: 12.34,
+  network: null
+)
+```
+

data/lib/weft/generated/api/account_api.rb

@@ -1,9 +1,9 @@
 =begin
 #Weft API
 
-#API for agent-first payments and discovery.
+#The Weft API is the buyer-runtime surface that powers the `weft` CLI, the hosted MCP server (`weft.network/mcp`), and any third-party agent that wants to discover and pay for paid resources on Weft. v1 covers five buyer concerns:    1. Account onboarding (`/api/v1/auth/*`, `/api/v1/me`)   2. CLI authentication (`/api/v1/api_keys`)   3. Wallet visibility (`/api/v1/balance`)   4. Discovery (`/api/v1/search`)   5. Paid execution (`/api/v1/fetch`)   6. Purchase history (`/api/v1/payments`)  Seller-side concerns (agent management, payout analytics, webhook delivery, the public storefront for `data_api` resources) live in the dashboard and are intentionally not documented here. They will be split out into a separate, dashboard-scoped spec when they need to be SDK-consumable.  All errors share the envelope defined by `ErrorResponse`, except the buyer-runtime endpoints (`/search`, `/fetch`) which use bespoke envelopes carrying additional context — see `SearchErrorResponse` and `FetchErrorResponse`. 
 
-The version of the OpenAPI document: 0.3.0
+The version of the OpenAPI document: 0.5.0
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.19.0

data/lib/weft/generated/api/api_keys_api.rb

@@ -1,9 +1,9 @@
 =begin
 #Weft API
 
-#API for agent-first payments and discovery.
+#The Weft API is the buyer-runtime surface that powers the `weft` CLI, the hosted MCP server (`weft.network/mcp`), and any third-party agent that wants to discover and pay for paid resources on Weft. v1 covers five buyer concerns:    1. Account onboarding (`/api/v1/auth/*`, `/api/v1/me`)   2. CLI authentication (`/api/v1/api_keys`)   3. Wallet visibility (`/api/v1/balance`)   4. Discovery (`/api/v1/search`)   5. Paid execution (`/api/v1/fetch`)   6. Purchase history (`/api/v1/payments`)  Seller-side concerns (agent management, payout analytics, webhook delivery, the public storefront for `data_api` resources) live in the dashboard and are intentionally not documented here. They will be split out into a separate, dashboard-scoped spec when they need to be SDK-consumable.  All errors share the envelope defined by `ErrorResponse`, except the buyer-runtime endpoints (`/search`, `/fetch`) which use bespoke envelopes carrying additional context — see `SearchErrorResponse` and `FetchErrorResponse`. 
 
-The version of the OpenAPI document: 0.3.0
+The version of the OpenAPI document: 0.5.0
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.19.0

data/lib/weft/generated/api/auth_api.rb

@@ -1,9 +1,9 @@
 =begin
 #Weft API
 
-#API for agent-first payments and discovery.
+#The Weft API is the buyer-runtime surface that powers the `weft` CLI, the hosted MCP server (`weft.network/mcp`), and any third-party agent that wants to discover and pay for paid resources on Weft. v1 covers five buyer concerns:    1. Account onboarding (`/api/v1/auth/*`, `/api/v1/me`)   2. CLI authentication (`/api/v1/api_keys`)   3. Wallet visibility (`/api/v1/balance`)   4. Discovery (`/api/v1/search`)   5. Paid execution (`/api/v1/fetch`)   6. Purchase history (`/api/v1/payments`)  Seller-side concerns (agent management, payout analytics, webhook delivery, the public storefront for `data_api` resources) live in the dashboard and are intentionally not documented here. They will be split out into a separate, dashboard-scoped spec when they need to be SDK-consumable.  All errors share the envelope defined by `ErrorResponse`, except the buyer-runtime endpoints (`/search`, `/fetch`) which use bespoke envelopes carrying additional context — see `SearchErrorResponse` and `FetchErrorResponse`. 
 
-The version of the OpenAPI document: 0.3.0
+The version of the OpenAPI document: 0.5.0
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.19.0

data/lib/weft/generated/api/balance_api.rb

@@ -0,0 +1,79 @@
+=begin
+#Weft API
+
+#The Weft API is the buyer-runtime surface that powers the `weft` CLI, the hosted MCP server (`weft.network/mcp`), and any third-party agent that wants to discover and pay for paid resources on Weft. v1 covers five buyer concerns:    1. Account onboarding (`/api/v1/auth/*`, `/api/v1/me`)   2. CLI authentication (`/api/v1/api_keys`)   3. Wallet visibility (`/api/v1/balance`)   4. Discovery (`/api/v1/search`)   5. Paid execution (`/api/v1/fetch`)   6. Purchase history (`/api/v1/payments`)  Seller-side concerns (agent management, payout analytics, webhook delivery, the public storefront for `data_api` resources) live in the dashboard and are intentionally not documented here. They will be split out into a separate, dashboard-scoped spec when they need to be SDK-consumable.  All errors share the envelope defined by `ErrorResponse`, except the buyer-runtime endpoints (`/search`, `/fetch`) which use bespoke envelopes carrying additional context — see `SearchErrorResponse` and `FetchErrorResponse`. 
+
+The version of the OpenAPI document: 0.5.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'cgi'
+
+module Weft
+  class BalanceApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # 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. 
+    # @param [Hash] opts the optional parameters
+    # @return [BalanceResponse]
+    def get_balance(opts = {})
+      data, _status_code, _headers = get_balance_with_http_info(opts)
+      data
+    end
+
+    # 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. 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(BalanceResponse, Integer, Hash)>] BalanceResponse data, response status code and response headers
+    def get_balance_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BalanceApi.get_balance ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/balance'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'BalanceResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"BalanceApi.get_balance",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BalanceApi#get_balance\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/weft/generated/api/default_api.rb

@@ -1,9 +1,9 @@
 =begin
 #Weft API
 
-#API for agent-first payments and discovery.
+#The Weft API is the buyer-runtime surface that powers the `weft` CLI, the hosted MCP server (`weft.network/mcp`), and any third-party agent that wants to discover and pay for paid resources on Weft. v1 covers five buyer concerns:    1. Account onboarding (`/api/v1/auth/*`, `/api/v1/me`)   2. CLI authentication (`/api/v1/api_keys`)   3. Wallet visibility (`/api/v1/balance`)   4. Discovery (`/api/v1/search`)   5. Paid execution (`/api/v1/fetch`)   6. Purchase history (`/api/v1/payments`)  Seller-side concerns (agent management, payout analytics, webhook delivery, the public storefront for `data_api` resources) live in the dashboard and are intentionally not documented here. They will be split out into a separate, dashboard-scoped spec when they need to be SDK-consumable.  All errors share the envelope defined by `ErrorResponse`, except the buyer-runtime endpoints (`/search`, `/fetch`) which use bespoke envelopes carrying additional context — see `SearchErrorResponse` and `FetchErrorResponse`. 
 
-The version of the OpenAPI document: 0.3.0
+The version of the OpenAPI document: 0.5.0
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.19.0
@@ -19,23 +19,23 @@ module Weft
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Fetch OpenAPI spec
+    # Fetch this OpenAPI document
     # @param [Hash] opts the optional parameters
     # @return [String]
-    def get_api_docs(opts = {})
-      data, _status_code, _headers = get_api_docs_with_http_info(opts)
+    def get_open_api_document(opts = {})
+      data, _status_code, _headers = get_open_api_document_with_http_info(opts)
       data
     end
 
-    # Fetch OpenAPI spec
+    # Fetch this OpenAPI document
     # @param [Hash] opts the optional parameters
     # @return [Array<(String, Integer, Hash)>] String data, response status code and response headers
-    def get_api_docs_with_http_info(opts = {})
+    def get_open_api_document_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: DefaultApi.get_api_docs ...'
+        @api_client.config.logger.debug 'Calling API: DefaultApi.get_open_api_document ...'
       end
       # resource path
-      local_var_path = '/api/v1/docs'
+      local_var_path = '/docs/openapi.yaml'
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -58,7 +58,7 @@ module Weft
       auth_names = opts[:debug_auth_names] || []
 
       new_options = opts.merge(
-        :operation => :"DefaultApi.get_api_docs",
+        :operation => :"DefaultApi.get_open_api_document",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -69,7 +69,7 @@ module Weft
 
       data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: DefaultApi#get_api_docs\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: DefaultApi#get_open_api_document\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end

data/lib/weft/generated/api/fetch_api.rb

@@ -0,0 +1,90 @@
+=begin
+#Weft API
+
+#The Weft API is the buyer-runtime surface that powers the `weft` CLI, the hosted MCP server (`weft.network/mcp`), and any third-party agent that wants to discover and pay for paid resources on Weft. v1 covers five buyer concerns:    1. Account onboarding (`/api/v1/auth/*`, `/api/v1/me`)   2. CLI authentication (`/api/v1/api_keys`)   3. Wallet visibility (`/api/v1/balance`)   4. Discovery (`/api/v1/search`)   5. Paid execution (`/api/v1/fetch`)   6. Purchase history (`/api/v1/payments`)  Seller-side concerns (agent management, payout analytics, webhook delivery, the public storefront for `data_api` resources) live in the dashboard and are intentionally not documented here. They will be split out into a separate, dashboard-scoped spec when they need to be SDK-consumable.  All errors share the envelope defined by `ErrorResponse`, except the buyer-runtime endpoints (`/search`, `/fetch`) which use bespoke envelopes carrying additional context — see `SearchErrorResponse` and `FetchErrorResponse`. 
+
+The version of the OpenAPI document: 0.5.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'cgi'
+
+module Weft
+  class FetchApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # 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`, `tx_hash`, and the      merchant's reputation snapshot.  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. 
+    # @param fetch_request [FetchRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [FetchResponse]
+    def fetch(fetch_request, opts = {})
+      data, _status_code, _headers = fetch_with_http_info(fetch_request, opts)
+      data
+    end
+
+    # 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`, `tx_hash`, and the      merchant's reputation snapshot.  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. 
+    # @param fetch_request [FetchRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FetchResponse, Integer, Hash)>] FetchResponse data, response status code and response headers
+    def fetch_with_http_info(fetch_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: FetchApi.fetch ...'
+      end
+      # verify the required parameter 'fetch_request' is set
+      if @api_client.config.client_side_validation && fetch_request.nil?
+        fail ArgumentError, "Missing the required parameter 'fetch_request' when calling FetchApi.fetch"
+      end
+      # resource path
+      local_var_path = '/api/v1/fetch'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(fetch_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FetchResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"FetchApi.fetch",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: FetchApi#fetch\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/weft/generated/api/payments_api.rb

@@ -1,9 +1,9 @@
 =begin
 #Weft API
 
-#API for agent-first payments and discovery.
+#The Weft API is the buyer-runtime surface that powers the `weft` CLI, the hosted MCP server (`weft.network/mcp`), and any third-party agent that wants to discover and pay for paid resources on Weft. v1 covers five buyer concerns:    1. Account onboarding (`/api/v1/auth/*`, `/api/v1/me`)   2. CLI authentication (`/api/v1/api_keys`)   3. Wallet visibility (`/api/v1/balance`)   4. Discovery (`/api/v1/search`)   5. Paid execution (`/api/v1/fetch`)   6. Purchase history (`/api/v1/payments`)  Seller-side concerns (agent management, payout analytics, webhook delivery, the public storefront for `data_api` resources) live in the dashboard and are intentionally not documented here. They will be split out into a separate, dashboard-scoped spec when they need to be SDK-consumable.  All errors share the envelope defined by `ErrorResponse`, except the buyer-runtime endpoints (`/search`, `/fetch`) which use bespoke envelopes carrying additional context — see `SearchErrorResponse` and `FetchErrorResponse`. 
 
-The version of the OpenAPI document: 0.3.0
+The version of the OpenAPI document: 0.5.0
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.19.0

data/lib/weft/generated/api/search_api.rb

@@ -0,0 +1,90 @@
+=begin
+#Weft API
+
+#The Weft API is the buyer-runtime surface that powers the `weft` CLI, the hosted MCP server (`weft.network/mcp`), and any third-party agent that wants to discover and pay for paid resources on Weft. v1 covers five buyer concerns:    1. Account onboarding (`/api/v1/auth/*`, `/api/v1/me`)   2. CLI authentication (`/api/v1/api_keys`)   3. Wallet visibility (`/api/v1/balance`)   4. Discovery (`/api/v1/search`)   5. Paid execution (`/api/v1/fetch`)   6. Purchase history (`/api/v1/payments`)  Seller-side concerns (agent management, payout analytics, webhook delivery, the public storefront for `data_api` resources) live in the dashboard and are intentionally not documented here. They will be split out into a separate, dashboard-scoped spec when they need to be SDK-consumable.  All errors share the envelope defined by `ErrorResponse`, except the buyer-runtime endpoints (`/search`, `/fetch`) which use bespoke envelopes carrying additional context — see `SearchErrorResponse` and `FetchErrorResponse`. 
+
+The version of the OpenAPI document: 0.5.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'cgi'
+
+module Weft
+  class SearchApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # 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. 
+    # @param search_request [SearchRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [SearchResponse]
+    def search(search_request, opts = {})
+      data, _status_code, _headers = search_with_http_info(search_request, opts)
+      data
+    end
+
+    # 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. 
+    # @param search_request [SearchRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SearchResponse, Integer, Hash)>] SearchResponse data, response status code and response headers
+    def search_with_http_info(search_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SearchApi.search ...'
+      end
+      # verify the required parameter 'search_request' is set
+      if @api_client.config.client_side_validation && search_request.nil?
+        fail ArgumentError, "Missing the required parameter 'search_request' when calling SearchApi.search"
+      end
+      # resource path
+      local_var_path = '/api/v1/search'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'text/markdown']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(search_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SearchResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"SearchApi.search",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SearchApi#search\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end