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