runtype 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: af0bbf25840f4340b5269585397637edd31012849c0d9bb6228d60818a3999b8
-  data.tar.gz: 7faf081469ffb6891459f53583b38919703705b21dc44e72aa99058ad5d6bdb3
+  metadata.gz: d23cd0d2f0bdb92ba4fadac9b25290bd05bd56b768bd504ce72734ac55fa86a7
+  data.tar.gz: 5e14e7acb3005a4fae7c6bfd6a0e9bba5d9743c2012e2a0235515aa72ff20da6
 SHA512:
-  metadata.gz: 037faa37e743cb38c72015de37a5c76f5cc1b01288c592abae0bf1f106f431c1fe3401131f4f7cf695c10fbbfbd30db0ca27dff520f16dde6e8279506d6698ff
-  data.tar.gz: 2db93bef84aef75510da3e23895d15a1cf75d640d8023397d2f90925f2f46353dc2c1adc5b34fb92dc061861e4aaccb6a5cdb96171908c6a054997fa133ee793
+  metadata.gz: 8fbe5f379329fd9dfb6b282c569f144154aeb4e786fb274a42256130dff35ab6e03a69689b747c95945806403eacfa862efcc74c93f1d8d9b0f7e1113cb866e0
+  data.tar.gz: 3b1101e037ea23e8af4fbeb207464f91bf147a5ba7cb70bdb5a99d900815a137656c541b9b81dd72a44ff6e3728539af414f2db0e5c98fb643d60af14f22b393

data/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to the Runtype Ruby SDK are documented here.
 
+## 0.3.0
+
+- Release aliases on `Runtype::Client`: `#list_agent_aliases`, `#get_agent_alias`,
+  `#activate_agent_alias`, `#archive_agent_alias`, `#rollback_agent_alias` and
+  `#list_agent_deployments` wrap the generated `agent_aliases` client with the curated
+  `Runtype::Error` tree. `revision:` is sent as `If-Match` and `idempotency_key:` as
+  `Idempotency-Key`; `version_id` is sent exactly as given, because an alias is never
+  resolved to a version client-side.
+- `Runtype::Client#ensure_agent(deploy:)` saves a version and aims a release alias at
+  it in one call, taking `{ alias: "pr-482" }` or the bare alias name. It rides both
+  the hash probe and the full-definition request. `release:` remains the compatibility
+  spelling of `deploy: { alias: "live" }`; passing both raises an `ArgumentError`
+  carrying the API's own refusal sentence.
+- README: a "Release aliases" section covering the wrappers, dispatching against a
+  pointer, and the cross-organization prepare, validate, evaluate, activate recipe.
+
 ## 0.2.2
 
 - The durable follow from 0.2.1, hardened after review: a buffered follow gives up
@@ -30,7 +46,7 @@ All notable changes to the Runtype Ruby SDK are documented here.
 ## 0.2.0
 
 - Agents as code: `Runtype.define_agent` builds a validated, immutable
