runtype 0.3.0 → 0.11.1

data/README.md

@@ -96,6 +96,34 @@ pass `on_conflict: "overwrite"` to converge over it) or when an
 platform does, over the canonical normalized form (keys ordered as `JSON.stringify`
 emits them, numbers rendered as JavaScript renders them).
 
+### Skills, flows, tools, surfaces, products and evals
+
+The same hash-first converge exists for every other config entity. Definitions are
+wire-shaped Hashes (Symbol or String keys). Create skills and tools before the agents
+that reference them.
+
+```ruby
+client.ensure_skill({ name: "code_reviewer", manifest: manifest }, release: "publish")
+client.ensure_tool({ name: "Weather Lookup", toolType: "external", ... })
+client.ensure_flow({ name: "Digest", steps: [...], evals: [...] })
+client.ensure_eval(suite)
+client.ensure_product({ name: "Support Desk", ... })
+client.ensure_fpo(fpo, prune: true)   # a whole product graph in one call
+
+# Surfaces are scoped to a product. A definition with inbound/outbound always ships
+# in full, so a credential-only change is written.
+client.ensure_surface(product_id, { name: "slack", type: "slack", inbound: { ... } })
+
+client.pull_flow("Digest")
+client.pull_surface(product_id, "slack")
+```
+
+Each `ensure_*` except `ensure_eval` and `ensure_fpo` takes `dry_run:`,
+`expect_no_changes:`, `on_conflict:` and `expected_remote_hash:`, and raises
+`Runtype::EnsureConflictError` and `Runtype::DriftError` as `ensure_agent` does.
+`Runtype::ContentHash` computes each entity's hash byte for byte like the TypeScript
+and Python SDKs.
+
 ## Release aliases
 
 An agent runs an immutable **version**. A named mutable **alias** selects which one:
@@ -119,6 +147,34 @@ client.archive_agent_alias(agent_id, "pr-482", revision: preview.revision)
 client.list_agent_deployments(agent_id, alias_name: "live", limit: 20)
 ```
 
+### Closing a pull request
+
+One pointer name usually spans several agents, so the cleanup a closed pull
+request runs is org-wide rather than per agent:
+
+```ruby
+client.list_agent_aliases_by_name("pr-482")            # every agent carrying it, with each revision
+client.archive_agent_alias_everywhere("pr-482", dry_run: true)  # report, archive nothing
+client.archive_agent_alias_everywhere("pr-482")
+```
+
+The sweep archives each pointer under the revision it just read, so a concurrent
+deploy answers 412 instead of racing. One agent's failure is reported rather than
+aborting the rest, transport failures included:
+
+```ruby
+sweep = client.archive_agent_alias_everywhere("pr-482")
+sweep["archived"]  # [{"agentId", "agentName", "revision", "receiptId"}, ...]
+sweep["failed"]    # [{"agentId", "agentName", "error", "code" => "alias_revision_mismatch"}, ...]
+```
+
+`"code"` is the alias plane's refusal code and is absent on a transport failure
+(DNS, TLS, a connection reset), which is reported with its message alone.
+
+Only active pointers are listed, so a second run archives nothing. A dry run
+answers `{"alias", "dryRun" => true, "wouldArchive" => [<row>]}` with the listed
+rows unchanged.
+
 `version_id` is sent exactly as given: the SDK never resolves an alias to a version
 for you. `revision:` is the alias revision you read back from `get_agent_alias`, sent
 as `If-Match`; moving an existing `live` pointer requires it, and a stale value is a
@@ -139,6 +195,20 @@ client.ensure_agent(assistant, deploy: "live")              # a bare String name
 `release: "publish"` is the older spelling of `deploy: { alias: "live" }`. Passing both
 raises an `ArgumentError` with the same sentence the API answers a 400 with.
 
+`version:` stamps the appended version row with your own provenance, which is what the
+agent page, the receipts and the compare-to-live view key on. Omit it and the label is
+`"sdk-ensure"` with server-generated notes:
+
+```ruby
+client.ensure_agent(assistant, deploy: "live",
+                    version: { label: ENV.fetch("GITHUB_SHA")[0, 7],
+                               notes: "Promoted from CI run #{ENV.fetch("GITHUB_RUN_ID")}" })
+```
+
+Both fields are optional (`label` up to 100 characters, `notes` up to 2000), and a hash
+whose values are all `nil` is treated as omitted rather than refused, so building one
+from environment variables that may be absent still saves.
+
 Dispatch against a pointer instead of pinning a version, and the run resolves it at
 admission:
 
@@ -160,8 +230,10 @@ staging    = Runtype::Client.new(api_key: ENV.fetch("RUNTYPE_STAGING_KEY"))
 production = Runtype::Client.new(api_key: ENV.fetch("RUNTYPE_PRODUCTION_KEY"))
 
 # 1. Prepare. Same portable definition, destination account, no deploy: so live is untouched.
-definition = staging.pull_agent("Pricing Assistant")["definition"]
-prepared = production.ensure_agent(definition)
+source = staging.pull_agent("Pricing Assistant")
+prepared = production.ensure_agent(
+  source["definition"], version: { label: ENV.fetch("GITHUB_SHA")[0, 7] }
+)
 agent_id, candidate = prepared["agentId"], prepared["versionId"]
 
 # 2. Validate the bindings in the destination, where the portable refs actually resolve.
@@ -173,13 +245,20 @@ report = production.evals.run_eval_suite_synchronously(
   suite_id: "evs_pricing", agent: { versionId: candidate }
 )
 
-# 4. Activate, quoting the revision you just read.
+# 4. Activate, quoting the revision you just read, and name where this came from.
 production.activate_agent_alias(
   agent_id, "live", version_id: candidate, revision: live.revision,
-  idempotency_key: "release-#{candidate}", reason: "promoted from staging"
+  idempotency_key: "release-#{candidate}", reason: "promoted from staging",
+  promotion: { source_agent_id: source["agentId"], source_version_id: source["versionId"],
+               source_content_hash: source["contentHash"], source_commit: ENV.fetch("GITHUB_SHA") }
 )
 ```
 
