runtype 0.3.0 → 0.11.1

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

@@ -97,8 +97,10 @@ module Runtype
         end
       end
 
-      # Assemble a product from a validated Full Product Object (FPO). Materializes secret bindings, so API keys must
-      # carry the SECRETS:WRITE permission.
+      # Assemble a product from a validated Full Product Object (FPO). API keys must carry PRODUCTS:WRITE (or
+      # PRODUCTS:CREATE) and SECRETS:WRITE, plus the write scope for every entity kind the FPO materializes
+      # (FLOWS:WRITE, AGENTS:WRITE, PRODUCTS:SURFACES:WRITE, SCHEDULES:WRITE, RECORDS:WRITE, EVALS:WRITE, SKILLS:WRITE),
+      # and SECRETS:READ when an inline HTTP step references a managed secret.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -220,7 +222,11 @@ module Runtype
       # reported in `entities[].result = "failed"` (and `hasFailures`) and a re-run self-heals; only a top-level product
       # reject aborts. Set dryRun to plan without writing. Set prune to remove product-scoped capabilities/surfaces (and
       # their items) absent from the FPO (account-scoped flows/agents/tools/records are never removed). Whole-FPO
-      # fast-probe is not yet supported (PR3).
+      # fast-probe is not yet supported (PR3). API keys converge each nested flow, agent, schedule, record, eval suite
+      # and skill only with that entity kind's own write scope (FLOWS:WRITE, AGENTS:WRITE or AGENTS:CREATE/UPDATE,
+      # SCHEDULES:WRITE, RECORDS:WRITE, EVALS:WRITE, SKILLS:WRITE) on top of the product scope; otherwise that entity
+      # reports `failed`. Binding a skill to an agent also needs agent update scope. Schedules also honor the plan's
+      # active-schedule limit and minimum frequency.
       #
       # @param request_options [Hash]
       # @param params [Runtype::Products::Types::PostV1ProductsEnsureFpoRequest]
@@ -308,7 +314,8 @@ module Runtype
       # FPO-local ids, so feeding the result back into POST /products/ensure-fpo converges to `unchanged`.
       # records/schedules/secrets are NOT reconstructed and `tools` is emitted empty (tool refs are portable
       # `tool:<name>`); see `warnings` for per-pull caveats. The contentHash is recomputed from the live graph, so it is
-      # accurate immediately after a dashboard edit.
+      # accurate immediately after a dashboard edit. API keys need PRODUCTS:READ, plus FLOWS:READ, AGENTS:READ,
+      # SCHEDULES:READ, EVALS:READ or SKILLS:READ for each section the product carries.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -471,6 +478,52 @@ module Runtype
         end
       end
 
+      # First page of every activity source a product has: one entry per conversational surface (messaging conversations
+      # or client-conversation records) and one per distinct agent capability. Agent rows are `RunListRow`s read the way
+      # `GET /v1/runs?agentId=` reads them, so a client continues that source with `/v1/runs` and the surface sources
+      # with their own list endpoints; rows, cursors and `hasMore` match. A source that fails returns empty rows plus an
+      # `error`; the response is still 200.
+      #
+      # @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, nil] :limit
+      #
+      # @example
+      #   client.products.get_product_activity(id: "id")
+      #
+      # @return [Runtype::Products::Types::GetV1ProductsIDActivityResponse]
+      def get_product_activity(request_options: {}, **params)
+        params = Runtype::Internal::Types::Utils.normalize_keys(params)
+        query_params = {}
+        query_params["limit"] = params[:limit] if params.key?(:limit)
+
+        request = Runtype::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "v1/products/#{URI.encode_uri_component(params[:id].to_s)}/activity",
+          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::Products::Types::GetV1ProductsIDActivityResponse.load(response.body)
+        else
+          error_class = Runtype::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
       # Add a capability (flow or agent binding) to a product. Requires either flowId or agentId.
       #
       # @param request_options [Hash]
@@ -643,6 +696,198 @@ module Runtype
         end
       end
 
