phronomy 0.25.0 → 0.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (323) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +71 -0
  3. data/CONTRIBUTING.md +4 -4
  4. data/README.md +14 -7
  5. data/VERIFY.sh +27 -27
  6. data/benchmark/bench_agent_invoke.rb +26 -22
  7. data/benchmark/bench_context_assembler.rb +4 -5
  8. data/benchmark/bench_regression.rb +1 -1
  9. data/docs/architecture/agent-chat-and-state-ownership.md +147 -0
  10. data/docs/architecture/agent-configuration-and-tool-binding.md +139 -0
  11. data/docs/architecture/agent-context.md +5 -3
  12. data/docs/architecture/agent-transition-ownership.md +89 -0
  13. data/docs/architecture/before-llm-input.md +6 -0
  14. data/docs/architecture/context-management.md +30 -0
  15. data/docs/architecture/context-preparation-steps.md +90 -0
  16. data/docs/architecture/entry-action-and-team-wording.md +72 -0
  17. data/docs/architecture/execution-metadata-and-values.md +80 -0
  18. data/docs/architecture/generator-verifier-ownership.md +111 -0
  19. data/docs/architecture/multi-agent-handoff.md +8 -2
  20. data/docs/architecture/persistence-refactoring-plan.md +50 -0
  21. data/docs/architecture/persistence.md +29 -6
  22. data/docs/architecture/refactoring-closure.md +334 -0
  23. data/docs/architecture/remaining-refactoring-plan.md +374 -0
  24. data/docs/architecture/rubyllm-2-token-ownership.md +82 -0
  25. data/docs/architecture/tool-schema-recording-gap.md +50 -0
  26. data/docs/architecture/tracing.md +4 -4
  27. data/docs/architecture/workflow-terminal-ownership-design.md +104 -0
  28. data/docs/architecture.md +209 -0
  29. data/docs/async-composition.md +205 -0
  30. data/docs/decisions/010-cooperative-first-concurrency.md +23 -23
  31. data/docs/decisions/014-unified-persistence-durable-state.md +11 -0
  32. data/docs/decisions/024-event-loop-single-writer-agent-runtime.md +5 -1
  33. data/docs/decisions/025-process-local-agent-ownership-and-runtime-admission.md +13 -3
  34. data/docs/decisions/026-workflow-runtime-admission-and-durable-terminal-barrier.md +5 -1
  35. data/docs/decisions/030-agent-handoff-domain-and-durable-responsibility.md +5 -0
  36. data/docs/decisions/031-durable-multi-agent-coordination.md +5 -0
  37. data/docs/decisions/032-storage-backend-composition.md +80 -0
  38. data/docs/decisions/033-domain-persistence-ownership.md +79 -0
  39. data/docs/decisions/034-handoff-runner-coordination-ownership.md +76 -0
  40. data/docs/decisions/035-tool-executor-capability-ownership.md +68 -0
  41. data/docs/decisions/036-context-contract-ownership.md +86 -0
  42. data/docs/decisions/037-common-definition-ownership.md +62 -0
  43. data/docs/decisions/038-responsibility-based-source-layout.md +131 -0
  44. data/docs/decisions/039-runtime-configuration-lifecycle-ownership.md +74 -0
  45. data/docs/decisions/040-configuration-default-composition.md +94 -0
  46. data/docs/decisions/041-feature-owned-identity-registries.md +100 -0
  47. data/docs/decisions/042-feature-owned-execution-state.md +106 -0
  48. data/docs/decisions/043-storage-execution-constraint-notifications.md +75 -0
  49. data/docs/decisions/044-agent-default-and-one-shot-composition.md +106 -0
  50. data/docs/decisions/045-worker-input-restriction-ownership.md +100 -0
  51. data/docs/decisions/046-agent-responsibility-layout-and-shared-records.md +110 -0
  52. data/docs/decisions/047-recovered-execution-continuation-contract.md +116 -0
  53. data/docs/decisions/048-dispatch-preparation-worker-ownership.md +120 -0
  54. data/docs/decisions/049-initial-preparation-worker-ownership.md +111 -0
  55. data/docs/decisions/050-approval-resume-snapshot-and-commit-ownership.md +98 -0
  56. data/docs/decisions/051-execution-outcome-worker-ownership.md +151 -0
  57. data/docs/decisions/052-tool-invocation-restoration-ownership.md +92 -0
  58. data/docs/decisions/053-shared-state-coordination-ownership.md +71 -0
  59. data/docs/decisions/054-workflow-terminal-save-single-owner.md +76 -0
  60. data/docs/decisions/055-terminal-observer-failure-settlement.md +60 -0
  61. data/docs/decisions/056-workflow-terminal-policy-ownership.md +87 -0
  62. data/docs/decisions/057-storage-transaction-boundaries.md +73 -0
  63. data/docs/decisions/058-neutral-storage-primitives.md +78 -0
  64. data/docs/decisions/README.md +35 -6
  65. data/docs/design/durable-semantic-coordination/IMPLEMENTATION_DESIGN_V2.md +6 -0
  66. data/docs/design/durable-semantic-coordination/IMPLEMENTATION_REPORT.md +6 -0
  67. data/docs/features.md +21 -12
  68. data/docs/getting-started.md +10 -10
  69. data/docs/migrations/0.15.md +5 -0
  70. data/docs/migrations/durable-semantic-coordination-v2.md +7 -1
  71. data/docs/migrations/handoff-runner-multi-agent.md +35 -0
  72. data/docs/migrations/neutral-storage-spi.md +43 -0
  73. data/docs/migrations/parallel-tool-chat-removal.md +49 -0
  74. data/docs/migrations/shared-state-multi-agent.md +44 -0
  75. data/docs/migrations/storage-backend-composition.md +117 -0
  76. data/docs/migrations/storage-transaction-boundaries.md +74 -0
  77. data/docs/persistence-backends.md +162 -204
  78. data/docs/runtime-and-concurrency.md +205 -60
  79. data/lib/phronomy/agent/api/agent.rb +17 -0
  80. data/lib/phronomy/agent/async_event_api.rb +2 -2
  81. data/lib/phronomy/agent/base.rb +55 -251
  82. data/lib/phronomy/{agent.rb → agent/composition/run_once.rb} +4 -13
  83. data/lib/phronomy/agent/context/capability/base.rb +67 -26
  84. data/lib/phronomy/agent/context/capability/tool_executor.rb +62 -0
  85. data/lib/phronomy/agent/{context_assembler.rb → context_assembly/context_assembler.rb} +143 -88
  86. data/lib/phronomy/agent/{context_importer.rb → context_assembly/context_importer.rb} +2 -2
  87. data/lib/phronomy/agent/{ruby_llm_materializer.rb → context_assembly/ruby_llm_materializer.rb} +4 -7
  88. data/lib/phronomy/agent/context_assembly/runtime_chat_builder.rb +36 -0
  89. data/lib/phronomy/agent/context_assembly/saved_context_reader.rb +53 -0
  90. data/lib/phronomy/agent/context_assembly/state_writer.rb +165 -0
  91. data/lib/phronomy/agent/context_assembly/token_budget_resolver.rb +22 -0
  92. data/lib/phronomy/agent/{context_plan.rb → context_contract/context_plan.rb} +1 -1
  93. data/lib/phronomy/agent/{context_policy_input.rb → context_contract/context_policy_input.rb} +6 -6
  94. data/lib/phronomy/agent/{llm_input_build_context.rb → context_contract/llm_input_build_context.rb} +1 -1
  95. data/lib/phronomy/agent/{llm_input_manifest.rb → context_contract/llm_input_manifest.rb} +20 -20
  96. data/lib/phronomy/agent/{llm_input_patch.rb → context_contract/llm_input_patch.rb} +2 -2
  97. data/lib/phronomy/agent/{agent_execution.rb → execution/agent_execution.rb} +8 -4
  98. data/lib/phronomy/agent/{agent_invocation.rb → execution/agent_invocation.rb} +8 -13
  99. data/lib/phronomy/agent/{agent_invocation_session_builder.rb → execution/agent_invocation_session_builder.rb} +20 -96
  100. data/lib/phronomy/agent/execution/approval_resume_commit.rb +108 -0
  101. data/lib/phronomy/agent/execution/dispatch_preparation.rb +305 -0
  102. data/lib/phronomy/agent/{exact_execution.rb → execution/exact_execution.rb} +12 -13
  103. data/lib/phronomy/agent/{execution_cancellation.rb → execution/execution_cancellation.rb} +2 -3
  104. data/lib/phronomy/agent/execution/execution_coordinator.rb +1925 -0
  105. data/lib/phronomy/agent/execution/execution_failure.rb +30 -0
  106. data/lib/phronomy/agent/execution/execution_metadata.rb +53 -0
  107. data/lib/phronomy/agent/execution/execution_outcome_committer.rb +344 -0
  108. data/lib/phronomy/agent/execution/execution_registry.rb +459 -0
  109. data/lib/phronomy/agent/execution/execution_session_runner.rb +118 -0
  110. data/lib/phronomy/agent/execution/initial_preparation.rb +421 -0
  111. data/lib/phronomy/agent/execution/invocation_transitions.rb +86 -0
  112. data/lib/phronomy/agent/{phase_machine_builder.rb → execution/phase_machine_builder.rb} +22 -73
  113. data/lib/phronomy/agent/{provider_call_outcome.rb → execution/provider_call_outcome.rb} +9 -9
  114. data/lib/phronomy/agent/execution/runtime_record_encoder.rb +210 -0
  115. data/lib/phronomy/agent/{handoff_context.rb → handoff/handoff_context.rb} +2 -2
  116. data/lib/phronomy/agent/handoff/handoff_execution_coordinator.rb +15 -0
  117. data/lib/phronomy/agent/handoff/handoff_outcome_committer.rb +131 -0
  118. data/lib/phronomy/agent/{handoff_state.rb → handoff/handoff_state.rb} +1 -1
  119. data/lib/phronomy/agent/{journal_projection.rb → journal/journal_projection.rb} +4 -0
  120. data/lib/phronomy/agent/{journal_record.rb → journal/journal_record.rb} +3 -3
  121. data/lib/phronomy/agent/{llm_call_record.rb → journal/llm_call_record.rb} +2 -2
  122. data/lib/phronomy/agent/{agent_root.rb → lifecycle/agent_root.rb} +6 -2
  123. data/lib/phronomy/agent/lifecycle/default_persistence.rb +29 -0
  124. data/lib/phronomy/{engine/runtime/agent_ownership_registry.rb → agent/lifecycle/ownership_registry.rb} +24 -10
  125. data/lib/phronomy/{agent_already_exists_error.rb → agent/lifecycle_contract/agent_already_exists_error.rb} +2 -0
  126. data/lib/phronomy/{agent_busy_error.rb → agent/lifecycle_contract/agent_busy_error.rb} +2 -0
  127. data/lib/phronomy/{agent_purged_error.rb → agent/lifecycle_contract/agent_purged_error.rb} +2 -0
  128. data/lib/phronomy/agent/lifecycle_contract/handoff_error.rb +7 -0
  129. data/lib/phronomy/{stream_callback_error.rb → agent/lifecycle_contract/stream_callback_error.rb} +2 -0
  130. data/lib/phronomy/agent/persistence/agent_repository.rb +61 -0
  131. data/lib/phronomy/agent/persistence/codec.rb +358 -0
  132. data/lib/phronomy/agent/persistence/execution_repository.rb +108 -0
  133. data/lib/phronomy/agent/persistence/handoff_state_repository.rb +58 -0
  134. data/lib/phronomy/agent/persistence/journal_repository.rb +54 -0
  135. data/lib/phronomy/agent/persistence/queries.rb +61 -0
  136. data/lib/phronomy/agent/persistence/storage_schema.rb +24 -0
  137. data/lib/phronomy/agent/persistence/watermark.rb +27 -0
  138. data/lib/phronomy/agent/recovery/invocation_restorer.rb +132 -0
  139. data/lib/phronomy/agent/{recovery_coordinator → recovery/recovery_coordinator}/continuation.rb +21 -45
  140. data/lib/phronomy/agent/{recovery_coordinator → recovery/recovery_coordinator}/installation.rb +36 -41
  141. data/lib/phronomy/agent/{recovery_coordinator → recovery/recovery_coordinator}/resolution.rb +37 -40
  142. data/lib/phronomy/agent/{recovery_coordinator.rb → recovery/recovery_coordinator.rb} +9 -13
  143. data/lib/phronomy/agent/recovery/recovery_support.rb +227 -0
  144. data/lib/phronomy/agent/selection/candidate.rb +1 -1
  145. data/lib/phronomy/agent/{approval_evaluation_request.rb → tool_execution/approval_evaluation_request.rb} +1 -12
  146. data/lib/phronomy/agent/{tool_approval_request.rb → tool_execution/tool_approval_request.rb} +1 -10
  147. data/lib/phronomy/agent/tool_execution/tool_binding.rb +90 -0
  148. data/lib/phronomy/agent/{tool_call_intercepted.rb → tool_execution/tool_call_intercepted.rb} +2 -2
  149. data/lib/phronomy/agent/{tool_definition_set.rb → tool_execution/tool_definition_set.rb} +9 -4
  150. data/lib/phronomy/agent/{tool_invocation.rb → tool_execution/tool_invocation.rb} +69 -34
  151. data/lib/phronomy/agent/{tool_invocation_session_builder.rb → tool_execution/tool_invocation_session_builder.rb} +2 -2
  152. data/lib/phronomy/common/configuration_error.rb +7 -0
  153. data/lib/phronomy/common/error.rb +5 -0
  154. data/lib/phronomy/{agent → common/values}/immutable.rb +9 -1
  155. data/lib/phronomy/common/values/serializable.rb +32 -0
  156. data/lib/phronomy/{configuration.rb → configuration/configuration.rb} +14 -5
  157. data/lib/phronomy/configuration/global_configuration.rb +26 -0
  158. data/lib/phronomy/content_store/storage_schema.rb +11 -0
  159. data/lib/phronomy/content_store/stored_contents.rb +43 -0
  160. data/lib/phronomy/engine/backpressure_error.rb +7 -0
  161. data/lib/phronomy/{blocking.rb → engine/blocking.rb} +15 -8
  162. data/lib/phronomy/engine/cancellation_error.rb +7 -0
  163. data/lib/phronomy/engine/concurrency/cancellation_token.rb +4 -0
  164. data/lib/phronomy/engine/concurrency/offload_pool.rb +29 -16
  165. data/lib/phronomy/engine/concurrency/operation_binding.rb +43 -0
  166. data/lib/phronomy/engine/concurrency/physical_completion_task.rb +4 -62
  167. data/lib/phronomy/engine/concurrency/result_collector.rb +99 -0
  168. data/lib/phronomy/engine/concurrency/result_composition.rb +145 -0
  169. data/lib/phronomy/engine/concurrency/subscriptions.rb +68 -0
  170. data/lib/phronomy/engine/concurrency/worker_input_restricted.rb +14 -0
  171. data/lib/phronomy/engine/event_loop.rb +160 -626
  172. data/lib/phronomy/engine/event_loop_reentrancy_error.rb +8 -0
  173. data/lib/phronomy/engine/execution.rb +229 -0
  174. data/lib/phronomy/engine/execution_cancellation_error.rb +14 -0
  175. data/lib/phronomy/engine/execution_receiver.rb +65 -0
  176. data/lib/phronomy/engine/execution_timeout_error.rb +14 -0
  177. data/lib/phronomy/engine/fsm_protocol.rb +14 -0
  178. data/lib/phronomy/engine/fsm_session.rb +38 -31
  179. data/lib/phronomy/{invalid_async_entry_action_error.rb → engine/invalid_async_entry_action_error.rb} +3 -1
  180. data/lib/phronomy/{invalid_async_transition_action_error.rb → engine/invalid_async_transition_action_error.rb} +3 -1
  181. data/lib/phronomy/{invalid_async_workflow_action_error.rb → engine/invalid_async_workflow_action_error.rb} +3 -1
  182. data/lib/phronomy/{invocation_context.rb → engine/invocation_context.rb} +13 -1
  183. data/lib/phronomy/engine/pool_shutdown_error.rb +7 -0
  184. data/lib/phronomy/engine/recursion_limit_error.rb +7 -0
  185. data/lib/phronomy/engine/runtime/timer_queue.rb +11 -0
  186. data/lib/phronomy/engine/runtime.rb +80 -84
  187. data/lib/phronomy/engine/runtime_shutdown_error.rb +7 -0
  188. data/lib/phronomy/engine/runtime_shutdown_reentrancy_error.rb +7 -0
  189. data/lib/phronomy/engine/scheduler_reentrancy_error.rb +9 -0
  190. data/lib/phronomy/engine/{task.rb → task_result.rb} +101 -42
  191. data/lib/phronomy/engine/timeout_error.rb +7 -0
  192. data/lib/phronomy/filter/contract/filter_block_error.rb +14 -0
  193. data/lib/phronomy/generation/generator_verifier/agent_result_receiver.rb +89 -0
  194. data/lib/phronomy/generation/generator_verifier/pipeline_state.rb +57 -0
  195. data/lib/phronomy/generation/generator_verifier/workflow_builder.rb +112 -0
  196. data/lib/phronomy/generation/generator_verifier.rb +118 -0
  197. data/lib/phronomy/generation/low_confidence_error.rb +14 -0
  198. data/lib/phronomy/llm_adapter/base.rb +2 -2
  199. data/lib/phronomy/llm_context_window/token_budget.rb +6 -7
  200. data/lib/phronomy/llm_contract/authentication_error.rb +7 -0
  201. data/lib/phronomy/{context_budget_exceeded_error.rb → llm_contract/context_budget_exceeded_error.rb} +2 -0
  202. data/lib/phronomy/llm_contract/context_length_error.rb +7 -0
  203. data/lib/phronomy/llm_contract/rate_limit_error.rb +7 -0
  204. data/lib/phronomy/{token_usage.rb → llm_contract/token_usage.rb} +2 -2
  205. data/lib/phronomy/llm_contract/transport_error.rb +7 -0
  206. data/lib/phronomy/multi_agent/admission_registry.rb +22 -2
  207. data/lib/phronomy/multi_agent/durable_subagent_coordinator.rb +8 -8
  208. data/lib/phronomy/{agent → multi_agent}/handoff_runner.rb +18 -17
  209. data/lib/phronomy/multi_agent/orchestrator.rb +36 -68
  210. data/lib/phronomy/multi_agent/persistence/codec.rb +55 -0
  211. data/lib/phronomy/multi_agent/persistence/queries.rb +30 -0
  212. data/lib/phronomy/multi_agent/persistence/team_execution_repository.rb +108 -0
  213. data/lib/phronomy/multi_agent/persistence/team_repository.rb +61 -0
  214. data/lib/phronomy/{agent → multi_agent}/shared_state.rb +56 -39
  215. data/lib/phronomy/multi_agent/storage_contract/team_storage_schema.rb +15 -0
  216. data/lib/phronomy/multi_agent/team_coordinator.rb +21 -18
  217. data/lib/phronomy/multi_agent/team_execution.rb +1 -1
  218. data/lib/phronomy/{engine/runtime → multi_agent}/team_ownership_registry.rb +14 -4
  219. data/lib/phronomy/multi_agent/team_root.rb +1 -1
  220. data/lib/phronomy/output_parser/contract/parse_error.rb +7 -0
  221. data/lib/phronomy/persistence/api/persistence.rb +140 -0
  222. data/lib/phronomy/persistence/migration/initial_format_migration.rb +19 -19
  223. data/lib/phronomy/persistence_composition/repositories.rb +77 -0
  224. data/lib/phronomy/persistence_composition/storage_schema.rb +24 -0
  225. data/lib/phronomy/{execution_rehydration_required_error.rb → recovery/execution_rehydration_required_error.rb} +2 -0
  226. data/lib/phronomy/{recovery.rb → recovery/recovery.rb} +1 -1
  227. data/lib/phronomy/runtime_composition/agent_defaults.rb +7 -0
  228. data/lib/phronomy/runtime_composition/configuration_defaults.rb +9 -0
  229. data/lib/phronomy/runtime_composition/global_runtime.rb +19 -0
  230. data/lib/phronomy/storage/backend.rb +101 -0
  231. data/lib/phronomy/storage/backends/in_memory.rb +157 -0
  232. data/lib/phronomy/storage/blob_conflict_error.rb +10 -0
  233. data/lib/phronomy/storage/blobs.rb +31 -0
  234. data/lib/phronomy/storage/condition.rb +25 -0
  235. data/lib/phronomy/storage/condition_failed_error.rb +16 -0
  236. data/lib/phronomy/storage/conflict_error.rb +9 -0
  237. data/lib/phronomy/{persistence → storage}/durable_record.rb +12 -12
  238. data/lib/phronomy/storage/entry.rb +33 -0
  239. data/lib/phronomy/storage/guard_ref.rb +13 -0
  240. data/lib/phronomy/storage/not_found_error.rb +9 -0
  241. data/lib/phronomy/storage/record_codec.rb +177 -0
  242. data/lib/phronomy/storage/records.rb +61 -0
  243. data/lib/phronomy/storage/resource.rb +126 -0
  244. data/lib/phronomy/storage/scope.rb +25 -0
  245. data/lib/phronomy/storage/serialization_error.rb +9 -0
  246. data/lib/phronomy/storage/streams.rb +44 -0
  247. data/lib/phronomy/storage/transaction_error.rb +10 -0
  248. data/lib/phronomy/storage/unique_constraint_error.rb +17 -0
  249. data/lib/phronomy/storage/unsupported_backend_error.rb +9 -0
  250. data/lib/phronomy/storage/validation.rb +53 -0
  251. data/lib/phronomy/storage/view.rb +131 -0
  252. data/lib/phronomy/testing/eval/scorer/llm_judge.rb +5 -3
  253. data/lib/phronomy/testing/fake_clock.rb +13 -9
  254. data/lib/phronomy/testing/persistence_contract/a_content_store.rb +1 -1
  255. data/lib/phronomy/testing/persistence_contract/a_journal_repository.rb +4 -4
  256. data/lib/phronomy/testing/persistence_contract/a_persistence_backend.rb +10 -7
  257. data/lib/phronomy/testing/persistence_contract/a_workflow_state_repository.rb +2 -2
  258. data/lib/phronomy/testing/persistence_contract/an_agent_repository.rb +6 -6
  259. data/lib/phronomy/testing/persistence_contract/an_execution_repository.rb +6 -6
  260. data/lib/phronomy/testing/persistence_contract/coordination_repositories.rb +8 -8
  261. data/lib/phronomy/testing/persistence_contract/neutral_storage_primitives.rb +263 -0
  262. data/lib/phronomy/testing/persistence_contract/storage_transaction_boundaries.rb +123 -0
  263. data/lib/phronomy/testing/persistence_contract.rb +4 -0
  264. data/lib/phronomy/tool/contract/tool_error.rb +7 -0
  265. data/lib/phronomy/tools/agent.rb +6 -6
  266. data/lib/phronomy/vector_store/async_backend.rb +5 -5
  267. data/lib/phronomy/vector_store/embeddings/base.rb +2 -2
  268. data/lib/phronomy/version.rb +1 -1
  269. data/lib/phronomy/{workflow.rb → workflow/execution/workflow.rb} +10 -8
  270. data/lib/phronomy/{workflow_context.rb → workflow/execution/workflow_context.rb} +4 -0
  271. data/lib/phronomy/workflow/execution/workflow_context_ownership_error.rb +7 -0
  272. data/lib/phronomy/workflow/execution/workflow_execution_registry.rb +188 -0
  273. data/lib/phronomy/{workflow_runner.rb → workflow/execution/workflow_runner.rb} +126 -75
  274. data/lib/phronomy/workflow/execution/workflow_terminal_policy.rb +40 -0
  275. data/lib/phronomy/workflow/persistence/codec.rb +153 -0
  276. data/lib/phronomy/workflow/persistence/state_repository.rb +57 -0
  277. data/lib/phronomy/workflow/phase_machine_builder.rb +8 -8
  278. data/lib/phronomy/workflow/storage_contract/workflow_storage_schema.rb +9 -0
  279. data/lib/phronomy.rb +52 -94
  280. data/scripts/api_snapshot.rb +4 -2
  281. data/scripts/storage_spi_snapshot.rb +36 -0
  282. data/sig/phronomy/agent.rbs +4 -5
  283. data/sig/phronomy/execution_receiver.rbs +34 -0
  284. data/sig/phronomy/extensions.rbs +5 -5
  285. data/sig/phronomy/handoff.rbs +4 -2
  286. data/sig/phronomy/multi_agent.rbs +19 -3
  287. data/sig/phronomy/persistence.rbs +7 -91
  288. data/sig/phronomy/runtime.rbs +34 -7
  289. data/sig/phronomy/storage.rbs +174 -0
  290. data/sig/phronomy/tool.rbs +11 -2
  291. data/sig/phronomy/workflow.rbs +1 -1
  292. metadata +236 -99
  293. data/lib/phronomy/agent/execution_coordinator.rb +0 -3138
  294. data/lib/phronomy/agent/handoff_execution_coordinator.rb +0 -143
  295. data/lib/phronomy/agent/recovery_support.rb +0 -504
  296. data/lib/phronomy/agent/token_budget_resolver.rb +0 -70
  297. data/lib/phronomy/agent/tool_executor.rb +0 -55
  298. data/lib/phronomy/generator_verifier.rb +0 -369
  299. data/lib/phronomy/invalid_context_budget_configuration_error.rb +0 -8
  300. data/lib/phronomy/multi_agent/fan_out_invocation.rb +0 -137
  301. data/lib/phronomy/multi_agent/fan_out_session_builder.rb +0 -118
  302. data/lib/phronomy/multi_agent/parallel_tool_chat.rb +0 -116
  303. data/lib/phronomy/persistence/durable_codec.rb +0 -706
  304. data/lib/phronomy/persistence/in_memory.rb +0 -690
  305. data/lib/phronomy/persistence/repository_facades.rb +0 -535
  306. data/lib/phronomy/persistence.rb +0 -276
  307. data/lib/phronomy/ruby_llm_patches.rb +0 -24
  308. data/lib/phronomy/workflow_recovery.rb +0 -123
  309. /data/lib/phronomy/agent/{context_candidate_resolver.rb → context_assembly/context_candidate_resolver.rb} +0 -0
  310. /data/lib/phronomy/agent/{context_policy_input_builder.rb → context_assembly/context_policy_input_builder.rb} +0 -0
  311. /data/lib/phronomy/agent/{context_plan_validator.rb → context_contract/context_plan_validator.rb} +0 -0
  312. /data/lib/phronomy/agent/{context_policy.rb → context_contract/context_policy.rb} +0 -0
  313. /data/lib/phronomy/agent/{llm_operation_result.rb → execution/llm_operation_result.rb} +0 -0
  314. /data/lib/phronomy/agent/{handoff.rb → handoff/handoff.rb} +0 -0
  315. /data/lib/phronomy/agent/{handoff_capability_factory.rb → handoff/handoff_capability_factory.rb} +0 -0
  316. /data/lib/phronomy/agent/{handoff_policy.rb → handoff/handoff_policy.rb} +0 -0
  317. /data/lib/phronomy/agent/{handoff_projection.rb → handoff/handoff_projection.rb} +0 -0
  318. /data/lib/phronomy/agent/{handoff_request.rb → handoff/handoff_request.rb} +0 -0
  319. /data/lib/phronomy/{canonical_json.rb → common/canonical_json.rb} +0 -0
  320. /data/lib/phronomy/{diagnostics.rb → engine/diagnostics.rb} +0 -0
  321. /data/lib/phronomy/{event.rb → engine/event.rb} +0 -0
  322. /data/lib/phronomy/{metrics.rb → engine/metrics.rb} +0 -0
  323. /data/lib/phronomy/{runnable.rb → engine/runnable.rb} +0 -0