+`promotion:` is what makes the production receipt name the staging version it came
+from. It is provenance only: it authorizes nothing, and the destination credentials
+alone decide what the activation may do. Every field is optional, and a hash whose
+values are all `nil` is treated as omitted.
+
 Nothing gates step 4 on step 3. `evaluate` reports; it does not hold the pointer. If a
 score should stop a release, branch on `report` yourself before calling
 `activate_agent_alias`. An environment-specific rendering of the definition produces a
@@ -202,6 +281,26 @@ different accounts or environments can coexist in one process.
 A missing or blank key raises `Runtype::AuthenticationError` at construction, before
 any request goes out.
 
+## Timeouts
+
+`timeout:` is the per-operation socket timeout in seconds, defaulting to 600. It is
+generous on purpose: an execution stream can idle between events while a model is
+thinking, and a synchronous eval run can take minutes. One value governs the dispatch
+and streaming paths and every generated resource call alike.
+
+```ruby
+client = Runtype::Client.new(timeout: 900)            # ten minutes is not enough
+client.evals.run_eval_suite_synchronously(suite_id: "evs_1")   # runs under 900 seconds
+
+# Override for one call, without touching the client other threads are sharing.
+client.flows.list_flows(request_options: { timeout_in_seconds: 5 })
+```
+
+A socket timeout raises `Runtype::APITimeoutError` on the dispatch and streaming
+paths. On a generated resource call it raises the transport's own error, so wrap the
+call in `Runtype.wrap_errors` to get `Runtype::APITimeoutError` there too, the same
+way the curated hierarchy is reached for every other generated failure.
+
 ## Streaming
 
 `dispatch_stream` returns a `Runtype::Streaming::EventStream`, an `Enumerable` of
@@ -309,13 +408,13 @@ Everything the client raises descends from `Runtype::Error`.
 | `Runtype::PermissionDeniedError`    | 403                                                                            |
 | `Runtype::NotFoundError`            | 404                                                                            |
 | `Runtype::ConflictError`            | 409                                                                            |
-| `Runtype::EnsureConflictError`      | 409 from `ensure_agent`, exposes `#code`                                       |
+| `Runtype::EnsureConflictError`      | 409 from an `ensure_*` call, exposes `#code`                                   |
 | `Runtype::UnprocessableEntityError` | 422                                                                            |
 | `Runtype::RateLimitError`           | 429, exposes `#retry_after`                                                    |
 | `Runtype::APIStatusError`           | any other non-2xx                                                              |
 | `Runtype::APITimeoutError`          | the request timed out                                                          |
 | `Runtype::APIConnectionError`       | the request never reached the API                                              |
