conductor_ruby 0.1.0 → 0.1.1

data/lib/conductor/http/api/scheduler_resource_api.rb

@@ -67,27 +67,24 @@ module Conductor
         end
 
         # Pause a schedule
+        #
+        # Per-schedule pause/resume is PUT-mapped on OSS Conductor but GET-only
+        # on some Orkes Conductor deployments. PUT is tried first and a 405
+        # response falls back to GET, mirroring the python-sdk/csharp-sdk/rust-sdk
+        # clients.
         # @param [String] name Schedule name
         # @return [void]
         def pause_schedule(name)
-          @api_client.call_api(
-            '/scheduler/schedules/{name}/pause',
-            'GET',
-            path_params: { name: name },
-            return_http_data_only: true
-          )
+          call_with_verb_fallback('/scheduler/schedules/{name}/pause', name)
         end
 
         # Resume a schedule
+        #
+        # See {#pause_schedule} for the PUT-with-GET-fallback rationale.
         # @param [String] name Schedule name
         # @return [void]
         def resume_schedule(name)
-          @api_client.call_api(
-            '/scheduler/schedules/{name}/resume',
-            'GET',
-            path_params: { name: name },
-            return_http_data_only: true
-          )
+          call_with_verb_fallback('/scheduler/schedules/{name}/resume', name)
         end
 
         # Pause all schedules
@@ -205,6 +202,28 @@ module Conductor
             return_http_data_only: true
           )
         end
+
+        private
+
+        # Try PUT first (OSS dialect); fall back to GET on 405 (some Orkes
+        # deployments only accept GET for these two routes).
+        def call_with_verb_fallback(templated_path, name)
+          @api_client.call_api(
+            templated_path,
+            'PUT',
+            path_params: { name: name },
+            return_http_data_only: true
+          )
+        rescue Conductor::ApiError => e
+          raise unless e.status == 405
+
+          @api_client.call_api(
+            templated_path,
+            'GET',
+            path_params: { name: name },
+            return_http_data_only: true
+          )
+        end
       end
     end
   end

data/lib/conductor/http/api/task_resource_api.rb

@@ -73,6 +73,21 @@ module Conductor
           )
         end
 
+        # Update task status using the v2 endpoint (POST /tasks/update-v2)
+        # Supports lease extension via TaskResult#extend_lease and returns the next
+        # task for the same worker when the server has one queued.
+        # @param [TaskResult] body Task result
+        # @return [Task, nil] Next task if the server returned one, nil on 204
+        def update_task_v2(body)
+          @api_client.call_api(
+            '/tasks/update-v2',
+            'POST',
+            body: body,
+            return_type: 'Task',
+            return_http_data_only: true
+          )
+        end
+
         # Get task details
         # @param [String] task_id Task ID
         # @return [Task] Task object

data/lib/conductor/http/models/task.rb

@@ -50,7 +50,8 @@ module Conductor
           first_start_time: 'Integer',
           loop_over_task: 'Boolean',
           task_definition: 'TaskDef',
-          queue_wait_time: 'Integer'
+          queue_wait_time: 'Integer',
+          runtime_metadata: 'Hash<String, String>'
         }.freeze
 
         ATTRIBUTE_MAP = {
@@ -96,7 +97,8 @@ module Conductor
           first_start_time: :firstStartTime,
           loop_over_task: :loopOverTask,
           task_definition: :taskDefinition,
-          queue_wait_time: :queueWaitTime
+          queue_wait_time: :queueWaitTime,
+          runtime_metadata: :runtimeMetadata
         }.freeze
 
         attr_accessor :task_type, :status, :input_data, :reference_task_name,
@@ -112,6 +114,11 @@ module Conductor
                       :iteration, :sub_workflow_id, :subworkflow_changed, :parent_task_id,
                       :first_start_time, :loop_over_task, :task_definition, :queue_wait_time
 
+        # Wire-only map of secret name => resolved value. The server fills it at poll
+        # time from TaskDef#runtime_metadata (names) and never persists it.
+        # @return [Hash<String, String>]
+        attr_accessor :runtime_metadata
+
         # Initialize a new Task
         # @param [Hash] attributes Model attributes in the form of hash
         def initialize(attributes = {})
@@ -125,6 +132,7 @@ module Conductor
           # Set default values for collections
           @input_data ||= {}
           @output_data ||= {}
+          @runtime_metadata ||= {}
         end
 
         # Check if task is in terminal state

data/lib/conductor/http/models/task_def.rb

@@ -37,7 +37,9 @@ module Conductor
           execution_name_space: 'String',
           owner_email: 'String',
           poll_timeout_seconds: 'Integer',