-  `Runtype::AgentDefinition` (snake_case or wire camelCase top-level fields, nested
+  `Runtype::AgentDefinition` (`snake_case` or wire `camelCase` top-level fields, nested
   config passed through untouched, account-scoped `tool_…`/`agent_…`/`flow_…` refs
   rejected). `Runtype::Client#ensure_agent` converges it via `POST /v1/agents/ensure`
   with the hash-first probe, per-client memo of the server hash, `dry_run:`,

data/README.md

@@ -83,11 +83,9 @@ pulled["definition"]   # the canonical wire definition; ensure_agent accepts it
 pulled["lastModifiedSource"]
 ```
 
-Top-level fields take snake_case or the wire's camelCase; nested config (`tools`,
+Top-level fields take snake*case or the wire's camelCase; nested config (`tools`,
 `loop_config`, ...) is passed through in wire shape untouched, because its keys can be
-tool names. Definitions must be environment-portable: raw `tool_…`, `agent_…` and
-`flow_…` ids are rejected in favour of `builtin:`, `platform:`, `mcp:` and
-`tool:<name>` / `agent:<name>` / `flow:<name>` references, so the same definition
+tool names. Definitions must be environment-portable: raw `tool*…`, `agent*…`and`flow*…`ids are rejected in favour of`builtin:`, `platform:`, `mcp:`and`tool:<name>`/`agent:<name>`/`flow:<name>` references, so the same definition
 converges staging and production.
 
 `ensure_agent` raises `Runtype::EnsureConflictError` (a 409) when the agent's last
@@ -98,6 +96,95 @@ 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).
 
+## Release aliases
+
+An agent runs an immutable **version**. A named mutable **alias** selects which one:
+`live` is the permanent pointer every unqualified dispatch resolves, and preview
+aliases such as `pr-482` point somewhere else. Every activation appends a
+**deployment receipt**, so the history of what ran is append-only.
+
+```ruby
+client.list_agent_aliases(agent_id)                       # live first, then previews by name
+client.list_agent_aliases(agent_id, include_archived: true, limit: 20, cursor: cursor)
+client.get_agent_alias(agent_id, "live")                  # 404 names the alias; never falls back to live
+
+client.activate_agent_alias(agent_id, "live", version_id: "agv_9",
+                            revision: current.revision,   # sent as If-Match
+                            idempotency_key: "deploy-482",
+                            reason: "ship the pricing fix")
+
+client.rollback_agent_alias(agent_id, "live", steps: 1, revision: current.revision)
+client.archive_agent_alias(agent_id, "pr-482", revision: preview.revision)
+
+client.list_agent_deployments(agent_id, alias_name: "live", limit: 20)
+```
+
+`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
+409 rather than a lost update. Archiving stops a preview from resolving for new
+executions, keeps its history, and does not interrupt runs already admitted; `live`
+cannot be archived. Rollback restores configuration only, not external data or side
+effects.
+
+`ensure_agent` can save and activate in one call. `deploy:` names the alias to aim at
+the version it just saved:
+
+```ruby
+client.ensure_agent(assistant)                              # save a version, live unchanged
+client.ensure_agent(assistant, deploy: { alias: "pr-482" }) # save and aim the preview pointer
+client.ensure_agent(assistant, deploy: "live")              # a bare String names the alias
+```
+
+`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.
+
+Dispatch against a pointer instead of pinning a version, and the run resolves it at
+admission:
+
+```ruby
+client.dispatch(agent: { agentId: agent_id }, messages: messages)                    # live
+client.dispatch(agent: { agentId: agent_id, alias: "pr-482" }, messages: messages)   # a preview
+client.dispatch(agent: { agentId: agent_id, versionId: "agv_9" }, messages: messages) # one exact version
+```
+
+### Deploying across organizations
+
+Organizations are isolated, so a staging version id means nothing in production. The
+recipe is prepare, validate the bindings, evaluate, activate, with one client per
+organization and the destination's own ids throughout. Credentials are never copied:
+the destination's connections and secrets are what its runs use.
+
+```ruby
+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)
+agent_id, candidate = prepared["agentId"], prepared["versionId"]
+
+# 2. Validate the bindings in the destination, where the portable refs actually resolve.
+production.pull_agent("Pricing Assistant")["definition"]["tools"]
+live = production.get_agent_alias(agent_id, "live")
+
+# 3. Evaluate that exact version id against a destination suite.
+report = production.evals.run_eval_suite_synchronously(
+  suite_id: "evs_pricing", agent: { versionId: candidate }
+)
+
+# 4. Activate, quoting the revision you just read.
+production.activate_agent_alias(
+  agent_id, "live", version_id: candidate, revision: live.revision,
+  idempotency_key: "release-#{candidate}", reason: "promoted from staging"
+)
+```
+
+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
+different artifact, so its evaluation evidence does not carry over from staging.
+
 ## Authentication
 
 Pass `api_key:`, or leave it out and the client reads `RUNTYPE_API_KEY`. The base URL
@@ -216,19 +303,19 @@ loop that exceeds `max_rounds:` raises `Runtype::LocalToolError`.
 
 Everything the client raises descends from `Runtype::Error`.
 
-| Class                               | When                               |
-| ----------------------------------- | ---------------------------------- |
-| `Runtype::AuthenticationError`      | 401, or no API key at construction |
-| `Runtype::PermissionDeniedError`    | 403                                |
-| `Runtype::NotFoundError`            | 404                                |
-| `Runtype::ConflictError`            | 409                                |
-| `Runtype::EnsureConflictError`      | 409 from `ensure_agent`, 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` |
+| Class                               | When                                                                           |
+| ----------------------------------- | ------------------------------------------------------------------------------ |
+| `Runtype::AuthenticationError`      | 401, or no API key at construction                                             |
+| `Runtype::PermissionDeniedError`    | 403                                                                            |
+| `Runtype::NotFoundError`            | 404                                                                            |
+| `Runtype::ConflictError`            | 409                                                                            |
+| `Runtype::EnsureConflictError`      | 409 from `ensure_agent`, 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::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

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

