phronomy 0.26.0 → 0.28.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 (557) hide show
  1. checksums.yaml +4 -4
  2. data/.mutant.yml +9 -9
  3. data/CHANGELOG.md +92 -0
  4. data/CONTRIBUTING.md +8 -8
  5. data/README.md +13 -3
  6. data/VERIFY.sh +27 -27
  7. data/benchmark/bench_agent_invoke.rb +26 -47
  8. data/benchmark/bench_context_assembler.rb +17 -15
  9. data/benchmark/bench_regression.rb +1 -1
  10. data/benchmark/bench_tool_schema.rb +1 -1
  11. data/docs/architecture/agent-chat-and-state-ownership.md +153 -0
  12. data/docs/architecture/agent-configuration-and-tool-binding.md +139 -0
  13. data/docs/architecture/agent-context.md +4 -2
  14. data/docs/architecture/agent-transition-ownership.md +13 -0
  15. data/docs/architecture/backend-groups.md +152 -0
  16. data/docs/architecture/before-llm-input.md +9 -3
  17. data/docs/architecture/context-management.md +31 -1
  18. data/docs/architecture/context-preparation-steps.md +90 -0
  19. data/docs/architecture/entry-action-and-team-wording.md +72 -0
  20. data/docs/architecture/execution-abstraction-review.md +88 -0
  21. data/docs/architecture/execution-boundaries.md +28 -0
  22. data/docs/architecture/execution-metadata-and-values.md +86 -0
  23. data/docs/architecture/generator-verifier-ownership.md +111 -0
  24. data/docs/architecture/multi-agent-handoff.md +11 -4
  25. data/docs/architecture/persistence-refactoring-plan.md +50 -0
  26. data/docs/architecture/persistence.md +45 -4
  27. data/docs/architecture/r8-unit1.md +104 -0
  28. data/docs/architecture/r8-unit10.md +72 -0
  29. data/docs/architecture/r8-unit11.md +71 -0
  30. data/docs/architecture/r8-unit12.md +67 -0
  31. data/docs/architecture/r8-unit13.md +61 -0
  32. data/docs/architecture/r8-unit14.md +72 -0
  33. data/docs/architecture/r8-unit15.md +65 -0
  34. data/docs/architecture/r8-unit16.md +54 -0
  35. data/docs/architecture/r8-unit17.md +73 -0
  36. data/docs/architecture/r8-unit18.md +92 -0
  37. data/docs/architecture/r8-unit19.md +61 -0
  38. data/docs/architecture/r8-unit2.md +55 -0
  39. data/docs/architecture/r8-unit20.md +51 -0
  40. data/docs/architecture/r8-unit21.md +79 -0
  41. data/docs/architecture/r8-unit22.md +74 -0
  42. data/docs/architecture/r8-unit23.md +81 -0
  43. data/docs/architecture/r8-unit3.md +130 -0
  44. data/docs/architecture/r8-unit4.md +79 -0
  45. data/docs/architecture/r8-unit5.md +115 -0
  46. data/docs/architecture/r8-unit6.md +71 -0
  47. data/docs/architecture/r8-unit7.md +70 -0
  48. data/docs/architecture/r8-unit8.md +78 -0
  49. data/docs/architecture/r8-unit9.md +73 -0
  50. data/docs/architecture/refactoring-closure.md +343 -0
  51. data/docs/architecture/remaining-refactoring-plan.md +390 -0
  52. data/docs/architecture/rubyllm-2-token-ownership.md +82 -0
  53. data/docs/architecture/storage-execution-boundaries.md +54 -0
  54. data/docs/architecture/tool-schema-recording-gap.md +56 -0
  55. data/docs/architecture/tracing.md +2 -2
  56. data/docs/architecture/workflow-terminal-ownership-design.md +104 -0
  57. data/docs/architecture.md +222 -0
  58. data/docs/decisions/014-unified-persistence-durable-state.md +11 -0
  59. data/docs/decisions/015-tool-public-facade-and-rbs-boundary.md +3 -3
  60. data/docs/decisions/024-event-loop-single-writer-agent-runtime.md +5 -1
  61. data/docs/decisions/025-process-local-agent-ownership-and-runtime-admission.md +13 -3
  62. data/docs/decisions/026-workflow-runtime-admission-and-durable-terminal-barrier.md +5 -1
  63. data/docs/decisions/027-llm-adapter-provider-boundary.md +2 -0
  64. data/docs/decisions/030-agent-handoff-domain-and-durable-responsibility.md +7 -0
  65. data/docs/decisions/031-durable-multi-agent-coordination.md +7 -0
  66. data/docs/decisions/032-storage-backend-composition.md +85 -0
  67. data/docs/decisions/033-domain-persistence-ownership.md +79 -0
  68. data/docs/decisions/034-handoff-runner-coordination-ownership.md +78 -0
  69. data/docs/decisions/035-tool-executor-capability-ownership.md +68 -0
  70. data/docs/decisions/036-context-contract-ownership.md +86 -0
  71. data/docs/decisions/037-common-definition-ownership.md +62 -0
  72. data/docs/decisions/038-responsibility-based-source-layout.md +145 -0
  73. data/docs/decisions/039-runtime-configuration-lifecycle-ownership.md +82 -0
  74. data/docs/decisions/040-configuration-default-composition.md +105 -0
  75. data/docs/decisions/041-feature-owned-identity-registries.md +100 -0
  76. data/docs/decisions/042-feature-owned-execution-state.md +106 -0
  77. data/docs/decisions/043-storage-execution-constraint-notifications.md +75 -0
  78. data/docs/decisions/044-agent-default-and-one-shot-composition.md +106 -0
  79. data/docs/decisions/045-worker-input-restriction-ownership.md +104 -0
  80. data/docs/decisions/046-agent-responsibility-layout-and-shared-records.md +110 -0
  81. data/docs/decisions/047-recovered-execution-continuation-contract.md +116 -0
  82. data/docs/decisions/048-dispatch-preparation-worker-ownership.md +120 -0
  83. data/docs/decisions/049-initial-preparation-worker-ownership.md +111 -0
  84. data/docs/decisions/050-approval-resume-snapshot-and-commit-ownership.md +98 -0
  85. data/docs/decisions/051-execution-outcome-worker-ownership.md +153 -0
  86. data/docs/decisions/052-tool-invocation-restoration-ownership.md +92 -0
  87. data/docs/decisions/053-shared-state-coordination-ownership.md +71 -0
  88. data/docs/decisions/054-workflow-terminal-save-single-owner.md +76 -0
  89. data/docs/decisions/055-terminal-observer-failure-settlement.md +60 -0
  90. data/docs/decisions/056-workflow-terminal-policy-ownership.md +87 -0
  91. data/docs/decisions/057-storage-transaction-boundaries.md +73 -0
  92. data/docs/decisions/058-neutral-storage-primitives.md +83 -0
  93. data/docs/decisions/059-backend-contracts-and-async-clients.md +74 -0
  94. data/docs/decisions/060-runtime-settings-and-application-configuration.md +86 -0
  95. data/docs/decisions/061-persistence-failure-contracts.md +89 -0
  96. data/docs/decisions/062-content-store-service.md +52 -0
  97. data/docs/decisions/063-execution-contracts-and-services.md +88 -0
  98. data/docs/decisions/064-agent-execution-and-multi-agent-responsibility.md +36 -0
  99. data/docs/decisions/065-vector-and-embeddings-common-operations.md +38 -0
  100. data/docs/decisions/066-llm-and-tool-operation-contracts.md +20 -0
  101. data/docs/decisions/067-agent-progress-and-engine-connection.md +29 -0
  102. data/docs/decisions/068-agent-tool-child-progress-and-tool-operation.md +36 -0
  103. data/docs/decisions/README.md +52 -6
  104. data/docs/design/durable-semantic-coordination/IMPLEMENTATION_DESIGN_V2.md +6 -0
  105. data/docs/design/durable-semantic-coordination/IMPLEMENTATION_REPORT.md +6 -0
  106. data/docs/execution-boundaries-preview.md +45 -0
  107. data/docs/features.md +16 -5
  108. data/docs/getting-started.md +11 -8
  109. data/docs/migrations/0.15.md +5 -0
  110. data/docs/migrations/0.22.md +2 -2
  111. data/docs/migrations/durable-semantic-coordination-v2.md +8 -0
  112. data/docs/migrations/handoff-runner-multi-agent.md +37 -0
  113. data/docs/migrations/neutral-storage-spi.md +43 -0
  114. data/docs/migrations/parallel-tool-chat-removal.md +49 -0
  115. data/docs/migrations/persistence-failure-contracts.md +67 -0
  116. data/docs/migrations/r8-unit10.md +36 -0
  117. data/docs/migrations/r8-unit11.md +33 -0
  118. data/docs/migrations/r8-unit12.md +31 -0
  119. data/docs/migrations/r8-unit13.md +36 -0
  120. data/docs/migrations/r8-unit14.md +31 -0
  121. data/docs/migrations/r8-unit15.md +31 -0
  122. data/docs/migrations/r8-unit16.md +26 -0
  123. data/docs/migrations/r8-unit17.md +28 -0
  124. data/docs/migrations/r8-unit18.md +29 -0
  125. data/docs/migrations/r8-unit19.md +28 -0
  126. data/docs/migrations/r8-unit20.md +24 -0
  127. data/docs/migrations/r8-unit21.md +28 -0
  128. data/docs/migrations/r8-unit22.md +29 -0
  129. data/docs/migrations/r8-unit23.md +20 -0
  130. data/docs/migrations/r8-unit4.md +67 -0
  131. data/docs/migrations/r8-unit5.md +75 -0
  132. data/docs/migrations/r8-unit6.md +109 -0
  133. data/docs/migrations/r8-unit7.md +31 -0
  134. data/docs/migrations/r8-unit8.md +33 -0
  135. data/docs/migrations/r8-unit9.md +28 -0
  136. data/docs/migrations/shared-state-multi-agent.md +44 -0
  137. data/docs/migrations/storage-async-client.md +103 -0
  138. data/docs/migrations/storage-backend-composition.md +117 -0
  139. data/docs/migrations/storage-transaction-boundaries.md +74 -0
  140. data/docs/migrations/vector-async-clients.md +110 -0
  141. data/docs/persistence-backends.md +190 -215
  142. data/docs/runtime-and-concurrency.md +142 -32
  143. data/lib/phronomy/agent/admission.rb +78 -0
  144. data/lib/phronomy/{agent_already_exists_error.rb → agent/agent_already_exists_error.rb} +2 -0
  145. data/lib/phronomy/{agent_busy_error.rb → agent/agent_busy_error.rb} +2 -0
  146. data/lib/phronomy/{agent_purged_error.rb → agent/agent_purged_error.rb} +2 -0
  147. data/lib/phronomy/agent/api/agent.rb +17 -0
  148. data/lib/phronomy/{execution_rehydration_required_error.rb → agent/api/execution_rehydration_required_error.rb} +2 -0
  149. data/lib/phronomy/agent/async_event_api.rb +38 -33
  150. data/lib/phronomy/agent/base.rb +106 -294
  151. data/lib/phronomy/agent/before_llm_input.rb +64 -0
  152. data/lib/phronomy/{agent.rb → agent/composition/run_once.rb} +4 -13
  153. data/lib/phronomy/agent/context_candidate_resolver.rb +2 -2
  154. data/lib/phronomy/agent/context_importer.rb +2 -2
  155. data/lib/phronomy/agent/{context_assembler.rb → context_preparation.rb} +157 -288
  156. data/lib/phronomy/agent/control_request.rb +21 -0
  157. data/lib/phronomy/agent/{agent_execution.rb → execution/agent_execution.rb} +8 -4
  158. data/lib/phronomy/agent/{agent_invocation.rb → execution/agent_invocation.rb} +32 -63
  159. data/lib/phronomy/agent/execution/approval_resume_commit.rb +108 -0
  160. data/lib/phronomy/agent/execution/dispatch_preparation.rb +195 -0
  161. data/lib/phronomy/agent/{exact_execution.rb → execution/exact_execution.rb} +43 -23
  162. data/lib/phronomy/agent/{execution_cancellation.rb → execution/execution_cancellation.rb} +8 -5
  163. data/lib/phronomy/agent/execution/execution_coordinator.rb +1744 -0
  164. data/lib/phronomy/agent/execution/execution_failure.rb +30 -0
  165. data/lib/phronomy/agent/execution/execution_metadata.rb +54 -0
  166. data/lib/phronomy/agent/execution/execution_outcome_committer.rb +288 -0
  167. data/lib/phronomy/agent/execution/execution_registry.rb +463 -0
  168. data/lib/phronomy/agent/execution/execution_session_runner.rb +113 -0
  169. data/lib/phronomy/agent/execution/initial_preparation.rb +323 -0
  170. data/lib/phronomy/agent/execution/invocation_actions.rb +368 -0
  171. data/lib/phronomy/agent/execution/invocation_transitions.rb +124 -0
  172. data/lib/phronomy/agent/execution/runtime_record_encoder.rb +210 -0
  173. data/lib/phronomy/agent/execution_change.rb +161 -0
  174. data/lib/phronomy/agent/execution_environment.rb +36 -0
  175. data/lib/phronomy/agent/execution_extension_state.rb +21 -0
  176. data/lib/phronomy/agent/execution_observation.rb +35 -0
  177. data/lib/phronomy/agent/filterable.rb +182 -0
  178. data/lib/phronomy/agent/{handoff_context.rb → handoff/transfer_context.rb} +6 -6
  179. data/lib/phronomy/agent/{handoff_projection.rb → handoff/transfer_projection.rb} +14 -33
  180. data/lib/phronomy/agent/handoff_error.rb +7 -0
  181. data/lib/phronomy/agent/{journal_projection.rb → journal/journal_projection.rb} +4 -0
  182. data/lib/phronomy/agent/{journal_record.rb → journal/journal_record.rb} +3 -3
  183. data/lib/phronomy/agent/{llm_call_record.rb → journal/llm_call_record.rb} +2 -2
  184. data/lib/phronomy/agent/knowledge_item.rb +13 -0
  185. data/lib/phronomy/agent/{agent_root.rb → lifecycle/agent_root.rb} +6 -2
  186. data/lib/phronomy/agent/lifecycle/default_persistence.rb +29 -0
  187. data/lib/phronomy/{engine/runtime/agent_ownership_registry.rb → agent/lifecycle/ownership_registry.rb} +24 -15
  188. data/lib/phronomy/agent/persistence/agent_repository.rb +69 -0
  189. data/lib/phronomy/agent/persistence/cancellation_repository.rb +51 -0
  190. data/lib/phronomy/agent/persistence/codec.rb +338 -0
  191. data/lib/phronomy/agent/persistence/execution_repository.rb +124 -0
  192. data/lib/phronomy/agent/persistence/journal_repository.rb +63 -0
  193. data/lib/phronomy/agent/persistence/records.rb +33 -0
  194. data/lib/phronomy/agent/persistence/retention_repository.rb +70 -0
  195. data/lib/phronomy/agent/persistence/storage_schema.rb +29 -0
  196. data/lib/phronomy/agent/persistence/watermark.rb +29 -0
  197. data/lib/phronomy/agent/recovery/invocation_restorer.rb +124 -0
  198. data/lib/phronomy/agent/{recovery_coordinator → recovery/recovery_coordinator}/continuation.rb +28 -51
  199. data/lib/phronomy/agent/{recovery_coordinator → recovery/recovery_coordinator}/installation.rb +50 -55
  200. data/lib/phronomy/agent/{recovery_coordinator → recovery/recovery_coordinator}/resolution.rb +38 -43
  201. data/lib/phronomy/agent/{recovery_coordinator.rb → recovery/recovery_coordinator.rb} +26 -23
  202. data/lib/phronomy/agent/recovery/recovery_rules.rb +119 -0
  203. data/lib/phronomy/agent/recovery/recovery_support.rb +224 -0
  204. data/lib/phronomy/agent/reserved_execution.rb +16 -0
  205. data/lib/phronomy/agent/retention.rb +17 -0
  206. data/lib/phronomy/agent/runtime_binding/engine_environment.rb +60 -0
  207. data/lib/phronomy/agent/runtime_binding/engine_session_builder.rb +34 -0
  208. data/lib/phronomy/agent/runtime_binding/phase_machine_builder.rb +64 -0
  209. data/lib/phronomy/agent/runtime_binding/tool_session_builder.rb +34 -0
  210. data/lib/phronomy/agent/{ruby_llm_materializer.rb → runtime_input.rb} +19 -39
  211. data/lib/phronomy/agent/saved_context_reader.rb +55 -0
  212. data/lib/phronomy/agent/settings.rb +47 -0
  213. data/lib/phronomy/agent/state_writer.rb +166 -0
  214. data/lib/phronomy/agent/store.rb +253 -0
  215. data/lib/phronomy/{stream_callback_error.rb → agent/stream_callback_error.rb} +2 -0
  216. data/lib/phronomy/agent/{approval_evaluation_request.rb → tool_execution/approval_evaluation_request.rb} +1 -12
  217. data/lib/phronomy/agent/{tool_approval_request.rb → tool_execution/tool_approval_request.rb} +1 -10
  218. data/lib/phronomy/agent/tool_execution/tool_binding.rb +30 -0
  219. data/lib/phronomy/agent/{tool_invocation.rb → tool_execution/tool_invocation.rb} +114 -248
  220. data/lib/phronomy/agent/tool_execution/tool_invocation_actions.rb +107 -0
  221. data/lib/phronomy/agent/tool_execution/tool_invocation_transitions.rb +70 -0
  222. data/lib/phronomy/common/configuration_error.rb +7 -0
  223. data/lib/phronomy/common/error.rb +5 -0
  224. data/lib/phronomy/{agent → common/values}/immutable.rb +9 -1
  225. data/lib/phronomy/common/values/serializable.rb +32 -0
  226. data/lib/phronomy/configuration/runtime_settings.rb +49 -0
  227. data/lib/phronomy/content_store/storage_schema.rb +12 -0
  228. data/lib/phronomy/content_store/stored_contents.rb +44 -0
  229. data/lib/phronomy/context/assembly.rb +202 -0
  230. data/lib/phronomy/{context_budget_exceeded_error.rb → context/budget_exceeded_error.rb} +5 -1
  231. data/lib/phronomy/context/candidate.rb +51 -0
  232. data/lib/phronomy/context/constraint.rb +47 -0
  233. data/lib/phronomy/{agent → context}/context_plan.rb +2 -2
  234. data/lib/phronomy/{agent → context}/context_plan_validator.rb +3 -3
  235. data/lib/phronomy/{agent → context}/context_policy.rb +1 -1
  236. data/lib/phronomy/{agent → context}/context_policy_input.rb +7 -7
  237. data/lib/phronomy/{agent → context}/context_policy_input_builder.rb +1 -1
  238. data/lib/phronomy/context/default_policy.rb +140 -0
  239. data/lib/phronomy/context/final_budget_validator.rb +33 -0
  240. data/lib/phronomy/{agent → context}/llm_input_build_context.rb +2 -2
  241. data/lib/phronomy/{agent → context}/llm_input_manifest.rb +21 -21
  242. data/lib/phronomy/{agent → context}/llm_input_patch.rb +3 -3
  243. data/lib/phronomy/context/manifest_error.rb +10 -0
  244. data/lib/phronomy/context/prompt_template.rb +98 -0
  245. data/lib/phronomy/{vector_store → documents}/loader/base.rb +1 -1
  246. data/lib/phronomy/{vector_store → documents}/loader/csv_loader.rb +2 -2
  247. data/lib/phronomy/{vector_store → documents}/loader/markdown_loader.rb +3 -3
  248. data/lib/phronomy/{vector_store → documents}/loader/plain_text_loader.rb +2 -2
  249. data/lib/phronomy/{vector_store → documents}/splitter/base.rb +1 -1
  250. data/lib/phronomy/{vector_store → documents}/splitter/fixed_size_splitter.rb +2 -2
  251. data/lib/phronomy/{vector_store → documents}/splitter/recursive_splitter.rb +2 -2
  252. data/lib/phronomy/embeddings/async/async_client.rb +44 -0
  253. data/lib/phronomy/embeddings/backends/ruby_llm_embeddings.rb +48 -0
  254. data/lib/phronomy/embeddings/base.rb +43 -0
  255. data/lib/phronomy/embeddings/invalid_result_error.rb +11 -0
  256. data/lib/phronomy/embeddings/transport_error.rb +11 -0
  257. data/lib/phronomy/engine/concurrency/offload_pool.rb +39 -20
  258. data/lib/phronomy/engine/concurrency/pool_registry.rb +47 -12
  259. data/lib/phronomy/{diagnostics.rb → engine/diagnostics.rb} +1 -1
  260. data/lib/phronomy/engine/event_loop.rb +164 -630
  261. data/lib/phronomy/engine/execution_binding.rb +23 -0
  262. data/lib/phronomy/engine/execution_receiver_binding.rb +43 -0
  263. data/lib/phronomy/engine/fsm_protocol.rb +9 -0
  264. data/lib/phronomy/engine/fsm_session.rb +37 -30
  265. data/lib/phronomy/engine/metrics.rb +28 -0
  266. data/lib/phronomy/engine/runtime/timer_queue.rb +1 -1
  267. data/lib/phronomy/engine/runtime.rb +104 -95
  268. data/lib/phronomy/engine/terminal_decision.rb +7 -0
  269. data/lib/phronomy/execution/async_operation.rb +41 -0
  270. data/lib/phronomy/execution/backpressure_error.rb +7 -0
  271. data/lib/phronomy/{blocking.rb → execution/blocking.rb} +2 -2
  272. data/lib/phronomy/execution/cancellation_error.rb +7 -0
  273. data/lib/phronomy/{engine → execution}/concurrency/cancellation_token.rb +5 -1
  274. data/lib/phronomy/{engine → execution}/concurrency/deadline.rb +0 -17
  275. data/lib/phronomy/{engine → execution}/concurrency/physical_completion_task.rb +1 -1
  276. data/lib/phronomy/{engine → execution}/concurrency/result_collector.rb +1 -1
  277. data/lib/phronomy/{engine → execution}/concurrency/result_composition.rb +33 -12
  278. data/lib/phronomy/{engine/concurrency/subscriptions.rb → execution/concurrency/result_subscriptions.rb} +14 -18
  279. data/lib/phronomy/execution/concurrency/subscriptions.rb +25 -0
  280. data/lib/phronomy/execution/concurrency/worker_input_restricted.rb +14 -0
  281. data/lib/phronomy/execution/event_loop_reentrancy_error.rb +8 -0
  282. data/lib/phronomy/{execution.rb → execution/execution.rb} +57 -30
  283. data/lib/phronomy/{execution_cancellation_error.rb → execution/execution_cancellation_error.rb} +2 -0
  284. data/lib/phronomy/execution/execution_receiver.rb +78 -0
  285. data/lib/phronomy/execution/execution_scope_state.rb +35 -0
  286. data/lib/phronomy/{execution_timeout_error.rb → execution/execution_timeout_error.rb} +2 -0
  287. data/lib/phronomy/{invalid_async_entry_action_error.rb → execution/invalid_async_entry_action_error.rb} +2 -0
  288. data/lib/phronomy/{invalid_async_transition_action_error.rb → execution/invalid_async_transition_action_error.rb} +2 -0
  289. data/lib/phronomy/{invalid_async_workflow_action_error.rb → execution/invalid_async_workflow_action_error.rb} +2 -0
  290. data/lib/phronomy/{invocation_context.rb → execution/invocation_context.rb} +0 -15
  291. data/lib/phronomy/execution/invocation_controls.rb +73 -0
  292. data/lib/phronomy/execution/pool_shutdown_error.rb +7 -0
  293. data/lib/phronomy/execution/recursion_limit_error.rb +7 -0
  294. data/lib/phronomy/execution/runnable.rb +24 -0
  295. data/lib/phronomy/execution/runtime_shutdown_error.rb +7 -0
  296. data/lib/phronomy/execution/runtime_shutdown_reentrancy_error.rb +7 -0
  297. data/lib/phronomy/execution/scheduler_reentrancy_error.rb +9 -0
  298. data/lib/phronomy/{engine → execution}/task_result.rb +7 -3
  299. data/lib/phronomy/execution/timeout_error.rb +7 -0
  300. data/lib/phronomy/execution/wait_policy.rb +24 -0
  301. data/lib/phronomy/filter/filter_block_error.rb +14 -0
  302. data/lib/phronomy/generation/generator_verifier/agent_operation.rb +65 -0
  303. data/lib/phronomy/generation/generator_verifier/agent_result_receiver.rb +89 -0
  304. data/lib/phronomy/generation/generator_verifier/default_parser.rb +27 -0
  305. data/lib/phronomy/generation/generator_verifier/pipeline_state.rb +57 -0
  306. data/lib/phronomy/generation/generator_verifier/workflow_builder.rb +112 -0
  307. data/lib/phronomy/generation/generator_verifier.rb +118 -0
  308. data/lib/phronomy/generation/low_confidence_error.rb +14 -0
  309. data/lib/phronomy/llm_adapter/async/async_client.rb +47 -0
  310. data/lib/phronomy/llm_adapter/authentication_error.rb +9 -0
  311. data/lib/phronomy/llm_adapter/backends/ruby_llm.rb +183 -0
  312. data/lib/phronomy/llm_adapter/base.rb +49 -68
  313. data/lib/phronomy/llm_adapter/context_length_error.rb +9 -0
  314. data/lib/phronomy/llm_adapter/invalid_result_error.rb +10 -0
  315. data/lib/phronomy/llm_adapter/message.rb +62 -0
  316. data/lib/phronomy/llm_adapter/rate_limit_error.rb +9 -0
  317. data/lib/phronomy/llm_adapter/request.rb +79 -0
  318. data/lib/phronomy/llm_adapter/response.rb +36 -0
  319. data/lib/phronomy/llm_adapter/stream_chunk.rb +18 -0
  320. data/lib/phronomy/llm_adapter/token_usage.rb +64 -0
  321. data/lib/phronomy/llm_adapter/transport_error.rb +9 -0
  322. data/lib/phronomy/llm_adapter.rb +3 -16
  323. data/lib/phronomy/llm_context_window/token_budget.rb +6 -7
  324. data/lib/phronomy/multi_agent/admission_registry.rb +15 -2
  325. data/lib/phronomy/multi_agent/durable_subagent_coordinator.rb +108 -84
  326. data/lib/phronomy/multi_agent/execution_environment.rb +29 -0
  327. data/lib/phronomy/{agent → multi_agent}/handoff.rb +2 -2
  328. data/lib/phronomy/{agent → multi_agent}/handoff_capability_factory.rb +21 -2
  329. data/lib/phronomy/multi_agent/handoff_participant.rb +79 -0
  330. data/lib/phronomy/{agent → multi_agent}/handoff_policy.rb +1 -1
  331. data/lib/phronomy/multi_agent/handoff_runner.rb +156 -0
  332. data/lib/phronomy/{agent → multi_agent}/handoff_state.rb +2 -2
  333. data/lib/phronomy/multi_agent/orchestrator.rb +61 -75
  334. data/lib/phronomy/multi_agent/persistence/codec.rb +75 -0
  335. data/lib/phronomy/multi_agent/persistence/handoff_state_repository.rb +77 -0
  336. data/lib/phronomy/multi_agent/persistence/records.rb +27 -0
  337. data/lib/phronomy/multi_agent/persistence/storage_schema.rb +21 -0
  338. data/lib/phronomy/multi_agent/persistence/team_execution_repository.rb +124 -0
  339. data/lib/phronomy/multi_agent/persistence/team_repository.rb +69 -0
  340. data/lib/phronomy/multi_agent/reserved_child_admission.rb +88 -0
  341. data/lib/phronomy/multi_agent/runtime_binding/engine_environment.rb +35 -0
  342. data/lib/phronomy/{agent → multi_agent}/shared_state.rb +56 -39
  343. data/lib/phronomy/multi_agent/store.rb +156 -0
  344. data/lib/phronomy/multi_agent/team_coordinator.rb +87 -75
  345. data/lib/phronomy/multi_agent/team_execution.rb +1 -1
  346. data/lib/phronomy/{engine/runtime → multi_agent}/team_ownership_registry.rb +5 -5
  347. data/lib/phronomy/multi_agent/team_root.rb +1 -1
  348. data/lib/phronomy/output_parser/parse_error.rb +7 -0
  349. data/lib/phronomy/persistence/content_repository.rb +26 -0
  350. data/lib/phronomy/persistence/errors.rb +16 -0
  351. data/lib/phronomy/persistence/migration/initial_format_migration.rb +21 -21
  352. data/lib/phronomy/persistence/persistence.rb +23 -0
  353. data/lib/phronomy/persistence/save_outcome.rb +24 -0
  354. data/lib/phronomy/persistence/snapshot_comparison.rb +81 -0
  355. data/lib/phronomy/persistence/storage_boundary.rb +32 -0
  356. data/lib/phronomy/persistence/transaction.rb +86 -0
  357. data/lib/phronomy/persistence_composition/storage_schema.rb +29 -0
  358. data/lib/phronomy/persistence_composition/stores.rb +34 -0
  359. data/lib/phronomy/persistence_composition/unit4_migration.rb +276 -0
  360. data/lib/phronomy/runtime_composition/agent_defaults.rb +11 -0
  361. data/lib/phronomy/runtime_composition/configuration.rb +146 -0
  362. data/lib/phronomy/runtime_composition/configuration_defaults.rb +9 -0
  363. data/lib/phronomy/runtime_composition/evaluation_defaults.rb +7 -0
  364. data/lib/phronomy/runtime_composition/execution_defaults.rb +5 -0
  365. data/lib/phronomy/runtime_composition/generation_defaults.rb +6 -0
  366. data/lib/phronomy/runtime_composition/global_configuration.rb +38 -0
  367. data/lib/phronomy/runtime_composition/global_runtime.rb +19 -0
  368. data/lib/phronomy/runtime_composition/multi_agent_defaults.rb +9 -0
  369. data/lib/phronomy/runtime_composition/workflow_defaults.rb +4 -0
  370. data/lib/phronomy/storage/async/async_client.rb +60 -0
  371. data/lib/phronomy/storage/backend.rb +107 -0
  372. data/lib/phronomy/storage/backends/in_memory.rb +157 -0
  373. data/lib/phronomy/storage/blob_conflict_error.rb +10 -0
  374. data/lib/phronomy/storage/blobs.rb +31 -0
  375. data/lib/phronomy/storage/condition.rb +25 -0
  376. data/lib/phronomy/storage/condition_failed_error.rb +16 -0
  377. data/lib/phronomy/storage/conflict_error.rb +9 -0
  378. data/lib/phronomy/{persistence → storage}/durable_record.rb +12 -12
  379. data/lib/phronomy/storage/entry.rb +33 -0
  380. data/lib/phronomy/storage/guard_ref.rb +13 -0
  381. data/lib/phronomy/storage/not_found_error.rb +9 -0
  382. data/lib/phronomy/storage/record_codec.rb +177 -0
  383. data/lib/phronomy/storage/records.rb +61 -0
  384. data/lib/phronomy/storage/resource.rb +126 -0
  385. data/lib/phronomy/storage/scope.rb +25 -0
  386. data/lib/phronomy/storage/serialization_error.rb +9 -0
  387. data/lib/phronomy/storage/streams.rb +44 -0
  388. data/lib/phronomy/storage/transaction_error.rb +10 -0
  389. data/lib/phronomy/storage/unique_constraint_error.rb +17 -0
  390. data/lib/phronomy/storage/unsupported_backend_error.rb +9 -0
  391. data/lib/phronomy/storage/validation.rb +53 -0
  392. data/lib/phronomy/storage/view.rb +131 -0
  393. data/lib/phronomy/testing/eval/metrics.rb +1 -1
  394. data/lib/phronomy/testing/eval/scorer/llm_judge.rb +19 -3
  395. data/lib/phronomy/testing/persistence_contract/a_content_store.rb +1 -1
  396. data/lib/phronomy/testing/persistence_contract/a_journal_repository.rb +2 -2
  397. data/lib/phronomy/testing/persistence_contract/a_persistence_backend.rb +54 -48
  398. data/lib/phronomy/testing/persistence_contract/a_workflow_state_repository.rb +1 -1
  399. data/lib/phronomy/testing/persistence_contract/an_agent_repository.rb +1 -1
  400. data/lib/phronomy/testing/persistence_contract/an_execution_repository.rb +5 -5
  401. data/lib/phronomy/testing/persistence_contract/coordination_repositories.rb +52 -46
  402. data/lib/phronomy/testing/persistence_contract/neutral_storage_primitives.rb +263 -0
  403. data/lib/phronomy/testing/persistence_contract/storage_transaction_boundaries.rb +124 -0
  404. data/lib/phronomy/testing/persistence_contract.rb +4 -0
  405. data/lib/phronomy/tool/authorization.rb +77 -0
  406. data/lib/phronomy/tool/base.rb +549 -9
  407. data/lib/phronomy/tool/call_request.rb +40 -0
  408. data/lib/phronomy/{agent/tool_definition_set.rb → tool/definition_set.rb} +16 -12
  409. data/lib/phronomy/tool/operation.rb +88 -0
  410. data/lib/phronomy/tool/schema.rb +214 -0
  411. data/lib/phronomy/tool/settings.rb +31 -0
  412. data/lib/phronomy/tool/tool_error.rb +7 -0
  413. data/lib/phronomy/{agent → tool}/tool_executor.rb +10 -7
  414. data/lib/phronomy/tools/agent.rb +22 -90
  415. data/lib/phronomy/tools/mcp.rb +21 -14
  416. data/lib/phronomy/tools/vector_search.rb +4 -4
  417. data/lib/phronomy/tracing/automatic.rb +11 -6
  418. data/lib/phronomy/tracing/base.rb +1 -1
  419. data/lib/phronomy/tracing/observation.rb +37 -0
  420. data/lib/phronomy/tracing/settings.rb +36 -0
  421. data/lib/phronomy/vector_store/{async_backend.rb → async/async_client.rb} +35 -29
  422. data/lib/phronomy/vector_store/{in_memory.rb → backends/in_memory.rb} +12 -10
  423. data/lib/phronomy/vector_store/{pgvector.rb → backends/pgvector.rb} +44 -16
  424. data/lib/phronomy/vector_store/{redis_search.rb → backends/redis_search.rb} +74 -37
  425. data/lib/phronomy/vector_store/base.rb +118 -49
  426. data/lib/phronomy/vector_store/invalid_result_error.rb +12 -0
  427. data/lib/phronomy/vector_store.rb +2 -17
  428. data/lib/phronomy/version.rb +1 -1
  429. data/lib/phronomy/workflow/completion.rb +11 -0
  430. data/lib/phronomy/{workflow.rb → workflow/execution/workflow.rb} +10 -8
  431. data/lib/phronomy/workflow/execution/workflow_action_rules.rb +67 -0
  432. data/lib/phronomy/{workflow_context.rb → workflow/execution/workflow_context.rb} +5 -1
  433. data/lib/phronomy/workflow/execution/workflow_context_ownership_error.rb +7 -0
  434. data/lib/phronomy/workflow/execution/workflow_execution_environment.rb +27 -0
  435. data/lib/phronomy/workflow/execution/workflow_execution_registry.rb +186 -0
  436. data/lib/phronomy/{workflow_runner.rb → workflow/execution/workflow_runner.rb} +145 -115
  437. data/lib/phronomy/workflow/execution/workflow_settings.rb +28 -0
  438. data/lib/phronomy/workflow/persistence/codec.rb +153 -0
  439. data/lib/phronomy/workflow/persistence/state_repository.rb +63 -0
  440. data/lib/phronomy/workflow/persistence/storage_schema.rb +13 -0
  441. data/lib/phronomy/workflow/runtime_binding/workflow_engine_environment.rb +38 -0
  442. data/lib/phronomy/workflow/runtime_binding/workflow_phase_machine_builder.rb +156 -0
  443. data/lib/phronomy/workflow/runtime_binding/workflow_terminal_policy.rb +40 -0
  444. data/lib/phronomy.rb +97 -98
  445. data/scripts/api_snapshot.rb +36 -16
  446. data/scripts/storage_spi_snapshot.rb +36 -0
  447. data/sig/_private/phronomy/agent/settings.rbs +19 -0
  448. data/sig/_private/phronomy/configuration/runtime_settings.rbs +20 -0
  449. data/sig/_private/phronomy/llm_adapter/async/async_client.rbs +10 -0
  450. data/sig/_private/phronomy/multi_agent/store.rbs +8 -0
  451. data/sig/_private/phronomy/persistence/storage_boundary.rbs +7 -0
  452. data/sig/_private/phronomy/tool/settings.rbs +13 -0
  453. data/sig/_private/phronomy/tracing/settings.rbs +15 -0
  454. data/sig/_private/phronomy/workflow/execution/workflow_settings.rbs +13 -0
  455. data/sig/phronomy/agent/admission.rbs +19 -0
  456. data/sig/phronomy/agent/execution_contract.rbs +132 -0
  457. data/sig/phronomy/agent/execution_environment.rbs +20 -0
  458. data/sig/phronomy/agent/store.rbs +73 -0
  459. data/sig/phronomy/agent.rbs +14 -139
  460. data/sig/phronomy/common.rbs +7 -0
  461. data/sig/phronomy/content_store/contracts.rbs +13 -0
  462. data/sig/phronomy/context.rbs +152 -0
  463. data/sig/phronomy/embeddings/async/async_client.rbs +9 -0
  464. data/sig/phronomy/embeddings/base.rbs +17 -0
  465. data/sig/phronomy/engine/concurrency/timer_bindings.rbs +22 -0
  466. data/sig/phronomy/engine/control_bindings.rbs +11 -0
  467. data/sig/phronomy/engine/control_protocols.rbs +23 -0
  468. data/sig/phronomy/engine/execution_binding.rbs +6 -0
  469. data/sig/phronomy/engine/execution_receiver.rbs +15 -0
  470. data/sig/phronomy/engine/observability.rbs +13 -0
  471. data/sig/phronomy/execution/async_operation.rbs +7 -0
  472. data/sig/phronomy/execution/blocking.rbs +5 -0
  473. data/sig/phronomy/execution/concurrency/cancellation_token.rbs +13 -0
  474. data/sig/phronomy/execution/concurrency/deadline.rbs +10 -0
  475. data/sig/phronomy/execution/concurrency/result_composition.rbs +7 -0
  476. data/sig/phronomy/execution/control_protocols.rbs +18 -0
  477. data/sig/phronomy/execution/errors.rbs +7 -0
  478. data/sig/phronomy/execution/execution.rbs +41 -0
  479. data/sig/phronomy/execution/execution_receiver.rbs +40 -0
  480. data/sig/phronomy/execution/execution_scope_state.rbs +9 -0
  481. data/sig/phronomy/execution/invocation_context.rbs +18 -0
  482. data/sig/phronomy/execution/invocation_controls.rbs +13 -0
  483. data/sig/phronomy/execution/task_result.rbs +29 -0
  484. data/sig/phronomy/extensions.rbs +0 -21
  485. data/sig/phronomy/handoff.rbs +12 -4
  486. data/sig/phronomy/llm_adapter/backends/ruby_llm.rbs +6 -0
  487. data/sig/phronomy/llm_adapter/base.rbs +14 -0
  488. data/sig/phronomy/llm_adapter/usage.rbs +14 -0
  489. data/sig/phronomy/llm_adapter/values.rbs +43 -0
  490. data/sig/phronomy/llm_context_window.rbs +10 -0
  491. data/sig/phronomy/multi_agent/reserved_child_admission.rbs +8 -0
  492. data/sig/phronomy/multi_agent/store.rbs +54 -0
  493. data/sig/phronomy/multi_agent.rbs +24 -3
  494. data/sig/phronomy/persistence/errors.rbs +18 -0
  495. data/sig/phronomy/persistence/migration.rbs +13 -0
  496. data/sig/phronomy/persistence/transaction.rbs +19 -0
  497. data/sig/phronomy/persistence.rbs +3 -185
  498. data/sig/phronomy/persistence_composition.rbs +19 -0
  499. data/sig/phronomy/runtime_composition/configuration.rbs +36 -0
  500. data/sig/phronomy/storage/async/async_client.rbs +8 -0
  501. data/sig/phronomy/storage/backends/in_memory.rbs +9 -0
  502. data/sig/phronomy/storage/contracts.rbs +160 -0
  503. data/sig/phronomy/tool.rbs +58 -5
  504. data/sig/phronomy/tracing/observation.rbs +7 -0
  505. data/sig/phronomy/vector_store/async/async_client.rbs +13 -0
  506. data/sig/phronomy/vector_store/base.rbs +23 -0
  507. data/sig/phronomy/workflow/execution/workflow_execution_environment.rbs +14 -0
  508. data/sig/phronomy/workflow/runtime_binding/workflow_terminal_policy.rbs +7 -0
  509. data/sig/phronomy/workflow/store.rbs +8 -0
  510. data/sig/phronomy/workflow.rbs +1 -1
  511. data/sig/phronomy.rbs +0 -49
  512. metadata +462 -130
  513. data/lib/phronomy/agent/agent_invocation_session_builder.rb +0 -584
  514. data/lib/phronomy/agent/concerns/before_llm_input.rb +0 -66
  515. data/lib/phronomy/agent/concerns/error_translation.rb +0 -45
  516. data/lib/phronomy/agent/concerns/filterable.rb +0 -184
  517. data/lib/phronomy/agent/context/capability/base.rb +0 -507
  518. data/lib/phronomy/agent/context/instruction/prompt_template.rb +0 -102
  519. data/lib/phronomy/agent/context_parts/validators/final_budget_validator.rb +0 -37
  520. data/lib/phronomy/agent/context_policies/default.rb +0 -142
  521. data/lib/phronomy/agent/execution_coordinator.rb +0 -3151
  522. data/lib/phronomy/agent/handoff_execution_coordinator.rb +0 -143
  523. data/lib/phronomy/agent/handoff_request.rb +0 -45
  524. data/lib/phronomy/agent/handoff_runner.rb +0 -178
  525. data/lib/phronomy/agent/phase_machine_builder.rb +0 -152
  526. data/lib/phronomy/agent/provider_call_outcome.rb +0 -106
  527. data/lib/phronomy/agent/recovery_support.rb +0 -504
  528. data/lib/phronomy/agent/selection/candidate.rb +0 -53
  529. data/lib/phronomy/agent/selection/constraint.rb +0 -49
  530. data/lib/phronomy/agent/token_budget_resolver.rb +0 -70
  531. data/lib/phronomy/agent/tool_call_intercepted.rb +0 -29
  532. data/lib/phronomy/agent/tool_invocation_session_builder.rb +0 -276
  533. data/lib/phronomy/configuration.rb +0 -59
  534. data/lib/phronomy/engine/concurrency/cancellation_scope.rb +0 -124
  535. data/lib/phronomy/engine/concurrency/operation_binding.rb +0 -43
  536. data/lib/phronomy/generator_verifier.rb +0 -369
  537. data/lib/phronomy/invalid_context_budget_configuration_error.rb +0 -8
  538. data/lib/phronomy/llm_adapter/ruby_llm.rb +0 -47
  539. data/lib/phronomy/metrics.rb +0 -26
  540. data/lib/phronomy/multi_agent/parallel_tool_chat.rb +0 -116
  541. data/lib/phronomy/persistence/durable_codec.rb +0 -706
  542. data/lib/phronomy/persistence/in_memory.rb +0 -690
  543. data/lib/phronomy/persistence/repository_facades.rb +0 -535
  544. data/lib/phronomy/persistence.rb +0 -276
  545. data/lib/phronomy/recovery.rb +0 -186
  546. data/lib/phronomy/ruby_llm_patches.rb +0 -24
  547. data/lib/phronomy/runnable.rb +0 -54
  548. data/lib/phronomy/token_usage.rb +0 -85
  549. data/lib/phronomy/vector_store/embeddings/base.rb +0 -44
  550. data/lib/phronomy/vector_store/embeddings/ruby_llm_embeddings.rb +0 -47
  551. data/lib/phronomy/workflow/phase_machine_builder.rb +0 -205
  552. data/lib/phronomy/workflow_recovery.rb +0 -123
  553. data/sig/phronomy/llm_adapter.rbs +0 -11
  554. data/sig/phronomy/runtime.rbs +0 -76
  555. /data/lib/phronomy/agent/{llm_operation_result.rb → execution/llm_operation_result.rb} +0 -0
  556. /data/lib/phronomy/{canonical_json.rb → common/canonical_json.rb} +0 -0
  557. /data/lib/phronomy/{event.rb → engine/event.rb} +0 -0
