shipeasy-sdk 3.8.0 → 4.0.0

data/lib/shipeasy_admin/api/ops_api.rb

@@ -1,7 +1,7 @@
 =begin
-#Shipeasy Admin API
+#Shipeasy Admin API (server-SDK surface)
 
-#REST API for managing feature gates, experiments, configs, universes, and killswitches in a Shipeasy project. Authenticate with an admin SDK key (`Authorization: Bearer sdk_admin_…`) and scope every request to a project via the `X-Project-Id` header.  Mint admin keys via `POST /api/admin/keys` with `type: \"admin\"`. Keys expire after 90 days; rotate with the `revoke` action.
+#The slice of the Shipeasy admin API that the published server SDKs expose as their optional `AdminClient`. Authenticate with an admin SDK key (`Authorization: Bearer sdk_admin_…`) and scope every request to a project via the `X-Project-Id` header.  Three capabilities, nothing else:  - **File a public ticket** — a bug or a feature request onto the project's ops queue. - **Toggle a kill switch** — flip the switch itself, or one of its named sub-switches, on one environment. - **Manage a flag's whitelist** — read, replace, add to, or remove from the allowlist that admits specific identities ahead of every targeting rule.  Everything else in the admin API is reachable through the Shipeasy CLI and MCP server, which speak the complete contract (`openapi.yaml`).
 
 The version of the OpenAPI document: 2.0.0
 
@@ -19,33 +19,31 @@ module Shipeasy::Admin::Generated
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # File a queue item
-    # Files one queue item — a bug report or a feature request — and fires the project's connectors (GitHub issue / Slack). `type` selects which; only the two user-fileable types are accepted (`error`/`alert` tickets are auto-filed by the platform). Returns the new id and per-project number.  **Use cases**  - **File a bug** — `{ \"type\": \"bug\", \"title\": \"Checkout 500s on Safari\", \"stepsToReproduce\": \"…\" }`. - **File a feature request** — `{ \"type\": \"feature_request\", \"title\": \"Dark mode\", \"priority\": \"nice_to_have\" }`.
-    # @param create_ops_item_request [CreateOpsItemRequest] 
+    # File a bug
+    # Files one bug onto a project's queue, awaiting human approval. This is the **public** intake: it authenticates with a *client* SDK key rather than an admin key, so it can be called from a CLI, an installer script, a devtools overlay, or any shipped code — the same places a client key already lives.  Three gates decide whether a ticket is filed, and nothing else the caller sends can widen them:  1. the key is a `client` key carrying the `tickets:public_create` scope, 2. the key's project has public ticket creation enabled, and 3. the item is filed as `pending_approval` — parked out of the work queue until a human promotes it in the dashboard.  The project is the key's own project; there is no `X-Project-Id` to pass and no way to file into someone else's queue. Repeat submissions of the same title dedupe against the open ticket already tracking it, which returns `200` with `deduped: true` instead of filing again.  This endpoint is served by the Shipeasy **edge worker** (`api.shipeasy.ai`), not the admin API — see `servers` below.  **Use case:** `shipeasy setup` fails on a customer's machine and self-reports the failure with the user's consent — `{ \"title\": \"Setup failed at Feature installs\", \"stepsToReproduce\": \"…\", \"actualResult\": \"…\" }`.
+    # @param create_public_bug_request [CreatePublicBugRequest] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [CreateOpsItemResponse]
-    def create_ops_item(create_ops_item_request, opts = {})
-      data, _status_code, _headers = create_ops_item_with_http_info(create_ops_item_request, opts)
+    # @return [CreatePublicTicketResponse]
+    def create_public_bug(create_public_bug_request, opts = {})
+      data, _status_code, _headers = create_public_bug_with_http_info(create_public_bug_request, opts)
       data
     end
 
