aia 2.0.0.0.pre.beta2 → 2.0.1
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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +152 -223
- data/README.md +41 -18
- data/bin/aia +8 -3
- data/lib/aia/aia_completion.bash +2 -3
- data/lib/aia/aia_completion.fish +6 -5
- data/lib/aia/aia_completion.zsh +2 -3
- data/lib/aia/chat_loop.rb +16 -14
- data/lib/aia/config/cli_parser.rb +123 -91
- data/lib/aia/config/defaults.yml +18 -40
- data/lib/aia/config/mcp_parser.rb +30 -36
- data/lib/aia/config/model_spec.rb +8 -14
- data/lib/aia/config/validator.rb +102 -103
- data/lib/aia/config/value_caster.rb +76 -0
- data/lib/aia/config.rb +70 -53
- data/lib/aia/crew.rb +29 -19
- data/lib/aia/debate_handler.rb +27 -10
- data/lib/aia/directives/configuration_directives.rb +55 -14
- data/lib/aia/directives/context_directives.rb +24 -12
- data/lib/aia/directives/execution_directives.rb +18 -23
- data/lib/aia/directives/model_directives.rb +41 -104
- data/lib/aia/directives/utility_directives.rb +16 -17
- data/lib/aia/directives/web_and_file_directives.rb +21 -14
- data/lib/aia/fact_asserter.rb +3 -3
- data/lib/aia/history_transfer.rb +64 -24
- data/lib/aia/logger.rb +14 -46
- data/lib/aia/mcp_config_normalizer.rb +27 -14
- data/lib/aia/mcp_connection_manager.rb +181 -184
- data/lib/aia/mcp_discovery.rb +43 -15
- data/lib/aia/mcp_grouper.rb +2 -1
- data/lib/aia/mcp_server_config.rb +20 -2
- data/lib/aia/mcp_utility.rb +24 -19
- data/lib/aia/mention_router.rb +15 -2
- data/lib/aia/modality_query.rb +36 -0
- data/lib/aia/model_alias_registry.rb +11 -11
- data/lib/aia/model_registry.rb +75 -0
- data/lib/aia/network_builder.rb +8 -7
- data/lib/aia/patches/mcp_stdio_stderr.rb +102 -0
- data/lib/aia/patches/ruby_llm_streaming_error.rb +21 -4
- data/lib/aia/patches/ruby_llm_tool_param_compat.rb +18 -0
- data/lib/aia/pipeline_orchestrator.rb +71 -38
- data/lib/aia/prompt_decomposer.rb +1 -1
- data/lib/aia/prompt_handler.rb +56 -29
- data/lib/aia/provider_registry.rb +105 -0
- data/lib/aia/robot_builder.rb +1 -1
- data/lib/aia/robot_factory.rb +67 -63
- data/lib/aia/robot_sync.rb +79 -0
- data/lib/aia/role_catalog.rb +89 -0
- data/lib/aia/session.rb +25 -11
- data/lib/aia/skill_utils.rb +60 -19
- data/lib/aia/spawn_handler.rb +16 -4
- data/lib/aia/spawn_spec_parser.rb +6 -7
- data/lib/aia/special_mode_handler.rb +28 -25
- data/lib/aia/speech.rb +70 -34
- data/lib/aia/startup_coordinator.rb +17 -92
- data/lib/aia/streaming_runner.rb +10 -2
- data/lib/aia/system_prompt_assembler.rb +12 -11
- data/lib/aia/task_board.rb +60 -0
- data/lib/aia/tool_approver.rb +205 -0
- data/lib/aia/tool_filter.rb +1 -10
- data/lib/aia/tool_filter_strategy.rb +12 -1
- data/lib/aia/tool_introspection.rb +9 -1
- data/lib/aia/tool_loader.rb +67 -33
- data/lib/aia/tool_utility.rb +6 -5
- data/lib/aia/tools/delegate_to_foreman_tool.rb +6 -4
- data/lib/aia/tools/recruit_robot_tool.rb +12 -12
- data/lib/aia/tools/reskill_robot_tool.rb +7 -7
- data/lib/aia/tools/task_board_tool.rb +16 -16
- data/lib/aia/trakflow_bridge.rb +14 -8
- data/lib/aia/turn_state.rb +31 -8
- data/lib/aia/ui_presenter.rb +16 -0
- data/lib/aia/utility.rb +6 -24
- data/lib/aia/variable_input_collector.rb +0 -3
- data/lib/aia/verification_network.rb +9 -10
- data/lib/aia/version.rb +1 -9
- data/lib/aia.rb +34 -8
- metadata +20 -161
- data/.better-commits.json +0 -150
- data/.config/tocer/configuration.yml +0 -6
- data/.envrc +0 -19
- data/.loki +0 -11
- data/.reek.yml +0 -160
- data/.rubocop.yml +0 -116
- data/.rubocop_strict.yml +0 -15
- data/.version +0 -1
- data/COMMITS.md +0 -196
- data/IMPLEMENTATION_PLAN.md +0 -506
- data/Rakefile +0 -47
- data/_typos.toml +0 -10
- data/aia.gemspec +0 -92
- data/architecture_review.md +0 -314
- data/config/aia.yml +0 -13
- data/docs/AGENTS.md +0 -40
- data/docs/advanced-prompting.md +0 -814
- data/docs/assets/images/aia.png +0 -0
- data/docs/cli-reference.md +0 -1241
- data/docs/configuration.md +0 -747
- data/docs/contributing.md +0 -386
- data/docs/directives-reference.md +0 -1145
- data/docs/examples/index.md +0 -277
- data/docs/examples/mcp/index.md +0 -475
- data/docs/examples/prompts/analysis/index.md +0 -78
- data/docs/examples/prompts/automation/index.md +0 -109
- data/docs/examples/prompts/development/index.md +0 -125
- data/docs/examples/prompts/index.md +0 -333
- data/docs/examples/prompts/learning/index.md +0 -127
- data/docs/examples/prompts/writing/index.md +0 -62
- data/docs/examples/tools/index.md +0 -282
- data/docs/faq.md +0 -578
- data/docs/guides/available-models.md +0 -366
- data/docs/guides/basic-usage.md +0 -478
- data/docs/guides/chat.md +0 -680
- data/docs/guides/crew.md +0 -239
- data/docs/guides/executable-prompts.md +0 -331
- data/docs/guides/first-prompt.md +0 -454
- data/docs/guides/getting-started.md +0 -455
- data/docs/guides/image-generation.md +0 -507
- data/docs/guides/index.md +0 -48
- data/docs/guides/local-models.md +0 -306
- data/docs/guides/migrate-prompts.md +0 -335
- data/docs/guides/models.md +0 -1017
- data/docs/guides/shared-tools.md +0 -254
- data/docs/guides/tools.md +0 -831
- data/docs/index.md +0 -259
- data/docs/installation.md +0 -274
- data/docs/mcp-integration.md +0 -603
- data/docs/prompt_management.md +0 -665
- data/docs/security.md +0 -674
- data/docs/special_projects_guide.md +0 -386
- data/docs/tools-and-mcp-examples.md +0 -1211
- data/docs/workflows-and-pipelines.md +0 -636
- data/examples/.gitignore +0 -2
- data/examples/00_setup_aia.sh +0 -111
- data/examples/01_basic_usage.sh +0 -23
- data/examples/02_frontmatter.sh +0 -33
- data/examples/03_shell_integration.sh +0 -55
- data/examples/04_erb_templating.sh +0 -56
- data/examples/05_shell_then_erb.sh +0 -38
- data/examples/06_prompt_chaining.sh +0 -59
- data/examples/07_pipeline.sh +0 -46
- data/examples/08_context_files.sh +0 -43
- data/examples/09_roles.sh +0 -67
- data/examples/10_stdin_piping.sh +0 -49
- data/examples/11_multi_model.sh +0 -65
- data/examples/12_token_usage.sh +0 -52
- data/examples/13_cost_tracking.sh +0 -68
- data/examples/14_output_file.sh +0 -91
- data/examples/15_parameters.sh +0 -68
- data/examples/16_directives.sh +0 -113
- data/examples/17_require_and_conditionals.sh +0 -68
- data/examples/18_tools.sh +0 -61
- data/examples/19_local_tools.sh +0 -34
- data/examples/20_mcp_servers.sh +0 -102
- data/examples/21_executable_prompts.sh +0 -78
- data/examples/22_chat_mode.sh +0 -217
- data/examples/23_verify.sh +0 -139
- data/examples/24_decompose.sh +0 -139
- data/examples/25_spawn.sh +0 -139
- data/examples/26_debate.sh +0 -97
- data/examples/27_mention_routing.sh +0 -157
- data/examples/28_model_switching.sh +0 -106
- data/examples/29_agent_harness.sh +0 -177
- data/examples/README.md +0 -321
- data/examples/advanced_multi_robot_capabilities_without_examples.md +0 -106
- data/examples/aia_config.yml +0 -22
- data/examples/aia_config_orchestrator.yml +0 -45
- data/examples/aia_config_with_mcp.yml +0 -21
- data/examples/common.sh +0 -39
- data/examples/context/project_goals.md +0 -6
- data/examples/context/tech_stack.md +0 -7
- data/examples/directives/timestamp_directive.rb +0 -22
- data/examples/mcp/filesystem.json +0 -9
- data/examples/prompts_dir/analyze.md +0 -2
- data/examples/prompts_dir/brainstorm.md +0 -2
- data/examples/prompts_dir/conditional.md +0 -17
- data/examples/prompts_dir/creative.md +0 -4
- data/examples/prompts_dir/erbinfo.md +0 -5
- data/examples/prompts_dir/erbinfo_raw.md +0 -8
- data/examples/prompts_dir/evaluate.md +0 -2
- data/examples/prompts_dir/explain_joke.md +0 -1
- data/examples/prompts_dir/explain_recursion.md +0 -1
- data/examples/prompts_dir/fun_fact +0 -3
- data/examples/prompts_dir/greeting.md +0 -8
- data/examples/prompts_dir/greeting_required.md +0 -7
- data/examples/prompts_dir/hello.md +0 -1
- data/examples/prompts_dir/includes/ruby_facts.md +0 -4
- data/examples/prompts_dir/limerick.md +0 -1
- data/examples/prompts_dir/list_with_mcp.md +0 -3
- data/examples/prompts_dir/pick_best.md +0 -2
- data/examples/prompts_dir/project_summary +0 -12
- data/examples/prompts_dir/quiz_with_include.md +0 -6
- data/examples/prompts_dir/require_demo.md +0 -5
- data/examples/prompts_dir/roles/formal.md +0 -3
- data/examples/prompts_dir/roles/orchestrator.md +0 -21
- data/examples/prompts_dir/roles/pirate.md +0 -3
- data/examples/prompts_dir/shell_then_erb.md +0 -6
- data/examples/prompts_dir/sort_compare.md +0 -2
- data/examples/prompts_dir/summarize_context.md +0 -2
- data/examples/prompts_dir/sysinfo.md +0 -5
- data/examples/prompts_dir/sysinfo_raw.md +0 -8
- data/examples/prompts_dir/tagline.md +0 -1
- data/examples/prompts_dir/tell_joke.md +0 -1
- data/examples/prompts_dir/tell_joke_with_next.md +0 -4
- data/examples/prompts_dir/use_local_tool.md +0 -8
- data/examples/prompts_dir/use_tools.md +0 -8
- data/examples/prompts_dir/weather.md +0 -2
- data/examples/prompts_dir/whats_new.md +0 -2
- data/examples/prompts_dir/with_timestamp.md +0 -5
- data/examples/requirements/sinatra_taskflow_app.md +0 -139
- data/examples/rules/01_classify_ruby.rb +0 -16
- data/examples/rules/02_prefer_claude_for_code.rb +0 -19
- data/examples/rules/03_gate_prompt_length.rb +0 -19
- data/examples/rules/04_tool_selection.rb +0 -41
- data/examples/rules/README.md +0 -30
- data/examples/run_all.sh +0 -294
- data/examples/tools/word_count_tool.rb +0 -30
- data/lib/AGENTS.md +0 -57
- data/lib/aia/model_switch_handler.rb +0 -100
- data/mcp_servers/README.md +0 -110
- data/mcp_servers/apple-mcp.json +0 -8
- data/mcp_servers/filesystem.json +0 -9
- data/mcp_servers/mcp_server_chart.json +0 -11
- data/mcp_servers/playwright_one.json +0 -8
- data/mcp_servers/playwright_server_definition.json +0 -9
- data/mcp_servers/playwright_two.json +0 -8
- data/mcp_servers/tavily_mcp_server.json +0 -8
- 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!
|