roast-ai 0.4.9 → 0.5.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 (194) hide show
  1. checksums.yaml +4 -4
  2. data/.claude/commands/docs/write-comments.md +36 -0
  3. data/.github/CODEOWNERS +1 -1
  4. data/.github/workflows/ci.yaml +10 -6
  5. data/.gitignore +0 -1
  6. data/.rubocop.yml +7 -1
  7. data/CLAUDE.md +2 -2
  8. data/CONTRIBUTING.md +2 -0
  9. data/Gemfile +18 -18
  10. data/Gemfile.lock +46 -57
  11. data/README.md +118 -1432
  12. data/README_LEGACY.md +1464 -0
  13. data/Rakefile +39 -4
  14. data/dev.yml +29 -0
  15. data/dsl/agent_sessions.rb +20 -0
  16. data/dsl/async_cogs.rb +49 -0
  17. data/dsl/async_cogs_complex.rb +67 -0
  18. data/dsl/call.rb +44 -0
  19. data/dsl/collect_from.rb +72 -0
  20. data/dsl/demo/Gemfile +4 -0
  21. data/dsl/demo/Gemfile.lock +120 -0
  22. data/dsl/demo/cogs/local.rb +15 -0
  23. data/dsl/demo/simple_external_cog.rb +17 -0
  24. data/dsl/json_output.rb +28 -0
  25. data/dsl/map.rb +55 -0
  26. data/dsl/map_reduce.rb +37 -0
  27. data/dsl/map_with_index.rb +49 -0
  28. data/dsl/next_break.rb +40 -0
  29. data/dsl/next_break_parallel.rb +44 -0
  30. data/dsl/outputs.rb +39 -0
  31. data/dsl/outputs_bang.rb +36 -0
  32. data/dsl/parallel_map.rb +37 -0
  33. data/dsl/plugin-gem-example/.gitignore +8 -0
  34. data/dsl/plugin-gem-example/Gemfile +13 -0
  35. data/dsl/plugin-gem-example/Gemfile.lock +178 -0
  36. data/dsl/plugin-gem-example/lib/other.rb +17 -0
  37. data/dsl/plugin-gem-example/lib/plugin_gem_example.rb +5 -0
  38. data/dsl/plugin-gem-example/lib/simple.rb +15 -0
  39. data/dsl/plugin-gem-example/lib/version.rb +10 -0
  40. data/dsl/plugin-gem-example/plugin-gem-example.gemspec +28 -0
  41. data/dsl/prompts/simple_prompt.md.erb +3 -0
  42. data/dsl/prototype.rb +10 -4
  43. data/dsl/repeat_loop_results.rb +53 -0
  44. data/dsl/ruby_cog.rb +72 -0
  45. data/dsl/simple_agent.rb +18 -0
  46. data/dsl/simple_chat.rb +26 -0
  47. data/dsl/simple_repeat.rb +29 -0
  48. data/dsl/skip.rb +36 -0
  49. data/dsl/step_communication.rb +10 -5
  50. data/dsl/targets_and_params.rb +57 -0
  51. data/dsl/temperature.rb +17 -0
  52. data/dsl/temporary_directory.rb +22 -0
  53. data/dsl/tutorial/01_your_first_workflow/README.md +179 -0
  54. data/dsl/tutorial/01_your_first_workflow/configured_chat.rb +33 -0
  55. data/dsl/tutorial/01_your_first_workflow/hello.rb +23 -0
  56. data/dsl/tutorial/02_chaining_cogs/README.md +310 -0
  57. data/dsl/tutorial/02_chaining_cogs/code_review.rb +104 -0
  58. data/dsl/tutorial/02_chaining_cogs/session_resumption.rb +92 -0
  59. data/dsl/tutorial/02_chaining_cogs/simple_chain.rb +84 -0
  60. data/dsl/tutorial/03_targets_and_params/README.md +230 -0
  61. data/dsl/tutorial/03_targets_and_params/multiple_targets.rb +65 -0
  62. data/dsl/tutorial/03_targets_and_params/single_target.rb +65 -0
  63. data/dsl/tutorial/04_configuration_options/README.md +209 -0
  64. data/dsl/tutorial/04_configuration_options/control_display_and_temperature.rb +104 -0
  65. data/dsl/tutorial/04_configuration_options/simple_config.rb +68 -0
  66. data/dsl/tutorial/05_control_flow/README.md +156 -0
  67. data/dsl/tutorial/05_control_flow/conditional_execution.rb +62 -0
  68. data/dsl/tutorial/05_control_flow/handling_failures.rb +77 -0
  69. data/dsl/tutorial/06_reusable_scopes/README.md +172 -0
  70. data/dsl/tutorial/06_reusable_scopes/accessing_scope_outputs.rb +126 -0
  71. data/dsl/tutorial/06_reusable_scopes/basic_scope.rb +63 -0
  72. data/dsl/tutorial/06_reusable_scopes/parameterized_scope.rb +78 -0
  73. data/dsl/tutorial/07_processing_collections/README.md +152 -0
  74. data/dsl/tutorial/07_processing_collections/basic_map.rb +70 -0
  75. data/dsl/tutorial/07_processing_collections/parallel_map.rb +74 -0
  76. data/dsl/tutorial/08_iterative_workflows/README.md +231 -0
  77. data/dsl/tutorial/08_iterative_workflows/basic_repeat.rb +57 -0
  78. data/dsl/tutorial/08_iterative_workflows/conditional_break.rb +57 -0
  79. data/dsl/tutorial/09_async_cogs/README.md +197 -0
  80. data/dsl/tutorial/09_async_cogs/basic_async.rb +38 -0
  81. data/dsl/tutorial/README.md +222 -0
  82. data/dsl/working_directory.rb +16 -0
  83. data/exe/roast +1 -1
  84. data/internal/documentation/architectural-notes.md +115 -0
  85. data/internal/documentation/doc-comments-external.md +686 -0
  86. data/internal/documentation/doc-comments-internal.md +342 -0
  87. data/internal/documentation/doc-comments.md +211 -0
  88. data/lib/roast/dsl/cog/config.rb +280 -4
  89. data/lib/roast/dsl/cog/input.rb +73 -0
  90. data/lib/roast/dsl/cog/output.rb +313 -0
  91. data/lib/roast/dsl/cog/registry.rb +71 -0
  92. data/lib/roast/dsl/cog/stack.rb +3 -2
  93. data/lib/roast/dsl/cog/store.rb +11 -8
  94. data/lib/roast/dsl/cog.rb +108 -31
  95. data/lib/roast/dsl/cog_input_context.rb +44 -0
  96. data/lib/roast/dsl/cog_input_manager.rb +156 -0
  97. data/lib/roast/dsl/cogs/agent/config.rb +465 -0
  98. data/lib/roast/dsl/cogs/agent/input.rb +81 -0
  99. data/lib/roast/dsl/cogs/agent/output.rb +59 -0
  100. data/lib/roast/dsl/cogs/agent/provider.rb +51 -0
  101. data/lib/roast/dsl/cogs/agent/providers/claude/claude_invocation.rb +185 -0
  102. data/lib/roast/dsl/cogs/agent/providers/claude/message.rb +73 -0
  103. data/lib/roast/dsl/cogs/agent/providers/claude/messages/assistant_message.rb +36 -0
  104. data/lib/roast/dsl/cogs/agent/providers/claude/messages/result_message.rb +61 -0
  105. data/lib/roast/dsl/cogs/agent/providers/claude/messages/system_message.rb +47 -0
  106. data/lib/roast/dsl/cogs/agent/providers/claude/messages/text_message.rb +36 -0
  107. data/lib/roast/dsl/cogs/agent/providers/claude/messages/tool_result_message.rb +47 -0
  108. data/lib/roast/dsl/cogs/agent/providers/claude/messages/tool_use_message.rb +46 -0
  109. data/lib/roast/dsl/cogs/agent/providers/claude/messages/unknown_message.rb +27 -0
  110. data/lib/roast/dsl/cogs/agent/providers/claude/messages/user_message.rb +37 -0
  111. data/lib/roast/dsl/cogs/agent/providers/claude/tool_result.rb +51 -0
  112. data/lib/roast/dsl/cogs/agent/providers/claude/tool_use.rb +48 -0
  113. data/lib/roast/dsl/cogs/agent/providers/claude.rb +31 -0
  114. data/lib/roast/dsl/cogs/agent/stats.rb +92 -0
  115. data/lib/roast/dsl/cogs/agent/usage.rb +62 -0
  116. data/lib/roast/dsl/cogs/agent.rb +75 -0
  117. data/lib/roast/dsl/cogs/chat/config.rb +453 -0
  118. data/lib/roast/dsl/cogs/chat/input.rb +92 -0
  119. data/lib/roast/dsl/cogs/chat/output.rb +64 -0
  120. data/lib/roast/dsl/cogs/chat/session.rb +68 -0
  121. data/lib/roast/dsl/cogs/chat.rb +81 -0
  122. data/lib/roast/dsl/cogs/cmd.rb +291 -27
  123. data/lib/roast/dsl/cogs/ruby.rb +171 -0
  124. data/lib/roast/dsl/command_runner.rb +191 -0
  125. data/lib/roast/dsl/config_context.rb +2 -47
  126. data/lib/roast/dsl/config_manager.rb +143 -0
  127. data/lib/roast/dsl/control_flow.rb +41 -0
  128. data/lib/roast/dsl/execution_context.rb +9 -0
  129. data/lib/roast/dsl/execution_manager.rb +267 -0
  130. data/lib/roast/dsl/nil_assertions.rb +23 -0
  131. data/lib/roast/dsl/system_cog/params.rb +32 -0
  132. data/lib/roast/dsl/system_cog.rb +36 -0
  133. data/lib/roast/dsl/system_cogs/call.rb +162 -0
  134. data/lib/roast/dsl/system_cogs/map.rb +448 -0
  135. data/lib/roast/dsl/system_cogs/repeat.rb +242 -0
  136. data/lib/roast/dsl/workflow.rb +123 -0
  137. data/lib/roast/dsl/workflow_context.rb +20 -0
  138. data/lib/roast/dsl/workflow_params.rb +24 -0
  139. data/lib/roast/sorbet_runtime_stub.rb +154 -0
  140. data/lib/roast/tools/apply_diff.rb +1 -3
  141. data/lib/roast/tools/cmd.rb +4 -3
  142. data/lib/roast/tools/read_file.rb +1 -1
  143. data/lib/roast/tools/update_files.rb +1 -1
  144. data/lib/roast/tools/write_file.rb +1 -1
  145. data/lib/roast/version.rb +1 -1
  146. data/lib/roast/workflow/base_workflow.rb +4 -0
  147. data/lib/roast/workflow/step_loader.rb +14 -2
  148. data/lib/roast-ai.rb +4 -0
  149. data/lib/roast.rb +60 -22
  150. data/{roast.gemspec → roast-ai.gemspec} +10 -13
  151. data/sorbet/config +1 -0
  152. data/sorbet/rbi/gems/async@2.34.0.rbi +1577 -0
  153. data/sorbet/rbi/gems/cli-kit@5.2.0.rbi +2063 -0
  154. data/sorbet/rbi/gems/{cli-ui@2.3.0.rbi → cli-ui@2.7.0-6bdefd1d06305e5d6ae312ac76f9c88f88658dda.rbi} +1418 -1013
  155. data/sorbet/rbi/gems/console@1.34.2.rbi +1193 -0
  156. data/sorbet/rbi/gems/fiber-annotation@0.2.0.rbi +50 -0
  157. data/sorbet/rbi/gems/fiber-local@1.1.0.rbi +35 -0
  158. data/sorbet/rbi/gems/fiber-storage@1.0.1.rbi +41 -0
  159. data/sorbet/rbi/gems/io-event@1.14.0.rbi +724 -0
  160. data/sorbet/rbi/gems/marcel@1.1.0.rbi +239 -0
  161. data/sorbet/rbi/gems/metrics@0.15.0.rbi +9 -0
  162. data/sorbet/rbi/gems/ruby_llm@1.8.2.rbi +5703 -0
  163. data/sorbet/rbi/gems/traces@0.18.2.rbi +9 -0
  164. data/sorbet/rbi/shims/lib/roast/dsl/cog_input_context.rbi +1197 -0
  165. data/sorbet/rbi/shims/lib/roast/dsl/config_context.rbi +314 -2
  166. data/sorbet/rbi/shims/lib/roast/dsl/execution_context.rbi +498 -0
  167. data/sorbet/tapioca/config.yml +6 -0
  168. data/sorbet/tapioca/require.rb +2 -0
  169. metadata +198 -34
  170. data/dsl/less_simple.rb +0 -112
  171. data/dsl/simple.rb +0 -8
  172. data/lib/roast/dsl/cog_execution_context.rb +0 -29
  173. data/lib/roast/dsl/cogs/graph.rb +0 -53
  174. data/lib/roast/dsl/cogs.rb +0 -65
  175. data/lib/roast/dsl/executor.rb +0 -82
  176. data/lib/roast/dsl/workflow_execution_context.rb +0 -47
  177. data/sorbet/rbi/gems/cgi@0.5.0.rbi +0 -2961
  178. data/sorbet/rbi/gems/claude_swarm@0.1.19.rbi +0 -568
  179. data/sorbet/rbi/gems/cli-kit@5.0.1.rbi +0 -1991
  180. data/sorbet/rbi/gems/dry-configurable@1.3.0.rbi +0 -672
  181. data/sorbet/rbi/gems/dry-core@1.1.0.rbi +0 -1894
  182. data/sorbet/rbi/gems/dry-inflector@1.2.0.rbi +0 -659
  183. data/sorbet/rbi/gems/dry-initializer@3.2.0.rbi +0 -781
  184. data/sorbet/rbi/gems/dry-logic@1.6.0.rbi +0 -1127
  185. data/sorbet/rbi/gems/dry-schema@1.14.1.rbi +0 -3727
  186. data/sorbet/rbi/gems/dry-types@1.8.3.rbi +0 -3969
  187. data/sorbet/rbi/gems/fast-mcp-annotations@1.5.3.rbi +0 -1588
  188. data/sorbet/rbi/gems/mime-types-data@3.2025.0617.rbi +0 -136
  189. data/sorbet/rbi/gems/mime-types@3.7.0.rbi +0 -1342
  190. data/sorbet/rbi/gems/rack@2.2.18.rbi +0 -5659
  191. data/sorbet/rbi/gems/rbs-inline@0.12.0.rbi +0 -2170
  192. data/sorbet/rbi/gems/yard-sorbet@0.9.0.rbi +0 -435
  193. data/sorbet/rbi/gems/yard@0.9.37.rbi +0 -18492
  194. data/sorbet/rbi/shims/lib/roast/dsl/workflow_execution_context.rbi +0 -11