-          backoff_scale_factor: 'Integer'
+          backoff_scale_factor: 'Integer',
+          enforce_schema: 'Boolean',
+          runtime_metadata: 'Array<String>'
         }.freeze
 
         ATTRIBUTE_MAP = {
@@ -58,7 +60,9 @@ module Conductor
           execution_name_space: :executionNameSpace,
           owner_email: :ownerEmail,
           poll_timeout_seconds: :pollTimeoutSeconds,
-          backoff_scale_factor: :backoffScaleFactor
+          backoff_scale_factor: :backoffScaleFactor,
+          enforce_schema: :enforceSchema,
+          runtime_metadata: :runtimeMetadata
         }.freeze
 
         attr_accessor :name, :description, :retry_count, :timeout_seconds,
@@ -67,7 +71,12 @@ module Conductor
                       :concurrent_exec_limit, :rate_limit_per_frequency,
                       :rate_limit_frequency_in_seconds, :isolation_group_id,
                       :execution_name_space, :owner_email, :poll_timeout_seconds,
-                      :backoff_scale_factor
+                      :backoff_scale_factor, :enforce_schema
+
+        # Names of secrets the server must resolve and attach to every task of this
+        # type (delivered as Task#runtime_metadata). Requires conductor-oss >= 3.32.0-rc.8.
+        # @return [Array<String>]
+        attr_accessor :runtime_metadata
 
         def initialize(params = {})
           @name = params[:name]
@@ -88,6 +97,8 @@ module Conductor
           @owner_email = params[:owner_email]
           @poll_timeout_seconds = params[:poll_timeout_seconds]
           @backoff_scale_factor = params[:backoff_scale_factor] || 1
+          @enforce_schema = params.fetch(:enforce_schema, false)
+          @runtime_metadata = params[:runtime_metadata] || []
         end
       end
     end

data/lib/conductor/http/rest_client.rb

@@ -112,11 +112,20 @@ module Conductor
           end
 
           # Retry middleware (3 retries with exponential backoff)
+          #
+          # `exceptions` has to be spelled out: faraday-retry's
+          # DEFAULT_EXCEPTIONS covers timeouts but not Faraday::ConnectionFailed,
+          # which is what the net_http_persistent adapter raises for
+          # Errno::ECONNRESET/EPIPE -- a write to a pooled socket the peer closed
+          # first. net-http-persistent retries stale sockets itself, but only for
+          # idempotent requests, so POSTs surfaced these as hard ApiErrors while
+          # every GET was silently protected.
           conn.request :retry,
                        max: 3,
                        interval: 0.5,
                        backoff_factor: 2,
                        retry_statuses: [408, 429, 500, 502, 503, 504],
+                       exceptions: Faraday::Retry::Middleware::DEFAULT_EXCEPTIONS + [Faraday::ConnectionFailed],
                        methods: %i[get post put patch delete]
 
           # Connection settings

data/lib/conductor/orkes/orkes_clients.rb

@@ -8,7 +8,7 @@ module Conductor
     # Usage:
     #   config = Conductor::Configuration.new
     #   config.server_url = 'https://developer.orkescloud.com/api'
-    #   config.authentication_settings = Conductor::Configuration::AuthenticationSettings.new(
+    #   config.authentication_settings = Conductor::AuthenticationSettings.new(
     #     key_id: 'your_key', key_secret: 'your_secret'
     #   )
     #   clients = Conductor::Orkes::OrkesClients.new(config)
@@ -61,6 +61,10 @@ module Conductor
         Client::SchemaClient.new(@api_client)
       end
 
+      def get_agent_client
+        Client::AgentClient.new(@api_client)
+      end
+
       def get_workflow_executor
         Workflow::WorkflowExecutor.new(@configuration)
       end

data/lib/conductor/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Conductor
-  VERSION = '0.1.0'
+  VERSION = '0.1.1'
 end