metadata CHANGED
@@ -1,35 +1,57 @@
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.28.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-10-08 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
- - - ">="
17
+ - - "~>"
18
18
  - !ruby/object:Gem::Version
19
- version: '1.15'
20
- - - "<"
19
+ version: 2.0.0
20
+ type: :runtime
21
+ prerelease: false
22
+ version_requirements: !ruby/object:Gem::Requirement
23
+ requirements:
24
+ - - "~>"
25
+ - !ruby/object:Gem::Version
26
+ version: 2.0.0
27
+ - !ruby/object:Gem::Dependency
28
+ name: schematist
29
+ requirement: !ruby/object:Gem::Requirement
30
+ requirements:
31
+ - - "~>"
21
32
  - !ruby/object:Gem::Version
22
- version: '2'
33
+ version: '1.1'
23
34
  type: :runtime
24
35
  prerelease: false
25
36
  version_requirements: !ruby/object:Gem::Requirement
26
37
  requirements:
27
- - - ">="
38
+ - - "~>"
28
39
  - !ruby/object:Gem::Version
29
- version: '1.15'
30
- - - "<"
40
+ version: '1.1'
41
+ - !ruby/object:Gem::Dependency
42
+ name: json_schemer
43
+ requirement: !ruby/object:Gem::Requirement
44
+ requirements:
45
+ - - "~>"
46
+ - !ruby/object:Gem::Version
47
+ version: '2.5'
48
+ type: :runtime
49
+ prerelease: false
50
+ version_requirements: !ruby/object:Gem::Requirement
51
+ requirements:
52
+ - - "~>"
31
53
  - !ruby/object:Gem::Version