@@ -10,6 +10,52 @@ module Runtype
         @client = client
       end
 
+      # Every agent in the caller's organization that carries a release alias with this name, with the pointer revision
+      # to quote back as `If-Match`. This is the read a "pull request closed" cleanup makes before archiving each
+      # pointer. Archived rows are omitted unless `includeArchived=true`; the built-in `live` alias is readable here
+      # like any other name.
+      #
+      # @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] :alias_
+      # @option params [String, nil] :include_archived
+      #
+      # @example
+      #   client.agent_aliases.list_release_aliases_with_one_name_across_the_organization(alias_: "alias")
+      #
+      # @return [Runtype::AgentAliases::Types::GetV1AgentAliasesResponse]
+      def list_release_aliases_with_one_name_across_the_organization(request_options: {}, **params)
+        params = Runtype::Internal::Types::Utils.normalize_keys(params)
+        query_params = {}
+        query_params["alias"] = params[:alias_] if params.key?(:alias_)
+        query_params["includeArchived"] = params[:include_archived] if params.key?(:include_archived)
+
+        request = Runtype::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "v1/agent-aliases",
+          query: query_params,
+          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::GetV1AgentAliasesResponse.load(response.body)
+        else
+          error_class = Runtype::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
       # List the named pointers that select which immutable version of this agent runs. `live` sorts first, then the
       # preview aliases by name. Archived aliases are omitted unless `includeArchived=true`. Omitting `limit` returns
       # every pointer; supplying it pages through the same order with `cursor`.
@@ -108,7 +154,9 @@ module Runtype
       # Aim one alias at one immutable version of the same agent, appending a deployment receipt in the same
       # transaction. Moving an existing `live` pointer requires the AGENTS:DEPLOY:LIVE scope and an `If-Match` revision;
       # preview aliases require AGENTS:DEPLOY:PREVIEW. Dependency references the version names are fingerprinted first,
-      # and an unresolvable reference refuses the activation.
+      # and an unresolvable reference refuses the activation. Activating a preview alias renews its 14-day expiry;
+      # `live` never expires. Creating a new preview alias past the active-preview quota answers 429 with code
+      # PREVIEW_ALIAS_LIMIT.
       #
       # @param request_options [Hash]
       # @param params [Runtype::AgentAliases::Types::PutV1AgentsIDAliasesAliasRequest]

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

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

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Runtype
+  module AgentAliases
+    module Types
+      class GetV1AgentAliasesResponse < Internal::Types::Model
+        field :data, -> { Internal::Types::Array[Runtype::AgentAliases::Types::GetV1AgentAliasesResponseDataItem] }, optional: false, nullable: false
+      end
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Runtype
+  module AgentAliases
+    module Types
+      class GetV1AgentAliasesResponseDataItem < Internal::Types::Model
+        field :agent_id, -> { String }, optional: false, nullable: false, api_name: "agentId"
+
+        field :agent_name, -> { String }, optional: false, nullable: false, api_name: "agentName"
+
+        field :alias_, -> { String }, optional: false, nullable: false, api_name: "alias"
+
+        field :archived_at, -> { String }, optional: false, nullable: true, api_name: "archivedAt"
+
+        field :expires_at, -> { String }, optional: false, nullable: true, api_name: "expiresAt"
+
+        field :revision, -> { Integer }, optional: false, nullable: false
+
+        field :updated_at, -> { String }, optional: false, nullable: false, api_name: "updatedAt"
+
+        field :version_id, -> { String }, optional: false, nullable: false, api_name: "versionId"
+      end
+    end
+  end
+end

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

@@ -4,10 +4,14 @@ module Runtype
   module AgentAliases
     module Types
       class PostV1AgentsIDAliasesAliasRollbackResponse < Internal::Types::Model