data/lib/conductor/worker/lease_renewer.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'concurrent'
+require_relative '../http/models/task_result'
+
+module Conductor
+  module Worker
+    # Renews a task's lease while its worker body runs. Each active task has one
+    # interruptible heartbeat thread, independent of the polling/execution pool.
+    class LeaseRenewer
+      INTERVAL_FACTOR = 0.8
+
+      def initialize(task_client:, logger:)
+        @task_client = task_client
+        @logger = logger
+      end
+
+      def during(task, worker_id:)
+        interval = task.response_timeout_seconds.to_f * INTERVAL_FACTOR
+        return yield unless interval.positive?
+
+        stopped = Concurrent::Event.new
+        heartbeat = Thread.new do
+          Thread.current.name = "conductor-lease-#{task.task_id}"
+          delay = interval
+          # Retry transient failures within the remaining lease window.
+          delay = renew(task, worker_id) ? interval : [interval / 4, 1.0].min until stopped.wait(delay)
+        end
+        yield
+      ensure
+        stopped&.set
+        # Drain an in-flight heartbeat before the caller can submit a final result.
+        heartbeat&.join
+      end
+
+      private
+
+      def renew(task, worker_id)
+        result = Http::Models::TaskResult.new(
+          task_id: task.task_id,
+          workflow_instance_id: task.workflow_instance_id,
+          worker_id: worker_id,
+          status: Http::Models::TaskResultStatus::IN_PROGRESS,
+          extend_lease: true
+        )
+        # The original endpoint handles lease updates without claiming more work.
+        @task_client.update_task(result)
+        true
+      rescue StandardError => e
+        @logger.warn("Lease renewal failed for task #{task.task_id}: #{e.class}: #{e.message}")
+        false
+      end
+    end
+  end
+end

data/lib/conductor/worker/ractor_task_runner.rb

@@ -143,7 +143,7 @@ module Conductor
           server_api_url: @configuration_hash[:server_api_url]
         )
         if @configuration_hash[:authentication_settings]
