phronomy 0.17.0 → 0.18.0

data/lib/phronomy/vector_store/embeddings/base.rb

@@ -19,18 +19,19 @@ module Phronomy
           raise NotImplementedError, "#{self.class}#embed is not implemented"
         end
 
-        # Submits an {#embed} call to {BlockingAdapterPool} and returns a
-        # {BlockingAdapterPool::PendingOperation}.
+        # Submits an {#embed} call to {OffloadPool} and returns an
+        # {OffloadPool::PendingOperation}.
         #
         # @param text               [String]
         # @param cancellation_token [Phronomy::Concurrency::CancellationToken, nil]
         # @param timeout            [Numeric, nil] seconds before the operation is abandoned
-        # @return [BlockingAdapterPool::PendingOperation]
+        # @return [OffloadPool::PendingOperation]
         # @api public
         def embed_async(text, cancellation_token = nil, timeout: nil)
-          Phronomy::Runtime.instance.blocking_io.submit(
+          Phronomy::Runtime.instance.offload.submit(
             timeout: timeout,
-            cancellation_token: cancellation_token
+            cancellation_token: cancellation_token,
+            on_full: :raise
           ) do
             embed(text, cancellation_token)
           end

data/lib/phronomy/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Phronomy
-  VERSION = "0.17.0"
+  VERSION = "0.18.0"
 end

data/lib/phronomy/workflow_runner.rb

@@ -311,13 +311,11 @@ module Phronomy
     end
 
     def complete_task(task, value)
-      task.backend.unblock(value, nil)
-      task.transition!(:completed, value: value)
+      task.complete(value)
     end
 
     def fail_task(task, error)
-      task.backend.unblock(nil, error)
-      task.transition!(:failed, error: error)
+      task.fail(error)
     end
 
     def failed_task(name, error)

data/lib/phronomy.rb

@@ -38,7 +38,13 @@ module Phronomy
   class ContextLengthError < Error; end
   class CancellationError < Error; end
 
-  class SchedulerReentrancyError < Error; end
+  # Raised when a synchronous API would block the EventLoop control thread.
+  class EventLoopReentrancyError < Error; end
+
+  # Backward-compatible error class name for callers that still rescue the old
+  # scheduler-oriented exception. New code should use EventLoopReentrancyError.
+  class SchedulerReentrancyError < EventLoopReentrancyError; end
+
   class RuntimeShutdownError < Error; end
   class RuntimeShutdownReentrancyError < RuntimeShutdownError; end
 
@@ -63,9 +69,6 @@ module Phronomy
   class PoolShutdownError < Error; end
   class BackpressureError < Error; end
 
-  # Raised when a WorkflowContext field is mutated from a thread that does not
-  # own the context. Deliver asynchronous updates back to the Workflow as later
-  # events via Workflow#signal instead of mutating context from worker callbacks.
   class WorkflowContextOwnershipError < Error; end
 
   class << self

data/scripts/api_snapshot.rb

@@ -3,9 +3,10 @@
 
 # scripts/api_snapshot.rb
 #
-# Dumps the public instance methods of all Stable/Beta public API classes to
-# JSON. The snapshot is stored in spec/fixtures/api_snapshot.json and is used
-# by spec/phronomy/api_compatibility_spec.rb to detect unintended API removals.
+# Dumps the public instance methods of all Stable/Beta product API classes to
+# JSON. Testing helpers are intentionally excluded from this compatibility gate.
+# The snapshot is stored in spec/fixtures/api_snapshot.json and is used by
+# spec/phronomy/api_compatibility_spec.rb to detect unintended API removals.
 #
 # Usage:
 #   ruby scripts/api_snapshot.rb --write
@@ -33,7 +34,6 @@ PUBLIC_API_ENTRIES = [
   Phronomy::VectorStore::Embeddings::Base,
   Phronomy::Tracing::Base,
   Phronomy::Tracing::NullTracer,
-  Phronomy::Eval::Runner,
   Phronomy::Tools::Mcp,
   Phronomy::Tools::Agent,
   Phronomy::Tools::VectorSearch

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: phronomy
 version: !ruby/object:Gem::Version
-  version: 0.17.0
+  version: 0.18.0
 platform: ruby
 authors:
 - Raizo T.C.S
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-09 00:00:00.000000000 Z
+date: 2026-08-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby_llm
@@ -104,6 +104,7 @@ files:
 - benchmark/bench_vector_store.rb
 - benchmark/bench_workflow.rb
 - benchmark/run_all.rb
+- docs/changelog/0.14-and-earlier.md
 - docs/decisions/001-rubyllm-as-provider-layer.md
 - docs/decisions/002-workflow-context-immutability.md
 - docs/decisions/003-event-loop-singleton.md
@@ -118,7 +119,12 @@ files:
 - docs/decisions/011-delegate-transport-policy-to-adapters.md
 - docs/decisions/012-canonical-execution-log-and-context-policy.md
 - docs/decisions/013-journal-backed-knowledge-as-context-candidates.md
+- docs/features.md
+- docs/getting-started.md
 - docs/mcp-client.md
+- docs/migrations/0.15.md
+- docs/migrations/0.16.md
+- docs/runtime-and-concurrency.md
 - examples/workflows/agent_event_mapping.rb
 - examples/workflows/generic_task_event_mapping.rb
 - gemfiles/mcp_1_0.gemfile
@@ -184,44 +190,18 @@ files:
 - lib/phronomy/context_budget_exceeded_error.rb
 - lib/phronomy/diagnostics.rb
 - lib/phronomy/engine/concurrency/async_queue.rb
-- lib/phronomy/engine/concurrency/blocking_adapter_pool.rb
 - lib/phronomy/engine/concurrency/cancellation_scope.rb
 - lib/phronomy/engine/concurrency/cancellation_token.rb
 - lib/phronomy/engine/concurrency/deadline.rb
+- lib/phronomy/engine/concurrency/offload_pool.rb
 - lib/phronomy/engine/concurrency/pool_registry.rb
 - lib/phronomy/engine/event_loop.rb
 - lib/phronomy/engine/fsm_session.rb
 - lib/phronomy/engine/runtime.rb
-- lib/phronomy/engine/runtime/deterministic_scheduler.rb
-- lib/phronomy/engine/runtime/fake_scheduler.rb
-- lib/phronomy/engine/runtime/runtime_metrics.rb
-- lib/phronomy/engine/runtime/scheduler.rb
-- lib/phronomy/engine/runtime/scheduler_timer_adapter.rb
 - lib/phronomy/engine/runtime/shutdown_result.rb
-- lib/phronomy/engine/runtime/task_registry.rb
-- lib/phronomy/engine/runtime/thread_scheduler.rb
 - lib/phronomy/engine/runtime/timer_queue.rb
 - lib/phronomy/engine/runtime/timer_service.rb
 - lib/phronomy/engine/task.rb
-- lib/phronomy/engine/task/backend.rb
-- lib/phronomy/engine/task/deferred_backend.rb
-- lib/phronomy/engine/task/fiber_backend.rb
-- lib/phronomy/engine/task/immediate_backend.rb
-- lib/phronomy/engine/task/mapped_backend.rb
-- lib/phronomy/engine/task/thread_backend.rb
-- lib/phronomy/engine/task_group.rb
-- lib/phronomy/eval.rb
-- lib/phronomy/eval/comparison.rb
-- lib/phronomy/eval/dataset.rb
-- lib/phronomy/eval/eval_case.rb
-- lib/phronomy/eval/eval_result.rb
-- lib/phronomy/eval/metrics.rb
-- lib/phronomy/eval/runner.rb
-- lib/phronomy/eval/scorer.rb
-- lib/phronomy/eval/scorer/base.rb
-- lib/phronomy/eval/scorer/exact_match.rb
-- lib/phronomy/eval/scorer/includes_scorer.rb
-- lib/phronomy/eval/scorer/llm_judge.rb
 - lib/phronomy/event.rb
 - lib/phronomy/execution_rehydration_required_error.rb
 - lib/phronomy/filter.rb
@@ -239,6 +219,8 @@ files:
 - lib/phronomy/llm_context_window/token_budget.rb
 - lib/phronomy/llm_context_window/token_estimator.rb
 - lib/phronomy/metrics.rb
+- lib/phronomy/multi_agent/fan_out_invocation.rb
+- lib/phronomy/multi_agent/fan_out_session_builder.rb
 - lib/phronomy/multi_agent/handoff.rb
 - lib/phronomy/multi_agent/orchestrator.rb
 - lib/phronomy/multi_agent/parallel_tool_chat.rb
@@ -255,9 +237,19 @@ files:
 - lib/phronomy/state_store/in_memory.rb
 - lib/phronomy/stream_callback_error.rb
 - lib/phronomy/testing.rb
+- lib/phronomy/testing/eval.rb
+- lib/phronomy/testing/eval/comparison.rb
+- lib/phronomy/testing/eval/dataset.rb
+- lib/phronomy/testing/eval/eval_case.rb
+- lib/phronomy/testing/eval/eval_result.rb
+- lib/phronomy/testing/eval/metrics.rb
+- lib/phronomy/testing/eval/runner.rb
+- lib/phronomy/testing/eval/scorer.rb
+- lib/phronomy/testing/eval/scorer/base.rb
+- lib/phronomy/testing/eval/scorer/exact_match.rb
+- lib/phronomy/testing/eval/scorer/includes_scorer.rb
+- lib/phronomy/testing/eval/scorer/llm_judge.rb
 - lib/phronomy/testing/fake_clock.rb
-- lib/phronomy/testing/fake_scheduler.rb
-- lib/phronomy/testing/scheduler_helpers.rb
 - lib/phronomy/token_usage.rb
 - lib/phronomy/tools/agent.rb
 - lib/phronomy/tools/mcp.rb