+        field :active_preview_count, -> { Integer }, optional: false, nullable: true, api_name: "activePreviewCount"
+
         field :alias_, -> { String }, optional: false, nullable: false, api_name: "alias"
 
         field :changed, -> { Internal::Types::Boolean }, optional: false, nullable: false
 
+        field :preview_limit, -> { Integer }, optional: false, nullable: true, api_name: "previewLimit"
+
         field :receipt_id, -> { String }, optional: false, nullable: false, api_name: "receiptId"
 
         field :revision, -> { Integer }, optional: false, nullable: false

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

@@ -12,6 +12,8 @@ module Runtype
 
         field :idempotency_key, -> { String }, optional: true, nullable: false, api_name: "idempotency-key"
 
+        field :promotion, -> { Runtype::Types::AgentDeploymentPromotion }, optional: true, nullable: false
+
         field :reason, -> { String }, optional: true, nullable: false
 
         field :version_id, -> { String }, optional: false, nullable: false, api_name: "versionId"

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

@@ -4,10 +4,14 @@ module Runtype
   module AgentAliases
     module Types
       class PutV1AgentsIDAliasesAliasResponse < Internal::Types::Model
+        field :active_preview_count, -> { Integer }, optional: false, nullable: true, api_name: "activePreviewCount"
+
         field :alias_, -> { String }, optional: false, nullable: false, api_name: "alias"
 
         field :changed, -> { Internal::Types::Boolean }, optional: false, nullable: false
 
+        field :preview_limit, -> { Integer }, optional: false, nullable: true, api_name: "previewLimit"
+
         field :receipt_id, -> { String }, optional: false, nullable: false, api_name: "receiptId"
 
         field :revision, -> { Integer }, optional: false, nullable: false

data/generated/lib/runtype/agents/types/post_v1agents_ensure_request_definition_config_memory.rb

@@ -8,6 +8,8 @@ module Runtype
 
         field :inject_summary, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "injectSummary"
 
+        field :pointer_scope, -> { Runtype::Agents::Types::PostV1AgentsEnsureRequestDefinitionConfigMemoryPointerScope }, optional: true, nullable: false, api_name: "pointerScope"
+
         field :profile_template, -> { String }, optional: true, nullable: false, api_name: "profileTemplate"
       end
     end

data/generated/lib/runtype/agents/types/post_v1agents_ensure_request_definition_config_memory_pointer_scope.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Runtype
+  module Agents
+    module Types
+      module PostV1AgentsEnsureRequestDefinitionConfigMemoryPointerScope
+        extend Runtype::Internal::Types::Enum
+
+        SHARED = "shared"
+        ALIAS = "alias"
+        VERSION = "version"
+      end
+    end
+  end
+end

data/generated/lib/runtype/agents/types/post_v1agents_id_execute_request_x_runtype_concurrency.rb

@@ -9,6 +9,7 @@ module Runtype
         REJECT = "reject"
         SUPERSEDE = "supersede"
         QUEUE = "queue"
+        JOIN = "join"
       end
     end
   end

data/generated/lib/runtype/agents/types/post_v1agents_request_config_memory.rb

@@ -8,6 +8,8 @@ module Runtype
 
         field :inject_summary, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "injectSummary"
 
+        field :pointer_scope, -> { Runtype::Agents::Types::PostV1AgentsRequestConfigMemoryPointerScope }, optional: true, nullable: false, api_name: "pointerScope"
+
         field :profile_template, -> { String }, optional: true, nullable: false, api_name: "profileTemplate"
       end
     end

data/generated/lib/runtype/agents/types/post_v1agents_request_config_memory_pointer_scope.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Runtype
+  module Agents
+    module Types
+      module PostV1AgentsRequestConfigMemoryPointerScope
+        extend Runtype::Internal::Types::Enum
+
+        SHARED = "shared"
+        ALIAS = "alias"
+        VERSION = "version"
+      end
+    end
+  end
+end

data/generated/lib/runtype/agents/types/put_v1agents_id_request_config_memory.rb

@@ -8,6 +8,8 @@ module Runtype
 
         field :inject_summary, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "injectSummary"
 