metadata CHANGED
@@ -1,35 +1,29 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: phronomy
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.25.0
4
+ version: 0.27.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Raizo T.C.S
8
8
  autorequire:
9
9
  bindir: exe
10
10
  cert_chain: []
11
- date: 2026-09-12 00:00:00.000000000 Z
11
+ date: 2026-09-24 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: ruby_llm
15
15
  requirement: !ruby/object:Gem::Requirement
16
16
  requirements:
17
- - - ">="
18
- - !ruby/object:Gem::Version
19
- version: '1.15'
20
- - - "<"
17
+ - - "~>"
21
18
  - !ruby/object:Gem::Version
22
- version: '2'
19
+ version: 2.0.0
23
20
  type: :runtime
24
21
  prerelease: false
25
22
  version_requirements: !ruby/object:Gem::Requirement
26
23
  requirements:
27
- - - ">="
28
- - !ruby/object:Gem::Version
29
- version: '1.15'
30
- - - "<"
24
+ - - "~>"
31
25
  - !ruby/object:Gem::Version
32
- version: '2'
26
+ version: 2.0.0
33
27
  - !ruby/object:Gem::Dependency
34
28
  name: zeitwerk
35
29
  requirement: !ruby/object:Gem::Requirement
@@ -120,21 +114,35 @@ files:
120
114
  - benchmark/bench_workflow.rb
