Skip to content

Building AI agents, atomically

chore: add release skill and format test files

KennyVaneetvelde9487597c41ce
diff --git a/.claude/skills/release/SKILL.md b/.claude/skills/release/SKILL.md
new file mode 100644
index 0000000..a41542e
--- /dev/null
+++ b/.claude/skills/release/SKILL.md
@@ -0,0 +1,104 @@
+---
+name: release
+description: Release a new version of atomic-agents to PyPI and GitHub. Use when the user asks to "release", "publish", "deploy", or "bump version" for atomic-agents.
+allowed-tools: Read, Bash, Grep, Glob
+---
+
+# Release Process for atomic-agents
+
+## Overview
+
+This skill guides the release process for atomic-agents, including version bumping, PyPI publishing, and GitHub release creation.
+
+## Prerequisites
+
+- Must be on `main` branch with clean working directory
+- `.env` file must contain `PYPI_TOKEN` environment variable
+- Must have push access to the repository
+
+## Release Types
+
+| Type | When to Use | Example |
+|------|-------------|---------|
+| `major` | Breaking changes | 2.5.0 → 3.0.0 |
+| `minor` | New features (backwards compatible) | 2.5.0 → 2.6.0 |
+| `patch` | Bug fixes only | 2.5.0 → 2.5.1 |
+
+## Step-by-Step Process
+
+### 1. Prepare the Branch
+
+```bash
+git checkout main
+git pull
+git status # Ensure clean working directory
+```
+
+### 2. Run Build and Deploy Script
+
+**Important**: The script bumps versions, so if it fails partway through, reset to main before retrying.
+
+```powershell
+powershell -ExecutionPolicy Bypass -File build_and_deploy.ps1 <major|minor|patch>
+```
+
+This script will:
+- Read current version from `pyproject.toml`
+- Increment version based on release type
+- Update `pyproject.toml` with new version
+- Run `uv sync` to update dependencies
+- Run `uv build` to create distribution packages
+- Run `uv publish` to upload to PyPI
+
+### 3. If Script Fails - Reset and Retry
+
+```bash
+git checkout main
+git reset --hard origin/main
+# Fix the issue, then run script again
+```
+
+### 4. Commit and Push Version Bump
+
+```bash
+git add pyproject.toml uv.lock
+git commit -m "Release vX.Y.Z"
+git push
+```
+
+### 5. Create GitHub Release
+
+```bash
+gh release create vX.Y.Z --title "vX.Y.Z" --notes "RELEASE_NOTES_HERE"
+```
+
+## Release Notes Template
+
+```markdown
+## What's New
+
+### Feature Name
+Brief description of the feature.
+
+#### Features
+- Feature 1
+- Feature 2
+
+#### Improvements
+- Improvement 1
+
+#### Bug Fixes
+- Fix 1
+
+### Full Changelog
+https://github.com/BrainBlend-AI/atomic-agents/compare/vOLD...vNEW
+```
+
+## Checklist
+
+- [ ] On main branch with clean working directory
+- [ ] `.env` file has `PYPI_TOKEN`
+- [ ] Determined correct release type (major/minor/patch)
+- [ ] Build and deploy script completed successfully
+- [ ] Version bump committed and pushed
+- [ ] GitHub release created with release notes
diff --git a/.gitignore b/.gitignore
index a1ba1b7..7c8bfc0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -153,6 +153,8 @@ debug.log
# AI tools
.claude
+!.claude/skills/
+!.claude/skills/**
CLAUDE.md
CLAUDE.local.md
.serena
\ No newline at end of file
diff --git a/atomic-agents/tests/connectors/mcp/test_mcp_factory.py b/atomic-agents/tests/connectors/mcp/test_mcp_factory.py
index 3ac5c19..1b15818 100644
--- a/atomic-agents/tests/connectors/mcp/test_mcp_factory.py
+++ b/atomic-agents/tests/connectors/mcp/test_mcp_factory.py
@@ -207,9 +207,7 @@ async def test_typed_output_schema_with_structured_content_dict(monkeypatch):
"required": ["results", "count"],
}
definitions = [
- MCPToolDefinition(
- name="SearchTool", description="Search tool", input_schema=input_schema, output_schema=output_schema
- )
+ MCPToolDefinition(name="SearchTool", description="Search tool", input_schema=input_schema, output_schema=output_schema)
]
monkeypatch.setattr(MCPFactory, "_fetch_tool_definitions", lambda self: definitions)
tools = fetch_mcp_tools("http://example.com", MCPTransportType.HTTP_STREAM)
diff --git a/atomic-agents/tests/connectors/mcp/test_schema_transformer.py b/atomic-agents/tests/connectors/mcp/test_schema_transformer.py
index c198c9b..cbfd4be 100644
--- a/atomic-agents/tests/connectors/mcp/test_schema_transformer.py
+++ b/atomic-agents/tests/connectors/mcp/test_schema_transformer.py
@@ -218,9 +218,7 @@ class TestCreateModelFromSchema:
},
"required": ["results", "count"],
}
- model = SchemaTransformer.create_model_from_schema(
- schema, "OutputModel", "my_tool", is_output_schema=True
- )
+ model = SchemaTransformer.create_model_from_schema(schema, "OutputModel", "my_tool", is_output_schema=True)
# Output schema should NOT have tool_name field
assert "tool_name" not in model.model_fields
@@ -243,9 +241,7 @@ class TestCreateModelFromSchema:
},
"required": ["query"],
}
- model = SchemaTransformer.create_model_from_schema(
- schema, "InputModel", "my_tool", is_output_schema=False
- )
+ model = SchemaTransformer.create_model_from_schema(schema, "InputModel", "my_tool", is_output_schema=False)
# Input schema SHOULD have tool_name field
assert "tool_name" in model.model_fields
@@ -271,9 +267,7 @@ class TestCreateModelFromSchema:
# Output schema for resource - should not have resource_name
model = SchemaTransformer.create_model_from_schema(
- schema, "ResourceOutput", "my_resource",
- attribute_type=MCPAttributeType.RESOURCE,
- is_output_schema=True
+ schema, "ResourceOutput", "my_resource", attribute_type=MCPAttributeType.RESOURCE, is_output_schema=True
)
assert "resource_name" not in model.model_fields