32
- version: '2'
54
+ version: '2.5'
33
55
  - !ruby/object:Gem::Dependency
34
56
  name: zeitwerk
35
57
  requirement: !ruby/object:Gem::Requirement
@@ -120,15 +142,55 @@ files:
120
142
  - benchmark/bench_workflow.rb
121
143
  - benchmark/run_all.rb
122
144
  - docs/architecture.md
145
+ - docs/architecture/agent-chat-and-state-ownership.md
146
+ - docs/architecture/agent-configuration-and-tool-binding.md
123
147
  - docs/architecture/agent-context.md
148
+ - docs/architecture/agent-transition-ownership.md
149
+ - docs/architecture/backend-groups.md
124
150
  - docs/architecture/before-llm-input.md
125
151
  - docs/architecture/context-management.md
152
+ - docs/architecture/context-preparation-steps.md
153
+ - docs/architecture/entry-action-and-team-wording.md
154
+ - docs/architecture/execution-abstraction-review.md
155
+ - docs/architecture/execution-boundaries.md
156
+ - docs/architecture/execution-metadata-and-values.md
157
+ - docs/architecture/generator-verifier-ownership.md
126
158
  - docs/architecture/knowledge-and-rag.md
127
159
  - docs/architecture/multi-agent-handoff.md