+      # List the comment threads on a product's canvas with their messages. Threads belong to the product's
+      # organization; a personal account's product has none.
+      #
+      # @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 [Runtype::Products::Types::GetV1ProductsIDCommentsRequestStatus, nil] :status
+      # @option params [Integer, nil] :limit
+      # @option params [String, nil] :cursor
+      # @option params [String, nil] :ids
+      #
+      # @example
+      #   client.products.list_product_comments(id: "id")
+      #
+      # @return [Runtype::Types::ListProductCommentsResponse]
+      def list_product_comments(request_options: {}, **params)
+        params = Runtype::Internal::Types::Utils.normalize_keys(params)
+        query_params = {}
+        query_params["status"] = params[:status] if params.key?(:status)
+        query_params["limit"] = params[:limit] if params.key?(:limit)
+        query_params["cursor"] = params[:cursor] if params.key?(:cursor)
+        query_params["ids"] = params[:ids] if params.key?(:ids)
+
+        request = Runtype::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "v1/products/#{URI.encode_uri_component(params[:id].to_s)}/comments",
+          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::ListProductCommentsResponse.load(response.body)
+        else
+          error_class = Runtype::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Start a comment thread on one element of the product canvas with its first comment. The author is the caller's
+      # credential.
+      #
+      # @param request_options [Hash]
+      # @param params [Runtype::Products::Types::CreateProductCommentThreadRequest]
+      # @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
+      #
+      # @example
+      #   client.products.start_a_product_comment_thread(
+      #     id: "id",
+      #     anchor: "anchor",
+      #     body: "body"
+      #   )
+      #
+      # @return [Runtype::Types::ProductCommentThread]
+      def start_a_product_comment_thread(request_options: {}, **params)
+        params = Runtype::Internal::Types::Utils.normalize_keys(params)
+        request_data = Runtype::Products::Types::CreateProductCommentThreadRequest.new(params).to_h
+        non_body_param_names = %w[id]
+        body = request_data.except(*non_body_param_names)
+
+        request = Runtype::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "v1/products/#{URI.encode_uri_component(params[:id].to_s)}/comments",
+          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::Types::ProductCommentThread.load(response.body)
+        else
+          error_class = Runtype::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Resolve a thread, recording who resolved it and when, or open it again. Setting the state it already has changes
+      # nothing.
+      #
+      # @param request_options [Hash]
+      # @param params [Runtype::Products::Types::UpdateProductCommentThreadRequest]
+      # @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] :thread_id
+      #
+      # @example
+      #   client.products.resolve_a_product_comment_thread(
+      #     id: "id",
+      #     thread_id: "threadId",
+      #     resolved: true
+      #   )
+      #
+      # @return [Runtype::Types::ProductCommentThread]
+      def resolve_a_product_comment_thread(request_options: {}, **params)
+        params = Runtype::Internal::Types::Utils.normalize_keys(params)
+        request_data = Runtype::Products::Types::UpdateProductCommentThreadRequest.new(params).to_h
+        non_body_param_names = %w[id threadId]
+        body = request_data.except(*non_body_param_names)
+
+        request = Runtype::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "PATCH",
+          path: "v1/products/#{URI.encode_uri_component(params[:id].to_s)}/comments/threads/#{URI.encode_uri_component(params[:thread_id].to_s)}",
+          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::Types::ProductCommentThread.load(response.body)
+        else
+          error_class = Runtype::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Add a comment to a thread, resolved or not. `authorKind: assistant` posts the Assistant's answer to an
+      # `@assistant` mention, relayed by the caller's client.
+      #
+      # @param request_options [Hash]
+      # @param params [Runtype::Products::Types::CreateProductCommentRequest]
+      # @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] :thread_id
+      #
+      # @example
+      #   client.products.reply_in_a_product_comment_thread(
+      #     id: "id",
+      #     thread_id: "threadId",
+      #     body: "body"
+      #   )
+      #
+      # @return [Runtype::Types::ProductComment]
+      def reply_in_a_product_comment_thread(request_options: {}, **params)
+        params = Runtype::Internal::Types::Utils.normalize_keys(params)
+        request_data = Runtype::Products::Types::CreateProductCommentRequest.new(params).to_h
+        non_body_param_names = %w[id threadId]
+        body = request_data.except(*non_body_param_names)
+
+        request = Runtype::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "v1/products/#{URI.encode_uri_component(params[:id].to_s)}/comments/threads/#{URI.encode_uri_component(params[:thread_id].to_s)}/messages",
+          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::Types::ProductComment.load(response.body)
+        else
+          error_class = Runtype::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
       # Get the secret configuration summary for a product. Never returns secret values — used to decide whether to show
       # a "Configure secrets" prompt.
       #
@@ -719,6 +964,57 @@ module Runtype
         end
       end
 