-          config.authentication_settings = Configuration::AuthenticationSettings.new(
+          config.authentication_settings = AuthenticationSettings.new(
             key_id: @configuration_hash[:authentication_settings][:key_id],
             key_secret: @configuration_hash[:authentication_settings][:key_secret]
           )

data/lib/conductor/worker/task_definition_registrar.rb

@@ -210,7 +210,7 @@ module Conductor
         raise unless e.status == 404
 
         # Task def doesn't exist, create it
-        @metadata_client.register_task_def([task_def])
+        @metadata_client.register_task_def(task_def)
       end
 
       # Register task def only if it doesn't exist
@@ -222,7 +222,7 @@ module Conductor
         raise unless e.status == 404
 
         # Task def doesn't exist, create it
-        @metadata_client.register_task_def([task_def])
+        @metadata_client.register_task_def(task_def)
       end
     end
 

data/lib/conductor/worker/task_runner.rb

@@ -10,6 +10,7 @@ require_relative '../exceptions'
 require_relative 'task_context'
 require_relative 'task_in_progress'
 require_relative 'worker_config'
+require_relative 'lease_renewer'
 require_relative 'events/task_runner_events'
 require_relative 'events/sync_event_dispatcher'
 require_relative 'events/listener_registry'
@@ -43,6 +44,7 @@ module Conductor
 
         # Create task client for API communication
         @task_client = Client::TaskClient.new(@configuration)
+        @lease_renewer = LeaseRenewer.new(task_client: @task_client, logger: @logger)
 
         # Resolve worker configuration
         resolved_config = WorkerConfig.resolve(
@@ -68,6 +70,9 @@ module Conductor
         @poll_count = Concurrent::AtomicFixnum.new(0)
         @shutdown = Concurrent::AtomicBoolean.new(false)
         @mutex = Mutex.new
+        # Prefer POST /tasks/update-v2 (lease extension, next-task return); fall back
+        # to POST /tasks once if the server does not serve it (404/405).
+        @use_update_v2 = Concurrent::AtomicBoolean.new(true)
       end
 
       # Main polling loop (runs until shutdown)
@@ -176,6 +181,7 @@ module Conductor
         @worker_id = config[:worker_id]
         @domain = config[:domain]
         @poll_timeout = config[:poll_timeout]
+        @lease_extend_enabled = config[:lease_extend_enabled]
       end
 
       # Cleanup completed task futures
@@ -305,16 +311,21 @@ module Conductor
       # Execute a task and update the result
       # @param task [Hash] Task data from API
       def execute_and_update(task)
-        task_result = execute_task(task)
+        while task
+          task_result = execute_task(task)
 
-        # Skip update for TaskInProgress (task stays in IN_PROGRESS state)
-        return if task_result.nil?
+          # Skip update for TaskInProgress (task stays in IN_PROGRESS state)
+          return if task_result.nil?
 
-        # Don't update if result is IN_PROGRESS (will be polled again)
-        return if task_result.status == Http::Models::TaskResultStatus::IN_PROGRESS &&
-                  task_result.callback_after_seconds&.positive?
+          # Don't update if result is IN_PROGRESS (will be polled again)
+          return if task_result.status == Http::Models::TaskResultStatus::IN_PROGRESS &&
+                    task_result.callback_after_seconds&.positive?
 
-        update_task_with_retry(task_result)
+          # update-v2 has already claimed the returned task. Reuse this executor slot
+          # rather than dropping it or exceeding the worker's concurrency limit.
+          response = update_task_with_retry(task_result)
+          task = response.is_a?(Http::Models::Task) ? response : nil
+        end
       end
 
       # Execute a task
@@ -345,7 +356,11 @@ module Conductor
 
         begin
           # Execute worker
-          task_result = @worker.execute(task_obj)
+          task_result = if @lease_extend_enabled
+                          @lease_renewer.during(task_obj, worker_id: @worker_id) { @worker.execute(task_obj) }
+                        else
+                          @worker.execute(task_obj)
+                        end
 
           duration_ms = (Time.now - start_time) * 1000
 
@@ -458,11 +473,11 @@ module Conductor
 
           start_time = Time.now
           begin
-            @task_client.update_task(task_result)
+            next_task = send_task_update(task_result)
             duration_ms = (Time.now - start_time) * 1000
 
             publish_task_update_completed(task_result, duration_ms)
-            return # Success
+            return next_task
           rescue StandardError => e
             duration_ms = (Time.now - start_time) * 1000
             @logger.error("Task update failed (attempt #{attempt + 1}/#{RETRY_BACKOFFS.size}): #{e.message}")
@@ -474,6 +489,24 @@ module Conductor
             end
           end
         end
+        nil
+      end
+
+      # Send the task result to the server, preferring the v2 endpoint
+      # @param task_result [TaskResult]
+      def send_task_update(task_result)
+        return @task_client.update_task(task_result) unless @use_update_v2.true? && running?
+
+        task_result.extend_lease = false if task_result.extend_lease.nil?
+        begin
+          @task_client.update_task_v2(task_result)
+        rescue ApiError => e
+          raise unless [404, 405].include?(e.status)
+
+          @logger.info('Server does not support /tasks/update-v2, falling back to /tasks')
+          @use_update_v2.make_false
+          @task_client.update_task(task_result)
+        end
       end
 
       def publish_task_update_completed(task_result, duration_ms)

data/lib/conductor/worker/worker.rb

@@ -22,7 +22,7 @@ module Conductor
       attr_accessor :poll_interval, :thread_count, :domain, :worker_id,
                     :poll_timeout, :register_task_def, :overwrite_task_def,
                     :strict_schema, :paused, :isolation, :executor,
-                    :task_def_template
+                    :task_def_template, :lease_extend_enabled
 
       # Default configuration values
       DEFAULTS = {
@@ -36,7 +36,8 @@ module Conductor
         strict_schema: false,
         paused: false,
         isolation: :thread,
-        executor: :thread_pool
+        executor: :thread_pool,
+        lease_extend_enabled: false
       }.freeze
 
       # Initialize a worker

data/lib/conductor/worker/worker_config.rb

@@ -22,7 +22,8 @@ module Conductor
         strict_schema: { type: :boolean, default: false },
         paused: { type: :boolean, default: false },
         isolation: { type: :symbol, default: :thread },        # :thread or :ractor
-        executor: { type: :symbol, default: :thread_pool }     # :thread_pool or :fiber
+        executor: { type: :symbol, default: :thread_pool },    # :thread_pool or :fiber
+        lease_extend_enabled: { type: :boolean, default: false }
       }.freeze
 
       class << self

data/lib/conductor.rb

@@ -69,6 +69,7 @@ require_relative 'conductor/http/api/gateway_auth_resource_api'
 require_relative 'conductor/http/api/schema_resource_api'
 require_relative 'conductor/http/api/integration_resource_api'
 require_relative 'conductor/http/api/prompt_resource_api'
+require_relative 'conductor/http/api/agent_resource_api'
 # OSS Clients
 require_relative 'conductor/client/workflow_client'
 require_relative 'conductor/client/task_client'
@@ -80,6 +81,7 @@ require_relative 'conductor/client/authorization_client'
 require_relative 'conductor/client/schema_client'
 require_relative 'conductor/client/integration_client'
 require_relative 'conductor/client/prompt_client'
+require_relative 'conductor/client/agent_client'
 # Orkes-specific models
 require_relative 'conductor/orkes/models/metadata_tag'
 require_relative 'conductor/orkes/models/rate_limit_tag'
@@ -147,7 +149,7 @@ module Conductor
     # @example
     #   Conductor.configure do |config|
     #     config.server_url = 'http://localhost:7001/api'
-    #     config.authentication_settings = Conductor::Configuration::AuthenticationSettings.new(
+    #     config.authentication_settings = Conductor::AuthenticationSettings.new(
     #       key_id: 'my_key',
     #       key_secret: 'my_secret'
     #     )

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: conductor_ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Conductor OSS
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-29 00:00:00.000000000 Z
+date: 2026-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -80,6 +80,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: json_schemer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -150,20 +164,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
-- !ruby/object:Gem::Dependency
-  name: vcr
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '6.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '6.0'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
@@ -190,6 +190,32 @@ files:
 - LICENSE
 - README.md
 - examples/agentic_workflows/llm_chat.rb
+- examples/agents/01_basic_agent.rb
+- examples/agents/02a_simple_tools.rb
+- examples/agents/02c_tool_retry_config.rb
+- examples/agents/04_http_and_mcp_tools.rb
+- examples/agents/05_handoffs.rb
+- examples/agents/06_sequential_pipeline.rb
+- examples/agents/07_parallel_agents.rb
+- examples/agents/09_human_in_the_loop.rb
+- examples/agents/09c_hitl_streaming.rb
+- examples/agents/103_plan_and_compile.rb
+- examples/agents/10_guardrails.rb
+- examples/agents/13_hierarchical_agents.rb
+- examples/agents/16e_credentials_http_tool.rb
+- examples/agents/17_swarm_orchestration.rb
+- examples/agents/21_regex_guardrails.rb
+- examples/agents/22_llm_guardrails.rb
+- examples/agents/33_external_workers.rb
+- examples/agents/64_swarm_with_tools.rb
+- examples/agents/66_handoff_to_parallel.rb
+- examples/agents/bug_desk.rb
+- examples/agents/catalog.rb
+- examples/agents/dump_agent_configs.rb
+- examples/agents/external_workers.rb
+- examples/agents/golden_agents.rb
+- examples/agents/support_approval.rb
+- examples/agents/weather.rb
 - examples/dynamic_workflow.rb
 - examples/event_handler.rb
 - examples/event_listener_examples.rb
@@ -213,6 +239,33 @@ files:
 - examples/workflow_dsl.rb
 - examples/workflow_ops.rb
 - lib/conductor.rb
+- lib/conductor/agents.rb
+- lib/conductor/agents/agent.rb
+- lib/conductor/agents/callback_handler.rb
+- lib/conductor/agents/config_serializer.rb
+- lib/conductor/agents/errors.rb
+- lib/conductor/agents/guardrail.rb
+- lib/conductor/agents/handoff.rb
+- lib/conductor/agents/memory.rb
+- lib/conductor/agents/plans.rb
+- lib/conductor/agents/prompt_template.rb
+- lib/conductor/agents/runtime/agent_config.rb
+- lib/conductor/agents/runtime/agent_runtime.rb
+- lib/conductor/agents/runtime/approval_request.rb
+- lib/conductor/agents/runtime/dispatch.rb
+- lib/conductor/agents/runtime/execution.rb
+- lib/conductor/agents/runtime/secrets.rb
+- lib/conductor/agents/runtime/sse_client.rb
+- lib/conductor/agents/runtime/status_poller.rb
+- lib/conductor/agents/runtime/system_workers.rb
+- lib/conductor/agents/runtime/tool_call.rb
+- lib/conductor/agents/runtime/tool_registry.rb
+- lib/conductor/agents/termination.rb
+- lib/conductor/agents/tool.rb
+- lib/conductor/agents/tools.rb
+- lib/conductor/agents/tools/schema_builder.rb
+- lib/conductor/agents/tools/secret_scanner.rb
+- lib/conductor/client/agent_client.rb
 - lib/conductor/client/authorization_client.rb
 - lib/conductor/client/integration_client.rb
 - lib/conductor/client/metadata_client.rb
@@ -225,6 +278,7 @@ files:
 - lib/conductor/configuration.rb
 - lib/conductor/configuration/authentication_settings.rb
 - lib/conductor/exceptions.rb
+- lib/conductor/http/api/agent_resource_api.rb
 - lib/conductor/http/api/application_resource_api.rb
 - lib/conductor/http/api/authorization_resource_api.rb
 - lib/conductor/http/api/event_resource_api.rb
@@ -302,6 +356,7 @@ files:
 - lib/conductor/worker/events/task_runner_events.rb
 - lib/conductor/worker/events/workflow_events.rb
 - lib/conductor/worker/fiber_executor.rb
+- lib/conductor/worker/lease_renewer.rb
 - lib/conductor/worker/ractor_task_runner.rb
 - lib/conductor/worker/task_context.rb
 - lib/conductor/worker/task_definition_registrar.rb