+        field :pointer_scope, -> { Runtype::Agents::Types::PutV1AgentsIDRequestConfigMemoryPointerScope }, optional: true, nullable: false, api_name: "pointerScope"
+
         field :profile_template, -> { String }, optional: true, nullable: false, api_name: "profileTemplate"
       end
     end

data/generated/lib/runtype/agents/types/put_v1agents_id_request_config_memory_pointer_scope.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Runtype
+  module Agents
+    module Types
+      module PutV1AgentsIDRequestConfigMemoryPointerScope
+        extend Runtype::Internal::Types::Enum
+
+        SHARED = "shared"
+        ALIAS = "alias"
+        VERSION = "version"
+      end
+    end
+  end
+end

data/generated/lib/runtype/batch/types/get_v1batch_batch_id_records_record_id_steps_response_data_item_execution_engine.rb

@@ -8,6 +8,7 @@ module Runtype
 
         RUNTIME = "runtime"
         LEGACY = "legacy"
+        EXTERNAL = "external"
       end
     end
   end

data/generated/lib/runtype/client.rb

@@ -21,6 +21,11 @@ module Runtype
       )
     end
 
+    # @return [Runtype::AgentAliases::Client]
+    def agent_aliases
+      @agent_aliases ||= Runtype::AgentAliases::Client.new(client: @raw_client)
+    end
+
     # @return [Runtype::AgentVersions::Client]
     def agent_versions
       @agent_versions ||= Runtype::AgentVersions::Client.new(client: @raw_client)
@@ -31,11 +36,6 @@ module Runtype
       @agents ||= Runtype::Agents::Client.new(client: @raw_client)
     end
 
-    # @return [Runtype::AgentAliases::Client]
-    def agent_aliases
-      @agent_aliases ||= Runtype::AgentAliases::Client.new(client: @raw_client)
-    end
-
     # @return [Runtype::Analytics::Client]
     def analytics
       @analytics ||= Runtype::Analytics::Client.new(client: @raw_client)

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

@@ -12,7 +12,10 @@ module Runtype
 
       # Send a message for a browser client-token chat session. The request streams flow/agent events over Server-Sent
       # Events. `turnId` and `submitMode` are optional and let newer Persona clients suppress stale interrupted
-      # responses; older clients can omit both fields.
+      # responses; older clients can omit both fields. Opt-in `join` accepts exactly one new user message whose `id`
+      # equals `turnId` for visitor-owned native durable agents. A new execution streams SSE; joining an existing
+      # execution returns a 202 delivery receipt without replacing its response. Retry with the same turn and message
+      # IDs.
       #
       # @param request_options [Hash]
       # @param params [Runtype::ClientRuntime::Types::PostV1ClientChatRequest]
@@ -180,6 +183,120 @@ module Runtype
         end
       end
 
