weft-sdk 0.24.0 → 0.32.2

data/docs/SearchResponse.md

@@ -8,7 +8,7 @@
 | **query** | **String** |  |  |
 | **format** | **String** | Which view this response carries, echoing the requested format. `json` populates `results` and leaves `markdown` null; `markdown` populates `markdown` and leaves `results` empty. Exactly one is populated per response, never both — returning both eagerly would double the payload.  | [optional] |
 | **markdown** | **String** | The flat comparison table, when `format` is `markdown`; null otherwise. Rendered deterministically from the same stored result the `json` view returns, so the two views of one search can never disagree.  | [optional] |
-| **result_count** | **Integer** | How many `(Provider + Capability)` results the search produced. Read THIS, not `results.length`, for the count: on a `markdown` response `results` is empty by design, so `result_count > 0` with an empty `results` is a rendered table while `result_count == 0` is a genuine zero-result.  | [optional] |
+| **result_count** | **Integer** | How many `(Provider + Capability)` results the search produced. Read THIS, not `results.length`, for the count: on a `markdown` response `results` is empty by design, so `result_count > 0` with an empty `results` is a rendered table while `result_count == 0` is a genuine zero-result. On a `compact` view response it counts `compact_results`; there, `result_count == 0` with `omitted_results` means every ranked result was too large to show.  | [optional] |
 | **served_from** | **String** | `live` for a fresh serve; `snapshot` for an immutable replay of a completed search. A re-read is a snapshot and says so — read it with `as_of` and `stale`.  | [optional] |
 | **as_of** | **Time** | When the results were produced. Now on a `live` serve; on a `snapshot` the ORIGINAL serve time, because a replay returns exactly what was paid for, not current truth.  | [optional] |
 | **stale** | **Boolean** | Whether the active search index has changed since these results were produced. `true` does not mean the results are wrong — it means they are a snapshot of an index that has since moved. Always `false` on a `live` serve.  | [optional] |
@@ -21,7 +21,10 @@
 | **match_quality** | **String** | Calibrated confidence in this result set — read this instead of thresholding a raw similarity score. `strong`: the top match is confidently on-intent, proceed. `weak`: above the relevance floor but inside the band where plausible-but-wrong matches live, verify the result before paying. `none`: nothing cleared the floor — `results` is empty and `reason` / `suggestion` say why. Results below the floor are never returned as near-misses.  | [optional][default to 'none'] |
 | **reason** | **String** | Machine-readable cause of an empty result set, non-null exactly when `match_quality` is `none`. `below_relevance_floor`: candidates ranked but the best scored under the floor. `filter_collapsed_pool`: a caller filter cut the pool before ranking and nothing relevant survived — relax the filter. `no_catalog_coverage`: recall returned no candidates at all on an unfiltered query. `unsupported_filter_value`: a CATEGORICAL filter value (`type` / `protocol`) matches zero stored values, so it could never have matched — categorical only, since a continuous bound like `price` that matches nothing is reported as `filter_collapsed_pool` instead (the bound needs raising, the dimension is not unsupported). `index_unavailable`: no active index — an operational fault, paired with the `EMPTY_INDEX` warning.  | [optional] |
 | **suggestion** | **String** | Human/agent-readable explanation of `reason`, carrying the concrete numbers behind it (pool sizes, the best discarded score against the floor, the values actually stored for a filter). Non-null exactly when `reason` is.  | [optional] |
-| **results** | [**Array<SearchResult>**](SearchResult.md) | Ranked `(Provider + Capability)` results; empty when the index is empty or nothing cleared the relevance floor. Results BELOW the floor are never returned — an empty list plus a `reason` is the honest answer, not a list of near-misses in the same shape as a genuine match.  |  |
+| **results** | [**Array<SearchResult>**](SearchResult.md) | Ranked `(Provider + Capability)` results; empty when the index is empty or nothing cleared the relevance floor. Results BELOW the floor are never returned — an empty list plus a `reason` is the honest answer, not a list of near-misses in the same shape as a genuine match. Empty on a `compact` view response; read `compact_results`.  |  |
+| **view** | **String** | The view this response carries. Present as `compact` when the request asked for `view: \"compact\"`; absent means `full`.  | [optional] |
+| **compact_results** | [**Array<SearchCompactResult>**](SearchCompactResult.md) | Ranked compact results, present only on a `compact` view response. `result_count` is their count. They are a separate field so that typed clients keep the full `SearchResult` shape for `results`.  | [optional] |
+| **omitted_results** | **Integer** | Compact view only: how many ranked results were left out because even their minimum summary does not fit the per-result budget. Absent when none were left out.  | [optional] |
 
 ## Example
 