@@ -0,0 +1,239 @@
1
+ # typed: true
2
+
3
+ # DO NOT EDIT MANUALLY
4
+ # This is an autogenerated file for types exported from the `marcel` gem.
5
+ # Please instead update this file by running `bin/tapioca gem marcel`.
6
+
7
+
8
+ # This file is auto-generated. Instead of editing this file, please
9
+ # add MIMEs to data/custom.xml or lib/marcel/mime_type/definitions.rb.
10
+ #
11
+ # source://marcel//lib/marcel.rb#3
12
+ module Marcel; end
13
+
14
+ # @private
15
+ #
16
+ # source://marcel//lib/marcel/tables.rb#9
17
+ Marcel::EXTENSIONS = T.let(T.unsafe(nil), Hash)
18
+
19
+ # @private
20
+ #
21
+ # source://marcel//lib/marcel/tables.rb#2513
22
+ Marcel::MAGIC = T.let(T.unsafe(nil), Array)
23
+
24
+ # Mime type detection
25
+ #
26
+ # source://marcel//lib/marcel/magic.rb#12
27
+ class Marcel::Magic
28
+ # Mime type by type string
29
+ #
30
+ # @return [Magic] a new instance of Magic
31
+ #
32
+ # source://marcel//lib/marcel/magic.rb#16
33
+ def initialize(type); end
34
+
35
+ # Allow comparison with string
36
+ #
37
+ # @return [Boolean]
38
+ #
39
+ # source://marcel//lib/marcel/magic.rb#103
40
+ def ==(other); end
41
+
42
+ # @return [Boolean]
43
+ #
44
+ # source://marcel//lib/marcel/magic.rb#54
45
+ def audio?; end
46
+
47
+ # Returns true if type is child of parent type
48
+ #
49
+ # @return [Boolean]
50
+ #
51
+ # source://marcel//lib/marcel/magic.rb#58
52
+ def child_of?(parent); end
53
+
54
+ # Get mime comment
55
+ #
56
+ # source://marcel//lib/marcel/magic.rb#68
57
+ def comment; end
58
+
59
+ # Allow comparison with string
60
+ #
61
+ # @return [Boolean]
62
+ #
63
+ # source://marcel//lib/marcel/magic.rb#103
64
+ def eql?(other); end
65
+
66
+ # Get string list of file extensions
67
+ #
68
+ # source://marcel//lib/marcel/magic.rb#63
69
+ def extensions; end
70
+
71
+ # source://marcel//lib/marcel/magic.rb#107
72
+ def hash; end
73
+
74
+ # Mediatype shortcuts
75
+ #
76
+ # @return [Boolean]
77
+ #
78
+ # source://marcel//lib/marcel/magic.rb#53
79
+ def image?; end
80
+
81
+ # Returns the value of attribute mediatype.
82
+ #
83
+ # source://marcel//lib/marcel/magic.rb#13
84
+ def mediatype; end
85
+
86
+ # Returns the value of attribute subtype.
87
+ #
88
+ # source://marcel//lib/marcel/magic.rb#13
89
+ def subtype; end
90
+
91
+ # Returns true if type is a text format
92
+ #
93
+ # @return [Boolean]
94
+ #
95
+ # source://marcel//lib/marcel/magic.rb#50
96
+ def text?; end
97
+
98
+ # Return type as string
99
+ #
100
+ # source://marcel//lib/marcel/magic.rb#98
101
+ def to_s; end
102
+
103
+ # Returns the value of attribute type.
104
+ #
105
+ # source://marcel//lib/marcel/magic.rb#13
106
+ def type; end
107
+
108
+ # @return [Boolean]
109
+ #
110
+ # source://marcel//lib/marcel/magic.rb#55
111
+ def video?; end
112
+
113
+ class << self
114
+ # Add custom mime type. Arguments:
115
+ # * <i>type</i>: Mime type
116
+ # * <i>options</i>: Options hash
117
+ #
118
+ # Option keys:
119
+ # * <i>:extensions</i>: String list or single string of file extensions
120
+ # * <i>:parents</i>: String list or single string of parent mime types
121
+ # * <i>:magic</i>: Mime magic specification
122
+ # * <i>:comment</i>: Comment string
123
+ #
124
+ # source://marcel//lib/marcel/magic.rb#30
125
+ def add(type, options); end
126
+
127
+ # Lookup all mime types by magic content analysis.
128
+ # This is a slower operation.
129
+ #
130
+ # source://marcel//lib/marcel/magic.rb#93
131
+ def all_by_magic(io); end
132
+
133
+ # Lookup mime type by file extension
134
+ #
135
+ # source://marcel//lib/marcel/magic.rb#73
136
+ def by_extension(ext); end
137
+
138
+ # Lookup mime type by magic content analysis.
139
+ # This is a slow operation.
140
+ #
141
+ # source://marcel//lib/marcel/magic.rb#86
142
+ def by_magic(io); end
143
+
144
+ # Lookup mime type by filename
145
+ #
146
+ # source://marcel//lib/marcel/magic.rb#80
147
+ def by_path(path); end
148
+
149
+ # @return [Boolean]
150
+ #
151
+ # source://marcel//lib/marcel/magic.rb#113
152
+ def child?(child, parent); end
153
+
154
+ # Removes a mime type from the dictionary. You might want to do this if
155
+ # you're seeing impossible conflicts (for instance, application/x-gmc-link).
156
+ # * <i>type</i>: The mime type to remove. All associated extensions and magic are removed too.
157
+ #
158
+ # source://marcel//lib/marcel/magic.rb#42
159
+ def remove(type); end
160
+
161
+ private
162
+
163
+ # source://marcel//lib/marcel/magic.rb#117
164
+ def magic_match(io, method); end
165
+
166
+ # source://marcel//lib/marcel/magic.rb#127
167
+ def magic_match_io(io, matches, buffer); end
168
+ end
169
+ end
170
+
171
+ # source://marcel//lib/marcel/mime_type.rb#4
172
+ class Marcel::MimeType
173
+ class << self
174
+ # source://marcel//lib/marcel/mime_type.rb#8
175
+ def extend(type, extensions: T.unsafe(nil), parents: T.unsafe(nil), magic: T.unsafe(nil)); end
176
+
177
+ # Returns the most appropriate content type for the given file.
178
+ #
179
+ # The first argument should be a +Pathname+ or an +IO+. If it is a +Pathname+, the specified
180
+ # file will be opened first.
181
+ #
182
+ # Optional parameters:
183
+ # * +name+: file name, if known
184
+ # * +extension+: file extension, if known
185
+ # * +declared_type+: MIME type, if known
186
+ #
187
+ # The most appropriate type is determined by the following:
188
+ # * type declared by binary magic number data
189
+ # * type declared by the first of file name, file extension, or declared MIME type
190
+ #
191
+ # If no type can be determined, then +application/octet-stream+ is returned.
192
+ #
193
+ # source://marcel//lib/marcel/mime_type.rb#29
194
+ def for(pathname_or_io = T.unsafe(nil), name: T.unsafe(nil), extension: T.unsafe(nil), declared_type: T.unsafe(nil)); end
195
+
196
+ private
197
+
198
+ # source://marcel//lib/marcel/mime_type.rb#36
199
+ def for_data(pathname_or_io); end
200
+
201
+ # source://marcel//lib/marcel/mime_type.rb#62
202
+ def for_declared_type(declared_type); end
203
+
204
+ # source://marcel//lib/marcel/mime_type.rb#54
205
+ def for_extension(extension); end
206
+
207
+ # source://marcel//lib/marcel/mime_type.rb#46
208
+ def for_name(name); end
209
+
210
+ # For some document types (notably Microsoft Office) we recognise the main content
211
+ # type with magic, but not the specific subclass. In this situation, if we can get a more
212
+ # specific class using either the name or declared_type, we should use that in preference
213
+ #
214
+ # source://marcel//lib/marcel/mime_type.rb#89
215
+ def most_specific_type(*candidates); end
216
+
217
+ # source://marcel//lib/marcel/mime_type.rb#79
218
+ def parse_media_type(content_type); end
219
+
220
+ # source://marcel//lib/marcel/mime_type.rb#71
221
+ def with_io(pathname_or_io, &block); end
222
+ end
223
+ end
224
+
225
+ # source://marcel//lib/marcel/mime_type.rb#5
226
+ Marcel::MimeType::BINARY = T.let(T.unsafe(nil), String)
227
+
228
+ # @private
229
+ #
230
+ # source://marcel//lib/marcel/tables.rb#1310
231
+ Marcel::TYPE_EXTS = T.let(T.unsafe(nil), Hash)
232
+
233
+ # Cooltalk Audio
234
+ #
235
+ # source://marcel//lib/marcel/tables.rb#2239
236
+ Marcel::TYPE_PARENTS = T.let(T.unsafe(nil), Hash)
237
+
238
+ # source://marcel//lib/marcel/version.rb#4
239
+ Marcel::VERSION = T.let(T.unsafe(nil), String)
@@ -0,0 +1,9 @@
1
+ # typed: true
2
+
3
+ # DO NOT EDIT MANUALLY
4
+ # This is an autogenerated file for types exported from the `metrics` gem.
5
+ # Please instead update this file by running `bin/tapioca gem metrics`.
6
+
7
+
8
+ # THIS IS AN EMPTY RBI FILE.
9
+ # see https://github.com/Shopify/tapioca#manually-requiring-parts-of-a-gem