agentsml-impl 0.2.0__tar.gz
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.
- agentsml_impl-0.2.0/LICENSE +28 -0
- agentsml_impl-0.2.0/PKG-INFO +109 -0
- agentsml_impl-0.2.0/README.md +88 -0
- agentsml_impl-0.2.0/pyproject.toml +41 -0
- agentsml_impl-0.2.0/setup.cfg +4 -0
- agentsml_impl-0.2.0/src/agentsml_impl/__init__.py +3 -0
- agentsml_impl-0.2.0/src/agentsml_impl/cli.py +472 -0
- agentsml_impl-0.2.0/src/agentsml_impl/compiler/__init__.py +1 -0
- agentsml_impl-0.2.0/src/agentsml_impl/compiler/capabilities.py +330 -0
- agentsml_impl-0.2.0/src/agentsml_impl/compiler/conditions.py +177 -0
- agentsml_impl-0.2.0/src/agentsml_impl/compiler/diagnostics.py +112 -0
- agentsml_impl-0.2.0/src/agentsml_impl/compiler/durations.py +31 -0
- agentsml_impl-0.2.0/src/agentsml_impl/compiler/expressions.py +123 -0
- agentsml_impl-0.2.0/src/agentsml_impl/compiler/identifiers.py +60 -0
- agentsml_impl-0.2.0/src/agentsml_impl/compiler/ir.py +391 -0
- agentsml_impl-0.2.0/src/agentsml_impl/compiler/limits.py +28 -0
- agentsml_impl-0.2.0/src/agentsml_impl/compiler/loader.py +83 -0
- agentsml_impl-0.2.0/src/agentsml_impl/compiler/naming.py +87 -0
- agentsml_impl-0.2.0/src/agentsml_impl/compiler/planner.py +79 -0
- agentsml_impl-0.2.0/src/agentsml_impl/compiler/render.py +90 -0
- agentsml_impl-0.2.0/src/agentsml_impl/compiler/schema_validation.py +121 -0
- agentsml_impl-0.2.0/src/agentsml_impl/compiler/semantic_validation.py +424 -0
- agentsml_impl-0.2.0/src/agentsml_impl/protocols/__init__.py +1 -0
- agentsml_impl-0.2.0/src/agentsml_impl/runtime/__init__.py +1 -0
- agentsml_impl-0.2.0/src/agentsml_impl/runtime/events.py +59 -0
- agentsml_impl-0.2.0/src/agentsml_impl/runtime/json_schema.py +138 -0
- agentsml_impl-0.2.0/src/agentsml_impl/runtime/tools.py +145 -0
- agentsml_impl-0.2.0/src/agentsml_impl/schemas/agentsml.schema.json +406 -0
- agentsml_impl-0.2.0/src/agentsml_impl/schemas/v0.1/agentsml.schema.json +628 -0
- agentsml_impl-0.2.0/src/agentsml_impl/schemas/v0.2/agentsml.schema.json +363 -0
- agentsml_impl-0.2.0/src/agentsml_impl/schemas/v0.3/agentsml.schema.json +406 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/__init__.py +1 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/a2a/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/a2a/adapter.py +94 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/a2a/capabilities.yaml +25 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/ag2/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/ag2/adapter.py +655 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/ag2/capabilities.yaml +37 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/ag_ui/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/ag_ui/adapter.py +123 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/ag_ui/capabilities.yaml +25 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/agno/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/agno/adapter.py +191 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/agno/capabilities.yaml +26 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/ap2/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/ap2/adapter.py +84 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/ap2/capabilities.yaml +25 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/base.py +157 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/bedrock_agentcore/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/bedrock_agentcore/adapter.py +592 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/bedrock_agentcore/capabilities.yaml +26 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/claude_agent_sdk/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/claude_agent_sdk/adapter.py +178 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/claude_agent_sdk/capabilities.yaml +26 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/crewai/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/crewai/adapter.py +441 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/crewai/capabilities.yaml +30 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/databricks/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/databricks/adapter.py +427 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/databricks/capabilities.yaml +26 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/flowise/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/flowise/adapter.py +71 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/flowise/capabilities.yaml +26 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/google_adk/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/google_adk/adapter.py +589 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/google_adk/capabilities.yaml +36 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/langchain/__init__.py +1 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/langchain/adapter.py +351 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/langchain/capabilities.yaml +30 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/langflow/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/langflow/adapter.py +147 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/langflow/capabilities.yaml +26 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/langgraph/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/langgraph/adapter.py +911 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/langgraph/capabilities.yaml +33 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/llamaindex/__init__.py +1 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/llamaindex/adapter.py +406 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/llamaindex/capabilities.yaml +31 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/lyzr/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/lyzr/adapter.py +146 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/lyzr/capabilities.yaml +26 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/mastra/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/mastra/adapter.py +635 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/mastra/capabilities.yaml +32 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/mcp_server/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/mcp_server/adapter.py +141 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/mcp_server/capabilities.yaml +25 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/microsoft_agent_framework/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/microsoft_agent_framework/adapter.py +563 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/microsoft_agent_framework/capabilities.yaml +26 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/n8n/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/n8n/adapter.py +139 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/n8n/capabilities.yaml +26 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/openai_agents/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/openai_agents/adapter.py +175 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/openai_agents/capabilities.yaml +27 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/pydantic_ai/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/pydantic_ai/adapter.py +922 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/pydantic_ai/capabilities.yaml +37 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/registry.py +290 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/relevance_ai/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/relevance_ai/adapter.py +66 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/relevance_ai/capabilities.yaml +26 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/smolagents/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/smolagents/adapter.py +210 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/smolagents/capabilities.yaml +27 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/snowflake_cortex/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/snowflake_cortex/adapter.py +167 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/snowflake_cortex/capabilities.yaml +26 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/spring_ai/__init__.py +1 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/spring_ai/adapter.py +626 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/spring_ai/capabilities.yaml +31 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/strands_agents/__init__.py +1 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/strands_agents/adapter.py +309 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/strands_agents/capabilities.yaml +29 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/support_matrix.py +91 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/ucp/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/ucp/adapter.py +86 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/ucp/capabilities.yaml +25 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/vercel_ai/__init__.py +1 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/vercel_ai/adapter.py +349 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/vercel_ai/capabilities.yaml +30 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/vertex_agent_engine/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/vertex_agent_engine/adapter.py +407 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/vertex_agent_engine/capabilities.yaml +26 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/zapier_agents/__init__.py +0 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/zapier_agents/adapter.py +106 -0
- agentsml_impl-0.2.0/src/agentsml_impl/targets/zapier_agents/capabilities.yaml +26 -0
- agentsml_impl-0.2.0/src/agentsml_impl.egg-info/PKG-INFO +109 -0
- agentsml_impl-0.2.0/src/agentsml_impl.egg-info/SOURCES.txt +132 -0
- agentsml_impl-0.2.0/src/agentsml_impl.egg-info/dependency_links.txt +1 -0
- agentsml_impl-0.2.0/src/agentsml_impl.egg-info/entry_points.txt +3 -0
- agentsml_impl-0.2.0/src/agentsml_impl.egg-info/requires.txt +10 -0
- agentsml_impl-0.2.0/src/agentsml_impl.egg-info/top_level.txt +1 -0
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Sanjay Sharma
|
|
4
|
+
Author: Sanjay Sharma
|
|
5
|
+
|
|
6
|
+
Attribution notice: derivative works should preserve and quote both the
|
|
7
|
+
copyright holder, "Sanjay Sharma", and the author, "Sanjay Sharma",
|
|
8
|
+
in their notices or acknowledgements.
|
|
9
|
+
|
|
10
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
11
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
12
|
+
in the Software without restriction, including without limitation the rights
|
|
13
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
14
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
15
|
+
furnished to do so, subject to the following conditions:
|
|
16
|
+
|
|
17
|
+
The above copyright notice, author notice, attribution notice, and this
|
|
18
|
+
permission notice shall be included in all copies or substantial portions of
|
|
19
|
+
the Software.
|
|
20
|
+
|
|
21
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
22
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
23
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
24
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
25
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
26
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
27
|
+
SOFTWARE.
|
|
28
|
+
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: agentsml-impl
|
|
3
|
+
Version: 0.2.0
|
|
4
|
+
Summary: AgentsML IR-first compiler — converts AgentsML YAML documents into target-specific code, manifests, and deployment bundles.
|
|
5
|
+
Author: Sanjay Sharma
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
Keywords: agentsml,agents,compiler,codegen
|
|
8
|
+
Requires-Python: >=3.11
|
|
9
|
+
Description-Content-Type: text/markdown
|
|
10
|
+
License-File: LICENSE
|
|
11
|
+
Requires-Dist: pyyaml>=6.0
|
|
12
|
+
Requires-Dist: jsonschema>=4.23
|
|
13
|
+
Requires-Dist: jinja2>=3.1
|
|
14
|
+
Requires-Dist: typer>=0.12
|
|
15
|
+
Requires-Dist: rich>=13.0
|
|
16
|
+
Requires-Dist: pydantic>=2.7
|
|
17
|
+
Provides-Extra: dev
|
|
18
|
+
Requires-Dist: pytest>=8.0; extra == "dev"
|
|
19
|
+
Requires-Dist: pytest-cov; extra == "dev"
|
|
20
|
+
Dynamic: license-file
|
|
21
|
+
|
|
22
|
+
# agentsml-impl
|
|
23
|
+
|
|
24
|
+
`agentsml-impl` is the reference compiler and implementation surface for AgentsML.
|
|
25
|
+
It ingests AgentsML definitions (YAML or JSON) and compiles them into functioning code, export artifacts, and standard configurations for various target AI agent runtimes and protocols.
|
|
26
|
+
|
|
27
|
+
This repository is distinct from the core spec repository. While `agentsml/` contains the standard definitions and schemas, `agentsml-impl/` brings them to life via a Design 2 IR-first compilation approach.
|
|
28
|
+
|
|
29
|
+
## Supported Targets
|
|
30
|
+
|
|
31
|
+
See [Target Support Matrix](docs/target-support.md) for the current registry coverage, grouped by target category and maturity. The registry lists 31 targets: 22 runnable generators, 9 export generators, and 0 scaffolds. Certification: 15 external-runtime, 16 offline-behavioral, 0 structural. Registry level is retained for compatibility but does not imply runtime maturity.
|
|
32
|
+
|
|
33
|
+
## Quickstart
|
|
34
|
+
|
|
35
|
+
### Installation
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
# Clone the repository
|
|
39
|
+
git clone https://github.com/indoos/agentsml-impl.git
|
|
40
|
+
cd agentsml-impl
|
|
41
|
+
|
|
42
|
+
# Install locally
|
|
43
|
+
pip install -e .
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
### Usage
|
|
47
|
+
|
|
48
|
+
The CLI is available as both `agentsml` and `agentsml-impl`.
|
|
49
|
+
|
|
50
|
+
**1. Validate an AgentsML document:**
|
|
51
|
+
```bash
|
|
52
|
+
agentsml validate path/to/agent.yaml
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
**2. Compile to a Target Framework:**
|
|
56
|
+
```bash
|
|
57
|
+
agentsml generate path/to/agent.yaml --target pydantic-ai --out my_project
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
**3. Run Diagnostic Checks:**
|
|
61
|
+
```bash
|
|
62
|
+
agentsml doctor path/to/agent.yaml --target crewai
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
**4. Compile (alias of generate):**
|
|
66
|
+
```bash
|
|
67
|
+
agentsml compile path/to/agent.yaml -t langgraph -o my_project
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
**5. Render the execution graph:**
|
|
71
|
+
```bash
|
|
72
|
+
agentsml graph path/to/agent.yaml --format mermaid
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
**6. List registered targets with maturity and certification:**
|
|
76
|
+
```bash
|
|
77
|
+
agentsml list-targets
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
### Development & Testing
|
|
81
|
+
|
|
82
|
+
Run the complete structural, golden, conformance, and behavioral suite:
|
|
83
|
+
```bash
|
|
84
|
+
pip install -e ".[dev]"
|
|
85
|
+
pytest
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Run offline behavioral and external-runtime certification:
|
|
89
|
+
```bash
|
|
90
|
+
python scripts/run_certification.py
|
|
91
|
+
uv run --python 3.12 --with pytest --with 'pydantic-ai==1.107.0' --with 'langchain>=1.0,<2' --with 'langgraph==1.2.20' --with 'langchain-openai==1.7.4' --with 'google-adk==2.14.0' --with 'a2a-sdk[http-server]>=1.3.0' --with 'git+https://github.com/openai/swarm.git' --with 'smolagents[openai]>=1.0.0' --with 'anthropic>=0.30.0' --with 'crewai>=0.80.0' --with 'llama-index-core>=0.11.0' --with 'llama-index-llms-openai>=0.1.0' --with 'agno>=1.0.0' --with 'ag2==1.3.1' --with 'uvicorn>=0.30' --with 'strands-agents==1.65.0' --with 'semantic-kernel==1.47.0' --with 'protobuf' python scripts/run_external_certification.py --suite a
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Structural tests prove artifact shape and syntax. Offline behavioral tests
|
|
95
|
+
execute generated helpers or validate generated protocol artifacts against
|
|
96
|
+
semantic contracts. External-runtime tests install and exercise the real target
|
|
97
|
+
SDK or runtime against deterministic fixtures. Fifteen targets are external-runtime certified and the remaining sixteen are offline-behavioral certified; see the support matrix for per-target evidence.
|
|
98
|
+
|
|
99
|
+
## Changelog
|
|
100
|
+
|
|
101
|
+
See [CHANGELOG.md](CHANGELOG.md).
|
|
102
|
+
|
|
103
|
+
## Adding a Target
|
|
104
|
+
|
|
105
|
+
Please refer to the [Adapter Authoring Guide](docs/adapter-authoring.md) for instructions on creating a new target generator.
|
|
106
|
+
|
|
107
|
+
## License
|
|
108
|
+
|
|
109
|
+
MIT. See [LICENSE](LICENSE).
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# agentsml-impl
|
|
2
|
+
|
|
3
|
+
`agentsml-impl` is the reference compiler and implementation surface for AgentsML.
|
|
4
|
+
It ingests AgentsML definitions (YAML or JSON) and compiles them into functioning code, export artifacts, and standard configurations for various target AI agent runtimes and protocols.
|
|
5
|
+
|
|
6
|
+
This repository is distinct from the core spec repository. While `agentsml/` contains the standard definitions and schemas, `agentsml-impl/` brings them to life via a Design 2 IR-first compilation approach.
|
|
7
|
+
|
|
8
|
+
## Supported Targets
|
|
9
|
+
|
|
10
|
+
See [Target Support Matrix](docs/target-support.md) for the current registry coverage, grouped by target category and maturity. The registry lists 31 targets: 22 runnable generators, 9 export generators, and 0 scaffolds. Certification: 15 external-runtime, 16 offline-behavioral, 0 structural. Registry level is retained for compatibility but does not imply runtime maturity.
|
|
11
|
+
|
|
12
|
+
## Quickstart
|
|
13
|
+
|
|
14
|
+
### Installation
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
# Clone the repository
|
|
18
|
+
git clone https://github.com/indoos/agentsml-impl.git
|
|
19
|
+
cd agentsml-impl
|
|
20
|
+
|
|
21
|
+
# Install locally
|
|
22
|
+
pip install -e .
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
### Usage
|
|
26
|
+
|
|
27
|
+
The CLI is available as both `agentsml` and `agentsml-impl`.
|
|
28
|
+
|
|
29
|
+
**1. Validate an AgentsML document:**
|
|
30
|
+
```bash
|
|
31
|
+
agentsml validate path/to/agent.yaml
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
**2. Compile to a Target Framework:**
|
|
35
|
+
```bash
|
|
36
|
+
agentsml generate path/to/agent.yaml --target pydantic-ai --out my_project
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
**3. Run Diagnostic Checks:**
|
|
40
|
+
```bash
|
|
41
|
+
agentsml doctor path/to/agent.yaml --target crewai
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
**4. Compile (alias of generate):**
|
|
45
|
+
```bash
|
|
46
|
+
agentsml compile path/to/agent.yaml -t langgraph -o my_project
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
**5. Render the execution graph:**
|
|
50
|
+
```bash
|
|
51
|
+
agentsml graph path/to/agent.yaml --format mermaid
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
**6. List registered targets with maturity and certification:**
|
|
55
|
+
```bash
|
|
56
|
+
agentsml list-targets
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
### Development & Testing
|
|
60
|
+
|
|
61
|
+
Run the complete structural, golden, conformance, and behavioral suite:
|
|
62
|
+
```bash
|
|
63
|
+
pip install -e ".[dev]"
|
|
64
|
+
pytest
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
Run offline behavioral and external-runtime certification:
|
|
68
|
+
```bash
|
|
69
|
+
python scripts/run_certification.py
|
|
70
|
+
uv run --python 3.12 --with pytest --with 'pydantic-ai==1.107.0' --with 'langchain>=1.0,<2' --with 'langgraph==1.2.20' --with 'langchain-openai==1.7.4' --with 'google-adk==2.14.0' --with 'a2a-sdk[http-server]>=1.3.0' --with 'git+https://github.com/openai/swarm.git' --with 'smolagents[openai]>=1.0.0' --with 'anthropic>=0.30.0' --with 'crewai>=0.80.0' --with 'llama-index-core>=0.11.0' --with 'llama-index-llms-openai>=0.1.0' --with 'agno>=1.0.0' --with 'ag2==1.3.1' --with 'uvicorn>=0.30' --with 'strands-agents==1.65.0' --with 'semantic-kernel==1.47.0' --with 'protobuf' python scripts/run_external_certification.py --suite a
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Structural tests prove artifact shape and syntax. Offline behavioral tests
|
|
74
|
+
execute generated helpers or validate generated protocol artifacts against
|
|
75
|
+
semantic contracts. External-runtime tests install and exercise the real target
|
|
76
|
+
SDK or runtime against deterministic fixtures. Fifteen targets are external-runtime certified and the remaining sixteen are offline-behavioral certified; see the support matrix for per-target evidence.
|
|
77
|
+
|
|
78
|
+
## Changelog
|
|
79
|
+
|
|
80
|
+
See [CHANGELOG.md](CHANGELOG.md).
|
|
81
|
+
|
|
82
|
+
## Adding a Target
|
|
83
|
+
|
|
84
|
+
Please refer to the [Adapter Authoring Guide](docs/adapter-authoring.md) for instructions on creating a new target generator.
|
|
85
|
+
|
|
86
|
+
## License
|
|
87
|
+
|
|
88
|
+
MIT. See [LICENSE](LICENSE).
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools>=68", "wheel"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "agentsml-impl"
|
|
7
|
+
version = "0.2.0"
|
|
8
|
+
description = "AgentsML IR-first compiler — converts AgentsML YAML documents into target-specific code, manifests, and deployment bundles."
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
requires-python = ">=3.11"
|
|
11
|
+
license = "MIT"
|
|
12
|
+
authors = [{ name = "Sanjay Sharma" }]
|
|
13
|
+
keywords = ["agentsml", "agents", "compiler", "codegen"]
|
|
14
|
+
dependencies = [
|
|
15
|
+
"pyyaml>=6.0",
|
|
16
|
+
"jsonschema>=4.23",
|
|
17
|
+
"jinja2>=3.1",
|
|
18
|
+
"typer>=0.12",
|
|
19
|
+
"rich>=13.0",
|
|
20
|
+
"pydantic>=2.7",
|
|
21
|
+
]
|
|
22
|
+
|
|
23
|
+
[project.scripts]
|
|
24
|
+
agentsml-impl = "agentsml_impl.cli:app"
|
|
25
|
+
agentsml = "agentsml_impl.cli:app"
|
|
26
|
+
|
|
27
|
+
[project.optional-dependencies]
|
|
28
|
+
dev = [
|
|
29
|
+
"pytest>=8.0",
|
|
30
|
+
"pytest-cov",
|
|
31
|
+
]
|
|
32
|
+
|
|
33
|
+
[tool.setuptools.packages.find]
|
|
34
|
+
where = ["src"]
|
|
35
|
+
|
|
36
|
+
[tool.setuptools.package-data]
|
|
37
|
+
agentsml_impl = ["**/*.yaml", "**/*.json"]
|
|
38
|
+
|
|
39
|
+
[tool.pytest.ini_options]
|
|
40
|
+
testpaths = ["tests"]
|
|
41
|
+
addopts = "-v"
|