+      # Cancel the specified execution without starting a replacement. Pending inputs become not applied. Requires the
+      # exact visitor and session bound to the conversation.
+      #
+      # @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] :conversation_id
+      # @option params [String] :execution_id
+      # @option params [String] :session_id
+      # @option params [String] :visitor_token
+      # @option params [String, nil] :identity_proof
+      #
+      # @example
+      #   client.client_runtime.stop_a_native_durable_client_execution(
+      #     conversation_id: "conversationId",
+      #     execution_id: "executionId",
+      #     session_id: "sessionId",
+      #     visitor_token: "x-visitor-token"
+      #   )
+      #
+      # @return [Runtype::ClientRuntime::Types::PostV1ClientConversationsConversationIDExecutionsExecutionIDCancelResponse]
+      def stop_a_native_durable_client_execution(request_options: {}, **params)
+        params = Runtype::Internal::Types::Utils.normalize_keys(params)
+        query_params = {}
+        query_params["sessionId"] = params[:session_id] if params.key?(:session_id)
+
+        headers = {}
+        headers["x-visitor-token"] = params[:visitor_token] if params[:visitor_token]
+        headers["x-identity-proof"] = params[:identity_proof] if params[:identity_proof]
+
+        request = Runtype::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "v1/client/conversations/#{URI.encode_uri_component(params[:conversation_id].to_s)}/executions/#{URI.encode_uri_component(params[:execution_id].to_s)}/cancel",
+          headers: headers,
+          query: query_params,
+          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::ClientRuntime::Types::PostV1ClientConversationsConversationIDExecutionsExecutionIDCancelResponse.load(response.body)
+        else
+          error_class = Runtype::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Read whether a joined message is pending, applied, settled, or not applied. Requires the exact visitor and
+      # session bound to this conversation.
+      #
+      # @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] :conversation_id
+      # @option params [String] :execution_id
+      # @option params [String] :delivery_id
+      # @option params [String] :session_id
+      # @option params [String] :visitor_token
+      # @option params [String, nil] :identity_proof
+      #
+      # @example
+      #   client.client_runtime.read_a_live_input_delivery_receipt(
+      #     conversation_id: "conversationId",
+      #     execution_id: "executionId",
+      #     delivery_id: "deliveryId",
+      #     session_id: "sessionId",
+      #     visitor_token: "x-visitor-token"
+      #   )
+      #
+      # @return [Runtype::Types::ClientInputDeliveryReceipt]
+      def read_a_live_input_delivery_receipt(request_options: {}, **params)
+        params = Runtype::Internal::Types::Utils.normalize_keys(params)
+        query_params = {}
+        query_params["sessionId"] = params[:session_id] if params.key?(:session_id)
+
+        headers = {}
+        headers["x-visitor-token"] = params[:visitor_token] if params[:visitor_token]
+        headers["x-identity-proof"] = params[:identity_proof] if params[:identity_proof]
+
+        request = Runtype::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "v1/client/conversations/#{URI.encode_uri_component(params[:conversation_id].to_s)}/executions/#{URI.encode_uri_component(params[:execution_id].to_s)}/deliveries/#{URI.encode_uri_component(params[:delivery_id].to_s)}",
+          headers: headers,
+          query: query_params,
+          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::Types::ClientInputDeliveryReceipt.load(response.body)
+        else
+          error_class = Runtype::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
       # Return a single conversation with its message transcript. Answers 404 (never 403) for a conversation the caller
       # does not own, so the route cannot be used to probe for other visitors' conversations. Every response carries
       # `X-History-Identity-Status` (`not_provided` | `admitted` | `ignored`) reporting what the server did with a

data/generated/lib/runtype/client_runtime/types/get_v1client_conversations_conversation_id_executions_execution_id_deliveries_delivery_id_request.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Runtype
+  module ClientRuntime
+    module Types
+      class GetV1ClientConversationsConversationIDExecutionsExecutionIDDeliveriesDeliveryIDRequest < Internal::Types::Model
+        field :conversation_id, -> { String }, optional: false, nullable: false, api_name: "conversationId"
+
+        field :execution_id, -> { String }, optional: false, nullable: false, api_name: "executionId"
+
+        field :delivery_id, -> { String }, optional: false, nullable: false, api_name: "deliveryId"
+
+        field :session_id, -> { String }, optional: false, nullable: false, api_name: "sessionId"
+
+        field :visitor_token, -> { String }, optional: false, nullable: false, api_name: "x-visitor-token"
+
+        field :identity_proof, -> { String }, optional: true, nullable: false, api_name: "x-identity-proof"
+      end
+    end
+  end
+end

data/generated/lib/runtype/client_runtime/types/post_v1client_chat_request_submit_mode.rb

@@ -8,6 +8,7 @@ module Runtype
 
         NORMAL = "normal"
         INTERRUPT = "interrupt"
+        JOIN = "join"
       end
     end
   end

data/generated/lib/runtype/client_runtime/types/post_v1client_conversations_conversation_id_executions_execution_id_cancel_request.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Runtype
+  module ClientRuntime
+    module Types
+      class PostV1ClientConversationsConversationIDExecutionsExecutionIDCancelRequest < Internal::Types::Model
+        field :conversation_id, -> { String }, optional: false, nullable: false, api_name: "conversationId"
+
+        field :execution_id, -> { String }, optional: false, nullable: false, api_name: "executionId"
+
+        field :session_id, -> { String }, optional: false, nullable: false, api_name: "sessionId"
+
+        field :visitor_token, -> { String }, optional: false, nullable: false, api_name: "x-visitor-token"
+
+        field :identity_proof, -> { String }, optional: true, nullable: false, api_name: "x-identity-proof"
+      end
+    end
+  end
+end