-    # File a queue item
-    # Files one queue item — a bug report or a feature request — and fires the project's connectors (GitHub issue / Slack). `type` selects which; only the two user-fileable types are accepted (`error`/`alert` tickets are auto-filed by the platform). Returns the new id and per-project number.  **Use cases**  - **File a bug** — `{ \"type\": \"bug\", \"title\": \"Checkout 500s on Safari\", \"stepsToReproduce\": \"…\" }`. - **File a feature request** — `{ \"type\": \"feature_request\", \"title\": \"Dark mode\", \"priority\": \"nice_to_have\" }`.
-    # @param create_ops_item_request [CreateOpsItemRequest] 
+    # File a bug
+    # Files one bug onto a project's queue, awaiting human approval. This is the **public** intake: it authenticates with a *client* SDK key rather than an admin key, so it can be called from a CLI, an installer script, a devtools overlay, or any shipped code — the same places a client key already lives.  Three gates decide whether a ticket is filed, and nothing else the caller sends can widen them:  1. the key is a `client` key carrying the `tickets:public_create` scope, 2. the key's project has public ticket creation enabled, and 3. the item is filed as `pending_approval` — parked out of the work queue until a human promotes it in the dashboard.  The project is the key's own project; there is no `X-Project-Id` to pass and no way to file into someone else's queue. Repeat submissions of the same title dedupe against the open ticket already tracking it, which returns `200` with `deduped: true` instead of filing again.  This endpoint is served by the Shipeasy **edge worker** (`api.shipeasy.ai`), not the admin API — see `servers` below.  **Use case:** `shipeasy setup` fails on a customer's machine and self-reports the failure with the user's consent — `{ \"title\": \"Setup failed at Feature installs\", \"stepsToReproduce\": \"…\", \"actualResult\": \"…\" }`.
+    # @param create_public_bug_request [CreatePublicBugRequest] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [Array<(CreateOpsItemResponse, Integer, Hash)>] CreateOpsItemResponse data, response status code and response headers
-    def create_ops_item_with_http_info(create_ops_item_request, opts = {})
+    # @return [Array<(CreatePublicTicketResponse, Integer, Hash)>] CreatePublicTicketResponse data, response status code and response headers
+    def create_public_bug_with_http_info(create_public_bug_request, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: OpsApi.create_ops_item ...'
+        @api_client.config.logger.debug 'Calling API: OpsApi.create_public_bug ...'
       end
-      # verify the required parameter 'create_ops_item_request' is set
-      if @api_client.config.client_side_validation && create_ops_item_request.nil?
-        fail ArgumentError, "Missing the required parameter 'create_ops_item_request' when calling OpsApi.create_ops_item"
+      # verify the required parameter 'create_public_bug_request' is set
+      if @api_client.config.client_side_validation && create_public_bug_request.nil?
+        fail ArgumentError, "Missing the required parameter 'create_public_bug_request' when calling OpsApi.create_public_bug"
       end
       # resource path
-      local_var_path = '/api/admin/ops'
+      local_var_path = '/ops/bug'
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -59,22 +57,21 @@ module Shipeasy::Admin::Generated
       if !content_type.nil?
           header_params['Content-Type'] = content_type
       end
-      header_params[:'X-Project-Id'] = opts[:'x_project_id'] if !opts[:'x_project_id'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(create_ops_item_request)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(create_public_bug_request)
 
       # return_type
-      return_type = opts[:debug_return_type] || 'CreateOpsItemResponse'
+      return_type = opts[:debug_return_type] || 'CreatePublicTicketResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['bearerSdkKey']
+      auth_names = opts[:debug_auth_names] || ['clientSdkKey']
 
       new_options = opts.merge(
-        :operation => :"OpsApi.create_ops_item",
+        :operation => :"OpsApi.create_public_bug",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -85,106 +82,36 @@ module Shipeasy::Admin::Generated
 
       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: OpsApi#create_ops_item\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: OpsApi#create_public_bug\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Get one queue item
-    # Fetch a single queue item by its per-project `number` or full id.  **Use case:** Inspect one item's full detail before updating its status or linking a PR.
-    # @param handle [String] Per-project item number (e.g. &#x60;7&#x60;) or the full ops item id.
+    # File a feature request
+    # Files one feature request onto a project's queue, awaiting human approval. The feature-request counterpart to `POST /ops/bug`, with the same three gates: a `client` key carrying `tickets:public_create`, a project that has opted in, and a `pending_approval` state forced server-side.  The project is the key's own project; there is no `X-Project-Id` to pass. Repeat submissions of the same title dedupe against the open ticket already tracking it, which returns `200` with `deduped: true` instead of filing again.  This endpoint is served by the Shipeasy **edge worker** (`api.shipeasy.ai`), not the admin API — see `servers` below.  **Use case:** An in-product \"request a feature\" form posts what the user asked for — `{ \"title\": \"Dark mode\", \"useCase\": \"Reduce eye strain at night\" }`.
+    # @param create_public_feature_request_request [CreatePublicFeatureRequestRequest] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [GetOpsItemResponse]
-    def get_ops_item(handle, opts = {})
-      data, _status_code, _headers = get_ops_item_with_http_info(handle, opts)
+    # @return [CreatePublicTicketResponse]
+    def create_public_feature_request(create_public_feature_request_request, opts = {})
+      data, _status_code, _headers = create_public_feature_request_with_http_info(create_public_feature_request_request, opts)
       data
     end
 
-    # Get one queue item
-    # Fetch a single queue item by its per-project &#x60;number&#x60; or full id.  **Use case:** Inspect one item&#39;s full detail before updating its status or linking a PR.
-    # @param handle [String] Per-project item number (e.g. &#x60;7&#x60;) or the full ops item id.
+    # File a feature request
+    # Files one feature request onto a project&#39;s queue, awaiting human approval. The feature-request counterpart to &#x60;POST /ops/bug&#x60;, with the same three gates: a &#x60;client&#x60; key carrying &#x60;tickets:public_create&#x60;, a project that has opted in, and a &#x60;pending_approval&#x60; state forced server-side.  The project is the key&#39;s own project; there is no &#x60;X-Project-Id&#x60; to pass. Repeat submissions of the same title dedupe against the open ticket already tracking it, which returns &#x60;200&#x60; with &#x60;deduped: true&#x60; instead of filing again.  This endpoint is served by the Shipeasy **edge worker** (&#x60;api.shipeasy.ai&#x60;), not the admin API — see &#x60;servers&#x60; below.  **Use case:** An in-product \&quot;request a feature\&quot; form posts what the user asked for — &#x60;{ \&quot;title\&quot;: \&quot;Dark mode\&quot;, \&quot;useCase\&quot;: \&quot;Reduce eye strain at night\&quot; }&#x60;.
+    # @param create_public_feature_request_request [CreatePublicFeatureRequestRequest] 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [Array<(GetOpsItemResponse, Integer, Hash)>] GetOpsItemResponse data, response status code and response headers
-    def get_ops_item_with_http_info(handle, opts = {})
+    # @return [Array<(CreatePublicTicketResponse, Integer, Hash)>] CreatePublicTicketResponse data, response status code and response headers
+    def create_public_feature_request_with_http_info(create_public_feature_request_request, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: OpsApi.get_ops_item ...'
+        @api_client.config.logger.debug 'Calling API: OpsApi.create_public_feature_request ...'
       end
-      # resource path
-      local_var_path = '/api/admin/ops/{handle}'.sub('{handle}', CGI.escape(handle.to_s))
-
-      # 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']
-      header_params[:'X-Project-Id'] = opts[:'x_project_id'] if !opts[:'x_project_id'].nil?
-
-      # form parameters
-      form_params = opts[:form_params] || {}
-
-      # http body (model)
-      post_body = opts[:debug_body]
-
-      # return_type
-      return_type = opts[:debug_return_type] || 'GetOpsItemResponse'
-
-      # auth_names
-      auth_names = opts[:debug_auth_names] || ['bearerSdkKey']
-
-      new_options = opts.merge(
-        :operation => :"OpsApi.get_ops_item",
-        :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: OpsApi#get_ops_item\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
-    # Link a fixing PR
-    # Record the pull request that fixes a queue item (and clears the link with `prNumber: null`).  **Use case:** Tie the fixing PR to the item so closing the PR can flip it to ready_for_qa.
-    # @param handle [String] Per-project item number (e.g. &#x60;7&#x60;) or the full ops item id.
-    # @param link_pr_to_ops_item_request [LinkPrToOpsItemRequest] 
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [LinkPrToOpsItemResponse]
-    def link_pr_to_ops_item(handle, link_pr_to_ops_item_request, opts = {})
-      data, _status_code, _headers = link_pr_to_ops_item_with_http_info(handle, link_pr_to_ops_item_request, opts)
-      data
-    end
-
-    # Link a fixing PR
-    # Record the pull request that fixes a queue item (and clears the link with &#x60;prNumber: null&#x60;).  **Use case:** Tie the fixing PR to the item so closing the PR can flip it to ready_for_qa.
-    # @param handle [String] Per-project item number (e.g. &#x60;7&#x60;) or the full ops item id.
-    # @param link_pr_to_ops_item_request [LinkPrToOpsItemRequest] 
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [Array<(LinkPrToOpsItemResponse, Integer, Hash)>] LinkPrToOpsItemResponse data, response status code and response headers
-    def link_pr_to_ops_item_with_http_info(handle, link_pr_to_ops_item_request, opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: OpsApi.link_pr_to_ops_item ...'
-      end
-      # verify the required parameter 'handle' is set
-      if @api_client.config.client_side_validation && handle.nil?
-        fail ArgumentError, "Missing the required parameter 'handle' when calling OpsApi.link_pr_to_ops_item"
-      end
-      # verify the required parameter 'link_pr_to_ops_item_request' is set
-      if @api_client.config.client_side_validation && link_pr_to_ops_item_request.nil?
-        fail ArgumentError, "Missing the required parameter 'link_pr_to_ops_item_request' when calling OpsApi.link_pr_to_ops_item"
+      # verify the required parameter 'create_public_feature_request_request' is set
+      if @api_client.config.client_side_validation && create_public_feature_request_request.nil?
+        fail ArgumentError, "Missing the required parameter 'create_public_feature_request_request' when calling OpsApi.create_public_feature_request"
       end
       # resource path
-      local_var_path = '/api/admin/ops/{handle}/link-pr'.sub('{handle}', CGI.escape(handle.to_s))
+      local_var_path = '/ops/feature-request'
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -198,22 +125,21 @@ module Shipeasy::Admin::Generated
       if !content_type.nil?
           header_params['Content-Type'] = content_type
       end
-      header_params[:'X-Project-Id'] = opts[:'x_project_id'] if !opts[:'x_project_id'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(link_pr_to_ops_item_request)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(create_public_feature_request_request)
 
       # return_type
-      return_type = opts[:debug_return_type] || 'LinkPrToOpsItemResponse'
+      return_type = opts[:debug_return_type] || 'CreatePublicTicketResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['bearerSdkKey']
+      auth_names = opts[:debug_auth_names] || ['clientSdkKey']
 
       new_options = opts.merge(
-        :operation => :"OpsApi.link_pr_to_ops_item",
+        :operation => :"OpsApi.create_public_feature_request",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -224,240 +150,7 @@ module Shipeasy::Admin::Generated
 
       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: OpsApi#link_pr_to_ops_item\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
-    # List the operational queue
-    # Returns the unified ops queue (bugs, feature requests, errors, alerts), newest first. Filter by `type` and/or `status`, and cap with `limit`.  **Use case:** Pull the open queue to triage — e.g. every `bug` still `open` — before working items down one by one.
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @option opts [String] :type Filter by item type (&#x60;bug&#x60;/&#x60;feature_request&#x60;/&#x60;error&#x60;/&#x60;alert&#x60;), or &#x60;all&#x60;.
-    # @option opts [String] :status Filter by lifecycle status, or &#x60;all&#x60;.
-    # @option opts [Integer] :limit Max items to return (1–500).
-    # @return [Array<ListOpsItemsResponseInner>]
-    def list_ops_items(opts = {})
-      data, _status_code, _headers = list_ops_items_with_http_info(opts)
-      data
-    end
-
-    # List the operational queue
-    # Returns the unified ops queue (bugs, feature requests, errors, alerts), newest first. Filter by &#x60;type&#x60; and/or &#x60;status&#x60;, and cap with &#x60;limit&#x60;.  **Use case:** Pull the open queue to triage — e.g. every &#x60;bug&#x60; still &#x60;open&#x60; — before working items down one by one.
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @option opts [String] :type Filter by item type (&#x60;bug&#x60;/&#x60;feature_request&#x60;/&#x60;error&#x60;/&#x60;alert&#x60;), or &#x60;all&#x60;.
-    # @option opts [String] :status Filter by lifecycle status, or &#x60;all&#x60;.
-    # @option opts [Integer] :limit Max items to return (1–500).
-    # @return [Array<(Array<ListOpsItemsResponseInner>, Integer, Hash)>] Array<ListOpsItemsResponseInner> data, response status code and response headers
-    def list_ops_items_with_http_info(opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: OpsApi.list_ops_items ...'
-      end
-      allowable_values = ["bug", "feature_request", "error", "alert", "all"]
-      if @api_client.config.client_side_validation && opts[:'type'] && !allowable_values.include?(opts[:'type'])
-        fail ArgumentError, "invalid value for \"type\", must be one of #{allowable_values}"
-      end
-      allowable_values = ["open", "triaged", "in_progress", "ready_for_qa", "resolved", "wont_fix", "all"]
-      if @api_client.config.client_side_validation && opts[:'status'] && !allowable_values.include?(opts[:'status'])
-        fail ArgumentError, "invalid value for \"status\", must be one of #{allowable_values}"
-      end
-      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 500
-        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling OpsApi.list_ops_items, must be smaller than or equal to 500.'
-      end
-
-      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
-        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling OpsApi.list_ops_items, must be greater than or equal to 1.'
-      end
-
-      # resource path
-      local_var_path = '/api/admin/ops'
-
-      # query parameters
-      query_params = opts[:query_params] || {}
-      query_params[:'type'] = opts[:'type'] if !opts[:'type'].nil?
-      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
-      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
-
-      # 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']
-      header_params[:'X-Project-Id'] = opts[:'x_project_id'] if !opts[:'x_project_id'].nil?
-
-      # form parameters
-      form_params = opts[:form_params] || {}
-
-      # http body (model)
-      post_body = opts[:debug_body]
-
-      # return_type
-      return_type = opts[:debug_return_type] || 'Array<ListOpsItemsResponseInner>'
-
-      # auth_names
-      auth_names = opts[:debug_auth_names] || ['bearerSdkKey']
-
-      new_options = opts.merge(
-        :operation => :"OpsApi.list_ops_items",
-        :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: OpsApi#list_ops_items\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
-    # Raise an attention notification
-    # Raise a 'needs your attention' bell notification. Create-only and idempotent on `dedupeKey`.  **Use case:** Escalate something that needs a human, deduped so repeats don't spam the bell.
-    # @param notify_ops_request [NotifyOpsRequest] 
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [NotifyOpsResponse]
-    def notify_ops(notify_ops_request, opts = {})
-      data, _status_code, _headers = notify_ops_with_http_info(notify_ops_request, opts)
-      data
-    end
-
-    # Raise an attention notification
-    # Raise a &#39;needs your attention&#39; bell notification. Create-only and idempotent on &#x60;dedupeKey&#x60;.  **Use case:** Escalate something that needs a human, deduped so repeats don&#39;t spam the bell.
-    # @param notify_ops_request [NotifyOpsRequest] 
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [Array<(NotifyOpsResponse, Integer, Hash)>] NotifyOpsResponse data, response status code and response headers
-    def notify_ops_with_http_info(notify_ops_request, opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: OpsApi.notify_ops ...'
-      end
-      # verify the required parameter 'notify_ops_request' is set
-      if @api_client.config.client_side_validation && notify_ops_request.nil?
-        fail ArgumentError, "Missing the required parameter 'notify_ops_request' when calling OpsApi.notify_ops"
-      end
-      # resource path
-      local_var_path = '/api/admin/notifications'
-
-      # 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
-      header_params[:'X-Project-Id'] = opts[:'x_project_id'] if !opts[:'x_project_id'].nil?
-
-      # form parameters
-      form_params = opts[:form_params] || {}
-
-      # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(notify_ops_request)
-
-      # return_type
-      return_type = opts[:debug_return_type] || 'NotifyOpsResponse'
-
-      # auth_names
-      auth_names = opts[:debug_auth_names] || ['bearerSdkKey']
-
-      new_options = opts.merge(
-        :operation => :"OpsApi.notify_ops",
-        :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: OpsApi#notify_ops\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
-    # Update a queue item
-    # Update a queue item's `status` and/or `priority`. Other fields are immutable.  **Use case:** Move an item through its lifecycle (triage → in_progress → resolved) as you work it.
-    # @param handle [String] Per-project item number (e.g. &#x60;7&#x60;) or the full ops item id.
-    # @param update_ops_item_request [UpdateOpsItemRequest] 
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [UpdateOpsItemResponse]
-    def update_ops_item(handle, update_ops_item_request, opts = {})
-      data, _status_code, _headers = update_ops_item_with_http_info(handle, update_ops_item_request, opts)
-      data
-    end
-
-    # Update a queue item
-    # Update a queue item&#39;s &#x60;status&#x60; and/or &#x60;priority&#x60;. Other fields are immutable.  **Use case:** Move an item through its lifecycle (triage → in_progress → resolved) as you work it.
-    # @param handle [String] Per-project item number (e.g. &#x60;7&#x60;) or the full ops item id.
-    # @param update_ops_item_request [UpdateOpsItemRequest] 
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :x_project_id Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
-    # @return [Array<(UpdateOpsItemResponse, Integer, Hash)>] UpdateOpsItemResponse data, response status code and response headers
-    def update_ops_item_with_http_info(handle, update_ops_item_request, opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: OpsApi.update_ops_item ...'
-      end
-      # verify the required parameter 'handle' is set
-      if @api_client.config.client_side_validation && handle.nil?
-        fail ArgumentError, "Missing the required parameter 'handle' when calling OpsApi.update_ops_item"
-      end
-      # verify the required parameter 'update_ops_item_request' is set
-      if @api_client.config.client_side_validation && update_ops_item_request.nil?
-        fail ArgumentError, "Missing the required parameter 'update_ops_item_request' when calling OpsApi.update_ops_item"
-      end
-      # resource path
-      local_var_path = '/api/admin/ops/{handle}'.sub('{handle}', CGI.escape(handle.to_s))
-
-      # 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
-      header_params[:'X-Project-Id'] = opts[:'x_project_id'] if !opts[:'x_project_id'].nil?
-
-      # form parameters
-      form_params = opts[:form_params] || {}
-
-      # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(update_ops_item_request)
-
-      # return_type
-      return_type = opts[:debug_return_type] || 'UpdateOpsItemResponse'
-
-      # auth_names
-      auth_names = opts[:debug_auth_names] || ['bearerSdkKey']
-
-      new_options = opts.merge(
-        :operation => :"OpsApi.update_ops_item",
-        :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(:PATCH, local_var_path, new_options)
-      if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: OpsApi#update_ops_item\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: OpsApi#create_public_feature_request\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end

data/lib/shipeasy_admin/api_client.rb

@@ -1,7 +1,7 @@
 =begin
-#Shipeasy Admin API
+#Shipeasy Admin API (server-SDK surface)
 
-#REST API for managing feature gates, experiments, configs, universes, and killswitches in a Shipeasy project. Authenticate with an admin SDK key (`Authorization: Bearer sdk_admin_…`) and scope every request to a project via the `X-Project-Id` header.  Mint admin keys via `POST /api/admin/keys` with `type: \"admin\"`. Keys expire after 90 days; rotate with the `revoke` action.
+#The slice of the Shipeasy admin API that the published server SDKs expose as their optional `AdminClient`. Authenticate with an admin SDK key (`Authorization: Bearer sdk_admin_…`) and scope every request to a project via the `X-Project-Id` header.  Three capabilities, nothing else:  - **File a public ticket** — a bug or a feature request onto the project's ops queue. - **Toggle a kill switch** — flip the switch itself, or one of its named sub-switches, on one environment. - **Manage a flag's whitelist** — read, replace, add to, or remove from the allowlist that admits specific identities ahead of every targeting rule.  Everything else in the admin API is reachable through the Shipeasy CLI and MCP server, which speak the complete contract (`openapi.yaml`).
 
 The version of the OpenAPI document: 2.0.0
 

data/lib/shipeasy_admin/api_error.rb

@@ -1,7 +1,7 @@
 =begin
-#Shipeasy Admin API
+#Shipeasy Admin API (server-SDK surface)
 
-#REST API for managing feature gates, experiments, configs, universes, and killswitches in a Shipeasy project. Authenticate with an admin SDK key (`Authorization: Bearer sdk_admin_…`) and scope every request to a project via the `X-Project-Id` header.  Mint admin keys via `POST /api/admin/keys` with `type: \"admin\"`. Keys expire after 90 days; rotate with the `revoke` action.
+#The slice of the Shipeasy admin API that the published server SDKs expose as their optional `AdminClient`. Authenticate with an admin SDK key (`Authorization: Bearer sdk_admin_…`) and scope every request to a project via the `X-Project-Id` header.  Three capabilities, nothing else:  - **File a public ticket** — a bug or a feature request onto the project's ops queue. - **Toggle a kill switch** — flip the switch itself, or one of its named sub-switches, on one environment. - **Manage a flag's whitelist** — read, replace, add to, or remove from the allowlist that admits specific identities ahead of every targeting rule.  Everything else in the admin API is reachable through the Shipeasy CLI and MCP server, which speak the complete contract (`openapi.yaml`).
 
 The version of the OpenAPI document: 2.0.0
 

data/lib/shipeasy_admin/api_model_base.rb

@@ -1,7 +1,7 @@
 =begin
-#Shipeasy Admin API
+#Shipeasy Admin API (server-SDK surface)
 
-#REST API for managing feature gates, experiments, configs, universes, and killswitches in a Shipeasy project. Authenticate with an admin SDK key (`Authorization: Bearer sdk_admin_…`) and scope every request to a project via the `X-Project-Id` header.  Mint admin keys via `POST /api/admin/keys` with `type: \"admin\"`. Keys expire after 90 days; rotate with the `revoke` action.
+#The slice of the Shipeasy admin API that the published server SDKs expose as their optional `AdminClient`. Authenticate with an admin SDK key (`Authorization: Bearer sdk_admin_…`) and scope every request to a project via the `X-Project-Id` header.  Three capabilities, nothing else:  - **File a public ticket** — a bug or a feature request onto the project's ops queue. - **Toggle a kill switch** — flip the switch itself, or one of its named sub-switches, on one environment. - **Manage a flag's whitelist** — read, replace, add to, or remove from the allowlist that admits specific identities ahead of every targeting rule.  Everything else in the admin API is reachable through the Shipeasy CLI and MCP server, which speak the complete contract (`openapi.yaml`).
 
 The version of the OpenAPI document: 2.0.0
 

data/lib/shipeasy_admin/configuration.rb

@@ -1,7 +1,7 @@
 =begin
-#Shipeasy Admin API
+#Shipeasy Admin API (server-SDK surface)
 
-#REST API for managing feature gates, experiments, configs, universes, and killswitches in a Shipeasy project. Authenticate with an admin SDK key (`Authorization: Bearer sdk_admin_…`) and scope every request to a project via the `X-Project-Id` header.  Mint admin keys via `POST /api/admin/keys` with `type: \"admin\"`. Keys expire after 90 days; rotate with the `revoke` action.
+#The slice of the Shipeasy admin API that the published server SDKs expose as their optional `AdminClient`. Authenticate with an admin SDK key (`Authorization: Bearer sdk_admin_…`) and scope every request to a project via the `X-Project-Id` header.  Three capabilities, nothing else:  - **File a public ticket** — a bug or a feature request onto the project's ops queue. - **Toggle a kill switch** — flip the switch itself, or one of its named sub-switches, on one environment. - **Manage a flag's whitelist** — read, replace, add to, or remove from the allowlist that admits specific identities ahead of every targeting rule.  Everything else in the admin API is reachable through the Shipeasy CLI and MCP server, which speak the complete contract (`openapi.yaml`).
 
 The version of the OpenAPI document: 2.0.0
 
@@ -256,6 +256,13 @@ module Shipeasy::Admin::Generated
             key: 'Authorization',
             value: "Bearer #{access_token_with_refresh}"
           },
+        'clientSdkKey' =>
+          {
+            type: 'api_key',
+            in: 'header',
+            key: 'X-SDK-Key',
+            value: api_key_with_prefix('X-SDK-Key')
+          },
       }
     end
 
@@ -275,6 +282,26 @@ module Shipeasy::Admin::Generated
 
     def operation_server_settings
       {
+        "OpsApi.create_public_bug": [
+          {
+          url: "https://api.shipeasy.ai",
+          description: "Shipeasy edge worker (production)",
+          },
+          {
+          url: "http://localhost:8787",
+          description: "Local `wrangler dev`",
+          }
+        ],
+        "OpsApi.create_public_feature_request": [
+          {
+          url: "https://api.shipeasy.ai",
+          description: "Shipeasy edge worker (production)",
+          },
+          {
+          url: "http://localhost:8787",
+          description: "Local `wrangler dev`",
+          }
+        ],
       }
     end