hanzoai 8.5.156

data/lib/hanzoai/api/agents_api.rb

@@ -0,0 +1,2503 @@
+=begin
+#Hanzo Cloud API
+
+#The Hanzo Cloud API as a customer calls it: every operation under /v1/ except the operator's admin product, relay routes, legacy spellings and capabilities still reached by flag. Tagged by product: the first path segment after /v1/.
+
+The version of the OpenAPI document: v1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.14.0
+
+=end
+
+require 'cgi'
+
+module Hanzoai
+  class AgentsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Removes an agent and every run recorded against it.
+    # Removes an agent and every run recorded against it. Answers 204.
+    # @param ref [String] Ref is the agent's public id (the agent_… handle create and list return) or its org-unique name, from the path. Either resolves the same agent.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def delete_agents_by_ref(ref, opts = {})
+      delete_agents_by_ref_with_http_info(ref, opts)
+      nil
+    end
+
+    # Removes an agent and every run recorded against it.
+    # Removes an agent and every run recorded against it. Answers 204.
+    # @param ref [String] Ref is the agent's public id (the agent_… handle create and list return) or its org-unique name, from the path. Either resolves the same agent.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_agents_by_ref_with_http_info(ref, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.delete_agents_by_ref ...'
+      end
+      # verify the required parameter 'ref' is set
+      if @api_client.config.client_side_validation && ref.nil?
+        fail ArgumentError, "Missing the required parameter 'ref' when calling AgentsApi.delete_agents_by_ref"
+      end
+      # resource path
+      local_var_path = '/v1/agents/{ref}'.sub('{' + 'ref' + '}', CGI.escape(ref.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.delete_agents_by_ref",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#delete_agents_by_ref\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Deregisters one machine.
+    # Deregisters one machine. Only its owner, or an org admin, may remove it; an unknown id, a cross-org id and a machine owned by someone else all answer the same not-found, so a probe learns nothing about what exists.
+    # @param id [String] ID is the target to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [TargetDeleted]
+    def delete_agents_targets_by_id(id, opts = {})
+      data, _status_code, _headers = delete_agents_targets_by_id_with_http_info(id, opts)
+      data
+    end
+
+    # Deregisters one machine.
+    # Deregisters one machine. Only its owner, or an org admin, may remove it; an unknown id, a cross-org id and a machine owned by someone else all answer the same not-found, so a probe learns nothing about what exists.
+    # @param id [String] ID is the target to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TargetDeleted, Integer, Hash)>] TargetDeleted data, response status code and response headers
+    def delete_agents_targets_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.delete_agents_targets_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.delete_agents_targets_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/agents/targets/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TargetDeleted'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.delete_agents_targets_by_id",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#delete_agents_targets_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns every agent defined in the caller's org, each with the number of runs recorded against it.
+    # Returns every agent defined in the caller's org, each with the number of runs recorded against it.
+    # @param [Hash] opts the optional parameters
+    # @return [AgentList]
+    def get_agents(opts = {})
+      data, _status_code, _headers = get_agents_with_http_info(opts)
+      data
+    end
+
+    # Returns every agent defined in the caller&#39;s org, each with the number of runs recorded against it.
+    # Returns every agent defined in the caller&#39;s org, each with the number of runs recorded against it.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AgentList, Integer, Hash)>] AgentList data, response status code and response headers
+    def get_agents_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents ...'
+      end
+      # resource path
+      local_var_path = '/v1/agents'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AgentList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Serves the org-wide recent-activity feed.
+    # Serves the org-wide recent-activity feed. Events are REAL: each recorded run is an invoked (ok) or failed (error) event; each agent's own create/update timestamps are created/updated events. Merged, newest first, capped. Nothing is invented — an org with no agents and no runs gets [].
+    # @param [Hash] opts the optional parameters
+    # @return [ActivityFeed]
+    def get_agents_activity(opts = {})
+      data, _status_code, _headers = get_agents_activity_with_http_info(opts)
+      data
+    end
+
+    # Serves the org-wide recent-activity feed.
+    # Serves the org-wide recent-activity feed. Events are REAL: each recorded run is an invoked (ok) or failed (error) event; each agent&#39;s own create/update timestamps are created/updated events. Merged, newest first, capped. Nothing is invented — an org with no agents and no runs gets [].
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ActivityFeed, Integer, Hash)>] ActivityFeed data, response status code and response headers
+    def get_agents_activity_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_activity ...'
+      end
+      # resource path
+      local_var_path = '/v1/agents/activity'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ActivityFeed'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_activity",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_activity\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the public index of every published build, most recently updated first, so a gallery can link straight to the story behind each product.
+    # Returns the public index of every published build, most recently updated first, so a gallery can link straight to the story behind each product. PUBLIC, no tenancy: publishing is the author's act, and only published root sessions appear here.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit caps the page. Absent, zero or over 500 reads as 100.
+    # @return [BuildList]
+    def get_agents_builds(opts = {})
+      data, _status_code, _headers = get_agents_builds_with_http_info(opts)
+      data
+    end
+
+    # Returns the public index of every published build, most recently updated first, so a gallery can link straight to the story behind each product.
+    # Returns the public index of every published build, most recently updated first, so a gallery can link straight to the story behind each product. PUBLIC, no tenancy: publishing is the author&#39;s act, and only published root sessions appear here.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit caps the page. Absent, zero or over 500 reads as 100.
+    # @return [Array<(BuildList, Integer, Hash)>] BuildList data, response status code and response headers
+    def get_agents_builds_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_builds ...'
+      end
+      # resource path
+      local_var_path = '/v1/agents/builds'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'BuildList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_builds",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_builds\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the readable build of one product: the agent session that produced it, turn by turn — the prompts, the reasoning, the commits each turn produced — plus the exact `git log` that re-derives every commit binding from git itself, so nothing here has to be taken on trust.
+    # Returns the readable build of one product: the agent session that produced it, turn by turn — the prompts, the reasoning, the commits each turn produced — plus the exact `git log` that re-derives every commit binding from git itself, so nothing here has to be taken on trust.  PUBLIC, no tenancy: it answers only for a session its author explicitly published, which is what makes it safe to be anonymous. An unpublished session is invisible here no matter who asks; its owner reads it through the org-scoped /v1/agents/sessions routes, which need a validated principal.
+    # @param org [String] Org is the org that published the build, from the path.
+    # @param project [String] Project is the product&#39;s slug, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [BuildView]
+    def get_agents_builds_by_org_by_project(org, project, opts = {})
+      data, _status_code, _headers = get_agents_builds_by_org_by_project_with_http_info(org, project, opts)
+      data
+    end
+
+    # Returns the readable build of one product: the agent session that produced it, turn by turn — the prompts, the reasoning, the commits each turn produced — plus the exact &#x60;git log&#x60; that re-derives every commit binding from git itself, so nothing here has to be taken on trust.
+    # Returns the readable build of one product: the agent session that produced it, turn by turn — the prompts, the reasoning, the commits each turn produced — plus the exact &#x60;git log&#x60; that re-derives every commit binding from git itself, so nothing here has to be taken on trust.  PUBLIC, no tenancy: it answers only for a session its author explicitly published, which is what makes it safe to be anonymous. An unpublished session is invisible here no matter who asks; its owner reads it through the org-scoped /v1/agents/sessions routes, which need a validated principal.
+    # @param org [String] Org is the org that published the build, from the path.
+    # @param project [String] Project is the product&#39;s slug, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(BuildView, Integer, Hash)>] BuildView data, response status code and response headers
+    def get_agents_builds_by_org_by_project_with_http_info(org, project, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_builds_by_org_by_project ...'
+      end
+      # verify the required parameter 'org' is set
+      if @api_client.config.client_side_validation && org.nil?
+        fail ArgumentError, "Missing the required parameter 'org' when calling AgentsApi.get_agents_builds_by_org_by_project"
+      end
+      # verify the required parameter 'project' is set
+      if @api_client.config.client_side_validation && project.nil?
+        fail ArgumentError, "Missing the required parameter 'project' when calling AgentsApi.get_agents_builds_by_org_by_project"
+      end
+      # resource path
+      local_var_path = '/v1/agents/builds/{org}/{project}'.sub('{' + 'org' + '}', CGI.escape(org.to_s)).sub('{' + 'project' + '}', CGI.escape(project.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'BuildView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_builds_by_org_by_project",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_builds_by_org_by_project\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one agent with its system prompt and its 20 most recent runs.
+    # Returns one agent with its system prompt and its 20 most recent runs. The ref is the agent's public id or its org-unique name — a created agent is immediately gettable by whatever create handed back.
+    # @param ref [String] Ref is the agent&#39;s public id (the agent_… handle create and list return) or its org-unique name, from the path. Either resolves the same agent.
+    # @param [Hash] opts the optional parameters
+    # @return [AgentDetail]
+    def get_agents_by_ref(ref, opts = {})
+      data, _status_code, _headers = get_agents_by_ref_with_http_info(ref, opts)
+      data
+    end
+
+    # Returns one agent with its system prompt and its 20 most recent runs.
+    # Returns one agent with its system prompt and its 20 most recent runs. The ref is the agent&#39;s public id or its org-unique name — a created agent is immediately gettable by whatever create handed back.
+    # @param ref [String] Ref is the agent&#39;s public id (the agent_… handle create and list return) or its org-unique name, from the path. Either resolves the same agent.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AgentDetail, Integer, Hash)>] AgentDetail data, response status code and response headers
+    def get_agents_by_ref_with_http_info(ref, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_by_ref ...'
+      end
+      # verify the required parameter 'ref' is set
+      if @api_client.config.client_side_validation && ref.nil?
+        fail ArgumentError, "Missing the required parameter 'ref' when calling AgentsApi.get_agents_by_ref"
+      end
+      # resource path
+      local_var_path = '/v1/agents/{ref}'.sub('{' + 'ref' + '}', CGI.escape(ref.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AgentDetail'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_by_ref",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_by_ref\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one agent's execution history, newest first — each run's input, its output or its error, and how long it took.
+    # Returns one agent's execution history, newest first — each run's input, its output or its error, and how long it took. Every row is a run that actually happened.
+    # @param ref [String] Ref is the agent&#39;s public id or its org-unique name, from the path.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit caps how many runs come back, newest first. Absent, zero or out of range (1..200) reads as 50.
+    # @return [RunList]
+    def get_agents_by_ref_runs(ref, opts = {})
+      data, _status_code, _headers = get_agents_by_ref_runs_with_http_info(ref, opts)
+      data
+    end
+
+    # Returns one agent&#39;s execution history, newest first — each run&#39;s input, its output or its error, and how long it took.
+    # Returns one agent&#39;s execution history, newest first — each run&#39;s input, its output or its error, and how long it took. Every row is a run that actually happened.
+    # @param ref [String] Ref is the agent&#39;s public id or its org-unique name, from the path.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit caps how many runs come back, newest first. Absent, zero or out of range (1..200) reads as 50.
+    # @return [Array<(RunList, Integer, Hash)>] RunList data, response status code and response headers
+    def get_agents_by_ref_runs_with_http_info(ref, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_by_ref_runs ...'
+      end
+      # verify the required parameter 'ref' is set
+      if @api_client.config.client_side_validation && ref.nil?
+        fail ArgumentError, "Missing the required parameter 'ref' when calling AgentsApi.get_agents_by_ref_runs"
+      end
+      # resource path
+      local_var_path = '/v1/agents/{ref}/runs'.sub('{' + 'ref' + '}', CGI.escape(ref.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'RunList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_by_ref_runs",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_by_ref_runs\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List the agent threads in your org
+    # Returns a summary of every agent conversation in the caller's org — id, derived title, and when it was last appended to — for populating a thread list.  Scoped to the caller's org and nothing else, and that isolation is structural rather than a filter: conversations are persisted in a store opened PER ORG, so there is no query in which another tenant's threads could appear. A validated principal with a non-empty org is required; 403 without one.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_agents_chat_conversations(opts = {})
+      get_agents_chat_conversations_with_http_info(opts)
+      nil
+    end
+
+    # List the agent threads in your org
+    # Returns a summary of every agent conversation in the caller&#39;s org — id, derived title, and when it was last appended to — for populating a thread list.  Scoped to the caller&#39;s org and nothing else, and that isolation is structural rather than a filter: conversations are persisted in a store opened PER ORG, so there is no query in which another tenant&#39;s threads could appear. A validated principal with a non-empty org is required; 403 without one.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_agents_chat_conversations_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_chat_conversations ...'
+      end
+      # resource path
+      local_var_path = '/v1/agents/chat/conversations'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_chat_conversations",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_chat_conversations\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Read one agent thread in full
+    # Returns every message of one conversation in order — role, content, the assistant's tool calls where it made any, and each message's creation time — which is the transcript a client replays to resume a thread.  The lookup happens inside the caller's OWN per-org store, so an id belonging to another tenant is not refused, it is simply absent: the answer is 200 with an empty message list. Read it as \"no such conversation for you\" rather than as an empty thread. A validated principal with a non-empty org is required; 403 without one.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_agents_chat_conversations_by_id(id, opts = {})
+      get_agents_chat_conversations_by_id_with_http_info(id, opts)
+      nil
+    end
+
+    # Read one agent thread in full
+    # Returns every message of one conversation in order — role, content, the assistant&#39;s tool calls where it made any, and each message&#39;s creation time — which is the transcript a client replays to resume a thread.  The lookup happens inside the caller&#39;s OWN per-org store, so an id belonging to another tenant is not refused, it is simply absent: the answer is 200 with an empty message list. Read it as \&quot;no such conversation for you\&quot; rather than as an empty thread. A validated principal with a non-empty org is required; 403 without one.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_agents_chat_conversations_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_chat_conversations_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.get_agents_chat_conversations_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/agents/chat/conversations/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_chat_conversations_by_id",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_chat_conversations_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List the agent presets available to a caller
+    # Returns the preset catalog: each entry's id, its description and whether it is server-executing — the flag that decides if a preset's tool calls run here or come back for the client to apply. The ids are what the round accepts in `preset`.  The catalog is compiled into the build, identical for every caller, and this is the one read in the group that needs no principal.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_agents_chat_presets(opts = {})
+      get_agents_chat_presets_with_http_info(opts)
+      nil
+    end
+
+    # List the agent presets available to a caller
+    # Returns the preset catalog: each entry&#39;s id, its description and whether it is server-executing — the flag that decides if a preset&#39;s tool calls run here or come back for the client to apply. The ids are what the round accepts in &#x60;preset&#x60;.  The catalog is compiled into the build, identical for every caller, and this is the one read in the group that needs no principal.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_agents_chat_presets_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_chat_presets ...'
+      end
+      # resource path
+      local_var_path = '/v1/agents/chat/presets'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_chat_presets",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_chat_presets\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Serves the invocations-over-time histogram for the org's Agents dashboard.
+    # Serves the invocations-over-time histogram for the org's Agents dashboard. Every point is a REAL count of recorded runs in that time bucket — one series line per agent that ran in the window. The Resource Usage rollup is all-null because this store meters no CPU/memory/storage/cost; the console renders those as \"—\" rather than a fabricated figure. No runs => empty series (an honest \"not connected / no activity yet\"), never a synthesized trend.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :range Range is the window to bucket: 24H, 7D or 30D. Anything else reads as 30D.
+    # @return [MetricsView]
+    def get_agents_metrics(opts = {})
+      data, _status_code, _headers = get_agents_metrics_with_http_info(opts)
+      data
+    end
+
+    # Serves the invocations-over-time histogram for the org&#39;s Agents dashboard.
+    # Serves the invocations-over-time histogram for the org&#39;s Agents dashboard. Every point is a REAL count of recorded runs in that time bucket — one series line per agent that ran in the window. The Resource Usage rollup is all-null because this store meters no CPU/memory/storage/cost; the console renders those as \&quot;—\&quot; rather than a fabricated figure. No runs &#x3D;&gt; empty series (an honest \&quot;not connected / no activity yet\&quot;), never a synthesized trend.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :range Range is the window to bucket: 24H, 7D or 30D. Anything else reads as 30D.
+    # @return [Array<(MetricsView, Integer, Hash)>] MetricsView data, response status code and response headers
+    def get_agents_metrics_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_metrics ...'
+      end
+      # resource path
+      local_var_path = '/v1/agents/metrics'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'range'] = opts[:'range'] if !opts[:'range'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'MetricsView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_metrics",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_metrics\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's agent runs across EVERY agent, newest first — what ran here, for whom, on which model, how long it took, and why it failed.
+    # Returns the org's agent runs across EVERY agent, newest first — what ran here, for whom, on which model, how long it took, and why it failed.  It is the feed the per-agent history could not be: an operator asking \"what is this tenant's agent plane doing\" does not start out knowing an agent ref, and answering by listing the agents and then paging each one's history is N+1 round trips to reconstruct one ordering the database already has (RunsSince, ordered by created_at over the org index).  The org is the CALLER's, resolved from identity by tenantStore — never a parameter. There is deliberately no org field on orgRunsQuery to forge: run history is the tenant's own record, and the only tenant this can answer for is the one asking.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit caps how many runs come back, newest first. Absent, zero or out of range (1..200) reads as 50.
+    # @option opts [String] :status Status keeps only runs with this outcome (\&quot;ok\&quot; or \&quot;error\&quot;). Empty keeps both. It is the filter an operator reaches for first — \&quot;show me what broke\&quot; — and answering it here rather than by paging the whole history client-side is the difference between a usable feed and a download.
+    # @return [RunList]
+    def get_agents_runs(opts = {})
+      data, _status_code, _headers = get_agents_runs_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s agent runs across EVERY agent, newest first — what ran here, for whom, on which model, how long it took, and why it failed.
+    # Returns the org&#39;s agent runs across EVERY agent, newest first — what ran here, for whom, on which model, how long it took, and why it failed.  It is the feed the per-agent history could not be: an operator asking \&quot;what is this tenant&#39;s agent plane doing\&quot; does not start out knowing an agent ref, and answering by listing the agents and then paging each one&#39;s history is N+1 round trips to reconstruct one ordering the database already has (RunsSince, ordered by created_at over the org index).  The org is the CALLER&#39;s, resolved from identity by tenantStore — never a parameter. There is deliberately no org field on orgRunsQuery to forge: run history is the tenant&#39;s own record, and the only tenant this can answer for is the one asking.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit caps how many runs come back, newest first. Absent, zero or out of range (1..200) reads as 50.
+    # @option opts [String] :status Status keeps only runs with this outcome (\&quot;ok\&quot; or \&quot;error\&quot;). Empty keeps both. It is the filter an operator reaches for first — \&quot;show me what broke\&quot; — and answering it here rather than by paging the whole history client-side is the difference between a usable feed and a download.
+    # @return [Array<(RunList, Integer, Hash)>] RunList data, response status code and response headers
+    def get_agents_runs_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_runs ...'
+      end
+      # resource path
+      local_var_path = '/v1/agents/runs'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'RunList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_runs",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_runs\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the caller org's live sessions, newest first — each with its event count, its direct-child count and a one-line preview of its latest event.
+    # Returns the caller org's live sessions, newest first — each with its event count, its direct-child count and a one-line preview of its latest event. With no filter it returns ROOT sessions only, so a dashboard shows one row per flow rather than one per subagent; ?root= or ?parent= descends.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :root Root scopes the page to one subagent tree (its root session id).
+    # @option opts [String] :parent Parent scopes the page to the direct children of one session. Ignored when root is set; with neither, only ROOT sessions come back.
+    # @option opts [String] :status Status filters to running, paused, done or error.
+    # @option opts [String] :project Project filters to the sessions tagged with one product slug.
+    # @option opts [String] :room Room filters to the sessions started in one collaborative room — the query a workspace view runs to show what has been run in it.
+    # @option opts [Integer] :limit Limit caps the page. Absent, zero or over 500 reads as 100.
+    # @return [SessionList]
+    def get_agents_sessions(opts = {})
+      data, _status_code, _headers = get_agents_sessions_with_http_info(opts)
+      data
+    end
+
+    # Returns the caller org&#39;s live sessions, newest first — each with its event count, its direct-child count and a one-line preview of its latest event.
+    # Returns the caller org&#39;s live sessions, newest first — each with its event count, its direct-child count and a one-line preview of its latest event. With no filter it returns ROOT sessions only, so a dashboard shows one row per flow rather than one per subagent; ?root&#x3D; or ?parent&#x3D; descends.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :root Root scopes the page to one subagent tree (its root session id).
+    # @option opts [String] :parent Parent scopes the page to the direct children of one session. Ignored when root is set; with neither, only ROOT sessions come back.
+    # @option opts [String] :status Status filters to running, paused, done or error.
+    # @option opts [String] :project Project filters to the sessions tagged with one product slug.
+    # @option opts [String] :room Room filters to the sessions started in one collaborative room — the query a workspace view runs to show what has been run in it.
+    # @option opts [Integer] :limit Limit caps the page. Absent, zero or over 500 reads as 100.
+    # @return [Array<(SessionList, Integer, Hash)>] SessionList data, response status code and response headers
+    def get_agents_sessions_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_sessions ...'
+      end
+      # resource path
+      local_var_path = '/v1/agents/sessions'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'root'] = opts[:'root'] if !opts[:'root'].nil?
+      query_params[:'parent'] = opts[:'parent'] if !opts[:'parent'].nil?
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+      query_params[:'project'] = opts[:'project'] if !opts[:'project'].nil?
+      query_params[:'room'] = opts[:'room'] if !opts[:'room'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SessionList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_sessions",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_sessions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one session with its direct child sessions and its 50 most recent events, oldest of those first.
+    # Returns one session with its direct child sessions and its 50 most recent events, oldest of those first.
+    # @param id [String] ID is the session to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [SessionDetail]
+    def get_agents_sessions_by_id(id, opts = {})
+      data, _status_code, _headers = get_agents_sessions_by_id_with_http_info(id, opts)
+      data
+    end
+
+    # Returns one session with its direct child sessions and its 50 most recent events, oldest of those first.
+    # Returns one session with its direct child sessions and its 50 most recent events, oldest of those first.
+    # @param id [String] ID is the session to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SessionDetail, Integer, Hash)>] SessionDetail data, response status code and response headers
+    def get_agents_sessions_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_sessions_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.get_agents_sessions_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/agents/sessions/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SessionDetail'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_sessions_by_id",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_sessions_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the steering commands (pause/resume/stop/message) recorded against the caller's own session that are newer than the cursor, oldest first, with the cursor to poll from next.
+    # Returns the steering commands (pause/resume/stop/message) recorded against the caller's own session that are newer than the cursor, oldest first, with the cursor to poll from next. It is how a locally started `hanzo code` session — which is not task-backed, so nothing forwards its commands to an execution engine — consumes what the dashboard posted. Read-only and bounded at 200 per poll, so a steady poll is cheap and an applied command is never redelivered.
+    # @param id [String] ID is the session whose commands are being drained, from the path.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :after After is the last seq this poller applied; only commands newer than it come back. Absent or negative reads as 0, which drains from the beginning.
+    # @return [ControlDrain]
+    def get_agents_sessions_by_id_control(id, opts = {})
+      data, _status_code, _headers = get_agents_sessions_by_id_control_with_http_info(id, opts)
+      data
+    end
+
+    # Returns the steering commands (pause/resume/stop/message) recorded against the caller&#39;s own session that are newer than the cursor, oldest first, with the cursor to poll from next.
+    # Returns the steering commands (pause/resume/stop/message) recorded against the caller&#39;s own session that are newer than the cursor, oldest first, with the cursor to poll from next. It is how a locally started &#x60;hanzo code&#x60; session — which is not task-backed, so nothing forwards its commands to an execution engine — consumes what the dashboard posted. Read-only and bounded at 200 per poll, so a steady poll is cheap and an applied command is never redelivered.
+    # @param id [String] ID is the session whose commands are being drained, from the path.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :after After is the last seq this poller applied; only commands newer than it come back. Absent or negative reads as 0, which drains from the beginning.
+    # @return [Array<(ControlDrain, Integer, Hash)>] ControlDrain data, response status code and response headers
+    def get_agents_sessions_by_id_control_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_sessions_by_id_control ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.get_agents_sessions_by_id_control"
+      end
+      # resource path
+      local_var_path = '/v1/agents/sessions/{id}/control'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'after'] = opts[:'after'] if !opts[:'after'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ControlDrain'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_sessions_by_id_control",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_sessions_by_id_control\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns how far along one run is: the share of its goal that is done, whether it is running, blocked or finished, and a line saying what it is doing right now.
+    # Returns how far along one run is: the share of its goal that is done, whether it is running, blocked or finished, and a line saying what it is doing right now.  It is a MODEL ESTIMATE read off the run's own transcript, not a measurement — `estimated` says so on every answer, and a run whose progress cannot be told reports phase \"unknown\" with no percentage rather than a zero it does not mean. A session that has already finished answers from its own status instead, and is marked not estimated.  The list and detail reads carry the same value; this address is the one that WAITS. Where the stored estimate has gone stale it is remade before answering, so a human deciding whether to step into a run gets a current reading rather than the last poll's — which costs one small completion, charged to the same wallet the session already names, at most once every thirty seconds per run.
+    # @param id [String] ID is the session to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [SessionProgress]
+    def get_agents_sessions_by_id_progress(id, opts = {})
+      data, _status_code, _headers = get_agents_sessions_by_id_progress_with_http_info(id, opts)
+      data
+    end
+
+    # Returns how far along one run is: the share of its goal that is done, whether it is running, blocked or finished, and a line saying what it is doing right now.
+    # Returns how far along one run is: the share of its goal that is done, whether it is running, blocked or finished, and a line saying what it is doing right now.  It is a MODEL ESTIMATE read off the run&#39;s own transcript, not a measurement — &#x60;estimated&#x60; says so on every answer, and a run whose progress cannot be told reports phase \&quot;unknown\&quot; with no percentage rather than a zero it does not mean. A session that has already finished answers from its own status instead, and is marked not estimated.  The list and detail reads carry the same value; this address is the one that WAITS. Where the stored estimate has gone stale it is remade before answering, so a human deciding whether to step into a run gets a current reading rather than the last poll&#39;s — which costs one small completion, charged to the same wallet the session already names, at most once every thirty seconds per run.
+    # @param id [String] ID is the session to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SessionProgress, Integer, Hash)>] SessionProgress data, response status code and response headers
+    def get_agents_sessions_by_id_progress_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_sessions_by_id_progress ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.get_agents_sessions_by_id_progress"
+      end
+      # resource path
+      local_var_path = '/v1/agents/sessions/{id}/progress'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SessionProgress'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_sessions_by_id_progress",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_sessions_by_id_progress\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the subagent-flow graph rooted at this session: the session, its children, their children, each node carrying its own event count.
+    # Returns the subagent-flow graph rooted at this session: the session, its children, their children, each node carrying its own event count. One indexed read pulls the whole flow (every node of a flow shares a root id), so the shape is assembled in memory rather than by walking the store per node.
+    # @param id [String] ID is the session to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [TreeNode]
+    def get_agents_sessions_by_id_tree(id, opts = {})
+      data, _status_code, _headers = get_agents_sessions_by_id_tree_with_http_info(id, opts)
+      data
+    end
+
+    # Returns the subagent-flow graph rooted at this session: the session, its children, their children, each node carrying its own event count.
+    # Returns the subagent-flow graph rooted at this session: the session, its children, their children, each node carrying its own event count. One indexed read pulls the whole flow (every node of a flow shares a root id), so the shape is assembled in memory rather than by walking the store per node.
+    # @param id [String] ID is the session to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TreeNode, Integer, Hash)>] TreeNode data, response status code and response headers
+    def get_agents_sessions_by_id_tree_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_sessions_by_id_tree ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.get_agents_sessions_by_id_tree"
+      end
+      # resource path
+      local_var_path = '/v1/agents/sessions/{id}/tree'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TreeNode'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_sessions_by_id_tree",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_sessions_by_id_tree\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Live session and event updates for the caller's org, as Server-Sent Events.
+    # Holds the connection open as text/event-stream and pushes a frame each time the org's registry moves: an `event: session` frame carrying the same session shape the list and detail reads answer with (a registration, an update, or a login-manager revoke tearing a session down), and an `event: event` frame carrying one appended turn. Optional ?root=<session id> narrows the feed to a single subagent tree.  Requires a validated principal carrying an org; 403 without one. Org-scoped fail-closed: the bus filters on tenant before it fans out, so a subscriber only ever receives its own org's updates, and ?root= narrows that further but can never widen it.  Delivery is best-effort and the GET reads remain the source of truth. A subscriber that falls more than 256 frames behind is DROPPED — its channel is closed and the stream ends — so one stuck dashboard can never back-pressure a session write; the client reconnects and re-reads the session endpoints to resynchronise. A `: ping` comment every 25 seconds holds the connection open through proxies and is how a departed client is noticed.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_agents_sessions_stream(opts = {})
+      get_agents_sessions_stream_with_http_info(opts)
+      nil
+    end
+
+    # Live session and event updates for the caller&#39;s org, as Server-Sent Events.
+    # Holds the connection open as text/event-stream and pushes a frame each time the org&#39;s registry moves: an &#x60;event: session&#x60; frame carrying the same session shape the list and detail reads answer with (a registration, an update, or a login-manager revoke tearing a session down), and an &#x60;event: event&#x60; frame carrying one appended turn. Optional ?root&#x3D;&lt;session id&gt; narrows the feed to a single subagent tree.  Requires a validated principal carrying an org; 403 without one. Org-scoped fail-closed: the bus filters on tenant before it fans out, so a subscriber only ever receives its own org&#39;s updates, and ?root&#x3D; narrows that further but can never widen it.  Delivery is best-effort and the GET reads remain the source of truth. A subscriber that falls more than 256 frames behind is DROPPED — its channel is closed and the stream ends — so one stuck dashboard can never back-pressure a session write; the client reconnects and re-reads the session endpoints to resynchronise. A &#x60;: ping&#x60; comment every 25 seconds holds the connection open through proxies and is how a departed client is noticed.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_agents_sessions_stream_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_sessions_stream ...'
+      end
+      # resource path
+      local_var_path = '/v1/agents/sessions/stream'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_sessions_stream",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_sessions_stream\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns every machine registered to the caller's org, newest first, each with its live session load.
+    # Returns every machine registered to the caller's org, newest first, each with its live session load.
+    # @param [Hash] opts the optional parameters
+    # @return [TargetList]
+    def get_agents_targets(opts = {})
+      data, _status_code, _headers = get_agents_targets_with_http_info(opts)
+      data
+    end
+
+    # Returns every machine registered to the caller&#39;s org, newest first, each with its live session load.
+    # Returns every machine registered to the caller&#39;s org, newest first, each with its live session load.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TargetList, Integer, Hash)>] TargetList data, response status code and response headers
+    def get_agents_targets_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_targets ...'
+      end
+      # resource path
+      local_var_path = '/v1/agents/targets'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TargetList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_targets",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_targets\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one registered machine, with its live session load.
+    # Returns one registered machine, with its live session load.
+    # @param id [String] ID is the target to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [TargetView]
+    def get_agents_targets_by_id(id, opts = {})
+      data, _status_code, _headers = get_agents_targets_by_id_with_http_info(id, opts)
+      data
+    end
+
+    # Returns one registered machine, with its live session load.
+    # Returns one registered machine, with its live session load.
+    # @param id [String] ID is the target to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TargetView, Integer, Hash)>] TargetView data, response status code and response headers
+    def get_agents_targets_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.get_agents_targets_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.get_agents_targets_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/agents/targets/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TargetView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.get_agents_targets_by_id",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#get_agents_targets_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Changes an agent in place.
+    # Changes an agent in place. Every field is optional; a field the request omits keeps its stored value. The resulting mode+schedule are re-validated together, so a partial update can never leave a long-running agent without the cron the scheduler needs to fire it, and a transition INTO long-running counts against the per-org cap on scheduled agents.
+    # @param ref [String] Ref is the agent to update — its public id or org-unique name, from the path.
+    # @param update_agent_in [UpdateAgentIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [AgentView]
+    def patch_agents_by_ref(ref, update_agent_in, opts = {})
+      data, _status_code, _headers = patch_agents_by_ref_with_http_info(ref, update_agent_in, opts)
+      data
+    end
+
+    # Changes an agent in place.
+    # Changes an agent in place. Every field is optional; a field the request omits keeps its stored value. The resulting mode+schedule are re-validated together, so a partial update can never leave a long-running agent without the cron the scheduler needs to fire it, and a transition INTO long-running counts against the per-org cap on scheduled agents.
+    # @param ref [String] Ref is the agent to update — its public id or org-unique name, from the path.
+    # @param update_agent_in [UpdateAgentIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AgentView, Integer, Hash)>] AgentView data, response status code and response headers
+    def patch_agents_by_ref_with_http_info(ref, update_agent_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.patch_agents_by_ref ...'
+      end
+      # verify the required parameter 'ref' is set
+      if @api_client.config.client_side_validation && ref.nil?
+        fail ArgumentError, "Missing the required parameter 'ref' when calling AgentsApi.patch_agents_by_ref"
+      end
+      # verify the required parameter 'update_agent_in' is set
+      if @api_client.config.client_side_validation && update_agent_in.nil?
+        fail ArgumentError, "Missing the required parameter 'update_agent_in' when calling AgentsApi.patch_agents_by_ref"
+      end
+      # resource path
+      local_var_path = '/v1/agents/{ref}'.sub('{' + 'ref' + '}', CGI.escape(ref.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(update_agent_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AgentView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.patch_agents_by_ref",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#patch_agents_by_ref\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Updates a session's surface-owned truth: its status, its title, the run-target it is dispatched to, and the product it built plus whether that build's story is public.
+    # Updates a session's surface-owned truth: its status, its title, the run-target it is dispatched to, and the product it built plus whether that build's story is public. A FINISHED session stays finished — reopening a done/error run would fabricate liveness — and publishing is refused unless the session names the project it built, because the public build route is keyed on (org, project).
+    # @param id [String] ID is the session to update, from the path.
+    # @param patch_session_in [PatchSessionIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [SessionView]
+    def patch_agents_sessions_by_id(id, patch_session_in, opts = {})
+      data, _status_code, _headers = patch_agents_sessions_by_id_with_http_info(id, patch_session_in, opts)
+      data
+    end
+
+    # Updates a session&#39;s surface-owned truth: its status, its title, the run-target it is dispatched to, and the product it built plus whether that build&#39;s story is public.
+    # Updates a session&#39;s surface-owned truth: its status, its title, the run-target it is dispatched to, and the product it built plus whether that build&#39;s story is public. A FINISHED session stays finished — reopening a done/error run would fabricate liveness — and publishing is refused unless the session names the project it built, because the public build route is keyed on (org, project).
+    # @param id [String] ID is the session to update, from the path.
+    # @param patch_session_in [PatchSessionIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SessionView, Integer, Hash)>] SessionView data, response status code and response headers
+    def patch_agents_sessions_by_id_with_http_info(id, patch_session_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.patch_agents_sessions_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.patch_agents_sessions_by_id"
+      end
+      # verify the required parameter 'patch_session_in' is set
+      if @api_client.config.client_side_validation && patch_session_in.nil?
+        fail ArgumentError, "Missing the required parameter 'patch_session_in' when calling AgentsApi.patch_agents_sessions_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/agents/sessions/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(patch_session_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SessionView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.patch_agents_sessions_by_id",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#patch_agents_sessions_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Updates one machine in place.
+    # Updates one machine in place. Every field is optional; a field the request omits is left alone. A metrics patch IS a heartbeat — the server stamps its own clock, so a client can neither forge nor backdate staleness.
+    # @param id [String] ID is the target to update, from the path.
+    # @param patch_target_in [PatchTargetIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [TargetView]
+    def patch_agents_targets_by_id(id, patch_target_in, opts = {})
+      data, _status_code, _headers = patch_agents_targets_by_id_with_http_info(id, patch_target_in, opts)
+      data
+    end
+
+    # Updates one machine in place.
+    # Updates one machine in place. Every field is optional; a field the request omits is left alone. A metrics patch IS a heartbeat — the server stamps its own clock, so a client can neither forge nor backdate staleness.
+    # @param id [String] ID is the target to update, from the path.
+    # @param patch_target_in [PatchTargetIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TargetView, Integer, Hash)>] TargetView data, response status code and response headers
+    def patch_agents_targets_by_id_with_http_info(id, patch_target_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.patch_agents_targets_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.patch_agents_targets_by_id"
+      end
+      # verify the required parameter 'patch_target_in' is set
+      if @api_client.config.client_side_validation && patch_target_in.nil?
+        fail ArgumentError, "Missing the required parameter 'patch_target_in' when calling AgentsApi.patch_agents_targets_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/agents/targets/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(patch_target_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TargetView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.patch_agents_targets_by_id",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#patch_agents_targets_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Defines an agent in the caller's org: a model, a system prompt (instructions) and a set of tool names.
+    # Defines an agent in the caller's org: a model, a system prompt (instructions) and a set of tool names. The name must be unique in the org and match ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$. An omitted model takes the deployment's configured default; a named one is checked against the gateway's served catalog, so a model this deployment never serves is refused here rather than failing at run time. A long-running agent must carry a 5-field cron schedule (the scheduler would otherwise never fire it) and counts against a per-org cap on scheduled agents.
+    # @param create_agent_in [CreateAgentIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [AgentView]
+    def post_agents(create_agent_in, opts = {})
+      data, _status_code, _headers = post_agents_with_http_info(create_agent_in, opts)
+      data
+    end
+
+    # Defines an agent in the caller&#39;s org: a model, a system prompt (instructions) and a set of tool names.
+    # Defines an agent in the caller&#39;s org: a model, a system prompt (instructions) and a set of tool names. The name must be unique in the org and match ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$. An omitted model takes the deployment&#39;s configured default; a named one is checked against the gateway&#39;s served catalog, so a model this deployment never serves is refused here rather than failing at run time. A long-running agent must carry a 5-field cron schedule (the scheduler would otherwise never fire it) and counts against a per-org cap on scheduled agents.
+    # @param create_agent_in [CreateAgentIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AgentView, Integer, Hash)>] AgentView data, response status code and response headers
+    def post_agents_with_http_info(create_agent_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.post_agents ...'
+      end
+      # verify the required parameter 'create_agent_in' is set
+      if @api_client.config.client_side_validation && create_agent_in.nil?
+        fail ArgumentError, "Missing the required parameter 'create_agent_in' when calling AgentsApi.post_agents"
+      end
+      # resource path
+      local_var_path = '/v1/agents'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(create_agent_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AgentView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.post_agents",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#post_agents\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Run one of your org's agents and get the recorded run back.
+    # Composes the agent's stored instructions with the caller's `input`, executes one real chat completion through the same in-process AI client the rest of the console uses, and answers with the run that was recorded: its id, status, model, output, duration and error. Every run this returns reflects an execution that actually happened — a model failure is recorded and reported, never hidden and never fabricated. A transient upstream failure (429, 5xx, empty choices) is retried up to three times with jittered backoff, and a configured failover model is tried before the run is called an error.  `ref` is the agent's public `agent_…` id or its org-unique name; either resolves the same agent, and it must belong to the caller's org, so an agent in another tenant is a 404 exactly like one that does not exist. A validated principal is required and the check is made twice on purpose: this route MOVES MONEY, so the debit's principal requirement is asserted where the money moves rather than inherited from the tenant lookup.  The org's balance is authorized BEFORE any inference, so an unfunded tenant gets 402 and no free compute, and a billing plane that cannot answer gets 503 rather than a free run. The flat per-run fee is an operator knob; setting it to zero makes runs free and removes the balance gate with them. Only a SUCCESSFUL run is billed, attributed to the model actually used — a failover run bills the model it fell over to, not the one it started on. A deployment with no inference wired answers 503 before any of this.  THE RULE A READER GETS WRONG: a failed run is a 502 whose body is the RUN, not an error envelope. The execution happened, the run was persisted to this agent's history, and its `error` field is the product — so a client that treats every non-2xx as an opaque failure throws away the only account of what went wrong. Each run also opens a root session in the live session registry, best-effort: a bookkeeping failure there never fails the run, because the run and its billing already happened.
+    # @param ref [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def post_agents_by_ref_run(ref, opts = {})
+      post_agents_by_ref_run_with_http_info(ref, opts)
+      nil
+    end
+
+    # Run one of your org&#39;s agents and get the recorded run back.
+    # Composes the agent&#39;s stored instructions with the caller&#39;s &#x60;input&#x60;, executes one real chat completion through the same in-process AI client the rest of the console uses, and answers with the run that was recorded: its id, status, model, output, duration and error. Every run this returns reflects an execution that actually happened — a model failure is recorded and reported, never hidden and never fabricated. A transient upstream failure (429, 5xx, empty choices) is retried up to three times with jittered backoff, and a configured failover model is tried before the run is called an error.  &#x60;ref&#x60; is the agent&#39;s public &#x60;agent_…&#x60; id or its org-unique name; either resolves the same agent, and it must belong to the caller&#39;s org, so an agent in another tenant is a 404 exactly like one that does not exist. A validated principal is required and the check is made twice on purpose: this route MOVES MONEY, so the debit&#39;s principal requirement is asserted where the money moves rather than inherited from the tenant lookup.  The org&#39;s balance is authorized BEFORE any inference, so an unfunded tenant gets 402 and no free compute, and a billing plane that cannot answer gets 503 rather than a free run. The flat per-run fee is an operator knob; setting it to zero makes runs free and removes the balance gate with them. Only a SUCCESSFUL run is billed, attributed to the model actually used — a failover run bills the model it fell over to, not the one it started on. A deployment with no inference wired answers 503 before any of this.  THE RULE A READER GETS WRONG: a failed run is a 502 whose body is the RUN, not an error envelope. The execution happened, the run was persisted to this agent&#39;s history, and its &#x60;error&#x60; field is the product — so a client that treats every non-2xx as an opaque failure throws away the only account of what went wrong. Each run also opens a root session in the live session registry, best-effort: a bookkeeping failure there never fails the run, because the run and its billing already happened.
+    # @param ref [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_agents_by_ref_run_with_http_info(ref, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.post_agents_by_ref_run ...'
+      end
+      # verify the required parameter 'ref' is set
+      if @api_client.config.client_side_validation && ref.nil?
+        fail ArgumentError, "Missing the required parameter 'ref' when calling AgentsApi.post_agents_by_ref_run"
+      end
+      # resource path
+      local_var_path = '/v1/agents/{ref}/run'.sub('{' + 'ref' + '}', CGI.escape(ref.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.post_agents_by_ref_run",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#post_agents_by_ref_run\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Run one tool-calling round against your org's own tools
+    # Answers one turn of a conversation with four things: the model's `reply`, the `actions` the server executed on the caller's behalf, the `ops` the client must apply itself, and the `conversationId` the turn was recorded under.  The split between actions and ops is the rule most easily got wrong. A tool call is executed HERE only when the chosen preset is server-executing AND the tool resolves in the caller's own scope; every other call is handed back as an op for the client to apply to its own graph or UI. A tool that fails still comes back as an action, carrying its error rather than failing the round.  `preset` selects the system prompt and the tool set (`capability` is a legacy alias for it); an unknown one is refused. `conversationId` continues an existing thread, and its absence starts one. A validated principal with a non-empty org is required — the org is the sole authority for both persistence and tool scope, and is NEVER read from the body.  A completion refused for the caller's own reason — 402 insufficient balance, 429, 403 — is relayed with its own status and body verbatim, so the real billing message reaches the client instead of an opaque gateway error. Only a genuine upstream fault becomes a 502.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def post_agents_chat(opts = {})
+      post_agents_chat_with_http_info(opts)
+      nil
+    end
+
+    # Run one tool-calling round against your org&#39;s own tools
+    # Answers one turn of a conversation with four things: the model&#39;s &#x60;reply&#x60;, the &#x60;actions&#x60; the server executed on the caller&#39;s behalf, the &#x60;ops&#x60; the client must apply itself, and the &#x60;conversationId&#x60; the turn was recorded under.  The split between actions and ops is the rule most easily got wrong. A tool call is executed HERE only when the chosen preset is server-executing AND the tool resolves in the caller&#39;s own scope; every other call is handed back as an op for the client to apply to its own graph or UI. A tool that fails still comes back as an action, carrying its error rather than failing the round.  &#x60;preset&#x60; selects the system prompt and the tool set (&#x60;capability&#x60; is a legacy alias for it); an unknown one is refused. &#x60;conversationId&#x60; continues an existing thread, and its absence starts one. A validated principal with a non-empty org is required — the org is the sole authority for both persistence and tool scope, and is NEVER read from the body.  A completion refused for the caller&#39;s own reason — 402 insufficient balance, 429, 403 — is relayed with its own status and body verbatim, so the real billing message reaches the client instead of an opaque gateway error. Only a genuine upstream fault becomes a 502.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_agents_chat_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.post_agents_chat ...'
+      end
+      # resource path
+      local_var_path = '/v1/agents/chat'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.post_agents_chat",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#post_agents_chat\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Start one autonomous coding run against a repo in the caller's org
+    # Runs a coding task on a repository: clones it into a sandbox, lets a model read and edit the code, run the tests, and push the work to a branch. Say the thing you want done — \"fix the failing auth test in hanzoai/cloud\" — and the run infers the repo, the branch and the plan. No prefix, no ceremony.  It answers 202 with the run's handle the moment the run is ADMITTED — not when it finishes. A coding run takes minutes; holding a request open for one would tie a connection to a model loop and give the caller nothing it cannot get better from the session stream.  The handle is a session id, and that is deliberate: the session is already the run's durable record and its live stream (/v1/agents/sessions/{id}/stream), so this op does not grow a progress endpoint, a status endpoint or a cancel endpoint of its own. One way to watch a run, whoever started it.  It is also how work CONTINUES. Pass an earlier run's session as `after` and this one starts from where that one stopped, so \"now add tests for it\" builds on the branch already pushed instead of a fresh clone. The follow-up still gets its own branch and its own session — one run, one branch, always reviewable on its own.
+    # @param coding_start_in [CodingStartIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [CodingStarted]
+    def post_agents_coding(coding_start_in, opts = {})
+      data, _status_code, _headers = post_agents_coding_with_http_info(coding_start_in, opts)
+      data
+    end
+
+    # Start one autonomous coding run against a repo in the caller&#39;s org
+    # Runs a coding task on a repository: clones it into a sandbox, lets a model read and edit the code, run the tests, and push the work to a branch. Say the thing you want done — \&quot;fix the failing auth test in hanzoai/cloud\&quot; — and the run infers the repo, the branch and the plan. No prefix, no ceremony.  It answers 202 with the run&#39;s handle the moment the run is ADMITTED — not when it finishes. A coding run takes minutes; holding a request open for one would tie a connection to a model loop and give the caller nothing it cannot get better from the session stream.  The handle is a session id, and that is deliberate: the session is already the run&#39;s durable record and its live stream (/v1/agents/sessions/{id}/stream), so this op does not grow a progress endpoint, a status endpoint or a cancel endpoint of its own. One way to watch a run, whoever started it.  It is also how work CONTINUES. Pass an earlier run&#39;s session as &#x60;after&#x60; and this one starts from where that one stopped, so \&quot;now add tests for it\&quot; builds on the branch already pushed instead of a fresh clone. The follow-up still gets its own branch and its own session — one run, one branch, always reviewable on its own.
+    # @param coding_start_in [CodingStartIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CodingStarted, Integer, Hash)>] CodingStarted data, response status code and response headers
+    def post_agents_coding_with_http_info(coding_start_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.post_agents_coding ...'
+      end
+      # verify the required parameter 'coding_start_in' is set
+      if @api_client.config.client_side_validation && coding_start_in.nil?
+        fail ArgumentError, "Missing the required parameter 'coding_start_in' when calling AgentsApi.post_agents_coding"
+      end
+      # resource path
+      local_var_path = '/v1/agents/coding'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(coding_start_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CodingStarted'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.post_agents_coding",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#post_agents_coding\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Opens a live agent session in the caller's org — the row every surface (the CLI's outer agent, hanzo.bot, the console, chat) hangs its activity off.
+    # Opens a live agent session in the caller's org — the row every surface (the CLI's outer agent, hanzo.bot, the console, chat) hangs its activity off. A session with a parentSessionId becomes a subagent of that session and inherits its root, so one flow is one tree; without one it is itself a root. Registering with a terminal status records a session that has already finished.
+    # @param register_req [RegisterReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [SessionView]
+    def post_agents_sessions(register_req, opts = {})
+      data, _status_code, _headers = post_agents_sessions_with_http_info(register_req, opts)
+      data
+    end
+
+    # Opens a live agent session in the caller&#39;s org — the row every surface (the CLI&#39;s outer agent, hanzo.bot, the console, chat) hangs its activity off.
+    # Opens a live agent session in the caller&#39;s org — the row every surface (the CLI&#39;s outer agent, hanzo.bot, the console, chat) hangs its activity off. A session with a parentSessionId becomes a subagent of that session and inherits its root, so one flow is one tree; without one it is itself a root. Registering with a terminal status records a session that has already finished.
+    # @param register_req [RegisterReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SessionView, Integer, Hash)>] SessionView data, response status code and response headers
+    def post_agents_sessions_with_http_info(register_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.post_agents_sessions ...'
+      end
+      # verify the required parameter 'register_req' is set
+      if @api_client.config.client_side_validation && register_req.nil?
+        fail ArgumentError, "Missing the required parameter 'register_req' when calling AgentsApi.post_agents_sessions"
+      end
+      # resource path
+      local_var_path = '/v1/agents/sessions'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(register_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SessionView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.post_agents_sessions",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#post_agents_sessions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Records one turn of a session's transcript and answers 201 with it.
+    # Records one turn of a session's transcript and answers 201 with it.  A `progress` turn additionally MOVES THE SESSION'S PROGRESS, marked as the run's own word rather than an estimate, and pushes the updated session onto the live stream — so a board's bar follows the run without polling and without a second write path. See progress.go.  THE TURN IS SCANNED BEFORE IT IS STORED. The same engine the code-security surface runs reads the payload at this boundary, and a credential in it refuses the append with 422 rather than redacting it — a redacted transcript is one that still had the secret in it once, and this way the author learns which value to rotate. The refusal carries every finding: the rule, the severity, the line, a MASKED preview and the fingerprint. The secret is never in the answer.
+    # @param id [String] ID is the session to append to, from the path.
+    # @param event_in [EventIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [EventView]
+    def post_agents_sessions_by_id_events(id, event_in, opts = {})
+      data, _status_code, _headers = post_agents_sessions_by_id_events_with_http_info(id, event_in, opts)
+      data
+    end
+
+    # Records one turn of a session&#39;s transcript and answers 201 with it.
+    # Records one turn of a session&#39;s transcript and answers 201 with it.  A &#x60;progress&#x60; turn additionally MOVES THE SESSION&#39;S PROGRESS, marked as the run&#39;s own word rather than an estimate, and pushes the updated session onto the live stream — so a board&#39;s bar follows the run without polling and without a second write path. See progress.go.  THE TURN IS SCANNED BEFORE IT IS STORED. The same engine the code-security surface runs reads the payload at this boundary, and a credential in it refuses the append with 422 rather than redacting it — a redacted transcript is one that still had the secret in it once, and this way the author learns which value to rotate. The refusal carries every finding: the rule, the severity, the line, a MASKED preview and the fingerprint. The secret is never in the answer.
+    # @param id [String] ID is the session to append to, from the path.
+    # @param event_in [EventIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(EventView, Integer, Hash)>] EventView data, response status code and response headers
+    def post_agents_sessions_by_id_events_with_http_info(id, event_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.post_agents_sessions_by_id_events ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.post_agents_sessions_by_id_events"
+      end
+      # verify the required parameter 'event_in' is set
+      if @api_client.config.client_side_validation && event_in.nil?
+        fail ArgumentError, "Missing the required parameter 'event_in' when calling AgentsApi.post_agents_sessions_by_id_events"
+      end
+      # resource path
+      local_var_path = '/v1/agents/sessions/{id}/events'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(event_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EventView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.post_agents_sessions_by_id_events",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#post_agents_sessions_by_id_events\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Sends a steering message to a running session — the endpoint a human or another agent interrupts through.
+    # Sends a steering message to a running session — the endpoint a human or another agent interrupts through. It requires a `message` or a `payload`; the other three commands do not.
+    # @param id [String] ID is the session to steer, from the path.
+    # @param control_in [ControlIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [ControlResult]
+    def post_agents_sessions_by_id_message(id, control_in, opts = {})
+      data, _status_code, _headers = post_agents_sessions_by_id_message_with_http_info(id, control_in, opts)
+      data
+    end
+
+    # Sends a steering message to a running session — the endpoint a human or another agent interrupts through.
+    # Sends a steering message to a running session — the endpoint a human or another agent interrupts through. It requires a &#x60;message&#x60; or a &#x60;payload&#x60;; the other three commands do not.
+    # @param id [String] ID is the session to steer, from the path.
+    # @param control_in [ControlIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ControlResult, Integer, Hash)>] ControlResult data, response status code and response headers
+    def post_agents_sessions_by_id_message_with_http_info(id, control_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.post_agents_sessions_by_id_message ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.post_agents_sessions_by_id_message"
+      end
+      # verify the required parameter 'control_in' is set
+      if @api_client.config.client_side_validation && control_in.nil?
+        fail ArgumentError, "Missing the required parameter 'control_in' when calling AgentsApi.post_agents_sessions_by_id_message"
+      end
+      # resource path
+      local_var_path = '/v1/agents/sessions/{id}/message'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(control_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ControlResult'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.post_agents_sessions_by_id_message",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#post_agents_sessions_by_id_message\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Asks a running session to pause.
+    # Asks a running session to pause. Recorded durably, and forwarded to the durable-execution engine when the session is task-backed.
+    # @param id [String] ID is the session to steer, from the path.
+    # @param control_in [ControlIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [ControlResult]
+    def post_agents_sessions_by_id_pause(id, control_in, opts = {})
+      data, _status_code, _headers = post_agents_sessions_by_id_pause_with_http_info(id, control_in, opts)
+      data
+    end
+
+    # Asks a running session to pause.
+    # Asks a running session to pause. Recorded durably, and forwarded to the durable-execution engine when the session is task-backed.
+    # @param id [String] ID is the session to steer, from the path.
+    # @param control_in [ControlIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ControlResult, Integer, Hash)>] ControlResult data, response status code and response headers
+    def post_agents_sessions_by_id_pause_with_http_info(id, control_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.post_agents_sessions_by_id_pause ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.post_agents_sessions_by_id_pause"
+      end
+      # verify the required parameter 'control_in' is set
+      if @api_client.config.client_side_validation && control_in.nil?
+        fail ArgumentError, "Missing the required parameter 'control_in' when calling AgentsApi.post_agents_sessions_by_id_pause"
+      end
+      # resource path
+      local_var_path = '/v1/agents/sessions/{id}/pause'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(control_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ControlResult'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.post_agents_sessions_by_id_pause",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#post_agents_sessions_by_id_pause\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Asks a paused session to continue, on the same terms as a pause.
+    # Asks a paused session to continue, on the same terms as a pause.
+    # @param id [String] ID is the session to steer, from the path.
+    # @param control_in [ControlIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [ControlResult]
+    def post_agents_sessions_by_id_resume(id, control_in, opts = {})
+      data, _status_code, _headers = post_agents_sessions_by_id_resume_with_http_info(id, control_in, opts)
+      data
+    end
+
+    # Asks a paused session to continue, on the same terms as a pause.
+    # Asks a paused session to continue, on the same terms as a pause.
+    # @param id [String] ID is the session to steer, from the path.
+    # @param control_in [ControlIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ControlResult, Integer, Hash)>] ControlResult data, response status code and response headers
+    def post_agents_sessions_by_id_resume_with_http_info(id, control_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.post_agents_sessions_by_id_resume ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.post_agents_sessions_by_id_resume"
+      end
+      # verify the required parameter 'control_in' is set
+      if @api_client.config.client_side_validation && control_in.nil?
+        fail ArgumentError, "Missing the required parameter 'control_in' when calling AgentsApi.post_agents_sessions_by_id_resume"
+      end
+      # resource path
+      local_var_path = '/v1/agents/sessions/{id}/resume'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(control_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ControlResult'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.post_agents_sessions_by_id_resume",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#post_agents_sessions_by_id_resume\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Ends a running session.
+    # Ends a running session. `message` is recorded as the cancellation reason, which is what a later reader of the transcript sees.  STOPPING IS NOT DELETING: the session, its transcript and anything it produced stay readable. A session that has already finished is 409 rather than a second stop.
+    # @param id [String] ID is the session to steer, from the path.
+    # @param control_in [ControlIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [ControlResult]
+    def post_agents_sessions_by_id_stop(id, control_in, opts = {})
+      data, _status_code, _headers = post_agents_sessions_by_id_stop_with_http_info(id, control_in, opts)
+      data
+    end
+
+    # Ends a running session.
+    # Ends a running session. &#x60;message&#x60; is recorded as the cancellation reason, which is what a later reader of the transcript sees.  STOPPING IS NOT DELETING: the session, its transcript and anything it produced stay readable. A session that has already finished is 409 rather than a second stop.
+    # @param id [String] ID is the session to steer, from the path.
+    # @param control_in [ControlIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ControlResult, Integer, Hash)>] ControlResult data, response status code and response headers
+    def post_agents_sessions_by_id_stop_with_http_info(id, control_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.post_agents_sessions_by_id_stop ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.post_agents_sessions_by_id_stop"
+      end
+      # verify the required parameter 'control_in' is set
+      if @api_client.config.client_side_validation && control_in.nil?
+        fail ArgumentError, "Missing the required parameter 'control_in' when calling AgentsApi.post_agents_sessions_by_id_stop"
+      end
+      # resource path
+      local_var_path = '/v1/agents/sessions/{id}/stop'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(control_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ControlResult'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.post_agents_sessions_by_id_stop",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#post_agents_sessions_by_id_stop\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Registers a machine as an agent target, or re-links one that is already registered.
+    # Registers a machine as an agent target, or re-links one that is already registered. Re-linking is idempotent and keyed on org+host+owner, so a machine that reconnects refreshes its own row rather than piling up duplicates; it answers 200, while a first registration answers 201.
+    # @param target_req [TargetReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [TargetView]
+    def post_agents_targets(target_req, opts = {})
+      data, _status_code, _headers = post_agents_targets_with_http_info(target_req, opts)
+      data
+    end
+
+    # Registers a machine as an agent target, or re-links one that is already registered.
+    # Registers a machine as an agent target, or re-links one that is already registered. Re-linking is idempotent and keyed on org+host+owner, so a machine that reconnects refreshes its own row rather than piling up duplicates; it answers 200, while a first registration answers 201.
+    # @param target_req [TargetReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TargetView, Integer, Hash)>] TargetView data, response status code and response headers
+    def post_agents_targets_with_http_info(target_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.post_agents_targets ...'
+      end
+      # verify the required parameter 'target_req' is set
+      if @api_client.config.client_side_validation && target_req.nil?
+        fail ArgumentError, "Missing the required parameter 'target_req' when calling AgentsApi.post_agents_targets"
+      end
+      # resource path
+      local_var_path = '/v1/agents/targets'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(target_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TargetView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.post_agents_targets",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#post_agents_targets\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # ClaimRoutedRun is the machine's long poll for work: it authenticates the daemon, stamps the liveness the dispatch gate reads (the poll IS the proof a runner is listening), and waits up to 25 seconds for the next run addressed to THIS machine.
+    # ClaimRoutedRun is the machine's long poll for work: it authenticates the daemon, stamps the liveness the dispatch gate reads (the poll IS the proof a runner is listening), and waits up to 25 seconds for the next run addressed to THIS machine. It answers the run when one arrives and 204 with no body when the window elapses, on which the daemon re-polls immediately.  TWO independent proofs are required and both fail closed to the same 403: the caller must own this machine (or be an org admin) AND present its claim key in X-Target-Key. A run offered to one machine is unreachable from another's claim.
+    # @param id [String] ID is the target to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [RoutedRunOut]
+    def post_agents_targets_by_id_claim(id, opts = {})
+      data, _status_code, _headers = post_agents_targets_by_id_claim_with_http_info(id, opts)
+      data
+    end
+
+    # ClaimRoutedRun is the machine&#39;s long poll for work: it authenticates the daemon, stamps the liveness the dispatch gate reads (the poll IS the proof a runner is listening), and waits up to 25 seconds for the next run addressed to THIS machine.
+    # ClaimRoutedRun is the machine&#39;s long poll for work: it authenticates the daemon, stamps the liveness the dispatch gate reads (the poll IS the proof a runner is listening), and waits up to 25 seconds for the next run addressed to THIS machine. It answers the run when one arrives and 204 with no body when the window elapses, on which the daemon re-polls immediately.  TWO independent proofs are required and both fail closed to the same 403: the caller must own this machine (or be an org admin) AND present its claim key in X-Target-Key. A run offered to one machine is unreachable from another&#39;s claim.
+    # @param id [String] ID is the target to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(RoutedRunOut, Integer, Hash)>] RoutedRunOut data, response status code and response headers
+    def post_agents_targets_by_id_claim_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.post_agents_targets_by_id_claim ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.post_agents_targets_by_id_claim"
+      end
+      # resource path
+      local_var_path = '/v1/agents/targets/{id}/claim'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'RoutedRunOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.post_agents_targets_by_id_claim",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#post_agents_targets_by_id_claim\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Mints (or rotates) the claim key a `hanzo code --serve` daemon presents to claim work for this machine, and returns it ONCE: only its SHA-256 hash is stored.
+    # Mints (or rotates) the claim key a `hanzo code --serve` daemon presents to claim work for this machine, and returns it ONCE: only its SHA-256 hash is stored. Rotating supersedes any prior daemon, so only the machine's owner — or an org admin — may call it; every other caller gets the same not-found an unknown id gets, and learns nothing about what exists.
+    # @param id [String] ID is the target to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [ClaimKeyOut]
+    def post_agents_targets_by_id_key(id, opts = {})
+      data, _status_code, _headers = post_agents_targets_by_id_key_with_http_info(id, opts)
+      data
+    end
+
+    # Mints (or rotates) the claim key a &#x60;hanzo code --serve&#x60; daemon presents to claim work for this machine, and returns it ONCE: only its SHA-256 hash is stored.
+    # Mints (or rotates) the claim key a &#x60;hanzo code --serve&#x60; daemon presents to claim work for this machine, and returns it ONCE: only its SHA-256 hash is stored. Rotating supersedes any prior daemon, so only the machine&#39;s owner — or an org admin — may call it; every other caller gets the same not-found an unknown id gets, and learns nothing about what exists.
+    # @param id [String] ID is the target to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ClaimKeyOut, Integer, Hash)>] ClaimKeyOut data, response status code and response headers
+    def post_agents_targets_by_id_key_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.post_agents_targets_by_id_key ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.post_agents_targets_by_id_key"
+      end
+      # resource path
+      local_var_path = '/v1/agents/targets/{id}/key'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ClaimKeyOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.post_agents_targets_by_id_key",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#post_agents_targets_by_id_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Completes a claimed run: it delivers the terminal result to the run's durable owner, which is what lets that workflow finish.
+    # Completes a claimed run: it delivers the terminal result to the run's durable owner, which is what lets that workflow finish. Scoped to (org, target, run) and claim-key authenticated, so a machine can only ever report a run it legitimately holds. Idempotent — a report for an unknown or already-finished run answers delivered:false rather than failing, because the session's terminal state was already set by the machine's own stream.
+    # @param id [String] ID is the machine reporting, from the path.
+    # @param run_id [String] RunID is the routed run being completed, from the path.
+    # @param report_run_in [ReportRunIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [ReportOut]
+    def post_agents_targets_by_id_runs_by_runid_report(id, run_id, report_run_in, opts = {})
+      data, _status_code, _headers = post_agents_targets_by_id_runs_by_runid_report_with_http_info(id, run_id, report_run_in, opts)
+      data
+    end
+
+    # Completes a claimed run: it delivers the terminal result to the run&#39;s durable owner, which is what lets that workflow finish.
+    # Completes a claimed run: it delivers the terminal result to the run&#39;s durable owner, which is what lets that workflow finish. Scoped to (org, target, run) and claim-key authenticated, so a machine can only ever report a run it legitimately holds. Idempotent — a report for an unknown or already-finished run answers delivered:false rather than failing, because the session&#39;s terminal state was already set by the machine&#39;s own stream.
+    # @param id [String] ID is the machine reporting, from the path.
+    # @param run_id [String] RunID is the routed run being completed, from the path.
+    # @param report_run_in [ReportRunIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ReportOut, Integer, Hash)>] ReportOut data, response status code and response headers
+    def post_agents_targets_by_id_runs_by_runid_report_with_http_info(id, run_id, report_run_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentsApi.post_agents_targets_by_id_runs_by_runid_report ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling AgentsApi.post_agents_targets_by_id_runs_by_runid_report"
+      end
+      # verify the required parameter 'run_id' is set
+      if @api_client.config.client_side_validation && run_id.nil?
+        fail ArgumentError, "Missing the required parameter 'run_id' when calling AgentsApi.post_agents_targets_by_id_runs_by_runid_report"
+      end
+      # verify the required parameter 'report_run_in' is set
+      if @api_client.config.client_side_validation && report_run_in.nil?
+        fail ArgumentError, "Missing the required parameter 'report_run_in' when calling AgentsApi.post_agents_targets_by_id_runs_by_runid_report"
+      end
+      # resource path
+      local_var_path = '/v1/agents/targets/{id}/runs/{runId}/report'.sub('{' + 'id' + '}', CGI.escape(id.to_s)).sub('{' + 'runId' + '}', CGI.escape(run_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(report_run_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ReportOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"AgentsApi.post_agents_targets_by_id_runs_by_runid_report",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentsApi#post_agents_targets_by_id_runs_by_runid_report\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end