121
115
  - benchmark/run_all.rb
122
116
  - docs/architecture.md
117
+ - docs/architecture/agent-chat-and-state-ownership.md
118
+ - docs/architecture/agent-configuration-and-tool-binding.md
123
119
  - docs/architecture/agent-context.md
120
+ - docs/architecture/agent-transition-ownership.md
124
121
  - docs/architecture/before-llm-input.md
125
122
  - docs/architecture/context-management.md
123
+ - docs/architecture/context-preparation-steps.md
124
+ - docs/architecture/entry-action-and-team-wording.md
125
+ - docs/architecture/execution-metadata-and-values.md
126
+ - docs/architecture/generator-verifier-ownership.md
126
127
  - docs/architecture/knowledge-and-rag.md
127
128
  - docs/architecture/multi-agent-handoff.md
129
+ - docs/architecture/persistence-refactoring-plan.md
128
130
  - docs/architecture/persistence.md
131
+ - docs/architecture/refactoring-closure.md
132
+ - docs/architecture/remaining-refactoring-plan.md
129
133
  - docs/architecture/removed/agent-context.md
134
+ - docs/architecture/rubyllm-2-token-ownership.md
130
135
  - docs/architecture/security-boundaries.md
136
+ - docs/architecture/tool-schema-recording-gap.md
131
137
  - docs/architecture/tracing.md
