durable_workflow 0.1.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 (116) hide show
  1. checksums.yaml +7 -0
  2. data/.claude/todo/01.amend.md +133 -0
  3. data/.claude/todo/02.amend.md +444 -0
  4. data/.claude/todo/phase-1-core/01-GEMSPEC.md +193 -0
  5. data/.claude/todo/phase-1-core/02-TYPES.md +462 -0
  6. data/.claude/todo/phase-1-core/03-EXECUTION.md +551 -0
  7. data/.claude/todo/phase-1-core/04-STEPS.md +603 -0
  8. data/.claude/todo/phase-1-core/05-PARSER.md +719 -0
  9. data/.claude/todo/phase-1-core/todo.md +574 -0
  10. data/.claude/todo/phase-2-runtime/01-STORAGE.md +641 -0
  11. data/.claude/todo/phase-2-runtime/02-RUNNERS.md +511 -0
  12. data/.claude/todo/phase-3-extensions/01-EXTENSION-SYSTEM.md +298 -0
  13. data/.claude/todo/phase-3-extensions/02-AI-PLUGIN.md +936 -0
  14. data/.claude/todo/phase-3-extensions/todo.md +262 -0
  15. data/.claude/todo/phase-4-ai-rework/01-DEPENDENCIES.md +107 -0
  16. data/.claude/todo/phase-4-ai-rework/02-CONFIGURATION.md +123 -0
  17. data/.claude/todo/phase-4-ai-rework/03-TOOL-REGISTRY.md +237 -0
  18. data/.claude/todo/phase-4-ai-rework/04-MCP-SERVER.md +432 -0
  19. data/.claude/todo/phase-4-ai-rework/05-MCP-CLIENT.md +333 -0
  20. data/.claude/todo/phase-4-ai-rework/06-EXECUTORS.md +397 -0
  21. data/.claude/todo/phase-4-ai-rework/todo.md +265 -0
  22. data/.claude/todo/phase-5-validation/.DS_Store +0 -0
  23. data/.claude/todo/phase-5-validation/01-TEST-GAPS.md +615 -0
  24. data/.claude/todo/phase-5-validation/01-TESTS.md +2378 -0
  25. data/.claude/todo/phase-5-validation/02-EXAMPLES-SIMPLE.md +744 -0
  26. data/.claude/todo/phase-5-validation/02-EXAMPLES.md +1857 -0
  27. data/.claude/todo/phase-5-validation/03-EXAMPLE-SUPPORT-AGENT.md +95 -0
  28. data/.claude/todo/phase-5-validation/04-EXAMPLE-ORDER-FULFILLMENT.md +94 -0
  29. data/.claude/todo/phase-5-validation/05-EXAMPLE-DATA-PIPELINE.md +145 -0
  30. data/.env.example +3 -0
  31. data/.rubocop.yml +64 -0
  32. data/0.3.amend.md +89 -0
  33. data/CHANGELOG.md +5 -0
  34. data/CODE_OF_CONDUCT.md +84 -0
  35. data/Gemfile +22 -0
  36. data/Gemfile.lock +192 -0
  37. data/LICENSE.txt +21 -0
  38. data/README.md +39 -0
  39. data/Rakefile +16 -0
  40. data/durable_workflow.gemspec +43 -0
  41. data/examples/approval_request.rb +106 -0
  42. data/examples/calculator.rb +154 -0
  43. data/examples/file_search_demo.rb +77 -0
  44. data/examples/hello_workflow.rb +57 -0
  45. data/examples/item_processor.rb +96 -0
  46. data/examples/order_fulfillment/Gemfile +6 -0
  47. data/examples/order_fulfillment/README.md +84 -0
  48. data/examples/order_fulfillment/run.rb +85 -0
  49. data/examples/order_fulfillment/services.rb +146 -0
  50. data/examples/order_fulfillment/workflow.yml +188 -0
  51. data/examples/parallel_fetch.rb +102 -0
  52. data/examples/service_integration.rb +137 -0
  53. data/examples/support_agent/Gemfile +6 -0
  54. data/examples/support_agent/README.md +91 -0
  55. data/examples/support_agent/config/claude_desktop.json +12 -0
  56. data/examples/support_agent/mcp_server.rb +49 -0
  57. data/examples/support_agent/run.rb +67 -0
  58. data/examples/support_agent/services.rb +113 -0
  59. data/examples/support_agent/workflow.yml +286 -0
  60. data/lib/durable_workflow/core/condition.rb +45 -0
  61. data/lib/durable_workflow/core/engine.rb +145 -0
  62. data/lib/durable_workflow/core/executors/approval.rb +51 -0
  63. data/lib/durable_workflow/core/executors/assign.rb +18 -0
  64. data/lib/durable_workflow/core/executors/base.rb +90 -0
  65. data/lib/durable_workflow/core/executors/call.rb +76 -0
  66. data/lib/durable_workflow/core/executors/end.rb +19 -0
  67. data/lib/durable_workflow/core/executors/halt.rb +24 -0
  68. data/lib/durable_workflow/core/executors/loop.rb +118 -0
  69. data/lib/durable_workflow/core/executors/parallel.rb +77 -0
  70. data/lib/durable_workflow/core/executors/registry.rb +34 -0
  71. data/lib/durable_workflow/core/executors/router.rb +26 -0
  72. data/lib/durable_workflow/core/executors/start.rb +61 -0
  73. data/lib/durable_workflow/core/executors/transform.rb +71 -0
  74. data/lib/durable_workflow/core/executors/workflow.rb +32 -0
  75. data/lib/durable_workflow/core/parser.rb +189 -0
  76. data/lib/durable_workflow/core/resolver.rb +61 -0
  77. data/lib/durable_workflow/core/schema_validator.rb +47 -0
  78. data/lib/durable_workflow/core/types/base.rb +41 -0
  79. data/lib/durable_workflow/core/types/condition.rb +25 -0
  80. data/lib/durable_workflow/core/types/configs.rb +103 -0
  81. data/lib/durable_workflow/core/types/entry.rb +26 -0
  82. data/lib/durable_workflow/core/types/results.rb +41 -0
  83. data/lib/durable_workflow/core/types/state.rb +95 -0
  84. data/lib/durable_workflow/core/types/step_def.rb +15 -0
  85. data/lib/durable_workflow/core/types/workflow_def.rb +43 -0
  86. data/lib/durable_workflow/core/types.rb +29 -0
  87. data/lib/durable_workflow/core/validator.rb +318 -0
  88. data/lib/durable_workflow/extensions/ai/ai.rb +149 -0
  89. data/lib/durable_workflow/extensions/ai/configuration.rb +41 -0
  90. data/lib/durable_workflow/extensions/ai/executors/agent.rb +150 -0
  91. data/lib/durable_workflow/extensions/ai/executors/file_search.rb +52 -0
  92. data/lib/durable_workflow/extensions/ai/executors/guardrail.rb +152 -0
  93. data/lib/durable_workflow/extensions/ai/executors/handoff.rb +33 -0
  94. data/lib/durable_workflow/extensions/ai/executors/mcp.rb +47 -0
  95. data/lib/durable_workflow/extensions/ai/mcp/adapter.rb +73 -0
  96. data/lib/durable_workflow/extensions/ai/mcp/client.rb +77 -0
  97. data/lib/durable_workflow/extensions/ai/mcp/rack_app.rb +66 -0
  98. data/lib/durable_workflow/extensions/ai/mcp/server.rb +122 -0
  99. data/lib/durable_workflow/extensions/ai/tool_registry.rb +63 -0
  100. data/lib/durable_workflow/extensions/ai/types.rb +213 -0
  101. data/lib/durable_workflow/extensions/ai.rb +6 -0
  102. data/lib/durable_workflow/extensions/base.rb +77 -0
  103. data/lib/durable_workflow/runners/adapters/inline.rb +42 -0
  104. data/lib/durable_workflow/runners/adapters/sidekiq.rb +69 -0
  105. data/lib/durable_workflow/runners/async.rb +100 -0
  106. data/lib/durable_workflow/runners/stream.rb +126 -0
  107. data/lib/durable_workflow/runners/sync.rb +40 -0
  108. data/lib/durable_workflow/storage/active_record.rb +148 -0
  109. data/lib/durable_workflow/storage/redis.rb +133 -0
  110. data/lib/durable_workflow/storage/sequel.rb +144 -0
  111. data/lib/durable_workflow/storage/store.rb +43 -0
  112. data/lib/durable_workflow/utils.rb +25 -0
  113. data/lib/durable_workflow/version.rb +5 -0
  114. data/lib/durable_workflow.rb +70 -0
  115. data/sig/durable_workflow.rbs +4 -0
  116. metadata +275 -0
