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,254 +0,0 @@
1
- # Shared Tools
2
-
3
- The [shared_tools gem](https://github.com/madbomber/shared_tools) provides a curated collection of ready-to-use tools for LLM-assisted workflows. These tools extend AIA's capabilities with file operations, web browsing, database access, system utilities, and more.
4
-
5
- ## Installation
6
-
7
- The `shared_tools` gem is installed separately:
8
-
9
- ```bash
10
- gem install shared_tools
11
- ```
12
-
13
- ## Usage
14
-
15
- Load shared tools into AIA with the `--require` option:
16
-
17
- ```bash
18
- # Load all shared tools
19
- aia --require shared_tools --chat
20
-
21
- # Load via the ruby_llm entry point (equivalent)
22
- aia --require shared_tools/ruby_llm --chat
23
-
24
- # Load a specific tool only
25
- aia --require shared_tools/ruby_llm/edit_file --chat
26
-
27
- # Combine with your own custom tools
28
- aia --require shared_tools --tools ~/my-tools/ --chat
29
-
30
- # Use in batch prompts (not just chat)
31
- aia --require shared_tools my_prompt input.txt
32
-
33
- # List what tools are available
34
- aia --require shared_tools --list-tools
35
- ```
36
-
37
- You can also load shared tools from within a prompt using a Ruby directive:
38
-
39
- ```ruby
40
- /ruby
41
- require 'shared_tools/ruby_llm'
42
- ```
43
-
44
- Or using an ERB block:
45
-
46
- ```erb
47
- <%= require 'shared_tools/ruby_llm'; '' %>
48
- ```
49
-
50
- ## Available Tools
51
-
52
- > **Tip:** Run `aia --require shared_tools --list-tools` to see the current list from your installed version. Redirect to a file for full markdown descriptions: `aia --require shared_tools --list-tools > tools.md`
53
-
54
- ### Data & Analysis
55
-
56
- #### `calculator`
57
-
58
- Perform advanced mathematical calculations with comprehensive error handling and validation.
59
- This tool supports basic arithmetic operations, parentheses, and common mathematical functions.
60
- It uses Dentaku for safe evaluation of mathematical expressions without executing arbitrary code,
61
- making it suitable for use in AI-assisted calculations where security is critical.
62
- The tool returns formatted results with configurable precision and helpful error messages
63
- when invalid expressions are provided.
64
-
65
- Supported operations:
66
- - Basic arithmetic: +, -, *, /, %
67
- - Parentheses for grouping: ( )
68
- - Exponentiation: ^ or pow(base, exponent)
69
- - Comparison operators: =, <, >, <=, >=, !=
70
- - Logical operators: and, or, not
71
- - Mathematical functions: sqrt, round, roundup, rounddown, abs
72
- - Trigonometric functions: sin, cos, tan
73
-
74
- #### `composite_analysis`
75
-
76
- Perform comprehensive multi-stage data analysis by orchestrating multiple specialized analysis steps
77
- to provide complete insights from various data sources. This composite tool automatically
78
- determines the appropriate data fetching method (web scraping for URLs, file reading for
79
- local paths), analyzes data structure and content, generates statistical insights,
80
- and suggests appropriate visualizations based on the data characteristics.
81
- Ideal for exploratory data analysis workflows where you need a complete picture
82
- from initial data loading through final insights. Handles CSV, JSON, and text data formats.
83
-
84
- ### Database
85
-
86
- #### `database_tool`
87
-
88
- Executes SQL commands (INSERT / UPDATE / SELECT / etc) on a database. Supports full read-write operations for data manipulation and schema management.
89
-
90
- #### `database_query`
91
-
92
- Execute safe, read-only database queries with automatic connection management and security controls.
93
- This tool is designed for secure data retrieval operations only, restricting access to SELECT statements
94
- to prevent any data modification. It includes automatic connection pooling, query result limiting,
95
- query timeout support, and comprehensive error handling. The tool supports multiple database configurations
96
- through environment variables and ensures all connections are properly closed after use.
97
-
98
- Security features:
99
- - SELECT-only queries (no INSERT, UPDATE, DELETE, DROP, etc.)
100
- - Automatic LIMIT clause enforcement
101
- - Query timeout protection
102
- - Prepared statement support to prevent SQL injection
103
- - Connection pooling with automatic cleanup
104
-
105
- Supported databases: PostgreSQL, MySQL, SQLite, SQL Server, Oracle, and any database supported by Sequel.
106
-
107
- ### File & System Operations
108
-
109
- #### `disk_tool`
110
-
111
- A tool for interacting with a system. It is able to list, create, delete, move and modify directories and files.
112
-
113
- #### `clipboard`
114
-
115
- Read from or write to the system clipboard.
116
-
117
- This tool provides cross-platform clipboard access:
118
- - macOS: Uses pbcopy/pbpaste
119
- - Linux: Uses xclip or xsel (must be installed)
120
- - Windows: Uses clip/powershell
121
-
122
- Actions: `read`, `write`, `clear`.
123
-
124
- #### `system_info`
125
-
126
- Retrieve system information including operating system, CPU, memory, and disk details.
127
-
128
- This tool provides cross-platform system information:
129
- - macOS: Uses system_profiler, sysctl, and df commands
130
- - Linux: Uses /proc filesystem and df command
131
- - Windows: Uses wmic and powershell commands
132
-
133
- Categories: `all`, `os`, `cpu`, `memory`, `disk`, `network`.
134
-
135
- #### `computer_tool`
136
-
137
- A tool for interacting with a computer.
138
-
139
- ### Web & Network
140
-
141
- #### `browser_tool`
142
-
143
- Automates a web browser to perform various actions like visiting web pages, clicking elements, inspecting page content, and taking screenshots.
144
-
145
- Actions:
146
- 1. `visit` - Navigate to a website
147
- 2. `page_inspect` - Get page HTML or summary
148
- 3. `ui_inspect` - Find elements by text content
149
- 4. `selector_inspect` - Find elements by CSS selector
150
- 5. `click` - Click an element by CSS selector
151
- 6. `text_field_set` - Enter text in input fields/text areas
152
- 7. `screenshot` - Take a screenshot of the page or specific element
153
-
154
- #### `dns`
155
-
156
- Perform DNS lookups and reverse DNS queries.
157
-
158
- Uses Ruby's built-in Resolv library for cross-platform DNS resolution.
159
-
160
- Actions:
161
- - `lookup` - Resolve a hostname to IP addresses
162
- - `reverse` - Perform reverse DNS lookup (IP to hostname)
163
- - `mx` - Get MX (mail exchange) records for a domain
164
- - `txt` - Get TXT records for a domain
165
- - `ns` - Get NS (nameserver) records for a domain
166
- - `all` - Get all available DNS records for a domain
167
-
168
- Record types for lookup: `A` (IPv4), `AAAA` (IPv6), `CNAME`, `ANY`.
169
-
170
- ### Code Execution
171
-
172
- #### `eval_tool`
173
-
174
- Execute code in various programming languages (Ruby, Python, Shell).
175
-
176
- **WARNING**: This tool executes arbitrary code. All code execution requires user authorization for security.
177
-
178
- Actions:
179
- - `ruby` - Execute Ruby code
180
- - `python` - Execute Python code (requires python3 in system PATH)
181
- - `shell` - Execute shell commands
182
-
183
- ### Documents
184
-
185
- #### `doc_tool`
186
-
187
- Read and process various document formats.
188
-
189
- Actions:
190
- - `pdf_read` - Read specific pages from a PDF document
191
-
192
- The `page_numbers` parameter accepts single pages (`"5"`), multiple pages (`"1, 3, 5"`), and range notation (`"1-10"` or `"1, 3-5, 10"`).
193
-
194
- ### Scheduling & Time
195
-
196
- #### `current_date_time`
197
-
198
- Returns the current date, time, and timezone information from the system.
199
- This tool provides accurate temporal context for AI assistants that need
200
- to reason about time-sensitive information or schedule-related queries.
201
-
202
- Returns: date (ISO 8601), time (24-hour), timezone name and UTC offset, Unix timestamp, day of week, and week number.
203
-
204
- #### `cron`
205
-
206
- Parse, validate, and explain cron expressions.
207
-
208
- Supports standard 5-field cron format (minute, hour, day of month, month, day of week) with special characters: `*`, `,`, `-`, `/`.
209
-
210
- Actions:
211
- - `parse` - Parse and explain a cron expression
212
- - `validate` - Check if a cron expression is valid
213
- - `next` - Calculate the next N execution times
214
- - `generate` - Generate a cron expression from a description
215
-
216
- ### Workflow & Weather
217
-
218
- #### `workflow_manager`
219
-
220
- Manage complex multi-step workflows with persistent state tracking across tool invocations.
221
- This tool enables the creation and management of stateful workflows that can span multiple
222
- AI interactions and tool calls. It provides workflow initialization, step-by-step execution,
223
- status monitoring, and completion tracking. Each workflow maintains its state in persistent
224
- storage, allowing for resumption of long-running processes and coordination between
225
- multiple tools and AI interactions.
226
-
227
- Workflow lifecycle:
228
- 1. **Start** - Initialize a new workflow with initial data (returns workflow_id)
229
- 2. **Step** - Execute multiple workflow steps using the workflow_id
230
- 3. **Status** - Check workflow progress and state at any time
231
- 4. **Complete** - Finalize the workflow and clean up resources
232
-
233
- #### `weather_tool`
234
-
235
- Retrieve comprehensive current weather information for any city worldwide using the OpenWeatherMap API.
236
- This tool provides real-time weather data including temperature, atmospheric conditions, humidity,
237
- and wind information. Requires the `OPENWEATHER_API_KEY` environment variable.
238
-
239
- ### Development & Reference
240
-
241
- #### `error_handling_tool`
242
-
243
- Reference tool demonstrating comprehensive error handling patterns and resilience strategies
244
- for robust tool development. This tool showcases best practices for handling different
245
- types of errors including validation errors, network failures, authorization issues,
246
- and general exceptions. It implements retry mechanisms with exponential backoff,
247
- proper resource cleanup, detailed error categorization, and user-friendly error messages.
248
-
249
- ## Related Documentation
250
-
251
- - [Tools Guide](tools.md) - Custom tool development and configuration
252
- - [Chat Mode](chat.md) - Using tools in interactive mode
253
- - [MCP Integration](../mcp-integration.md) - Model Context Protocol tools
254
- - [CLI Reference](../cli-reference.md) - `--require`, `--tools`, `--list-tools` options