138
+ - docs/architecture/workflow-terminal-ownership-design.md
132
139
  - docs/archive/design/archived/04_api_design.md
133
140
  - docs/archive/design/archived/09_guardrails.md
134
141
  - docs/archive/design/archived/17_rails_integration.md
135
142
  - docs/archive/design/historical/00_design_philosophy.md
136
143
  - docs/archive/design/historical/01_rubyllm_evaluation.md
137
144
  - docs/archive/design/historical/06_design_decisions.md
145
+ - docs/async-composition.md
138
146
  - docs/changelog/0.14-and-earlier.md
139
147
  - docs/decisions/001-rubyllm-as-provider-layer.md
140
148
  - docs/decisions/002-workflow-context-immutability.md
@@ -168,6 +176,33 @@ files:
168
176
  - docs/decisions/029-semantic-completion-and-application-effect-boundary.md
169
177
  - docs/decisions/030-agent-handoff-domain-and-durable-responsibility.md
170
178
  - docs/decisions/031-durable-multi-agent-coordination.md
179
+ - docs/decisions/032-storage-backend-composition.md
180
+ - docs/decisions/033-domain-persistence-ownership.md
181
+ - docs/decisions/034-handoff-runner-coordination-ownership.md
182
+ - docs/decisions/035-tool-executor-capability-ownership.md
183
+ - docs/decisions/036-context-contract-ownership.md
184
+ - docs/decisions/037-common-definition-ownership.md
185
+ - docs/decisions/038-responsibility-based-source-layout.md
186
+ - docs/decisions/039-runtime-configuration-lifecycle-ownership.md
187
+ - docs/decisions/040-configuration-default-composition.md
188
+ - docs/decisions/041-feature-owned-identity-registries.md
189
+ - docs/decisions/042-feature-owned-execution-state.md
190
+ - docs/decisions/043-storage-execution-constraint-notifications.md
191
+ - docs/decisions/044-agent-default-and-one-shot-composition.md
192
+ - docs/decisions/045-worker-input-restriction-ownership.md
193
+ - docs/decisions/046-agent-responsibility-layout-and-shared-records.md
194
+ - docs/decisions/047-recovered-execution-continuation-contract.md
195
+ - docs/decisions/048-dispatch-preparation-worker-ownership.md
196
+ - docs/decisions/049-initial-preparation-worker-ownership.md
197
+ - docs/decisions/050-approval-resume-snapshot-and-commit-ownership.md
198
+ - docs/decisions/051-execution-outcome-worker-ownership.md
199
+ - docs/decisions/052-tool-invocation-restoration-ownership.md
200
+ - docs/decisions/053-shared-state-coordination-ownership.md
201
+ - docs/decisions/054-workflow-terminal-save-single-owner.md
202
+ - docs/decisions/055-terminal-observer-failure-settlement.md
203
+ - docs/decisions/056-workflow-terminal-policy-ownership.md
204
+ - docs/decisions/057-storage-transaction-boundaries.md
205
+ - docs/decisions/058-neutral-storage-primitives.md
171
206
  - docs/decisions/README.md