160
+ - docs/architecture/persistence-refactoring-plan.md
128
161
  - docs/architecture/persistence.md
162
+ - docs/architecture/r8-unit1.md
163
+ - docs/architecture/r8-unit10.md
164
+ - docs/architecture/r8-unit11.md
165
+ - docs/architecture/r8-unit12.md
166
+ - docs/architecture/r8-unit13.md
167
+ - docs/architecture/r8-unit14.md
168
+ - docs/architecture/r8-unit15.md
169
+ - docs/architecture/r8-unit16.md
170
+ - docs/architecture/r8-unit17.md
171
+ - docs/architecture/r8-unit18.md
172
+ - docs/architecture/r8-unit19.md
173
+ - docs/architecture/r8-unit2.md
174
+ - docs/architecture/r8-unit20.md
175
+ - docs/architecture/r8-unit21.md
176
+ - docs/architecture/r8-unit22.md
177
+ - docs/architecture/r8-unit23.md
178
+ - docs/architecture/r8-unit3.md
179
+ - docs/architecture/r8-unit4.md
180
+ - docs/architecture/r8-unit5.md
181
+ - docs/architecture/r8-unit6.md
182
+ - docs/architecture/r8-unit7.md
183
+ - docs/architecture/r8-unit8.md
184
+ - docs/architecture/r8-unit9.md
185
+ - docs/architecture/refactoring-closure.md
186
+ - docs/architecture/remaining-refactoring-plan.md
129
187
  - docs/architecture/removed/agent-context.md