+      # Replace what one source declares the product is built on (frameworks, vector databases, upstream services,
+      # versions). The Overview shows declared items beside the ones detected from the product's own configuration. The
+      # actor is the caller's credential: a named API key reads as its name, anyone else by first name.
+      #
+      # @param request_options [Hash]
+      # @param params [Runtype::Products::Types::DeclareProductStackRequest]
+      # @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
+      #
+      # @example
+      #   client.products.declare_product_stack(
+      #     id: "id",
+      #     items: [{
+      #       key: "key",
+      #       label: "label"
+      #     }],
+      #     source: "mcp"
+      #   )
+      #
+      # @return [Runtype::Types::DeclareProductStackResponse]
+      def declare_product_stack(request_options: {}, **params)
+        params = Runtype::Internal::Types::Utils.normalize_keys(params)
+        request_data = Runtype::Products::Types::DeclareProductStackRequest.new(params).to_h
+        non_body_param_names = %w[id]
+        body = request_data.except(*non_body_param_names)
+
+        request = Runtype::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "PUT",
+          path: "v1/products/#{URI.encode_uri_component(params[:id].to_s)}/stack/declared",
+          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::Types::DeclareProductStackResponse.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 surfaces for a product with filtering and cursor pagination.
       #
       # @param request_options [Hash]
@@ -1046,6 +1342,51 @@ module Runtype
         end
       end
 
+      # @param request_options [Hash]
+      # @param params [Runtype::Products::Types::PutV1ProductsIDSurfacesSurfaceIDEntryPointRequest]
+      # @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] :surface_id
+      #
+      # @example
+      #   client.products.set_the_answering_capability_of_a_chat_surface(
+      #     id: "id",
+      #     surface_id: "surfaceId",
+      #     capability_id: "capabilityId"
+      #   )
+      #
+      # @return [Runtype::Products::Types::PutV1ProductsIDSurfacesSurfaceIDEntryPointResponse]
+      def set_the_answering_capability_of_a_chat_surface(request_options: {}, **params)
+        params = Runtype::Internal::Types::Utils.normalize_keys(params)
+        request_data = Runtype::Products::Types::PutV1ProductsIDSurfacesSurfaceIDEntryPointRequest.new(params).to_h
+        non_body_param_names = %w[id surfaceId]
+        body = request_data.except(*non_body_param_names)
+
+        request = Runtype::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "PUT",
+          path: "v1/products/#{URI.encode_uri_component(params[:id].to_s)}/surfaces/#{URI.encode_uri_component(params[:surface_id].to_s)}/entry-point",
+          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::Products::Types::PutV1ProductsIDSurfacesSurfaceIDEntryPointResponse.load(response.body)
+        else
+          error_class = Runtype::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
       # Add a capability item to a surface.
       #
       # @param request_options [Hash]

data/generated/lib/runtype/products/types/create_product_comment_request.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Runtype
+  module Products
+    module Types
+      class CreateProductCommentRequest < Internal::Types::Model
+        field :id, -> { String }, optional: false, nullable: false
+
+        field :thread_id, -> { String }, optional: false, nullable: false, api_name: "threadId"
+
+        field :author_kind, -> { Runtype::Products::Types::CreateProductCommentRequestAuthorKind }, optional: true, nullable: false, api_name: "authorKind"
+
+        field :body, -> { String }, optional: false, nullable: false
+
+        field :mentions, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/generated/lib/runtype/{conversations/types/put_v1conversations_id_request_messages_item_role.rb → products/types/create_product_comment_request_author_kind.rb}

@@ -1,14 +1,13 @@
 # frozen_string_literal: true
 
 module Runtype
-  module Conversations
+  module Products
     module Types
-      module PutV1ConversationsIDRequestMessagesItemRole
+      module CreateProductCommentRequestAuthorKind
         extend Runtype::Internal::Types::Enum
 
         USER = "user"
         ASSISTANT = "assistant"
-        SYSTEM = "system"
       end
     end
   end

