| fetch_documentation_tool | Fetches and formats narrative documentation from Ilograph website.
This tool provides detailed explanations, tutorials, and examples for learning
Ilograph concepts and implementation patterns. Content is fetched from the official
Ilograph documentation site and converted to clean markdown format.
Args:
section: Documentation section to fetch. Supported sections:
- 'resources' -> Resource tree organization, hierarchies, instanceOf patterns
- 'relation-perspectives' -> Arrow connections, from/to properties, routing, labels
- 'sequence-perspectives' -> Time-based diagrams with steps, bidirectional flows
- 'references' -> Resource reference patterns and advanced referencing
- 'advanced-references' -> Complex reference scenarios and usage patterns
- 'resource-sizes-and-positions' -> Layout control, resource sizing, visual hierarchy
- 'parent-overrides' -> Resource parent overrides in perspectives with scale properties
- 'perspectives-other-properties' -> Additional perspective properties and options
- 'icons' -> Icon system with iconStyle, icon paths, and categorization
- 'walkthroughs' -> Interactive step-by-step guides through diagrams
- 'contexts' -> Multiple context views with roots, extends inheritance
- 'imports' -> Namespace management with from/namespace properties, component reuse
- 'markdown' -> Rich text support in descriptions, notes, and diagram text
- 'tutorial' -> Complete tutorial for learning Ilograph diagram creation
Returns:
str: Clean markdown content with detailed explanations, examples, and best practices
|
| list_documentation_sections | Lists all available Ilograph documentation sections with descriptions.
This tool provides an overview of all available documentation sections
that can be fetched using the fetch_documentation_tool.
Returns:
str: Formatted list of available documentation sections with descriptions
|
| check_documentation_health | Checks the health and connectivity of the documentation fetching service.
This tool performs connectivity tests and returns status information about
the documentation fetching capabilities, including cache statistics.
Returns:
str: Health status report with service connectivity and cache information
|
| fetch_spec_tool | Fetches the official Ilograph specification from https://www.ilograph.com/docs/spec/
This tool provides the authoritative reference for all Ilograph properties, types,
and requirements in a structured table format - perfect for validation and quick lookups.
Returns:
str: Complete specification in markdown format with:
- Top-level properties table
- Resource properties and types
- Perspective properties and types
- Relation, Sequence, Step definitions
- Context, Layout, Import specifications
- All property types and requirements
|
| check_spec_health | Checks the health and connectivity of the specification fetching service.
This tool performs connectivity tests specifically for the specification endpoint
and returns status information about spec fetching capabilities.
Returns:
str: Health status report with spec service connectivity and cache information
|
| list_examples | Lists available Ilograph example diagrams, optionally filtering by category.
Args:
category: Filter examples by complexity ('beginner', 'intermediate', 'advanced').
Returns:
A dictionary containing a list of available examples and a message guiding the user.
|
| fetch_example | Retrieves a static example diagram with its content and learning context.
Args:
example_name: The filename of the example to fetch (e.g., 'serverless-on-aws.ilograph').
Returns:
A dictionary containing the example's content, metadata, learning objectives, and patterns.
|
| validate_diagram_tool | Validates Ilograph YAML syntax and structure.
This tool performs comprehensive validation of Ilograph diagrams:
1. First validates YAML syntax for structural correctness
2. Then validates Ilograph-specific schema requirements
3. Provides detailed error messages, warnings, and suggestions
4. Can optionally use official Ilograph specification for context
Args:
content: The Ilograph diagram content as a string
Returns:
dict: Validation result with success/failure, errors, warnings, and suggestions
Format: {
"success": bool,
"yaml_valid": bool,
"schema_valid": bool,
"summary": {"total_errors": int, "total_warnings": int, "total_info": int},
"errors": [{"level": str, "message": str, "line": int, "suggestion": str}, ...],
"warnings": [...],
"info": [...],
"assessment": str
}
|
| get_validation_help | Provides comprehensive help for Ilograph diagram validation.
Returns guidance on common validation issues, proper syntax,
and best practices for creating valid Ilograph diagrams.
Returns:
str: Detailed validation help in markdown format
|
| search_icons_tool | Searches the current icon catalog with semantic matching.
This tool fetches the live icon catalog from Ilograph and provides intelligent
search capabilities to help find appropriate icons for diagram resources.
Args:
query: Search term (e.g., 'database', 'aws lambda', 'kubernetes', 'storage')
provider: Optional filter by provider ('AWS', 'Azure', 'GCP', 'Networking')
Returns:
list: Matching icons with paths, categories, and usage information.
Each icon dict contains:
- path: The icon path for use in Ilograph diagrams
- provider: The cloud provider or category (AWS, Azure, GCP, Networking)
- category: The service category (e.g., 'Compute', 'Database', 'Analytics')
- name: The specific icon name
- usage: Example usage string for Ilograph diagrams
|
| list_icon_providers_tool | Lists all available icon providers and their categories.
This tool provides an overview of the icon catalog structure,
showing available providers and their service categories.
Returns:
dict: Provider information with categories and icon counts
|