@@ -46,6 +49,9 @@ instance = Weft::SearchResponse.new(
   match_quality: null,
   reason: null,
   suggestion: null,
-  results: null
+  results: null,
+  view: null,
+  compact_results: null,
+  omitted_results: null
 )
 ```

data/docs/SearchWeftFetchCompatibility.md

@@ -7,6 +7,7 @@
 | **state** | **String** |  |  |
 | **reason** | **String** |  |  |
 | **contract_version** | **Integer** |  |  |
+| **coverage** | **String** | Extent of the operation covered by weft_fetch. `terminal_response` covers the terminal result; `submission_only` covers submission but not completion or retrieval of the result; `none` means no coverage. When absent, coverage is unknown, not terminal. Do not infer terminal coverage from synchronous execution mode alone.  | [optional] |
 
 ## Example
 
@@ -16,6 +17,7 @@ require 'weft-sdk'
 instance = Weft::SearchWeftFetchCompatibility.new(
   state: null,
   reason: null,
-  contract_version: null
+  contract_version: null,
+  coverage: null
 )
 ```

data/docs/WebhooksApi.md

@@ -0,0 +1,414 @@
+# Weft::WebhooksApi
+
+All URIs are relative to *https://weft.network*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**create_webhook_endpoint**](WebhooksApi.md#create_webhook_endpoint) | **POST** /api/v1/webhook_endpoints | Create a webhook endpoint |
+| [**delete_webhook_endpoint**](WebhooksApi.md#delete_webhook_endpoint) | **DELETE** /api/v1/webhook_endpoints/{id} | Delete a webhook endpoint |
+| [**get_webhook_endpoint**](WebhooksApi.md#get_webhook_endpoint) | **GET** /api/v1/webhook_endpoints/{id} | Get a webhook endpoint |
+| [**list_webhook_endpoints**](WebhooksApi.md#list_webhook_endpoints) | **GET** /api/v1/webhook_endpoints | List webhook endpoints |
+| [**replace_webhook_endpoint**](WebhooksApi.md#replace_webhook_endpoint) | **PUT** /api/v1/webhook_endpoints/{id} | Replace a webhook endpoint |
+| [**update_webhook_endpoint**](WebhooksApi.md#update_webhook_endpoint) | **PATCH** /api/v1/webhook_endpoints/{id} | Update a webhook endpoint |
+
+
+## create_webhook_endpoint
+
+> create_webhook_endpoint
+
+Create a webhook endpoint
+
+Retired. Returns HTTP 410 with error code `gone`. The body is ignored.
+
+### 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::WebhooksApi.new
+
+begin
+  # Create a webhook endpoint
+  api_instance.create_webhook_endpoint
+rescue Weft::ApiError => e
+  puts "Error when calling WebhooksApi->create_webhook_endpoint: #{e}"
+end
+```
+
+#### Using the create_webhook_endpoint_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> create_webhook_endpoint_with_http_info
+
+```ruby
+begin
+  # Create a webhook endpoint
+  data, status_code, headers = api_instance.create_webhook_endpoint_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Weft::ApiError => e
+  puts "Error when calling WebhooksApi->create_webhook_endpoint_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## delete_webhook_endpoint
+
+> delete_webhook_endpoint(id)
+
+Delete a webhook endpoint
+
+Retired. Returns HTTP 410 with error code `gone`. Stored rows are kept.
+
+### 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::WebhooksApi.new
+id = 56 # Integer | Webhook endpoint ID. Ignored. The response is always HTTP 410.
+
+begin
+  # Delete a webhook endpoint
+  api_instance.delete_webhook_endpoint(id)
+rescue Weft::ApiError => e
+  puts "Error when calling WebhooksApi->delete_webhook_endpoint: #{e}"
+end
+```
+
+#### Using the delete_webhook_endpoint_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> delete_webhook_endpoint_with_http_info(id)
+
+```ruby
+begin
+  # Delete a webhook endpoint
+  data, status_code, headers = api_instance.delete_webhook_endpoint_with_http_info(id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Weft::ApiError => e
+  puts "Error when calling WebhooksApi->delete_webhook_endpoint_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** | Webhook endpoint ID. Ignored. The response is always HTTP 410. |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_webhook_endpoint
+
+> get_webhook_endpoint(id)
+
+Get a webhook endpoint
+
+Retired. Returns HTTP 410 with error code `gone`.
+
+### 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::WebhooksApi.new
+id = 56 # Integer | Webhook endpoint ID. Ignored. The response is always HTTP 410.
+
+begin
+  # Get a webhook endpoint
+  api_instance.get_webhook_endpoint(id)
+rescue Weft::ApiError => e
+  puts "Error when calling WebhooksApi->get_webhook_endpoint: #{e}"
+end
+```
+
+#### Using the get_webhook_endpoint_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> get_webhook_endpoint_with_http_info(id)
+
+```ruby
+begin
+  # Get a webhook endpoint
+  data, status_code, headers = api_instance.get_webhook_endpoint_with_http_info(id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Weft::ApiError => e
+  puts "Error when calling WebhooksApi->get_webhook_endpoint_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** | Webhook endpoint ID. Ignored. The response is always HTTP 410. |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_webhook_endpoints
+
+> list_webhook_endpoints
+
+List webhook endpoints
+
+Retired. Returns HTTP 410 with error code `gone`.
+
+### 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::WebhooksApi.new
+
+begin
+  # List webhook endpoints
+  api_instance.list_webhook_endpoints
+rescue Weft::ApiError => e
+  puts "Error when calling WebhooksApi->list_webhook_endpoints: #{e}"
+end
+```
+
+#### Using the list_webhook_endpoints_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> list_webhook_endpoints_with_http_info
+
+```ruby
+begin
+  # List webhook endpoints
+  data, status_code, headers = api_instance.list_webhook_endpoints_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Weft::ApiError => e
+  puts "Error when calling WebhooksApi->list_webhook_endpoints_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## replace_webhook_endpoint
+
+> replace_webhook_endpoint(id)
+
+Replace a webhook endpoint
+
+Retired. Returns HTTP 410 with error code `gone`. The body is ignored.
+
+### 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::WebhooksApi.new
+id = 56 # Integer | Webhook endpoint ID. Ignored. The response is always HTTP 410.
+
+begin
+  # Replace a webhook endpoint
+  api_instance.replace_webhook_endpoint(id)
+rescue Weft::ApiError => e
+  puts "Error when calling WebhooksApi->replace_webhook_endpoint: #{e}"
+end
+```
+
+#### Using the replace_webhook_endpoint_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> replace_webhook_endpoint_with_http_info(id)
+
+```ruby
+begin
+  # Replace a webhook endpoint
+  data, status_code, headers = api_instance.replace_webhook_endpoint_with_http_info(id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Weft::ApiError => e
+  puts "Error when calling WebhooksApi->replace_webhook_endpoint_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** | Webhook endpoint ID. Ignored. The response is always HTTP 410. |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## update_webhook_endpoint
+
+> update_webhook_endpoint(id)
+
+Update a webhook endpoint
+
+Retired. Returns HTTP 410 with error code `gone`. The body is ignored.
+
+### 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::WebhooksApi.new
+id = 56 # Integer | Webhook endpoint ID. Ignored. The response is always HTTP 410.
+
+begin
+  # Update a webhook endpoint
+  api_instance.update_webhook_endpoint(id)
+rescue Weft::ApiError => e
+  puts "Error when calling WebhooksApi->update_webhook_endpoint: #{e}"
+end
+```
+
+#### Using the update_webhook_endpoint_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> update_webhook_endpoint_with_http_info(id)
+
+```ruby
+begin
+  # Update a webhook endpoint
+  data, status_code, headers = api_instance.update_webhook_endpoint_with_http_info(id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Weft::ApiError => e
+  puts "Error when calling WebhooksApi->update_webhook_endpoint_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** | Webhook endpoint ID. Ignored. The response is always HTTP 410. |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json