188
+ - docs/architecture/rubyllm-2-token-ownership.md
130
189
  - docs/architecture/security-boundaries.md
190
+ - docs/architecture/storage-execution-boundaries.md
191
+ - docs/architecture/tool-schema-recording-gap.md
131
192
  - docs/architecture/tracing.md
193
+ - docs/architecture/workflow-terminal-ownership-design.md
132
194
  - docs/archive/design/archived/04_api_design.md
133
195
  - docs/archive/design/archived/09_guardrails.md
134
196
  - docs/archive/design/archived/17_rails_integration.md
@@ -169,6 +231,43 @@ files:
169
231
  - docs/decisions/029-semantic-completion-and-application-effect-boundary.md
170
232
  - docs/decisions/030-agent-handoff-domain-and-durable-responsibility.md
171
233
  - docs/decisions/031-durable-multi-agent-coordination.md
234
+ - docs/decisions/032-storage-backend-composition.md
235
+ - docs/decisions/033-domain-persistence-ownership.md
236
+ - docs/decisions/034-handoff-runner-coordination-ownership.md
237
+ - docs/decisions/035-tool-executor-capability-ownership.md
238
+ - docs/decisions/036-context-contract-ownership.md
239
+ - docs/decisions/037-common-definition-ownership.md
240
+ - docs/decisions/038-responsibility-based-source-layout.md
241
+ - docs/decisions/039-runtime-configuration-lifecycle-ownership.md
242
+ - docs/decisions/040-configuration-default-composition.md
243
+ - docs/decisions/041-feature-owned-identity-registries.md
244
+ - docs/decisions/042-feature-owned-execution-state.md
245
+ - docs/decisions/043-storage-execution-constraint-notifications.md
246
+ - docs/decisions/044-agent-default-and-one-shot-composition.md
247
+ - docs/decisions/045-worker-input-restriction-ownership.md
248
+ - docs/decisions/046-agent-responsibility-layout-and-shared-records.md
249
+ - docs/decisions/047-recovered-execution-continuation-contract.md
250
+ - docs/decisions/048-dispatch-preparation-worker-ownership.md
251
+ - docs/decisions/049-initial-preparation-worker-ownership.md
252
+ - docs/decisions/050-approval-resume-snapshot-and-commit-ownership.md
253
+ - docs/decisions/051-execution-outcome-worker-ownership.md
254
+ - docs/decisions/052-tool-invocation-restoration-ownership.md
255
+ - docs/decisions/053-shared-state-coordination-ownership.md
256
+ - docs/decisions/054-workflow-terminal-save-single-owner.md
257
+ - docs/decisions/055-terminal-observer-failure-settlement.md
258
+ - docs/decisions/056-workflow-terminal-policy-ownership.md
259
+ - docs/decisions/057-storage-transaction-boundaries.md
260
+ - docs/decisions/058-neutral-storage-primitives.md
261
+ - docs/decisions/059-backend-contracts-and-async-clients.md
262
+ - docs/decisions/060-runtime-settings-and-application-configuration.md
263
+ - docs/decisions/061-persistence-failure-contracts.md
264
+ - docs/decisions/062-content-store-service.md
265
+ - docs/decisions/063-execution-contracts-and-services.md
266
+ - docs/decisions/064-agent-execution-and-multi-agent-responsibility.md
267
+ - docs/decisions/065-vector-and-embeddings-common-operations.md
268
+ - docs/decisions/066-llm-and-tool-operation-contracts.md
269
+ - docs/decisions/067-agent-progress-and-engine-connection.md
270
+ - docs/decisions/068-agent-tool-child-progress-and-tool-operation.md
172
271
  - docs/decisions/README.md