172
207
  - docs/design/durable-semantic-coordination/CHANGELOG_V2_REVISION_2.md
173
208
  - docs/design/durable-semantic-coordination/CONTINUATION_DECISION_REFACTOR.md
@@ -183,137 +218,229 @@ files:
183
218
  - docs/migrations/0.19.md
184
219
  - docs/migrations/0.22.md
185
220
  - docs/migrations/durable-semantic-coordination-v2.md
221
+ - docs/migrations/handoff-runner-multi-agent.md
222
+ - docs/migrations/neutral-storage-spi.md
223
+ - docs/migrations/parallel-tool-chat-removal.md
224
+ - docs/migrations/shared-state-multi-agent.md
225
+ - docs/migrations/storage-backend-composition.md
226
+ - docs/migrations/storage-transaction-boundaries.md
186
227
  - docs/persistence-backends.md
187
228
  - docs/runtime-and-concurrency.md
188
229
  - examples/README.md
189
230
  - gemfiles/mcp_1_0.gemfile
190
231
  - lib/phronomy.rb
191
- - lib/phronomy/agent.rb
192
- - lib/phronomy/agent/agent_execution.rb
193
- - lib/phronomy/agent/agent_invocation.rb
194
- - lib/phronomy/agent/agent_invocation_session_builder.rb
195
- - lib/phronomy/agent/agent_root.rb
196
- - lib/phronomy/agent/approval_evaluation_request.rb
232
+ - lib/phronomy/agent/api/agent.rb
197
233
  - lib/phronomy/agent/async_event_api.rb
198
234
  - lib/phronomy/agent/base.rb
235
+ - lib/phronomy/agent/composition/run_once.rb
199
236
  - lib/phronomy/agent/concerns/before_llm_input.rb
200
237
  - lib/phronomy/agent/concerns/error_translation.rb
201
238
  - lib/phronomy/agent/concerns/filterable.rb
202
239
  - lib/phronomy/agent/context/capability/base.rb
240
+ - lib/phronomy/agent/context/capability/tool_executor.rb
203
241
  - lib/phronomy/agent/context/instruction/prompt_template.rb