-| `Runtype::DriftError`               | `ensure_agent(..., expect_no_changes: true)` found drift, exposes `#plan`      |
+| `Runtype::DriftError`               | `ensure_*(..., expect_no_changes: true)` found drift, exposes `#plan`          |
 | `Runtype::LocalToolError`           | `run_with_local_tools` could not run a tool, exposes `#tool_name` and `#cause` |
 
 Status errors carry `#status_code`, `#body` (parsed when the response was JSON), and
@@ -399,12 +498,19 @@ an empty `GEM_HOME` to prove the packaged layout loads.
 
 The gem is published by `.github/workflows/publish-ruby-sdk.yml` through RubyGems
 trusted publishing (OIDC against the `rubygems` GitHub environment; no API key).
-The SDK sits outside the monorepo's changesets flow, so a release is:
-
-1. Bump `SDK_VERSION` in `lib/runtype/sdk_version.rb` and add a `## <version>`
-   section to `CHANGELOG.md`, in a PR to `staging`.
-2. After it merges, run the workflow from `staging` with that version, first with
-   `dry_run` on, then off:
+The version comes from the monorepo's changesets flow, so a release is:
+
+1. Land a changeset naming `@runtypelabs/ruby-sdk` (an overlay PR writes its
+   own; the Update SDKs bot writes one for every regenerated core, see
+   `docs/claude/sdk-release.md`). Never hand-edit `SDK_VERSION` in
+   `lib/runtype/sdk_version.rb`: it is a mirror of `package.json`, rewritten by
+   `scripts/sync-sdk-versions.mjs` on every Version Packages run, and
+   `pnpm check:release-config` reds on drift.
+2. Merge the Version Packages PR. That bumps `package.json`, mirrors the number
+   into `sdk_version.rb`, and prepends the `## <version>` section to
+   `CHANGELOG.md`.
+3. Run the workflow from `staging` with that version, first with `dry_run` on,
+   then off:
 
    ```bash
    gh workflow run publish-ruby-sdk.yml --ref staging -f version=<version> -f dry_run=true

data/generated/lib/runtype/agent_aliases/client.rb

@@ -260,6 +260,159 @@ module Runtype
         end
       end
 
+      # The per-alias secret binding NAMES this pointer carries. A binding value is write-only: no read surface returns
+      # it, and it never appears on a receipt, an audit envelope or a log line.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :id
+      # @option params [String] :alias_
+      #
+      # @example
+      #   client.agent_aliases.read_the_secret_binding_names_of_a_release_alias(
+      #     id: "id",
+      #     alias_: "alias"
+      #   )
+      #
+      # @return [Runtype::AgentAliases::Types::GetV1AgentsIDAliasesAliasBindingsResponse]
+      def read_the_secret_binding_names_of_a_release_alias(request_options: {}, **params)
+        params = Runtype::Internal::Types::Utils.normalize_keys(params)
+        request = Runtype::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "v1/agents/#{URI.encode_uri_component(params[:id].to_s)}/aliases/#{URI.encode_uri_component(params[:alias_].to_s)}/bindings",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Runtype::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Runtype::AgentAliases::Types::GetV1AgentsIDAliasesAliasBindingsResponse.load(response.body)
+        else
+          error_class = Runtype::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Replace the complete set of `{{secret:NAME}}` values executions resolve when they reach this agent through this
+      # pointer. A binding wins over the organization secret of the same name, so one preview per pull request can aim
+      # its HTTP tools at that pull request environment while the version content stays byte-identical to what `live`
+      # runs. Whole-set replacement: a name you stop sending stops resolving. Values are encrypted at rest and never
+      # returned. Names beginning RUNTYPE_, PLATFORM_, CLOUDFLARE_ or INTERNAL_ are refused because they are
+      # platform-resolved before the alias plane. A change bumps the alias revision and appends a `bind` receipt; an
+      # identical set writes nothing. Requires the same deploy scope as activating this alias.
+      #
+      # @param request_options [Hash]
+      # @param params [Runtype::AgentAliases::Types::PutV1AgentsIDAliasesAliasBindingsRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :id
+      # @option params [String] :alias_
+      # @option params [String, nil] :if_match
+      # @option params [String, nil] :idempotency_key
+      #
+      # @example
+      #   client.agent_aliases.replace_the_secret_bindings_of_a_release_alias(
+      #     id: "id",
+      #     alias_: "alias",
+      #     bindings: {
+      #       key: "value"
+      #     }
+      #   )
+      #
+      # @return [Runtype::AgentAliases::Types::PutV1AgentsIDAliasesAliasBindingsResponse]
+      def replace_the_secret_bindings_of_a_release_alias(request_options: {}, **params)
+        params = Runtype::Internal::Types::Utils.normalize_keys(params)
+        request_data = Runtype::AgentAliases::Types::PutV1AgentsIDAliasesAliasBindingsRequest.new(params).to_h
+        non_body_param_names = %w[id alias if-match idempotency-key]
+        body = request_data.except(*non_body_param_names)
+
+        headers = {}
+        headers["if-match"] = params[:if_match] if params[:if_match]
+        headers["idempotency-key"] = params[:idempotency_key] if params[:idempotency_key]
+
+        request = Runtype::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "PUT",
+          path: "v1/agents/#{URI.encode_uri_component(params[:id].to_s)}/aliases/#{URI.encode_uri_component(params[:alias_].to_s)}/bindings",
+          headers: headers,
+          body: body,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Runtype::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Runtype::AgentAliases::Types::PutV1AgentsIDAliasesAliasBindingsResponse.load(response.body)
+        else
+          error_class = Runtype::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Remove every per-alias secret binding from this pointer, so its executions fall back to the organization
+      # secrets. Equivalent to replacing the set with an empty object.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :id
+      # @option params [String] :alias_
+      # @option params [String, nil] :if_match
+      # @option params [String, nil] :idempotency_key
+      #
+      # @example
+      #   client.agent_aliases.clear_the_secret_bindings_of_a_release_alias(
+      #     id: "id",
+      #     alias_: "alias"
+      #   )
+      #
+      # @return [Runtype::AgentAliases::Types::DeleteV1AgentsIDAliasesAliasBindingsResponse]
+      def clear_the_secret_bindings_of_a_release_alias(request_options: {}, **params)
+        params = Runtype::Internal::Types::Utils.normalize_keys(params)
+        headers = {}
+        headers["if-match"] = params[:if_match] if params[:if_match]
+        headers["idempotency-key"] = params[:idempotency_key] if params[:idempotency_key]
+
+        request = Runtype::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "DELETE",
+          path: "v1/agents/#{URI.encode_uri_component(params[:id].to_s)}/aliases/#{URI.encode_uri_component(params[:alias_].to_s)}/bindings",
+          headers: headers,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Runtype::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Runtype::AgentAliases::Types::DeleteV1AgentsIDAliasesAliasBindingsResponse.load(response.body)
+        else
+          error_class = Runtype::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
       # Re-aim an alias at the version recorded as `previousVersionId` on its most recent pointer-moving receipt,
       # walking `steps` receipts back. Writes a `rollback` receipt. Rolling back `live` follows the same scope and
       # `If-Match` rules as activation, and restores configuration only: external data and side effects are not rolled

data/generated/lib/runtype/agent_aliases/types/delete_v1agents_id_aliases_alias_bindings_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Runtype
+  module AgentAliases
+    module Types
+      class DeleteV1AgentsIDAliasesAliasBindingsRequest < Internal::Types::Model
+        field :id, -> { String }, optional: false, nullable: false
+
+        field :alias_, -> { String }, optional: false, nullable: false, api_name: "alias"
+
+        field :if_match, -> { String }, optional: true, nullable: false, api_name: "if-match"
+
+        field :idempotency_key, -> { String }, optional: true, nullable: false, api_name: "idempotency-key"
+      end
+    end
+  end
+end

data/generated/lib/runtype/agent_aliases/types/delete_v1agents_id_aliases_alias_bindings_response.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Runtype
+  module AgentAliases
+    module Types
+      class DeleteV1AgentsIDAliasesAliasBindingsResponse < Internal::Types::Model
+        field :alias_, -> { String }, optional: false, nullable: false, api_name: "alias"
+
+        field :changed, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+        field :names, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+
+        field :receipt_id, -> { String }, optional: true, nullable: false, api_name: "receiptId"
+
+        field :revision, -> { Integer }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/generated/lib/runtype/agent_aliases/types/get_v1agents_id_aliases_alias_bindings_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Runtype
+  module AgentAliases
+    module Types
+      class GetV1AgentsIDAliasesAliasBindingsRequest < Internal::Types::Model
+        field :id, -> { String }, optional: false, nullable: false
+
+        field :alias_, -> { String }, optional: false, nullable: false, api_name: "alias"
+      end
+    end
+  end
+end

data/generated/lib/runtype/agent_aliases/types/get_v1agents_id_aliases_alias_bindings_response.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Runtype
+  module AgentAliases
+    module Types
+      class GetV1AgentsIDAliasesAliasBindingsResponse < Internal::Types::Model
+        field :alias_, -> { String }, optional: false, nullable: false, api_name: "alias"
+
+        field :changed, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+        field :names, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+
+        field :receipt_id, -> { String }, optional: true, nullable: false, api_name: "receiptId"
+
+        field :revision, -> { Integer }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/generated/lib/runtype/agent_aliases/types/get_v1agents_id_aliases_alias_response.rb

@@ -8,6 +8,8 @@ module Runtype
 
         field :archived_at, -> { String }, optional: false, nullable: true, api_name: "archivedAt"
 
+        field :binding_names, -> { Internal::Types::Array[String] }, optional: false, nullable: false, api_name: "bindingNames"
+
         field :content_hash, -> { String }, optional: false, nullable: true, api_name: "contentHash"
 
         field :created_at, -> { String }, optional: false, nullable: false, api_name: "createdAt"

data/generated/lib/runtype/agent_aliases/types/get_v1agents_id_aliases_response.rb

@@ -6,6 +6,8 @@ module Runtype
       class GetV1AgentsIDAliasesResponse < Internal::Types::Model
         field :data, -> { Internal::Types::Array[Runtype::AgentAliases::Types::GetV1AgentsIDAliasesResponseDataItem] }, optional: false, nullable: false
 
+        field :live_default, -> { Internal::Types::Boolean }, optional: false, nullable: false, api_name: "liveDefault"
+
         field :next_cursor, -> { String }, optional: false, nullable: true, api_name: "nextCursor"
       end
     end

data/generated/lib/runtype/agent_aliases/types/get_v1agents_id_aliases_response_data_item.rb

@@ -8,6 +8,8 @@ module Runtype
 
         field :archived_at, -> { String }, optional: false, nullable: true, api_name: "archivedAt"
 
+        field :binding_names, -> { Internal::Types::Array[String] }, optional: false, nullable: false, api_name: "bindingNames"
+
         field :content_hash, -> { String }, optional: false, nullable: true, api_name: "contentHash"
 
         field :created_at, -> { String }, optional: false, nullable: false, api_name: "createdAt"

data/generated/lib/runtype/agent_aliases/types/get_v1agents_id_deployments_response_data_item.rb

@@ -12,6 +12,8 @@ module Runtype
 
         field :alias_revision, -> { Integer }, optional: false, nullable: false, api_name: "aliasRevision"
 
+        field :bindings, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: true
+
         field :created_at, -> { String }, optional: false, nullable: false, api_name: "createdAt"
 
         field :dependencies, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: true

data/generated/lib/runtype/agent_aliases/types/post_v1agents_id_aliases_alias_rollback_response.rb

@@ -8,6 +8,8 @@ module Runtype
 
         field :alias_, -> { String }, optional: false, nullable: false, api_name: "alias"
 
+        field :binding_names, -> { Internal::Types::Array[String] }, optional: false, nullable: false, api_name: "bindingNames"
+
         field :changed, -> { Internal::Types::Boolean }, optional: false, nullable: false
 
         field :preview_limit, -> { Integer }, optional: false, nullable: true, api_name: "previewLimit"

data/generated/lib/runtype/agent_aliases/types/put_v1agents_id_aliases_alias_bindings_request.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Runtype
+  module AgentAliases
+    module Types
+      class PutV1AgentsIDAliasesAliasBindingsRequest < Internal::Types::Model
+        field :id, -> { String }, optional: false, nullable: false
+
+        field :alias_, -> { String }, optional: false, nullable: false, api_name: "alias"
+
+        field :if_match, -> { String }, optional: true, nullable: false, api_name: "if-match"
+
+        field :idempotency_key, -> { String }, optional: true, nullable: false, api_name: "idempotency-key"
+
+        field :bindings, -> { Internal::Types::Hash[String, String] }, optional: false, nullable: false
+
+        field :reason, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/generated/lib/runtype/agent_aliases/types/put_v1agents_id_aliases_alias_bindings_response.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Runtype
+  module AgentAliases
+    module Types
+      class PutV1AgentsIDAliasesAliasBindingsResponse < Internal::Types::Model
+        field :alias_, -> { String }, optional: false, nullable: false, api_name: "alias"
+
+        field :changed, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+        field :names, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+
+        field :receipt_id, -> { String }, optional: true, nullable: false, api_name: "receiptId"
+
+        field :revision, -> { Integer }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/generated/lib/runtype/agent_aliases/types/put_v1agents_id_aliases_alias_response.rb

@@ -8,6 +8,8 @@ module Runtype
 
         field :alias_, -> { String }, optional: false, nullable: false, api_name: "alias"
 
+        field :binding_names, -> { Internal::Types::Array[String] }, optional: false, nullable: false, api_name: "bindingNames"
+
         field :changed, -> { Internal::Types::Boolean }, optional: false, nullable: false
 
         field :preview_limit, -> { Integer }, optional: false, nullable: true, api_name: "previewLimit"

data/generated/lib/runtype/agent_feedback/client.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Runtype
+  module AgentFeedback
+    class Client
+      # @param client [Runtype::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # Report a problem with the Runtype API, MCP tools, documentation, SDKs, CLI, or dashboard. Built for coding
+      # agents: include a category, a short note, and the affected request ID or URL. Any API key can submit, and
+      # submitting costs no credits. Secret-looking values in the note are redacted before storage.
+      #
+      # @param request_options [Hash]
+      # @param params [Runtype::AgentFeedback::Types::PostV1AgentFeedbackRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      #
+      # @example
+      #   client.agent_feedback.report_a_problem(
+      #     category: "api",
+      #     note: "POST /v1/dispatch returned 500 when the flow had no steps; expected a 400 validation error.",
+      #     request_id: "req_01jv0000000000000000000001",
+      #     url: "/v1/dispatch"
+      #   )
+      #
+      # @return [Runtype::AgentFeedback::Types::PostV1AgentFeedbackResponse]
+      def report_a_problem(request_options: {}, **params)
+        params = Runtype::Internal::Types::Utils.normalize_keys(params)
+        request = Runtype::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "v1/agent-feedback",
+          body: Runtype::AgentFeedback::Types::PostV1AgentFeedbackRequest.new(params).to_h,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Runtype::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Runtype::AgentFeedback::Types::PostV1AgentFeedbackResponse.load(response.body)
+        else
+          error_class = Runtype::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+    end
+  end
+end

data/generated/lib/runtype/agent_feedback/types/post_v1agent_feedback_request.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Runtype
+  module AgentFeedback
+    module Types
+      class PostV1AgentFeedbackRequest < Internal::Types::Model
+        field :category, -> { Runtype::AgentFeedback::Types::PostV1AgentFeedbackRequestCategory }, optional: false, nullable: false
+
+        field :note, -> { String }, optional: false, nullable: false
+
+        field :request_id, -> { String }, optional: true, nullable: false, api_name: "requestId"
+
+        field :tool_name, -> { String }, optional: true, nullable: false, api_name: "toolName"
+
+        field :url, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/generated/lib/runtype/agent_feedback/types/post_v1agent_feedback_request_category.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Runtype
+  module AgentFeedback
+    module Types
+      module PostV1AgentFeedbackRequestCategory
+        extend Runtype::Internal::Types::Enum
+
+        API = "api"
+        MCP = "mcp"
+        DOCUMENTATION = "documentation"
+        SDK = "sdk"
+        CLI = "cli"
+        DASHBOARD = "dashboard"
+        OTHER = "other"
+      end
+    end
+  end
+end

data/generated/lib/runtype/agent_feedback/types/post_v1agent_feedback_response.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Runtype
+  module AgentFeedback
+    module Types
+      class PostV1AgentFeedbackResponse < Internal::Types::Model
+        field :id, -> { String }, optional: false, nullable: false
+
+        field :status, -> { Runtype::AgentFeedback::Types::PostV1AgentFeedbackResponseStatus }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/generated/lib/runtype/agent_feedback/types/post_v1agent_feedback_response_status.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Runtype
+  module AgentFeedback
+    module Types
+      module PostV1AgentFeedbackResponseStatus
+        extend Runtype::Internal::Types::Enum
+
+        RECEIVED = "received"
+      end
+    end
+  end
+end