173
272
  - docs/design/durable-semantic-coordination/CHANGELOG_V2_REVISION_2.md
174
273
  - docs/design/durable-semantic-coordination/CONTINUATION_DECISION_REFACTOR.md
@@ -176,6 +275,7 @@ files:
176
275
  - docs/design/durable-semantic-coordination/IMPLEMENTATION_REPORT.md
177
276
  - docs/design/durable-semantic-coordination/RECOVERY_CONTRACT_CLARIFICATIONS.md
178
277
  - docs/design/durable-semantic-coordination/RESPONSIBILITY_BOUNDARY_REVIEW.md
278
+ - docs/execution-boundaries-preview.md
179
279
  - docs/features.md
180
280
  - docs/getting-started.md
181
281
  - docs/mcp-client.md
@@ -184,142 +284,305 @@ files:
184
284
  - docs/migrations/0.19.md
185
285
  - docs/migrations/0.22.md
186
286
  - docs/migrations/durable-semantic-coordination-v2.md
287
+ - docs/migrations/handoff-runner-multi-agent.md
288
+ - docs/migrations/neutral-storage-spi.md
289
+ - docs/migrations/parallel-tool-chat-removal.md
290
+ - docs/migrations/persistence-failure-contracts.md
291
+ - docs/migrations/r8-unit10.md
292
+ - docs/migrations/r8-unit11.md
293
+ - docs/migrations/r8-unit12.md
294
+ - docs/migrations/r8-unit13.md
295
+ - docs/migrations/r8-unit14.md
296
+ - docs/migrations/r8-unit15.md
297
+ - docs/migrations/r8-unit16.md
298
+ - docs/migrations/r8-unit17.md
299
+ - docs/migrations/r8-unit18.md
300
+ - docs/migrations/r8-unit19.md
301
+ - docs/migrations/r8-unit20.md
302
+ - docs/migrations/r8-unit21.md
303
+ - docs/migrations/r8-unit22.md
304
+ - docs/migrations/r8-unit23.md
305
+ - docs/migrations/r8-unit4.md
306
+ - docs/migrations/r8-unit5.md
307
+ - docs/migrations/r8-unit6.md
308
+ - docs/migrations/r8-unit7.md
309
+ - docs/migrations/r8-unit8.md
310
+ - docs/migrations/r8-unit9.md
311
+ - docs/migrations/shared-state-multi-agent.md
312
+ - docs/migrations/storage-async-client.md
313
+ - docs/migrations/storage-backend-composition.md
314
+ - docs/migrations/storage-transaction-boundaries.md
315
+ - docs/migrations/vector-async-clients.md
187
316
  - docs/persistence-backends.md
188
317
  - docs/runtime-and-concurrency.md
189
318
  - examples/README.md
190
319
  - gemfiles/mcp_1_0.gemfile
191
320
  - 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
321
+ - lib/phronomy/agent/admission.rb
322
+ - lib/phronomy/agent/agent_already_exists_error.rb
323
+ - lib/phronomy/agent/agent_busy_error.rb
324
+ - lib/phronomy/agent/agent_purged_error.rb
325
+ - lib/phronomy/agent/api/agent.rb
326
+ - lib/phronomy/agent/api/execution_rehydration_required_error.rb
198
327
  - lib/phronomy/agent/async_event_api.rb
199
328
  - lib/phronomy/agent/base.rb
200
- - lib/phronomy/agent/concerns/before_llm_input.rb
201
- - lib/phronomy/agent/concerns/error_translation.rb
202
- - lib/phronomy/agent/concerns/filterable.rb
203
- - lib/phronomy/agent/context/capability/base.rb
204
- - lib/phronomy/agent/context/instruction/prompt_template.rb
205
- - lib/phronomy/agent/context_assembler.rb
329
+ - lib/phronomy/agent/before_llm_input.rb
330
+ - lib/phronomy/agent/composition/run_once.rb
206
331
  - lib/phronomy/agent/context_candidate_resolver.rb
207
332
  - lib/phronomy/agent/context_importer.rb
208
- - 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
- - 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
243
- - lib/phronomy/agent/selection/candidate.rb
244
- - 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
333
+ - lib/phronomy/agent/context_preparation.rb
334
+ - lib/phronomy/agent/control_request.rb
335
+ - lib/phronomy/agent/execution/agent_execution.rb
336
+ - lib/phronomy/agent/execution/agent_invocation.rb
337
+ - lib/phronomy/agent/execution/approval_resume_commit.rb
338
+ - lib/phronomy/agent/execution/dispatch_preparation.rb
339
+ - lib/phronomy/agent/execution/exact_execution.rb
340
+ - lib/phronomy/agent/execution/execution_cancellation.rb
341
+ - lib/phronomy/agent/execution/execution_coordinator.rb
342
+ - lib/phronomy/agent/execution/execution_failure.rb
343
+ - lib/phronomy/agent/execution/execution_metadata.rb
344
+ - lib/phronomy/agent/execution/execution_outcome_committer.rb
345
+ - lib/phronomy/agent/execution/execution_registry.rb
346
+ - lib/phronomy/agent/execution/execution_session_runner.rb
347
+ - lib/phronomy/agent/execution/initial_preparation.rb
348
+ - lib/phronomy/agent/execution/invocation_actions.rb
349
+ - lib/phronomy/agent/execution/invocation_transitions.rb
350
+ - lib/phronomy/agent/execution/llm_operation_result.rb
351
+ - lib/phronomy/agent/execution/runtime_record_encoder.rb
352
+ - lib/phronomy/agent/execution_change.rb
353
+ - lib/phronomy/agent/execution_environment.rb
354
+ - lib/phronomy/agent/execution_extension_state.rb
355
+ - lib/phronomy/agent/execution_observation.rb
356
+ - lib/phronomy/agent/filterable.rb
357
+ - lib/phronomy/agent/handoff/transfer_context.rb
358
+ - lib/phronomy/agent/handoff/transfer_projection.rb
359
+ - lib/phronomy/agent/handoff_error.rb
360
+ - lib/phronomy/agent/journal/journal_projection.rb
361
+ - lib/phronomy/agent/journal/journal_record.rb
362
+ - lib/phronomy/agent/journal/llm_call_record.rb
363
+ - lib/phronomy/agent/knowledge_item.rb
364
+ - lib/phronomy/agent/lifecycle/agent_root.rb
365
+ - lib/phronomy/agent/lifecycle/default_persistence.rb
366
+ - lib/phronomy/agent/lifecycle/ownership_registry.rb
367
+ - lib/phronomy/agent/persistence/agent_repository.rb
368
+ - lib/phronomy/agent/persistence/cancellation_repository.rb
369
+ - lib/phronomy/agent/persistence/codec.rb
370
+ - lib/phronomy/agent/persistence/execution_repository.rb
371
+ - lib/phronomy/agent/persistence/journal_repository.rb
372
+ - lib/phronomy/agent/persistence/records.rb
373
+ - lib/phronomy/agent/persistence/retention_repository.rb
374
+ - lib/phronomy/agent/persistence/storage_schema.rb
375
+ - lib/phronomy/agent/persistence/watermark.rb
376
+ - lib/phronomy/agent/recovery/invocation_restorer.rb
377
+ - lib/phronomy/agent/recovery/recovery_coordinator.rb
378
+ - lib/phronomy/agent/recovery/recovery_coordinator/continuation.rb
379
+ - lib/phronomy/agent/recovery/recovery_coordinator/installation.rb
380
+ - lib/phronomy/agent/recovery/recovery_coordinator/resolution.rb
381
+ - lib/phronomy/agent/recovery/recovery_rules.rb
382
+ - lib/phronomy/agent/recovery/recovery_support.rb
383
+ - lib/phronomy/agent/reserved_execution.rb
384
+ - lib/phronomy/agent/retention.rb
385
+ - lib/phronomy/agent/runtime_binding/engine_environment.rb
386
+ - lib/phronomy/agent/runtime_binding/engine_session_builder.rb
387
+ - lib/phronomy/agent/runtime_binding/phase_machine_builder.rb
388
+ - lib/phronomy/agent/runtime_binding/tool_session_builder.rb
389
+ - lib/phronomy/agent/runtime_input.rb
390
+ - lib/phronomy/agent/saved_context_reader.rb
391
+ - lib/phronomy/agent/settings.rb
392
+ - lib/phronomy/agent/state_writer.rb
393
+ - lib/phronomy/agent/store.rb
394
+ - lib/phronomy/agent/stream_callback_error.rb
395
+ - lib/phronomy/agent/tool_execution/approval_evaluation_request.rb
396
+ - lib/phronomy/agent/tool_execution/tool_approval_request.rb
397
+ - lib/phronomy/agent/tool_execution/tool_binding.rb
398
+ - lib/phronomy/agent/tool_execution/tool_invocation.rb
399
+ - lib/phronomy/agent/tool_execution/tool_invocation_actions.rb
400
+ - lib/phronomy/agent/tool_execution/tool_invocation_transitions.rb
401
+ - lib/phronomy/common/canonical_json.rb
402
+ - lib/phronomy/common/configuration_error.rb
403
+ - lib/phronomy/common/error.rb
404
+ - lib/phronomy/common/values/immutable.rb
405
+ - lib/phronomy/common/values/serializable.rb
406
+ - lib/phronomy/configuration/runtime_settings.rb
259
407
  - lib/phronomy/content_store/base.rb
260
- - lib/phronomy/context_budget_exceeded_error.rb
261
- - lib/phronomy/diagnostics.rb
408
+ - lib/phronomy/content_store/storage_schema.rb
409
+ - lib/phronomy/content_store/stored_contents.rb
410
+ - lib/phronomy/context/assembly.rb
411
+ - lib/phronomy/context/budget_exceeded_error.rb
412
+ - lib/phronomy/context/candidate.rb
413
+ - lib/phronomy/context/constraint.rb
414
+ - lib/phronomy/context/context_plan.rb
415
+ - lib/phronomy/context/context_plan_validator.rb
416
+ - lib/phronomy/context/context_policy.rb
417
+ - lib/phronomy/context/context_policy_input.rb
418
+ - lib/phronomy/context/context_policy_input_builder.rb
419
+ - lib/phronomy/context/default_policy.rb
420
+ - lib/phronomy/context/final_budget_validator.rb
421
+ - lib/phronomy/context/llm_input_build_context.rb
422
+ - lib/phronomy/context/llm_input_manifest.rb
423
+ - lib/phronomy/context/llm_input_patch.rb
424
+ - lib/phronomy/context/manifest_error.rb
425
+ - lib/phronomy/context/prompt_template.rb
426
+ - lib/phronomy/documents/loader/base.rb
427
+ - lib/phronomy/documents/loader/csv_loader.rb
428
+ - lib/phronomy/documents/loader/markdown_loader.rb
429
+ - lib/phronomy/documents/loader/plain_text_loader.rb
430
+ - lib/phronomy/documents/splitter/base.rb
431
+ - lib/phronomy/documents/splitter/fixed_size_splitter.rb
432
+ - lib/phronomy/documents/splitter/recursive_splitter.rb
433
+ - lib/phronomy/embeddings/async/async_client.rb
434
+ - lib/phronomy/embeddings/backends/ruby_llm_embeddings.rb
435
+ - lib/phronomy/embeddings/base.rb
436
+ - lib/phronomy/embeddings/invalid_result_error.rb
437
+ - lib/phronomy/embeddings/transport_error.rb
262
438
  - lib/phronomy/engine/concurrency/async_queue.rb