204
- - lib/phronomy/agent/context_assembler.rb
205
- - lib/phronomy/agent/context_candidate_resolver.rb
206
- - lib/phronomy/agent/context_importer.rb
242
+ - lib/phronomy/agent/context_assembly/context_assembler.rb
243
+ - lib/phronomy/agent/context_assembly/context_candidate_resolver.rb
244
+ - lib/phronomy/agent/context_assembly/context_importer.rb
245
+ - lib/phronomy/agent/context_assembly/context_policy_input_builder.rb
246
+ - lib/phronomy/agent/context_assembly/ruby_llm_materializer.rb
247
+ - lib/phronomy/agent/context_assembly/runtime_chat_builder.rb
248
+ - lib/phronomy/agent/context_assembly/saved_context_reader.rb
249
+ - lib/phronomy/agent/context_assembly/state_writer.rb
250
+ - lib/phronomy/agent/context_assembly/token_budget_resolver.rb
251
+ - lib/phronomy/agent/context_contract/context_plan.rb
252
+ - lib/phronomy/agent/context_contract/context_plan_validator.rb
253
+ - lib/phronomy/agent/context_contract/context_policy.rb
254
+ - lib/phronomy/agent/context_contract/context_policy_input.rb
255
+ - lib/phronomy/agent/context_contract/llm_input_build_context.rb
256
+ - lib/phronomy/agent/context_contract/llm_input_manifest.rb
257
+ - lib/phronomy/agent/context_contract/llm_input_patch.rb
207
258
  - lib/phronomy/agent/context_parts/validators/final_budget_validator.rb
208
- - lib/phronomy/agent/context_plan.rb
209
- - lib/phronomy/agent/context_plan_validator.rb
210
259
  - lib/phronomy/agent/context_policies/default.rb
211
- - lib/phronomy/agent/context_policy.rb
212
- - lib/phronomy/agent/context_policy_input.rb
213
- - lib/phronomy/agent/context_policy_input_builder.rb
214
- - lib/phronomy/agent/exact_execution.rb
215
- - lib/phronomy/agent/execution_cancellation.rb
216
- - lib/phronomy/agent/execution_coordinator.rb
217
- - lib/phronomy/agent/handoff.rb
218
- - lib/phronomy/agent/handoff_capability_factory.rb
219
- - lib/phronomy/agent/handoff_context.rb
220
- - lib/phronomy/agent/handoff_execution_coordinator.rb
221
- - lib/phronomy/agent/handoff_policy.rb
222
- - lib/phronomy/agent/handoff_projection.rb
223
- - lib/phronomy/agent/handoff_request.rb
224
- - lib/phronomy/agent/handoff_runner.rb
225
- - lib/phronomy/agent/handoff_state.rb
226
- - lib/phronomy/agent/immutable.rb
227
- - lib/phronomy/agent/journal_projection.rb
228
- - lib/phronomy/agent/journal_record.rb
229
- - lib/phronomy/agent/llm_call_record.rb
230
- - lib/phronomy/agent/llm_input_build_context.rb
231
- - lib/phronomy/agent/llm_input_manifest.rb
232
- - lib/phronomy/agent/llm_input_patch.rb
233
- - lib/phronomy/agent/llm_operation_result.rb
234
- - lib/phronomy/agent/phase_machine_builder.rb
235
- - lib/phronomy/agent/provider_call_outcome.rb
236
- - lib/phronomy/agent/recovery_coordinator.rb
237
- - lib/phronomy/agent/recovery_coordinator/continuation.rb
238
- - lib/phronomy/agent/recovery_coordinator/installation.rb
239
- - lib/phronomy/agent/recovery_coordinator/resolution.rb
240
- - lib/phronomy/agent/recovery_support.rb
241
- - lib/phronomy/agent/ruby_llm_materializer.rb
260
+ - lib/phronomy/agent/execution/agent_execution.rb
261
+ - lib/phronomy/agent/execution/agent_invocation.rb
262
+ - lib/phronomy/agent/execution/agent_invocation_session_builder.rb
263
+ - lib/phronomy/agent/execution/approval_resume_commit.rb
264
+ - lib/phronomy/agent/execution/dispatch_preparation.rb
265
+ - lib/phronomy/agent/execution/exact_execution.rb
266
+ - lib/phronomy/agent/execution/execution_cancellation.rb
267
+ - lib/phronomy/agent/execution/execution_coordinator.rb
268
+ - lib/phronomy/agent/execution/execution_failure.rb
269
+ - lib/phronomy/agent/execution/execution_metadata.rb
270
+ - lib/phronomy/agent/execution/execution_outcome_committer.rb
271
+ - lib/phronomy/agent/execution/execution_registry.rb
272
+ - lib/phronomy/agent/execution/execution_session_runner.rb
273
+ - lib/phronomy/agent/execution/initial_preparation.rb
274
+ - lib/phronomy/agent/execution/invocation_transitions.rb
275
+ - lib/phronomy/agent/execution/llm_operation_result.rb
276
+ - lib/phronomy/agent/execution/phase_machine_builder.rb
277
+ - lib/phronomy/agent/execution/provider_call_outcome.rb
278
+ - lib/phronomy/agent/execution/runtime_record_encoder.rb
279
+ - lib/phronomy/agent/handoff/handoff.rb
280
+ - lib/phronomy/agent/handoff/handoff_capability_factory.rb
281
+ - lib/phronomy/agent/handoff/handoff_context.rb
282
+ - lib/phronomy/agent/handoff/handoff_execution_coordinator.rb
283
+ - lib/phronomy/agent/handoff/handoff_outcome_committer.rb
284
+ - lib/phronomy/agent/handoff/handoff_policy.rb
285
+ - lib/phronomy/agent/handoff/handoff_projection.rb
286
+ - lib/phronomy/agent/handoff/handoff_request.rb
287
+ - lib/phronomy/agent/handoff/handoff_state.rb
288
+ - lib/phronomy/agent/journal/journal_projection.rb
289
+ - lib/phronomy/agent/journal/journal_record.rb
290
+ - lib/phronomy/agent/journal/llm_call_record.rb
291
+ - lib/phronomy/agent/lifecycle/agent_root.rb
292
+ - lib/phronomy/agent/lifecycle/default_persistence.rb
293
+ - lib/phronomy/agent/lifecycle/ownership_registry.rb
294
+ - lib/phronomy/agent/lifecycle_contract/agent_already_exists_error.rb
295
+ - lib/phronomy/agent/lifecycle_contract/agent_busy_error.rb
296
+ - lib/phronomy/agent/lifecycle_contract/agent_purged_error.rb
297
+ - lib/phronomy/agent/lifecycle_contract/handoff_error.rb
298
+ - lib/phronomy/agent/lifecycle_contract/stream_callback_error.rb
299
+ - lib/phronomy/agent/persistence/agent_repository.rb
300
+ - lib/phronomy/agent/persistence/codec.rb
301
+ - lib/phronomy/agent/persistence/execution_repository.rb
302
+ - lib/phronomy/agent/persistence/handoff_state_repository.rb
303
+ - lib/phronomy/agent/persistence/journal_repository.rb
304
+ - lib/phronomy/agent/persistence/queries.rb
305
+ - lib/phronomy/agent/persistence/storage_schema.rb
306
+ - lib/phronomy/agent/persistence/watermark.rb
307
+ - lib/phronomy/agent/recovery/invocation_restorer.rb
308
+ - lib/phronomy/agent/recovery/recovery_coordinator.rb
309
+ - lib/phronomy/agent/recovery/recovery_coordinator/continuation.rb
310
+ - lib/phronomy/agent/recovery/recovery_coordinator/installation.rb
311
+ - lib/phronomy/agent/recovery/recovery_coordinator/resolution.rb
312
+ - lib/phronomy/agent/recovery/recovery_support.rb
242
313
  - lib/phronomy/agent/selection/candidate.rb
243
314
  - lib/phronomy/agent/selection/constraint.rb
