aia 2.0.0.0.pre.alpha → 2.0.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 (236) hide show
  1. checksums.yaml +4 -4
  2. data/.version +1 -1
  3. data/CHANGELOG.md +151 -228
  4. data/README.md +42 -19
  5. data/bin/aia +8 -3
  6. data/lib/aia/aia_completion.bash +2 -3
  7. data/lib/aia/aia_completion.fish +6 -5
  8. data/lib/aia/aia_completion.zsh +2 -3
  9. data/lib/aia/chat_loop.rb +24 -66
  10. data/lib/aia/config/cli_parser.rb +164 -123
  11. data/lib/aia/config/defaults.yml +12 -39
  12. data/lib/aia/config/mcp_parser.rb +42 -40
  13. data/lib/aia/config/model_spec.rb +8 -14
  14. data/lib/aia/config/validator.rb +144 -156
  15. data/lib/aia/config/value_caster.rb +76 -0
  16. data/lib/aia/config.rb +72 -54
  17. data/lib/aia/content_extractor.rb +2 -0
  18. data/lib/aia/cost_calculator.rb +1 -0
  19. data/lib/aia/crew.rb +29 -19
  20. data/lib/aia/debate_handler.rb +45 -20
  21. data/lib/aia/delegate_handler.rb +7 -3
  22. data/lib/aia/directive.rb +10 -8
  23. data/lib/aia/directives/configuration_directives.rb +164 -109
  24. data/lib/aia/directives/context_directives.rb +55 -40
  25. data/lib/aia/directives/execution_directives.rb +25 -25
  26. data/lib/aia/directives/model_directives.rb +112 -195
  27. data/lib/aia/directives/trakflow_directives.rb +27 -9
  28. data/lib/aia/directives/utility_directives.rb +86 -87
  29. data/lib/aia/directives/web_and_file_directives.rb +83 -63
  30. data/lib/aia/fact_asserter.rb +3 -3
  31. data/lib/aia/history_transfer.rb +64 -24
  32. data/lib/aia/layered_orchestrator.rb +66 -43
  33. data/lib/aia/logger.rb +27 -62
  34. data/lib/aia/mcp_config_normalizer.rb +27 -14
  35. data/lib/aia/mcp_connection_manager.rb +193 -186
  36. data/lib/aia/mcp_discovery.rb +43 -15
  37. data/lib/aia/mcp_grouper.rb +2 -1
  38. data/lib/aia/mcp_server_config.rb +48 -0
  39. data/lib/aia/mcp_utility.rb +28 -20
  40. data/lib/aia/mention_router.rb +22 -52
  41. data/lib/aia/modality_query.rb +36 -0
  42. data/lib/aia/model_alias_registry.rb +11 -11
  43. data/lib/aia/model_registry.rb +75 -0
  44. data/lib/aia/network_builder.rb +17 -11
  45. data/lib/aia/network_memory_manager.rb +6 -6
  46. data/lib/aia/patches/ruby_llm_streaming_error.rb +21 -4
  47. data/lib/aia/patches/ruby_llm_tool_param_compat.rb +18 -0
  48. data/lib/aia/pipeline_orchestrator.rb +88 -45
  49. data/lib/aia/plugin_monitor.rb +9 -6
  50. data/lib/aia/prompt_decomposer.rb +6 -4
  51. data/lib/aia/prompt_handler.rb +90 -69
  52. data/lib/aia/provider_registry.rb +105 -0
  53. data/lib/aia/robot_builder.rb +1 -1
  54. data/lib/aia/robot_factory.rb +77 -69
  55. data/lib/aia/robot_namer.rb +2 -8
  56. data/lib/aia/robot_sync.rb +79 -0
  57. data/lib/aia/role_catalog.rb +89 -0
  58. data/lib/aia/session.rb +32 -14
  59. data/lib/aia/session_tracker.rb +39 -41
  60. data/lib/aia/similarity_scorer.rb +5 -3
  61. data/lib/aia/skill_utils.rb +60 -19
  62. data/lib/aia/spawn_handler.rb +16 -4
  63. data/lib/aia/spawn_spec_parser.rb +6 -7
  64. data/lib/aia/special_mode_handler.rb +80 -57
  65. data/lib/aia/speech.rb +103 -0
  66. data/lib/aia/startup_coordinator.rb +17 -91
  67. data/lib/aia/streaming_runner.rb +16 -5
  68. data/lib/aia/system_prompt_assembler.rb +20 -15
  69. data/lib/aia/task_board.rb +60 -0
  70. data/lib/aia/task_coordinator.rb +10 -5
  71. data/lib/aia/timing.rb +15 -0
  72. data/lib/aia/tool_approver.rb +205 -0
  73. data/lib/aia/tool_filter.rb +1 -9
  74. data/lib/aia/tool_filter_strategy.rb +39 -25
  75. data/lib/aia/tool_introspection.rb +25 -0
  76. data/lib/aia/tool_loader.rb +71 -31
  77. data/lib/aia/tool_utility.rb +6 -5
  78. data/lib/aia/tools/delegate_to_foreman_tool.rb +6 -4
  79. data/lib/aia/tools/recruit_robot_tool.rb +12 -12
  80. data/lib/aia/tools/reskill_robot_tool.rb +7 -7
  81. data/lib/aia/tools/task_board_tool.rb +17 -16
  82. data/lib/aia/trakflow_bridge.rb +19 -11
  83. data/lib/aia/turn_state.rb +32 -8
  84. data/lib/aia/ui_presenter.rb +83 -59
  85. data/lib/aia/utility.rb +8 -24
  86. data/lib/aia/variable_input_collector.rb +1 -3
  87. data/lib/aia/verification_network.rb +10 -12
  88. data/lib/aia.rb +49 -8
  89. metadata +27 -162
  90. data/.better-commits.json +0 -150
  91. data/.config/tocer/configuration.yml +0 -6
  92. data/.envrc +0 -15
  93. data/.loki +0 -231
  94. data/.quality/flay_baseline.txt +0 -1
  95. data/.quality/flog_baseline.txt +0 -29
  96. data/.quality/reek_baseline.txt +0 -80
  97. data/.rubocop.yml +0 -116
  98. data/COMMITS.md +0 -196
  99. data/IMPLEMENTATION_PLAN.md +0 -506
  100. data/Rakefile +0 -160
  101. data/architecture_review.md +0 -314
  102. data/docs/AGENTS.md +0 -40
  103. data/docs/advanced-prompting.md +0 -814
  104. data/docs/assets/images/aia.png +0 -0
  105. data/docs/cli-reference.md +0 -1241
  106. data/docs/configuration.md +0 -747
  107. data/docs/contributing.md +0 -386
  108. data/docs/directives-reference.md +0 -1145
  109. data/docs/examples/index.md +0 -277
  110. data/docs/examples/mcp/index.md +0 -475
  111. data/docs/examples/prompts/analysis/index.md +0 -78
  112. data/docs/examples/prompts/automation/index.md +0 -109
  113. data/docs/examples/prompts/development/index.md +0 -125
  114. data/docs/examples/prompts/index.md +0 -333
  115. data/docs/examples/prompts/learning/index.md +0 -127
  116. data/docs/examples/prompts/writing/index.md +0 -62
  117. data/docs/examples/tools/index.md +0 -282
  118. data/docs/faq.md +0 -578
  119. data/docs/guides/available-models.md +0 -366
  120. data/docs/guides/basic-usage.md +0 -478
  121. data/docs/guides/chat.md +0 -680
  122. data/docs/guides/crew.md +0 -239
  123. data/docs/guides/executable-prompts.md +0 -331
  124. data/docs/guides/first-prompt.md +0 -454
  125. data/docs/guides/getting-started.md +0 -455
  126. data/docs/guides/image-generation.md +0 -507
  127. data/docs/guides/index.md +0 -48
  128. data/docs/guides/local-models.md +0 -306
  129. data/docs/guides/migrate-prompts.md +0 -335
  130. data/docs/guides/models.md +0 -1017
  131. data/docs/guides/shared-tools.md +0 -254
  132. data/docs/guides/tools.md +0 -831
  133. data/docs/index.md +0 -259
  134. data/docs/installation.md +0 -274
  135. data/docs/mcp-integration.md +0 -603
  136. data/docs/prompt_management.md +0 -665
  137. data/docs/security.md +0 -674
  138. data/docs/special_projects_guide.md +0 -386
  139. data/docs/tools-and-mcp-examples.md +0 -1211
  140. data/docs/workflows-and-pipelines.md +0 -636
  141. data/examples/.gitignore +0 -2
  142. data/examples/00_setup_aia.sh +0 -111
  143. data/examples/01_basic_usage.sh +0 -23
  144. data/examples/02_frontmatter.sh +0 -33
  145. data/examples/03_shell_integration.sh +0 -55
  146. data/examples/04_erb_templating.sh +0 -56
  147. data/examples/05_shell_then_erb.sh +0 -38
  148. data/examples/06_prompt_chaining.sh +0 -59
  149. data/examples/07_pipeline.sh +0 -46
  150. data/examples/08_context_files.sh +0 -43
  151. data/examples/09_roles.sh +0 -67
  152. data/examples/10_stdin_piping.sh +0 -49
  153. data/examples/11_multi_model.sh +0 -65
  154. data/examples/12_token_usage.sh +0 -52
  155. data/examples/13_cost_tracking.sh +0 -68
  156. data/examples/14_output_file.sh +0 -91
  157. data/examples/15_parameters.sh +0 -68
  158. data/examples/16_directives.sh +0 -113
  159. data/examples/17_require_and_conditionals.sh +0 -68
  160. data/examples/18_tools.sh +0 -61
  161. data/examples/19_local_tools.sh +0 -34
  162. data/examples/20_mcp_servers.sh +0 -102
  163. data/examples/21_executable_prompts.sh +0 -78
  164. data/examples/22_chat_mode.sh +0 -217
  165. data/examples/23_verify.sh +0 -139
  166. data/examples/24_decompose.sh +0 -139
  167. data/examples/25_spawn.sh +0 -139
  168. data/examples/26_debate.sh +0 -97
  169. data/examples/27_mention_routing.sh +0 -157
  170. data/examples/28_model_switching.sh +0 -106
  171. data/examples/29_agent_harness.sh +0 -177
  172. data/examples/README.md +0 -321
  173. data/examples/advanced_multi_robot_capabilities_without_examples.md +0 -106
  174. data/examples/aia_config.yml +0 -22
  175. data/examples/aia_config_orchestrator.yml +0 -45
  176. data/examples/aia_config_with_mcp.yml +0 -21
  177. data/examples/common.sh +0 -39
  178. data/examples/context/project_goals.md +0 -6
  179. data/examples/context/tech_stack.md +0 -7
  180. data/examples/directives/timestamp_directive.rb +0 -22
  181. data/examples/mcp/filesystem.json +0 -9
  182. data/examples/prompts_dir/analyze.md +0 -2
  183. data/examples/prompts_dir/brainstorm.md +0 -2
  184. data/examples/prompts_dir/conditional.md +0 -17
  185. data/examples/prompts_dir/creative.md +0 -4
  186. data/examples/prompts_dir/erbinfo.md +0 -5
  187. data/examples/prompts_dir/erbinfo_raw.md +0 -8
  188. data/examples/prompts_dir/evaluate.md +0 -2
  189. data/examples/prompts_dir/explain_joke.md +0 -1
  190. data/examples/prompts_dir/explain_recursion.md +0 -1
  191. data/examples/prompts_dir/fun_fact +0 -3
  192. data/examples/prompts_dir/greeting.md +0 -8
  193. data/examples/prompts_dir/greeting_required.md +0 -7
  194. data/examples/prompts_dir/hello.md +0 -1
  195. data/examples/prompts_dir/includes/ruby_facts.md +0 -4
  196. data/examples/prompts_dir/limerick.md +0 -1
  197. data/examples/prompts_dir/list_with_mcp.md +0 -3
  198. data/examples/prompts_dir/pick_best.md +0 -2
  199. data/examples/prompts_dir/project_summary +0 -12
  200. data/examples/prompts_dir/quiz_with_include.md +0 -6
  201. data/examples/prompts_dir/require_demo.md +0 -5
  202. data/examples/prompts_dir/roles/formal.md +0 -3
  203. data/examples/prompts_dir/roles/orchestrator.md +0 -21
  204. data/examples/prompts_dir/roles/pirate.md +0 -3
  205. data/examples/prompts_dir/shell_then_erb.md +0 -6
  206. data/examples/prompts_dir/sort_compare.md +0 -2
  207. data/examples/prompts_dir/summarize_context.md +0 -2
  208. data/examples/prompts_dir/sysinfo.md +0 -5
  209. data/examples/prompts_dir/sysinfo_raw.md +0 -8
  210. data/examples/prompts_dir/tagline.md +0 -1
  211. data/examples/prompts_dir/tell_joke.md +0 -1
  212. data/examples/prompts_dir/tell_joke_with_next.md +0 -4
  213. data/examples/prompts_dir/use_local_tool.md +0 -8
  214. data/examples/prompts_dir/use_tools.md +0 -8
  215. data/examples/prompts_dir/weather.md +0 -2
  216. data/examples/prompts_dir/whats_new.md +0 -2
  217. data/examples/prompts_dir/with_timestamp.md +0 -5
  218. data/examples/requirements/sinatra_taskflow_app.md +0 -139
  219. data/examples/rules/01_classify_ruby.rb +0 -16
  220. data/examples/rules/02_prefer_claude_for_code.rb +0 -19
  221. data/examples/rules/03_gate_prompt_length.rb +0 -19
  222. data/examples/rules/04_tool_selection.rb +0 -41
  223. data/examples/rules/README.md +0 -30
  224. data/examples/run_all.sh +0 -294
  225. data/examples/tools/word_count_tool.rb +0 -30
  226. data/lib/AGENTS.md +0 -57
  227. data/lib/aia/model_switch_handler.rb +0 -100
  228. data/mcp_servers/README.md +0 -110
  229. data/mcp_servers/apple-mcp.json +0 -8
  230. data/mcp_servers/filesystem.json +0 -9
  231. data/mcp_servers/mcp_server_chart.json +0 -11
  232. data/mcp_servers/playwright_one.json +0 -8
  233. data/mcp_servers/playwright_server_definition.json +0 -9
  234. data/mcp_servers/playwright_two.json +0 -8
  235. data/mcp_servers/tavily_mcp_server.json +0 -8
  236. data/mkdocs.yml +0 -169