263
- - lib/phronomy/engine/concurrency/cancellation_scope.rb
264
- - lib/phronomy/engine/concurrency/cancellation_token.rb
265
- - lib/phronomy/engine/concurrency/deadline.rb
266
439
  - lib/phronomy/engine/concurrency/offload_pool.rb
267
- - lib/phronomy/engine/concurrency/operation_binding.rb
268
- - lib/phronomy/engine/concurrency/physical_completion_task.rb
269
440
  - lib/phronomy/engine/concurrency/pool_registry.rb
270
- - lib/phronomy/engine/concurrency/result_collector.rb
271
- - lib/phronomy/engine/concurrency/result_composition.rb
272
- - lib/phronomy/engine/concurrency/subscriptions.rb
441
+ - lib/phronomy/engine/diagnostics.rb
442
+ - lib/phronomy/engine/event.rb
273
443
  - lib/phronomy/engine/event_loop.rb
444
+ - lib/phronomy/engine/execution_binding.rb
445
+ - lib/phronomy/engine/execution_receiver_binding.rb
446
+ - lib/phronomy/engine/fsm_protocol.rb
274
447
  - lib/phronomy/engine/fsm_session.rb
448
+ - lib/phronomy/engine/metrics.rb
275
449
  - lib/phronomy/engine/runtime.rb
276
- - lib/phronomy/engine/runtime/agent_ownership_registry.rb
277
450
  - lib/phronomy/engine/runtime/shutdown_result.rb
278
- - lib/phronomy/engine/runtime/team_ownership_registry.rb
279
451
  - lib/phronomy/engine/runtime/timer_queue.rb
280
452
  - lib/phronomy/engine/runtime/timer_service.rb
281
- - 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
453
+ - lib/phronomy/engine/terminal_decision.rb
454
+ - lib/phronomy/execution/async_operation.rb
455
+ - lib/phronomy/execution/backpressure_error.rb
456
+ - lib/phronomy/execution/blocking.rb
457
+ - lib/phronomy/execution/cancellation_error.rb
458
+ - lib/phronomy/execution/concurrency/cancellation_token.rb
459
+ - lib/phronomy/execution/concurrency/deadline.rb
460
+ - lib/phronomy/execution/concurrency/physical_completion_task.rb
461
+ - lib/phronomy/execution/concurrency/result_collector.rb
462
+ - lib/phronomy/execution/concurrency/result_composition.rb
463
+ - lib/phronomy/execution/concurrency/result_subscriptions.rb
464
+ - lib/phronomy/execution/concurrency/subscriptions.rb
465
+ - lib/phronomy/execution/concurrency/worker_input_restricted.rb
466
+ - lib/phronomy/execution/event_loop_reentrancy_error.rb
467
+ - lib/phronomy/execution/execution.rb
468
+ - lib/phronomy/execution/execution_cancellation_error.rb
469
+ - lib/phronomy/execution/execution_receiver.rb
470
+ - lib/phronomy/execution/execution_scope_state.rb
471
+ - lib/phronomy/execution/execution_timeout_error.rb
472
+ - lib/phronomy/execution/invalid_async_entry_action_error.rb
473
+ - lib/phronomy/execution/invalid_async_transition_action_error.rb
474
+ - lib/phronomy/execution/invalid_async_workflow_action_error.rb
475
+ - lib/phronomy/execution/invocation_context.rb
476
+ - lib/phronomy/execution/invocation_controls.rb
477
+ - lib/phronomy/execution/pool_shutdown_error.rb
478
+ - lib/phronomy/execution/recursion_limit_error.rb
479
+ - lib/phronomy/execution/runnable.rb
480
+ - lib/phronomy/execution/runtime_shutdown_error.rb
481
+ - lib/phronomy/execution/runtime_shutdown_reentrancy_error.rb
482
+ - lib/phronomy/execution/scheduler_reentrancy_error.rb
483
+ - lib/phronomy/execution/task_result.rb
484
+ - lib/phronomy/execution/timeout_error.rb
485
+ - lib/phronomy/execution/wait_policy.rb
287
486
  - lib/phronomy/filter.rb
288
487
  - lib/phronomy/filter/base.rb
488
+ - lib/phronomy/filter/filter_block_error.rb
289
489
  - 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
490
+ - lib/phronomy/generation/generator_verifier.rb
491
+ - lib/phronomy/generation/generator_verifier/agent_operation.rb
492
+ - lib/phronomy/generation/generator_verifier/agent_result_receiver.rb
493
+ - lib/phronomy/generation/generator_verifier/default_parser.rb
494
+ - lib/phronomy/generation/generator_verifier/pipeline_state.rb
495
+ - lib/phronomy/generation/generator_verifier/workflow_builder.rb
496
+ - lib/phronomy/generation/low_confidence_error.rb
296
497
  - lib/phronomy/llm_adapter.rb
498
+ - lib/phronomy/llm_adapter/async/async_client.rb
499
+ - lib/phronomy/llm_adapter/authentication_error.rb
500
+ - lib/phronomy/llm_adapter/backends/ruby_llm.rb
297
501
  - lib/phronomy/llm_adapter/base.rb
298
- - lib/phronomy/llm_adapter/ruby_llm.rb
502
+ - lib/phronomy/llm_adapter/context_length_error.rb
503
+ - lib/phronomy/llm_adapter/invalid_result_error.rb
504
+ - lib/phronomy/llm_adapter/message.rb
505
+ - lib/phronomy/llm_adapter/rate_limit_error.rb
506
+ - lib/phronomy/llm_adapter/request.rb
507
+ - lib/phronomy/llm_adapter/response.rb
508
+ - lib/phronomy/llm_adapter/stream_chunk.rb
509
+ - lib/phronomy/llm_adapter/token_usage.rb
510
+ - lib/phronomy/llm_adapter/transport_error.rb
299
511
  - lib/phronomy/llm_context_window/token_budget.rb
300
512
  - lib/phronomy/llm_context_window/token_estimator.rb
301
- - lib/phronomy/metrics.rb
302
513
  - lib/phronomy/multi_agent/admission_registry.rb
303
514
  - lib/phronomy/multi_agent/durable_subagent_coordinator.rb
515
+ - lib/phronomy/multi_agent/execution_environment.rb
516
+ - lib/phronomy/multi_agent/handoff.rb
517
+ - lib/phronomy/multi_agent/handoff_capability_factory.rb
518
+ - lib/phronomy/multi_agent/handoff_participant.rb
519
+ - lib/phronomy/multi_agent/handoff_policy.rb
520
+ - lib/phronomy/multi_agent/handoff_runner.rb
521
+ - lib/phronomy/multi_agent/handoff_state.rb
304
522
  - lib/phronomy/multi_agent/orchestrator.rb
305
- - lib/phronomy/multi_agent/parallel_tool_chat.rb
523
+ - lib/phronomy/multi_agent/persistence/codec.rb
524
+ - lib/phronomy/multi_agent/persistence/handoff_state_repository.rb
525
+ - lib/phronomy/multi_agent/persistence/records.rb
526
+ - lib/phronomy/multi_agent/persistence/storage_schema.rb
527
+ - lib/phronomy/multi_agent/persistence/team_execution_repository.rb
528
+ - lib/phronomy/multi_agent/persistence/team_repository.rb
529
+ - lib/phronomy/multi_agent/reserved_child_admission.rb
530
+ - lib/phronomy/multi_agent/runtime_binding/engine_environment.rb
531
+ - lib/phronomy/multi_agent/shared_state.rb
532
+ - lib/phronomy/multi_agent/store.rb
306
533
  - lib/phronomy/multi_agent/team_coordinator.rb
307
534
  - lib/phronomy/multi_agent/team_execution.rb
535
+ - lib/phronomy/multi_agent/team_ownership_registry.rb
308
536
  - lib/phronomy/multi_agent/team_root.rb
309
537
  - lib/phronomy/output_parser.rb
310
538
  - lib/phronomy/output_parser/base.rb
311
539
  - lib/phronomy/output_parser/json_parser.rb
540
+ - lib/phronomy/output_parser/parse_error.rb
312
541
  - 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
542
+ - lib/phronomy/persistence/content_repository.rb
543
+ - lib/phronomy/persistence/errors.rb
317
544
  - 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
545
+ - lib/phronomy/persistence/persistence.rb
546
+ - lib/phronomy/persistence/save_outcome.rb
547
+ - lib/phronomy/persistence/snapshot_comparison.rb
548
+ - lib/phronomy/persistence/storage_boundary.rb
549
+ - lib/phronomy/persistence/transaction.rb
550
+ - lib/phronomy/persistence_composition/storage_schema.rb
551
+ - lib/phronomy/persistence_composition/stores.rb
552
+ - lib/phronomy/persistence_composition/unit4_migration.rb
553
+ - lib/phronomy/runtime_composition/agent_defaults.rb
554
+ - lib/phronomy/runtime_composition/configuration.rb
555
+ - lib/phronomy/runtime_composition/configuration_defaults.rb
556
+ - lib/phronomy/runtime_composition/evaluation_defaults.rb
557
+ - lib/phronomy/runtime_composition/execution_defaults.rb
558
+ - lib/phronomy/runtime_composition/generation_defaults.rb
559
+ - lib/phronomy/runtime_composition/global_configuration.rb
560
+ - lib/phronomy/runtime_composition/global_runtime.rb
561
+ - lib/phronomy/runtime_composition/multi_agent_defaults.rb
562
+ - lib/phronomy/runtime_composition/workflow_defaults.rb
563
+ - lib/phronomy/storage/async/async_client.rb
564
+ - lib/phronomy/storage/backend.rb
565
+ - lib/phronomy/storage/backends/in_memory.rb
566
+ - lib/phronomy/storage/blob_conflict_error.rb
567
+ - lib/phronomy/storage/blobs.rb
568
+ - lib/phronomy/storage/condition.rb
569
+ - lib/phronomy/storage/condition_failed_error.rb
570
+ - lib/phronomy/storage/conflict_error.rb
571
+ - lib/phronomy/storage/durable_record.rb
572
+ - lib/phronomy/storage/entry.rb
573
+ - lib/phronomy/storage/guard_ref.rb
574
+ - lib/phronomy/storage/not_found_error.rb
575
+ - lib/phronomy/storage/record_codec.rb
576
+ - lib/phronomy/storage/records.rb
577
+ - lib/phronomy/storage/resource.rb
578
+ - lib/phronomy/storage/scope.rb
579
+ - lib/phronomy/storage/serialization_error.rb
580
+ - lib/phronomy/storage/streams.rb
581
+ - lib/phronomy/storage/transaction_error.rb
582
+ - lib/phronomy/storage/unique_constraint_error.rb
583
+ - lib/phronomy/storage/unsupported_backend_error.rb
584
+ - lib/phronomy/storage/validation.rb
585
+ - lib/phronomy/storage/view.rb
323
586
  - lib/phronomy/testing.rb