244
- - lib/phronomy/agent/shared_state.rb
245
- - lib/phronomy/agent/token_budget_resolver.rb
246
- - lib/phronomy/agent/tool_approval_request.rb
247
- - lib/phronomy/agent/tool_call_intercepted.rb
248
- - lib/phronomy/agent/tool_definition_set.rb
249
- - lib/phronomy/agent/tool_executor.rb
250
- - lib/phronomy/agent/tool_invocation.rb
251
- - lib/phronomy/agent/tool_invocation_session_builder.rb
252
- - lib/phronomy/agent_already_exists_error.rb
253
- - lib/phronomy/agent_busy_error.rb
254
- - lib/phronomy/agent_purged_error.rb
255
- - lib/phronomy/blocking.rb
256
- - lib/phronomy/canonical_json.rb
257
- - lib/phronomy/configuration.rb
315
+ - lib/phronomy/agent/tool_execution/approval_evaluation_request.rb
316
+ - lib/phronomy/agent/tool_execution/tool_approval_request.rb
317
+ - lib/phronomy/agent/tool_execution/tool_binding.rb
318
+ - lib/phronomy/agent/tool_execution/tool_call_intercepted.rb
319
+ - lib/phronomy/agent/tool_execution/tool_definition_set.rb
320
+ - lib/phronomy/agent/tool_execution/tool_invocation.rb
321
+ - lib/phronomy/agent/tool_execution/tool_invocation_session_builder.rb
322
+ - lib/phronomy/common/canonical_json.rb
323
+ - lib/phronomy/common/configuration_error.rb
324
+ - lib/phronomy/common/error.rb
325
+ - lib/phronomy/common/values/immutable.rb
326
+ - lib/phronomy/common/values/serializable.rb
327
+ - lib/phronomy/configuration/configuration.rb
328
+ - lib/phronomy/configuration/global_configuration.rb
258
329
  - lib/phronomy/content_store/base.rb
259
- - lib/phronomy/context_budget_exceeded_error.rb
260
- - lib/phronomy/diagnostics.rb
330
+ - lib/phronomy/content_store/storage_schema.rb
331
+ - lib/phronomy/content_store/stored_contents.rb
332
+ - lib/phronomy/engine/backpressure_error.rb
333
+ - lib/phronomy/engine/blocking.rb
334
+ - lib/phronomy/engine/cancellation_error.rb
261
335
  - lib/phronomy/engine/concurrency/async_queue.rb
262
336
  - lib/phronomy/engine/concurrency/cancellation_scope.rb
263
337
  - lib/phronomy/engine/concurrency/cancellation_token.rb
264
338
  - lib/phronomy/engine/concurrency/deadline.rb
265
339
  - lib/phronomy/engine/concurrency/offload_pool.rb
340
+ - lib/phronomy/engine/concurrency/operation_binding.rb
266
341
  - lib/phronomy/engine/concurrency/physical_completion_task.rb
267
342
  - lib/phronomy/engine/concurrency/pool_registry.rb
343
+ - lib/phronomy/engine/concurrency/result_collector.rb
344
+ - lib/phronomy/engine/concurrency/result_composition.rb
345
+ - lib/phronomy/engine/concurrency/subscriptions.rb
346
+ - lib/phronomy/engine/concurrency/worker_input_restricted.rb
347
+ - lib/phronomy/engine/diagnostics.rb
348
+ - lib/phronomy/engine/event.rb
268
349
  - lib/phronomy/engine/event_loop.rb
350
+ - lib/phronomy/engine/event_loop_reentrancy_error.rb
351
+ - lib/phronomy/engine/execution.rb
352
+ - lib/phronomy/engine/execution_cancellation_error.rb
353
+ - lib/phronomy/engine/execution_receiver.rb
354
+ - lib/phronomy/engine/execution_timeout_error.rb
355
+ - lib/phronomy/engine/fsm_protocol.rb
269
356
  - lib/phronomy/engine/fsm_session.rb
357
+ - lib/phronomy/engine/invalid_async_entry_action_error.rb
358
+ - lib/phronomy/engine/invalid_async_transition_action_error.rb
359
+ - lib/phronomy/engine/invalid_async_workflow_action_error.rb
360
+ - lib/phronomy/engine/invocation_context.rb
361
+ - lib/phronomy/engine/metrics.rb
362
+ - lib/phronomy/engine/pool_shutdown_error.rb
363
+ - lib/phronomy/engine/recursion_limit_error.rb
364
+ - lib/phronomy/engine/runnable.rb
270
365
  - lib/phronomy/engine/runtime.rb
271
- - lib/phronomy/engine/runtime/agent_ownership_registry.rb
272
366
  - lib/phronomy/engine/runtime/shutdown_result.rb
273
- - lib/phronomy/engine/runtime/team_ownership_registry.rb
274
367
  - lib/phronomy/engine/runtime/timer_queue.rb
275
368
  - lib/phronomy/engine/runtime/timer_service.rb
276
- - lib/phronomy/engine/task.rb
277
- - lib/phronomy/event.rb
278
- - lib/phronomy/execution_rehydration_required_error.rb
369
+ - lib/phronomy/engine/runtime_shutdown_error.rb
370
+ - lib/phronomy/engine/runtime_shutdown_reentrancy_error.rb
371
+ - lib/phronomy/engine/scheduler_reentrancy_error.rb
372
+ - lib/phronomy/engine/task_result.rb
373
+ - lib/phronomy/engine/timeout_error.rb
279
374
  - lib/phronomy/filter.rb
280
375
  - lib/phronomy/filter/base.rb
376
+ - lib/phronomy/filter/contract/filter_block_error.rb
281
377
  - lib/phronomy/filter/prompt_injection_filter.rb
282
- - lib/phronomy/generator_verifier.rb
283
- - lib/phronomy/invalid_async_entry_action_error.rb
284
- - lib/phronomy/invalid_async_transition_action_error.rb
285
- - lib/phronomy/invalid_async_workflow_action_error.rb
286
- - lib/phronomy/invalid_context_budget_configuration_error.rb
287
- - lib/phronomy/invocation_context.rb
378
+ - lib/phronomy/generation/generator_verifier.rb
379
+ - lib/phronomy/generation/generator_verifier/agent_result_receiver.rb
380
+ - lib/phronomy/generation/generator_verifier/pipeline_state.rb
381
+ - lib/phronomy/generation/generator_verifier/workflow_builder.rb
382
+ - lib/phronomy/generation/low_confidence_error.rb
288
383
  - lib/phronomy/llm_adapter.rb
289
384
  - lib/phronomy/llm_adapter/base.rb
290
385
  - lib/phronomy/llm_adapter/ruby_llm.rb
291
386
  - lib/phronomy/llm_context_window/token_budget.rb
292
387
  - lib/phronomy/llm_context_window/token_estimator.rb
293
- - lib/phronomy/metrics.rb
388
+ - lib/phronomy/llm_contract/authentication_error.rb
389
+ - lib/phronomy/llm_contract/context_budget_exceeded_error.rb
390
+ - lib/phronomy/llm_contract/context_length_error.rb
391
+ - lib/phronomy/llm_contract/rate_limit_error.rb
392
+ - lib/phronomy/llm_contract/token_usage.rb
393
+ - lib/phronomy/llm_contract/transport_error.rb
294
394
  - lib/phronomy/multi_agent/admission_registry.rb
295
395
  - lib/phronomy/multi_agent/durable_subagent_coordinator.rb