metadata ADDED
@@ -0,0 +1,275 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: durable_workflow
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.1.0
5
+ platform: ruby
6
+ authors:
7
+ - Ben
8
+ autorequire:
9
+ bindir: exe
10
+ cert_chain: []
11
+ date: 2025-11-28 00:00:00.000000000 Z
12
+ dependencies:
13
+ - !ruby/object:Gem::Dependency
14
+ name: dry-types
15
+ requirement: !ruby/object:Gem::Requirement
16
+ requirements:
17
+ - - "~>"
18
+ - !ruby/object:Gem::Version
19
+ version: '1.7'
20
+ type: :runtime
21
+ prerelease: false
22
+ version_requirements: !ruby/object:Gem::Requirement
23
+ requirements:
24
+ - - "~>"
25
+ - !ruby/object:Gem::Version
26
+ version: '1.7'
27
+ - !ruby/object:Gem::Dependency
28
+ name: dry-struct
29
+ requirement: !ruby/object:Gem::Requirement
30
+ requirements:
31
+ - - "~>"
32
+ - !ruby/object:Gem::Version
33
+ version: '1.6'
34
+ type: :runtime
35
+ prerelease: false
36
+ version_requirements: !ruby/object:Gem::Requirement
37
+ requirements:
38
+ - - "~>"
39
+ - !ruby/object:Gem::Version
40
+ version: '1.6'
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.0'
48
+ type: :runtime
49
+ prerelease: false
50
+ version_requirements: !ruby/object:Gem::Requirement
51
+ requirements:
52
+ - - "~>"
53
+ - !ruby/object:Gem::Version
54
+ version: '2.0'
55
+ - !ruby/object:Gem::Dependency
56
+ name: async
57
+ requirement: !ruby/object:Gem::Requirement
58
+ requirements:
59
+ - - "~>"
60
+ - !ruby/object:Gem::Version
61
+ version: '2.21'
62
+ type: :runtime
63
+ prerelease: false
64
+ version_requirements: !ruby/object:Gem::Requirement
65
+ requirements:
66
+ - - "~>"
67
+ - !ruby/object:Gem::Version
68
+ version: '2.21'
69
+ - !ruby/object:Gem::Dependency
70
+ name: ruby_llm
71
+ requirement: !ruby/object:Gem::Requirement
72
+ requirements:
73
+ - - "~>"
74
+ - !ruby/object:Gem::Version
75
+ version: '1.0'
76
+ type: :runtime
77
+ prerelease: false
78
+ version_requirements: !ruby/object:Gem::Requirement
79
+ requirements:
80
+ - - "~>"
81
+ - !ruby/object:Gem::Version
82
+ version: '1.0'
83
+ - !ruby/object:Gem::Dependency
84
+ name: mcp
85
+ requirement: !ruby/object:Gem::Requirement
86
+ requirements:
87
+ - - "~>"
88
+ - !ruby/object:Gem::Version
89
+ version: '0.1'
90
+ type: :runtime
91
+ prerelease: false
92
+ version_requirements: !ruby/object:Gem::Requirement
93
+ requirements:
94
+ - - "~>"
95
+ - !ruby/object:Gem::Version
96
+ version: '0.1'
97
+ - !ruby/object:Gem::Dependency
98
+ name: faraday
99
+ requirement: !ruby/object:Gem::Requirement
100
+ requirements:
101
+ - - ">="
102
+ - !ruby/object:Gem::Version
103
+ version: '2.0'
104
+ type: :runtime
105
+ prerelease: false
106
+ version_requirements: !ruby/object:Gem::Requirement
107
+ requirements:
108
+ - - ">="
109
+ - !ruby/object:Gem::Version
110
+ version: '2.0'
111
+ - !ruby/object:Gem::Dependency
112
+ name: rack
113
+ requirement: !ruby/object:Gem::Requirement
114
+ requirements:
115
+ - - ">="
116
+ - !ruby/object:Gem::Version
117
+ version: '2.0'
118
+ type: :runtime
119
+ prerelease: false
120
+ version_requirements: !ruby/object:Gem::Requirement
121
+ requirements:
122
+ - - ">="
123
+ - !ruby/object:Gem::Version
124
+ version: '2.0'
125
+ description: A workflow engine supporting loops, parallel execution, approvals, halts,
126
+ and extensible step types. Designed for durable, resumable execution with optional
127
+ AI capabilities.
128
+ email:
129
+ - ben@dee.mx
130
+ executables: []
131
+ extensions: []
132
+ extra_rdoc_files: []
133
+ files:
134
+ - ".claude/todo/01.amend.md"
135
+ - ".claude/todo/02.amend.md"
136
+ - ".claude/todo/phase-1-core/01-GEMSPEC.md"
137
+ - ".claude/todo/phase-1-core/02-TYPES.md"
138
+ - ".claude/todo/phase-1-core/03-EXECUTION.md"
139
+ - ".claude/todo/phase-1-core/04-STEPS.md"
140
+ - ".claude/todo/phase-1-core/05-PARSER.md"
141
+ - ".claude/todo/phase-1-core/todo.md"
142
+ - ".claude/todo/phase-2-runtime/01-STORAGE.md"
143
+ - ".claude/todo/phase-2-runtime/02-RUNNERS.md"
144
+ - ".claude/todo/phase-3-extensions/01-EXTENSION-SYSTEM.md"
145
+ - ".claude/todo/phase-3-extensions/02-AI-PLUGIN.md"
146
+ - ".claude/todo/phase-3-extensions/todo.md"
147
+ - ".claude/todo/phase-4-ai-rework/01-DEPENDENCIES.md"
148
+ - ".claude/todo/phase-4-ai-rework/02-CONFIGURATION.md"
149
+ - ".claude/todo/phase-4-ai-rework/03-TOOL-REGISTRY.md"
150
+ - ".claude/todo/phase-4-ai-rework/04-MCP-SERVER.md"
151
+ - ".claude/todo/phase-4-ai-rework/05-MCP-CLIENT.md"
152
+ - ".claude/todo/phase-4-ai-rework/06-EXECUTORS.md"
153
+ - ".claude/todo/phase-4-ai-rework/todo.md"
154
+ - ".claude/todo/phase-5-validation/.DS_Store"
155
+ - ".claude/todo/phase-5-validation/01-TEST-GAPS.md"
156
+ - ".claude/todo/phase-5-validation/01-TESTS.md"
157
+ - ".claude/todo/phase-5-validation/02-EXAMPLES-SIMPLE.md"
158
+ - ".claude/todo/phase-5-validation/02-EXAMPLES.md"
159
+ - ".claude/todo/phase-5-validation/03-EXAMPLE-SUPPORT-AGENT.md"
160
+ - ".claude/todo/phase-5-validation/04-EXAMPLE-ORDER-FULFILLMENT.md"
161
+ - ".claude/todo/phase-5-validation/05-EXAMPLE-DATA-PIPELINE.md"
162
+ - ".env.example"
163
+ - ".rubocop.yml"
164
+ - 0.3.amend.md
165
+ - CHANGELOG.md
166
+ - CODE_OF_CONDUCT.md
167
+ - Gemfile
168
+ - Gemfile.lock
169
+ - LICENSE.txt
170
+ - README.md
171
+ - Rakefile
172
+ - durable_workflow.gemspec
173
+ - examples/approval_request.rb
174
+ - examples/calculator.rb
175
+ - examples/file_search_demo.rb
176
+ - examples/hello_workflow.rb
177
+ - examples/item_processor.rb
178
+ - examples/order_fulfillment/Gemfile
179
+ - examples/order_fulfillment/README.md
180
+ - examples/order_fulfillment/run.rb
181
+ - examples/order_fulfillment/services.rb
182
+ - examples/order_fulfillment/workflow.yml
183
+ - examples/parallel_fetch.rb
184
+ - examples/service_integration.rb
185
+ - examples/support_agent/Gemfile
186
+ - examples/support_agent/README.md
187
+ - examples/support_agent/config/claude_desktop.json
188
+ - examples/support_agent/mcp_server.rb
189
+ - examples/support_agent/run.rb
190
+ - examples/support_agent/services.rb
191
+ - examples/support_agent/workflow.yml
192
+ - lib/durable_workflow.rb
193
+ - lib/durable_workflow/core/condition.rb
194
+ - lib/durable_workflow/core/engine.rb
195
+ - lib/durable_workflow/core/executors/approval.rb
196
+ - lib/durable_workflow/core/executors/assign.rb
197
+ - lib/durable_workflow/core/executors/base.rb
198
+ - lib/durable_workflow/core/executors/call.rb
199
+ - lib/durable_workflow/core/executors/end.rb
200
+ - lib/durable_workflow/core/executors/halt.rb
201
+ - lib/durable_workflow/core/executors/loop.rb
202
+ - lib/durable_workflow/core/executors/parallel.rb
203
+ - lib/durable_workflow/core/executors/registry.rb
204
+ - lib/durable_workflow/core/executors/router.rb
205
+ - lib/durable_workflow/core/executors/start.rb
206
+ - lib/durable_workflow/core/executors/transform.rb
207
+ - lib/durable_workflow/core/executors/workflow.rb
208
+ - lib/durable_workflow/core/parser.rb
209
+ - lib/durable_workflow/core/resolver.rb
210
+ - lib/durable_workflow/core/schema_validator.rb
211
+ - lib/durable_workflow/core/types.rb
212
+ - lib/durable_workflow/core/types/base.rb
213
+ - lib/durable_workflow/core/types/condition.rb
214
+ - lib/durable_workflow/core/types/configs.rb
215
+ - lib/durable_workflow/core/types/entry.rb
216
+ - lib/durable_workflow/core/types/results.rb
217
+ - lib/durable_workflow/core/types/state.rb
218
+ - lib/durable_workflow/core/types/step_def.rb
219
+ - lib/durable_workflow/core/types/workflow_def.rb
220
+ - lib/durable_workflow/core/validator.rb
221
+ - lib/durable_workflow/extensions/ai.rb
222
+ - lib/durable_workflow/extensions/ai/ai.rb
223
+ - lib/durable_workflow/extensions/ai/configuration.rb
224
+ - lib/durable_workflow/extensions/ai/executors/agent.rb
225
+ - lib/durable_workflow/extensions/ai/executors/file_search.rb
226
+ - lib/durable_workflow/extensions/ai/executors/guardrail.rb
227
+ - lib/durable_workflow/extensions/ai/executors/handoff.rb
228
+ - lib/durable_workflow/extensions/ai/executors/mcp.rb
229
+ - lib/durable_workflow/extensions/ai/mcp/adapter.rb
230
+ - lib/durable_workflow/extensions/ai/mcp/client.rb
231
+ - lib/durable_workflow/extensions/ai/mcp/rack_app.rb
232
+ - lib/durable_workflow/extensions/ai/mcp/server.rb
233
+ - lib/durable_workflow/extensions/ai/tool_registry.rb
234
+ - lib/durable_workflow/extensions/ai/types.rb
235
+ - lib/durable_workflow/extensions/base.rb
236
+ - lib/durable_workflow/runners/adapters/inline.rb
237
+ - lib/durable_workflow/runners/adapters/sidekiq.rb
238
+ - lib/durable_workflow/runners/async.rb
239
+ - lib/durable_workflow/runners/stream.rb
240
+ - lib/durable_workflow/runners/sync.rb
241
+ - lib/durable_workflow/storage/active_record.rb
242
+ - lib/durable_workflow/storage/redis.rb
243
+ - lib/durable_workflow/storage/sequel.rb
244
+ - lib/durable_workflow/storage/store.rb
245
+ - lib/durable_workflow/utils.rb
246
+ - lib/durable_workflow/version.rb
247
+ - sig/durable_workflow.rbs
248
+ homepage: https://github.com/your-org/durable_workflow
249
+ licenses:
250
+ - MIT
251
+ metadata:
252
+ homepage_uri: https://github.com/your-org/durable_workflow
253
+ source_code_uri: https://github.com/your-org/durable_workflow
254
+ changelog_uri: https://github.com/your-org/durable_workflow/blob/main/CHANGELOG.md
255
+ rubygems_mfa_required: 'true'
256
+ post_install_message:
257
+ rdoc_options: []
258
+ require_paths:
259
+ - lib
260
+ required_ruby_version: !ruby/object:Gem::Requirement
261
+ requirements:
262
+ - - ">="
263
+ - !ruby/object:Gem::Version
264
+ version: 3.1.0
265
+ required_rubygems_version: !ruby/object:Gem::Requirement
266
+ requirements:
267
+ - - ">="
268
+ - !ruby/object:Gem::Version
269
+ version: '0'
270
+ requirements: []
271
+ rubygems_version: 3.4.19
272
+ signing_key:
273
+ specification_version: 4
274
+ summary: Durable workflow engine with YAML-defined steps and pluggable executors
275
+ test_files: []