324
587
  - lib/phronomy/testing/eval.rb
325
588
  - lib/phronomy/testing/eval/comparison.rb
@@ -342,9 +605,18 @@ files:
342
605
  - lib/phronomy/testing/persistence_contract/an_agent_repository.rb
343
606
  - lib/phronomy/testing/persistence_contract/an_execution_repository.rb
344
607
  - lib/phronomy/testing/persistence_contract/coordination_repositories.rb
345
- - lib/phronomy/token_usage.rb
608
+ - lib/phronomy/testing/persistence_contract/neutral_storage_primitives.rb
609
+ - lib/phronomy/testing/persistence_contract/storage_transaction_boundaries.rb
346
610
  - lib/phronomy/tool.rb
611
+ - lib/phronomy/tool/authorization.rb
347
612
  - lib/phronomy/tool/base.rb
613
+ - lib/phronomy/tool/call_request.rb
614
+ - lib/phronomy/tool/definition_set.rb
615
+ - lib/phronomy/tool/operation.rb
616
+ - lib/phronomy/tool/schema.rb
617
+ - lib/phronomy/tool/settings.rb
618
+ - lib/phronomy/tool/tool_error.rb
619
+ - lib/phronomy/tool/tool_executor.rb
348
620
  - lib/phronomy/tools/agent.rb
349
621
  - lib/phronomy/tools/mcp.rb
350
622
  - lib/phronomy/tools/vector_search.rb
@@ -353,28 +625,32 @@ files:
353
625
  - lib/phronomy/tracing/base.rb
354
626
  - lib/phronomy/tracing/langfuse_tracer.rb
355
627
  - lib/phronomy/tracing/null_tracer.rb
628
+ - lib/phronomy/tracing/observation.rb
356
629
  - lib/phronomy/tracing/open_telemetry_tracer.rb
630
+ - lib/phronomy/tracing/settings.rb
357
631
  - lib/phronomy/vector_store.rb
358
- - lib/phronomy/vector_store/async_backend.rb
632
+ - lib/phronomy/vector_store/async/async_client.rb
633
+ - lib/phronomy/vector_store/backends/in_memory.rb
634
+ - lib/phronomy/vector_store/backends/pgvector.rb
635
+ - lib/phronomy/vector_store/backends/redis_search.rb
359
636
  - lib/phronomy/vector_store/base.rb
360
- - lib/phronomy/vector_store/embeddings/base.rb
361
- - lib/phronomy/vector_store/embeddings/ruby_llm_embeddings.rb
362
- - lib/phronomy/vector_store/in_memory.rb
363
- - lib/phronomy/vector_store/loader/base.rb
364
- - lib/phronomy/vector_store/loader/csv_loader.rb
365
- - lib/phronomy/vector_store/loader/markdown_loader.rb
366
- - lib/phronomy/vector_store/loader/plain_text_loader.rb
367
- - lib/phronomy/vector_store/pgvector.rb
368
- - lib/phronomy/vector_store/redis_search.rb
369
- - lib/phronomy/vector_store/splitter/base.rb
370
- - lib/phronomy/vector_store/splitter/fixed_size_splitter.rb
371
- - lib/phronomy/vector_store/splitter/recursive_splitter.rb
637
+ - lib/phronomy/vector_store/invalid_result_error.rb
372
638
  - lib/phronomy/version.rb
373
- - lib/phronomy/workflow.rb
374
- - 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
639
+ - lib/phronomy/workflow/completion.rb
640
+ - lib/phronomy/workflow/execution/workflow.rb
641
+ - lib/phronomy/workflow/execution/workflow_action_rules.rb
642
+ - lib/phronomy/workflow/execution/workflow_context.rb
643
+ - lib/phronomy/workflow/execution/workflow_context_ownership_error.rb
644
+ - lib/phronomy/workflow/execution/workflow_execution_environment.rb
645
+ - lib/phronomy/workflow/execution/workflow_execution_registry.rb
646
+ - lib/phronomy/workflow/execution/workflow_runner.rb
647
+ - lib/phronomy/workflow/execution/workflow_settings.rb
648
+ - lib/phronomy/workflow/persistence/codec.rb
649
+ - lib/phronomy/workflow/persistence/state_repository.rb
650
+ - lib/phronomy/workflow/persistence/storage_schema.rb
651
+ - lib/phronomy/workflow/runtime_binding/workflow_engine_environment.rb
652
+ - lib/phronomy/workflow/runtime_binding/workflow_phase_machine_builder.rb
653
+ - lib/phronomy/workflow/runtime_binding/workflow_terminal_policy.rb
378
654
  - scripts/add_to_h_to_token_doubles.rb
379
655
  - scripts/add_to_h_unnamed_doubles.rb
380
656
  - scripts/api_snapshot.rb
@@ -385,16 +661,72 @@ files:
385
661
  - scripts/migrate_spec_agent_definition_pass2.rb
386
662
  - scripts/migrate_spec_inline_pass3.rb
387
663
  - scripts/run_mutation.sh
664
+ - scripts/storage_spi_snapshot.rb
665
+ - sig/_private/phronomy/agent/settings.rbs
666
+ - sig/_private/phronomy/configuration/runtime_settings.rbs
667
+ - sig/_private/phronomy/llm_adapter/async/async_client.rbs
668
+ - sig/_private/phronomy/multi_agent/store.rbs
669
+ - sig/_private/phronomy/persistence/storage_boundary.rbs
670
+ - sig/_private/phronomy/tool/settings.rbs
671
+ - sig/_private/phronomy/tracing/settings.rbs
672
+ - sig/_private/phronomy/workflow/execution/workflow_settings.rbs
388
673
  - sig/phronomy.rbs
389
674
  - sig/phronomy/agent.rbs
675
+ - sig/phronomy/agent/admission.rbs
676
+ - sig/phronomy/agent/execution_contract.rbs
677
+ - sig/phronomy/agent/execution_environment.rbs
678
+ - sig/phronomy/agent/store.rbs
679
+ - sig/phronomy/common.rbs
680
+ - sig/phronomy/content_store/contracts.rbs
681
+ - sig/phronomy/context.rbs
682
+ - sig/phronomy/embeddings/async/async_client.rbs
683
+ - sig/phronomy/embeddings/base.rbs
684
+ - sig/phronomy/engine/concurrency/timer_bindings.rbs
685
+ - sig/phronomy/engine/control_bindings.rbs
686
+ - sig/phronomy/engine/control_protocols.rbs
687
+ - sig/phronomy/engine/execution_binding.rbs
688
+ - sig/phronomy/engine/execution_receiver.rbs
689
+ - sig/phronomy/engine/observability.rbs
690
+ - sig/phronomy/execution/async_operation.rbs
691
+ - sig/phronomy/execution/blocking.rbs
692
+ - sig/phronomy/execution/concurrency/cancellation_token.rbs
693
+ - sig/phronomy/execution/concurrency/deadline.rbs
694
+ - sig/phronomy/execution/concurrency/result_composition.rbs
695
+ - sig/phronomy/execution/control_protocols.rbs
696
+ - sig/phronomy/execution/errors.rbs
697
+ - sig/phronomy/execution/execution.rbs
698
+ - sig/phronomy/execution/execution_receiver.rbs
699
+ - sig/phronomy/execution/execution_scope_state.rbs
700
+ - sig/phronomy/execution/invocation_context.rbs
701
+ - sig/phronomy/execution/invocation_controls.rbs
702
+ - sig/phronomy/execution/task_result.rbs
390
703
  - sig/phronomy/extensions.rbs
391
704
  - sig/phronomy/handoff.rbs
392
- - sig/phronomy/llm_adapter.rbs
705
+ - sig/phronomy/llm_adapter/backends/ruby_llm.rbs
706
+ - sig/phronomy/llm_adapter/base.rbs
707
+ - sig/phronomy/llm_adapter/usage.rbs
708
+ - sig/phronomy/llm_adapter/values.rbs
709
+ - sig/phronomy/llm_context_window.rbs
393
710
  - sig/phronomy/multi_agent.rbs
711
+ - sig/phronomy/multi_agent/reserved_child_admission.rbs
712
+ - sig/phronomy/multi_agent/store.rbs
394
713
  - sig/phronomy/persistence.rbs
395
- - sig/phronomy/runtime.rbs
714
+ - sig/phronomy/persistence/errors.rbs
715
+ - sig/phronomy/persistence/migration.rbs
716
+ - sig/phronomy/persistence/transaction.rbs
717
+ - sig/phronomy/persistence_composition.rbs
718
+ - sig/phronomy/runtime_composition/configuration.rbs
719
+ - sig/phronomy/storage/async/async_client.rbs
720
+ - sig/phronomy/storage/backends/in_memory.rbs
721
+ - sig/phronomy/storage/contracts.rbs
396
722
  - sig/phronomy/tool.rbs
723
+ - sig/phronomy/tracing/observation.rbs
724
+ - sig/phronomy/vector_store/async/async_client.rbs
725
+ - sig/phronomy/vector_store/base.rbs
397
726
  - sig/phronomy/workflow.rbs
727
+ - sig/phronomy/workflow/execution/workflow_execution_environment.rbs
728
+ - sig/phronomy/workflow/runtime_binding/workflow_terminal_policy.rbs
729
+ - sig/phronomy/workflow/store.rbs
398
730
  homepage: https://github.com/Raizo-TCS/phronomy
399
731
  licenses:
400
732
  - MIT