296
- - lib/phronomy/multi_agent/fan_out_invocation.rb
297
- - lib/phronomy/multi_agent/fan_out_session_builder.rb
396
+ - lib/phronomy/multi_agent/handoff_runner.rb
298
397
  - lib/phronomy/multi_agent/orchestrator.rb
299
- - lib/phronomy/multi_agent/parallel_tool_chat.rb
398
+ - lib/phronomy/multi_agent/persistence/codec.rb
399
+ - lib/phronomy/multi_agent/persistence/queries.rb
400
+ - lib/phronomy/multi_agent/persistence/team_execution_repository.rb
401
+ - lib/phronomy/multi_agent/persistence/team_repository.rb
402
+ - lib/phronomy/multi_agent/shared_state.rb
403
+ - lib/phronomy/multi_agent/storage_contract/team_storage_schema.rb
300
404
  - lib/phronomy/multi_agent/team_coordinator.rb
301
405
  - lib/phronomy/multi_agent/team_execution.rb
406
+ - lib/phronomy/multi_agent/team_ownership_registry.rb
302
407
  - lib/phronomy/multi_agent/team_root.rb
303
408
  - lib/phronomy/output_parser.rb
304
409
  - lib/phronomy/output_parser/base.rb
410
+ - lib/phronomy/output_parser/contract/parse_error.rb
305
411
  - lib/phronomy/output_parser/json_parser.rb
306
412
  - lib/phronomy/output_parser/structured_parser.rb
307
- - lib/phronomy/persistence.rb
308
- - lib/phronomy/persistence/durable_codec.rb
309
- - lib/phronomy/persistence/durable_record.rb
310
- - lib/phronomy/persistence/in_memory.rb
413
+ - lib/phronomy/persistence/api/persistence.rb
311
414
  - lib/phronomy/persistence/migration/initial_format_migration.rb
312
- - lib/phronomy/persistence/repository_facades.rb
313
- - lib/phronomy/recovery.rb
314
- - lib/phronomy/ruby_llm_patches.rb
315
- - lib/phronomy/runnable.rb
316
- - lib/phronomy/stream_callback_error.rb
415
+ - lib/phronomy/persistence_composition/repositories.rb
416
+ - lib/phronomy/persistence_composition/storage_schema.rb
417
+ - lib/phronomy/recovery/execution_rehydration_required_error.rb
418
+ - lib/phronomy/recovery/recovery.rb
419
+ - lib/phronomy/runtime_composition/agent_defaults.rb
420
+ - lib/phronomy/runtime_composition/configuration_defaults.rb
421
+ - lib/phronomy/runtime_composition/global_runtime.rb
422
+ - lib/phronomy/storage/backend.rb
423
+ - lib/phronomy/storage/backends/in_memory.rb
424
+ - lib/phronomy/storage/blob_conflict_error.rb
425
+ - lib/phronomy/storage/blobs.rb
426
+ - lib/phronomy/storage/condition.rb
427
+ - lib/phronomy/storage/condition_failed_error.rb
428
+ - lib/phronomy/storage/conflict_error.rb
429
+ - lib/phronomy/storage/durable_record.rb
430
+ - lib/phronomy/storage/entry.rb
431
+ - lib/phronomy/storage/guard_ref.rb
432
+ - lib/phronomy/storage/not_found_error.rb
433
+ - lib/phronomy/storage/record_codec.rb
434
+ - lib/phronomy/storage/records.rb
435
+ - lib/phronomy/storage/resource.rb
436
+ - lib/phronomy/storage/scope.rb
437
+ - lib/phronomy/storage/serialization_error.rb
438
+ - lib/phronomy/storage/streams.rb
439
+ - lib/phronomy/storage/transaction_error.rb
440
+ - lib/phronomy/storage/unique_constraint_error.rb
441
+ - lib/phronomy/storage/unsupported_backend_error.rb
442
+ - lib/phronomy/storage/validation.rb
443
+ - lib/phronomy/storage/view.rb
317
444
  - lib/phronomy/testing.rb
318
445
  - lib/phronomy/testing/eval.rb
319
446
  - lib/phronomy/testing/eval/comparison.rb
@@ -336,9 +463,11 @@ files:
336
463
  - lib/phronomy/testing/persistence_contract/an_agent_repository.rb
337
464
  - lib/phronomy/testing/persistence_contract/an_execution_repository.rb
338
465
  - lib/phronomy/testing/persistence_contract/coordination_repositories.rb
339
- - lib/phronomy/token_usage.rb
466
+ - lib/phronomy/testing/persistence_contract/neutral_storage_primitives.rb
467
+ - lib/phronomy/testing/persistence_contract/storage_transaction_boundaries.rb
340
468
  - lib/phronomy/tool.rb
341
469
  - lib/phronomy/tool/base.rb
470
+ - lib/phronomy/tool/contract/tool_error.rb
342
471
  - lib/phronomy/tools/agent.rb
343
472
  - lib/phronomy/tools/mcp.rb
344
473
  - lib/phronomy/tools/vector_search.rb
@@ -364,11 +493,16 @@ files:
364
493
  - lib/phronomy/vector_store/splitter/fixed_size_splitter.rb
365
494
  - lib/phronomy/vector_store/splitter/recursive_splitter.rb
366
495
  - lib/phronomy/version.rb
367
- - lib/phronomy/workflow.rb
496
+ - lib/phronomy/workflow/execution/workflow.rb
497
+ - lib/phronomy/workflow/execution/workflow_context.rb
498
+ - lib/phronomy/workflow/execution/workflow_context_ownership_error.rb
499
+ - lib/phronomy/workflow/execution/workflow_execution_registry.rb
500
+ - lib/phronomy/workflow/execution/workflow_runner.rb
501
+ - lib/phronomy/workflow/execution/workflow_terminal_policy.rb
502
+ - lib/phronomy/workflow/persistence/codec.rb
503
+ - lib/phronomy/workflow/persistence/state_repository.rb
368
504
  - lib/phronomy/workflow/phase_machine_builder.rb
369
- - lib/phronomy/workflow_context.rb
370
- - lib/phronomy/workflow_recovery.rb
371
- - lib/phronomy/workflow_runner.rb
505
+ - lib/phronomy/workflow/storage_contract/workflow_storage_schema.rb
372
506
  - scripts/add_to_h_to_token_doubles.rb
373
507
  - scripts/add_to_h_unnamed_doubles.rb
374
508
  - scripts/api_snapshot.rb
@@ -379,14 +513,17 @@ files:
379
513
  - scripts/migrate_spec_agent_definition_pass2.rb
380
514
  - scripts/migrate_spec_inline_pass3.rb
381
515
  - scripts/run_mutation.sh
516
+ - scripts/storage_spi_snapshot.rb
382
517
  - sig/phronomy.rbs
383
518
  - sig/phronomy/agent.rbs
519
+ - sig/phronomy/execution_receiver.rbs
384
520
  - sig/phronomy/extensions.rbs
385
521
  - sig/phronomy/handoff.rbs
386
522
  - sig/phronomy/llm_adapter.rbs
387
523
  - sig/phronomy/multi_agent.rbs
388
524
  - sig/phronomy/persistence.rbs
389
525
  - sig/phronomy/runtime.rbs
526
+ - sig/phronomy/storage.rbs
390
527
  - sig/phronomy/tool.rbs
391
528
  - sig/phronomy/workflow.rbs
392
529
  homepage: https://github.com/Raizo-TCS/phronomy