data/generated/lib/runtype/products/types/create_product_comment_thread_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Runtype
+  module Products
+    module Types
+      class CreateProductCommentThreadRequest < Internal::Types::Model
+        field :id, -> { String }, optional: false, nullable: false
+
+        field :anchor, -> { String }, optional: false, nullable: false
+
+        field :body, -> { String }, optional: false, nullable: false
+
+        field :mentions, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/generated/lib/runtype/products/types/declare_product_stack_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Runtype
+  module Products
+    module Types
+      class DeclareProductStackRequest < Internal::Types::Model
+        field :id, -> { String }, optional: false, nullable: false
+
+        field :items, -> { Internal::Types::Array[Runtype::Types::ProductStackItem] }, optional: false, nullable: false
+
+        field :source, -> { Runtype::Products::Types::DeclareProductStackRequestSource }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/generated/lib/runtype/products/types/declare_product_stack_request_source.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Runtype
+  module Products
+    module Types
+      module DeclareProductStackRequestSource
+        extend Runtype::Internal::Types::Enum
+
+        MCP = "mcp"
+        CLI = "cli"
+        API = "api"
+      end
+    end
+  end
+end

data/generated/lib/runtype/products/types/get_v1products_id_activity_request.rb

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

data/generated/lib/runtype/products/types/get_v1products_id_activity_response.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Runtype
+  module Products
+    module Types
+      class GetV1ProductsIDActivityResponse < Internal::Types::Model
+        field :data, -> { Runtype::Products::Types::GetV1ProductsIDActivityResponseData }, optional: false, nullable: false
+
+        field :success, -> { Internal::Types::Boolean }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/generated/lib/runtype/products/types/get_v1products_id_activity_response_data.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Runtype
+  module Products
+    module Types
+      class GetV1ProductsIDActivityResponseData < Internal::Types::Model
+        field :agents, -> { Internal::Types::Array[Runtype::Products::Types::GetV1ProductsIDActivityResponseDataAgentsItem] }, optional: false, nullable: false
+
+        field :surfaces, -> { Internal::Types::Array[Runtype::Products::Types::GetV1ProductsIDActivityResponseDataSurfacesItem] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/generated/lib/runtype/products/types/get_v1products_id_activity_response_data_agents_item.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Runtype
+  module Products
+    module Types
+      class GetV1ProductsIDActivityResponseDataAgentsItem < Internal::Types::Model
+        field :agent_id, -> { String }, optional: false, nullable: false, api_name: "agentId"
+
+        field :data, -> { Internal::Types::Array[Runtype::Products::Types::GetV1ProductsIDActivityResponseDataAgentsItemDataItem] }, optional: false, nullable: false
+
+        field :error, -> { Runtype::Products::Types::GetV1ProductsIDActivityResponseDataAgentsItemError }, optional: true, nullable: false
+
+        field :pagination, -> { Runtype::Types::RunListPagination }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/generated/lib/runtype/products/types/get_v1products_id_activity_response_data_agents_item_data_item.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+module Runtype
+  module Products
+    module Types
+      class GetV1ProductsIDActivityResponseDataAgentsItemDataItem < Internal::Types::Model
+        field :agent_id, -> { String }, optional: false, nullable: true, api_name: "agentId"
+
+        field :agent_target_resolution, -> { String }, optional: true, nullable: false, api_name: "agentTargetResolution"
+
+        field :agent_version_id, -> { String }, optional: true, nullable: false, api_name: "agentVersionId"
+
+        field :agent_version_label, -> { String }, optional: true, nullable: false, api_name: "agentVersionLabel"
+
+        field :agent_version_number, -> { Integer }, optional: true, nullable: false, api_name: "agentVersionNumber"
+
+        field :batch_execution_id, -> { String }, optional: false, nullable: true, api_name: "batchExecutionId"
+
+        field :budget_exhausted, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "budgetExhausted"
+
+        field :cache_read_tokens, -> { Integer }, optional: true, nullable: false, api_name: "cacheReadTokens"
+
+        field :cache_write_tokens, -> { Integer }, optional: true, nullable: false, api_name: "cacheWriteTokens"
+
+        field :cancel_requested_at, -> { String }, optional: true, nullable: false, api_name: "cancelRequestedAt"
+
+        field :child_count, -> { Integer }, optional: false, nullable: true, api_name: "childCount"
+
+        field :completeness, -> { Runtype::Products::Types::GetV1ProductsIDActivityResponseDataAgentsItemDataItemCompleteness }, optional: false, nullable: true
+
+        field :conversation_id, -> { String }, optional: false, nullable: true, api_name: "conversationId"
+
+        field :duration_ms, -> { Integer }, optional: false, nullable: true, api_name: "durationMs"
+
+        field :ended_at, -> { String }, optional: false, nullable: true, api_name: "endedAt"
+
+        field :execution_id, -> { String }, optional: false, nullable: false, api_name: "executionId"
+
+        field :expires_at, -> { String }, optional: true, nullable: false, api_name: "expiresAt"
+
+        field :fidelity_tier, -> { String }, optional: false, nullable: true, api_name: "fidelityTier"
+
+        field :flow_id, -> { String }, optional: false, nullable: true, api_name: "flowId"
+
+        field :inline_definition, -> { Internal::Types::Boolean }, optional: false, nullable: true, api_name: "inlineDefinition"
+
+        field :input_messages, -> { Object }, optional: true, nullable: false, api_name: "inputMessages"
+
+        field :input_preview, -> { String }, optional: true, nullable: false, api_name: "inputPreview"
+
+        field :input_tokens, -> { Integer }, optional: false, nullable: true, api_name: "inputTokens"
+
+        field :iterations, -> { Integer }, optional: true, nullable: false
+
+        field :kind, -> { Runtype::Products::Types::GetV1ProductsIDActivityResponseDataAgentsItemDataItemKind }, optional: false, nullable: false
+
+        field :last_heartbeat_at, -> { String }, optional: true, nullable: false, api_name: "lastHeartbeatAt"
+
+        field :origin, -> { Runtype::Products::Types::GetV1ProductsIDActivityResponseDataAgentsItemDataItemOrigin }, optional: false, nullable: true
+
+        field :otel_producer, -> { Object }, optional: true, nullable: false, api_name: "otelProducer"
+
+        field :output_tokens, -> { Integer }, optional: false, nullable: true, api_name: "outputTokens"
+
+        field :parent_execution_id, -> { String }, optional: false, nullable: true, api_name: "parentExecutionId"
+
+        field :parent_tool_call_id, -> { String }, optional: false, nullable: true, api_name: "parentToolCallId"
+
+        field :pending_approval, -> { Object }, optional: true, nullable: false, api_name: "pendingApproval"
+
+        field :progress, -> { Object }, optional: true, nullable: false
+
+        field :reasoning_tokens, -> { Integer }, optional: true, nullable: false, api_name: "reasoningTokens"
+
+        field :record_id, -> { String }, optional: false, nullable: true, api_name: "recordId"
+
+        field :requested_flow_id, -> { String }, optional: true, nullable: false, api_name: "requestedFlowId"
+
+        field :retention_elided, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "retentionElided"
+
+        field :root_execution_id, -> { String }, optional: false, nullable: true, api_name: "rootExecutionId"
+
+        field :self_reported_cost, -> { String }, optional: false, nullable: true, api_name: "selfReportedCost"
+
+        field :source, -> { Runtype::Products::Types::GetV1ProductsIDActivityResponseDataAgentsItemDataItemSource }, optional: false, nullable: false
+
+        field :span_count, -> { Integer }, optional: false, nullable: true, api_name: "spanCount"
+
+        field :started_at, -> { String }, optional: false, nullable: false, api_name: "startedAt"
+
+        field :status, -> { Runtype::Products::Types::GetV1ProductsIDActivityResponseDataAgentsItemDataItemStatus }, optional: false, nullable: false
+
+        field :stop_reason, -> { String }, optional: true, nullable: false, api_name: "stopReason"
+
+        field :store_results, -> { Internal::Types::Boolean }, optional: false, nullable: true, api_name: "storeResults"
+
+        field :surface_id, -> { String }, optional: false, nullable: true, api_name: "surfaceId"
+
+        field :surface_type, -> { String }, optional: false, nullable: true, api_name: "surfaceType"
+
+        field :test, -> { Internal::Types::Boolean }, optional: false, nullable: true
+
+        field :total_cost, -> { String }, optional: false, nullable: true, api_name: "totalCost"
+
+        field :trace_id, -> { String }, optional: false, nullable: true, api_name: "traceId"
+      end
+    end
+  end
+end

data/generated/lib/runtype/products/types/get_v1products_id_activity_response_data_agents_item_data_item_completeness.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Runtype
+  module Products
+    module Types
+      module GetV1ProductsIDActivityResponseDataAgentsItemDataItemCompleteness
+        extend Runtype::Internal::Types::Enum
+
+        PARTIAL = "partial"
+        COMPLETE = "complete"
+        CONFLICTED = "conflicted"
+        EXPIRED = "expired"
+        DELETED = "deleted"
+      end
+    end
+  end
+end