@@ -1,282 +0,0 @@
1
- # Tools Examples
2
-
3
- Collection of RubyLLM tools that extend AIA's capabilities with custom Ruby functions.
4
-
5
- ## Available Tools
6
-
7
- ### File Processing Tools
8
- - **file_analyzer.rb** - Advanced file analysis and metadata extraction
9
- - **log_analyzer.rb** - Log file parsing and pattern analysis
10
- - **config_manager.rb** - Configuration file management and validation
11
- - **document_processor.rb** - Document format conversion and processing
12
-
13
- ### Web Integration Tools
14
- - **web_client.rb** - HTTP client for API interactions
15
- - **web_scraper.rb** - Web scraping and content extraction
16
- - **api_tester.rb** - API endpoint testing and validation
17
- - **webhook_handler.rb** - Webhook processing and management
18
-
19
- ### Data Analysis Tools
20
- - **data_analyzer.rb** - CSV and JSON data analysis
21
- - **statistics_calculator.rb** - Statistical calculations and metrics
22
- - **chart_generator.rb** - Data visualization and chart generation
23
- - **database_connector.rb** - Database query and analysis tools
24
-
25
- ### Development Tools
26
- - **code_quality.rb** - Code quality analysis and metrics
27
- - **test_runner.rb** - Test execution and reporting
28
- - **dependency_checker.rb** - Dependency analysis and management
29
- - **deploy_helper.rb** - Deployment assistance and validation
30
-
31
- ### System Integration Tools
32
- - **system_monitor.rb** - System monitoring and health checks
33
- - **process_manager.rb** - Process management and control
34
- - **backup_manager.rb** - Backup operations and scheduling
35
- - **security_scanner.rb** - Security scanning and assessment
36
-
37
- ## Tool Structure
38
-
39
- All tools follow the standard RubyLLM::Tool pattern:
40
-
41
- ```ruby
42
- class ToolName < RubyLLM::Tool
43
- description "Brief description of tool functionality"
44
-
45
- def method_name(parameter1, parameter2 = nil)
46
- # Tool implementation
47
- return "Result string or JSON"
48
- end
49
-
50
- private
51
-
52
- def helper_method
53
- # Internal helper methods
54
- end
55
- end
56
- ```
57
-
58
- ## Usage Examples
59
-
60
- ### Basic Tool Usage
61
- ```bash
62
- # Use a single tool
63
- aia --tools file_analyzer.rb analyze_project project/
64
-
65
- # Use multiple tools
66
- aia --tools "web_client.rb,data_analyzer.rb" api_data_analysis
67
-
68
- # Use tool directory
69
- aia --tools ./tools/ comprehensive_analysis
70
- ```
71
-
72
- ### Tool Security
73
- ```bash
74
- # Restrict to specific tools
75
- aia --tools ./tools/ --allowed-tools "file_analyzer,data_analyzer" safe_analysis
76
-
77
- # Block potentially dangerous tools
78
- aia --tools ./tools/ --rejected-tools "system_monitor,process_manager" user_analysis
79
- ```
80
-
81
- ### Tool Integration in Prompts
82
- ```markdown
83
- # Use tools within prompts
84
- /tools file_analyzer.rb,web_client.rb
85
-
86
- Analyze the project structure and check API endpoints:
87
- 1. Use file_analyzer to examine project files
88
- 2. Use web_client to test API endpoints
89
- 3. Provide comprehensive assessment
90
- ```
91
-
92
- ## Tool Categories
93
-
94
- ### Security Level: Safe
95
- Tools that only read data and perform analysis:
96
- - file_analyzer.rb
97
- - data_analyzer.rb
98
- - statistics_calculator.rb
99
- - code_quality.rb
100
-
101
- ### Security Level: Network
102
- Tools that make network requests:
103
- - web_client.rb
104
- - web_scraper.rb
105
- - api_tester.rb
106
- - webhook_handler.rb
107
-
108
- ### Security Level: System
109
- Tools that interact with the system:
110
- - system_monitor.rb
111
- - process_manager.rb
112
- - deploy_helper.rb
113
- - security_scanner.rb
114
-
115
- ### Security Level: Write
116
- Tools that can modify files or system state:
117
- - config_manager.rb (when writing configs)
118
- - backup_manager.rb
119
- - document_processor.rb (when saving files)
120
-
121
- ## Tool Development Guidelines
122
-
123
- ### Best Practices
124
- 1. **Single Responsibility** - Each tool should do one thing well
125
- 2. **Error Handling** - Comprehensive error handling and user feedback
126
- 3. **Input Validation** - Validate all inputs and parameters
127
- 4. **Security** - Follow principle of least privilege
128
- 5. **Documentation** - Clear descriptions and usage examples
129
-
130
- ### Example Tool Template
131
- ```ruby
132
- # ~/.config/aia/tools/example_tool.rb
133
- require 'json'
134
-
135
- class ExampleTool < RubyLLM::Tool
136
- description "Example tool demonstrating best practices"
137
-
138
- def process_data(input_data, options = {})
139
- # Validate inputs
140
- return "Error: No input data provided" if input_data.nil? || input_data.empty?
141
-
142
- begin
143
- # Process data
144
- result = perform_processing(input_data, options)
145
-
146
- # Return structured result
147
- {
148
- status: 'success',
149
- data: result,
150
- metadata: {
151
- processed_at: Time.now.iso8601,
152
- options_used: options
153
- }
154
- }.to_json
155
-
156
- rescue StandardError => e
157
- # Handle errors gracefully
158
- {
159
- status: 'error',
160
- message: e.message,
161
- type: e.class.name
162
- }.to_json
163
- end
164
- end
165
-
166
- private
167
-
168
- def perform_processing(data, options)
169
- # Actual processing logic
170
- data.upcase
171
- end
172
- end
173
- ```
174
-
175
- ### Testing Tools
176
- ```ruby
177
- # test_example_tool.rb
178
- require 'minitest/autorun'
179
- require_relative 'example_tool'
180
-
181
- class TestExampleTool < Minitest::Test
182
- def setup
183
- @tool = ExampleTool.new
184
- end
185
-
186
- def test_basic_functionality
187
- result = @tool.process_data("test input")
188
- parsed = JSON.parse(result)
189
-
190
- assert_equal 'success', parsed['status']
191
- assert_equal 'TEST INPUT', parsed['data']
192
- end
193
-
194
- def test_error_handling
195
- result = @tool.process_data(nil)
196
- parsed = JSON.parse(result)
197
-
198
- assert_includes parsed['message'], 'No input data'
199
- end
200
- end
201
- ```
202
-
203
- ## Tool Installation and Distribution
204
-
205
- ### Local Tool Directory
206
- ```bash
207
- # Create tool directory structure
208
- mkdir -p ~/.config/aia/tools/{core,development,analysis,web,system}
209
-
210
- # Copy tools to appropriate directories
211
- cp file_analyzer.rb ~/.config/aia/tools/core/
212
- cp code_quality.rb ~/.config/aia/tools/development/
213
- cp data_analyzer.rb ~/.config/aia/tools/analysis/
214
- ```
215
-
216
- ### Loading Tools by Directory
217
- ```bash
218
- # Load all tools from a directory
219
- aia --tools ~/.config/aia/tools/core/ my_prompt
220
-
221
- # Load tools from multiple directories
222
- aia --tools ~/.config/aia/tools/core/ --tools ~/.config/aia/tools/development/ my_prompt
223
-
224
- # Filter to specific tools
225
- aia --tools ~/.config/aia/tools/ --allowed-tools FileAnalyzer,CodeQuality my_prompt
226
- ```
227
-
228
- ### Shared Tool Repositories
229
- ```bash
230
- # Clone shared tool repositories
231
- git clone https://github.com/team/aia-tools.git ~/.config/aia/shared-tools
232
-
233
- # Use shared tools
234
- aia --tools ~/.config/aia/shared-tools/web/ api_analysis
235
- ```
236
-
237
- ## Performance Considerations
238
-
239
- ### Tool Optimization
240
- - Cache expensive operations
241
- - Use appropriate data structures
242
- - Implement timeouts for network operations
243
- - Handle large data sets efficiently
244
- - Profile and optimize slow operations
245
-
246
- ### Memory Management
247
- - Clean up temporary files
248
- - Manage large object lifecycles
249
- - Use streaming for large data processing
250
- - Monitor memory usage in long-running operations
251
-
252
- ## Troubleshooting
253
-
254
- ### Common Issues
255
- 1. **Tool Not Found** - Check file paths and permissions
256
- 2. **Method Errors** - Verify method signatures and parameters
257
- 3. **Permission Denied** - Check file and directory permissions
258
- 4. **Network Timeouts** - Implement proper timeout handling
259
- 5. **Memory Issues** - Optimize for large data processing
260
-
261
- ### Debugging Tools
262
- ```bash
263
- # Debug tool loading
264
- aia --debug --tools problem_tool.rb test_prompt
265
-
266
- # Verbose tool execution
267
- aia --verbose --tools analysis_tool.rb data_analysis
268
-
269
- # Test tool isolation
270
- ruby -r './my_tool.rb' -e "puts MyTool.new.test_method('input')"
271
- ```
272
-
273
- ## Related Documentation
274
-
275
- - [Tools Integration Guide](../../guides/tools.md) - Detailed tool development guide
276
- - [Advanced Prompting](../../advanced-prompting.md) - Complex tool integration
277
- - [MCP Examples](../mcp/index.md) - Alternative integration approach
278
- - [Configuration](../../configuration.md) - Tool configuration options
279
-
280
- ---
281
-
282
- Tools are the backbone of AIA's extensibility. Start with simple analysis tools and gradually build more sophisticated capabilities as your needs grow!