v0.2.0-alpha.2

Full Changelog: v0.2.0-alpha.1...v0.2.0-alpha.2

v0.2.0-alpha.1

🎉 Major Release - v0.2 AWS MVP Edition

This is the first alpha release of v0.2, featuring complete Worker Protocol compliance,
comprehensive documentation, and production-ready quality.

Added

• v0.2 Core Features:

  • AgentType enum (ATOMIC | COMPOSITE) - required field for all agents
  • CompletionCriteria entity with success/failure conditions
  • Review Gate 1 validation (task_goal, completion_criteria, input/output schemas)
  • Full SYNC/ASYNC execution mode support
  • DynamoDB state management for async executions

• Public API Enhancements:

  • Export AgentType from main package
  • Export CompletionCriteria from main package
  • All v0.2 fields accessible via builder API

• Runtime Wrapper:

  • Complete @agent.atomic decorator for Lambda functions
  • SYNC mode: Direct JSON response
  • ASYNC mode: DynamoDB state reporting
  • Error handling with HandlerError, InputValidationError, etc.
  • Context parsing for Platform Core payloads

• Comprehensive Documentation:

  • 960-line README with complete developer guide
  • Table of contents with 12 major sections
  • Step-by-step tutorials for COMPOSITE and ATOMIC agents
  • Troubleshooting section with 6 common issues
  • Complete API reference with code examples
  • Architecture diagrams
  • Development paths guide
  • CLI reference

Changed

• Breaking: agent_type is now required - All AgentDefinition must specify AgentType.ATOMIC or AgentType.COMPOSITE
• Breaking: v0.2 fields required - task_goal, completion_criteria, input_schema, output_schema are mandatory
• Updated README from 164 to 960 lines (+485%)
• Enhanced examples with v0.2 fields
• Improved error messages for missing v0.2 fields

Fixed

• Runtime output validation logic in decorators.py
• Import statements sorted correctly
• MyPy unreachable code warnings in runtime module
• Ruff linting rules for runtime error handling patterns
• Test suite updated for v0.2 compliance (175 tests)

Quality Assurance

• ✅ Ruff linting: All checks passed
• ✅ MyPy type checking: 66 files, 0 errors
• ✅ Pytest: 175/175 tests passed (100% pass rate)
• ✅ Bandit security: 1 medium, 2 low (acceptable)
• ✅ Code coverage: >85%
• ✅ Type coverage: 100%

Spec Compliance

• ✅ Worker Protocol (02_worker_protocol.md) - Complete
• ✅ Review Gate 1 - Complete
• ✅ SYNC/ASYNC modes per spec
• ✅ DynamoDB PK format: EXEC#{executionId}
• ✅ Hexagonal Architecture maintained

Migration from 0.1.x

# Before (0.1.x)
agent = AgentBuilder("my-agent") \
    .version("1.0.0") \
    .build()

# After (0.2.0)
from ainalyn import AgentType, CompletionCriteria

agent = AgentBuilder("my-agent") \
    .version("1.0.0") \
    .agent_type(AgentType.COMPOSITE) \      # ← Required
    .task_goal("What this agent does") \     # ← Required
    .completion_criteria(                    # ← Required
        CompletionCriteria(
            success="Success condition",
            failure="Failure condition"
        )
    ) \
    .input_schema({"type": "object"}) \     # ← Required
    .output_schema({"type": "object"}) \    # ← Required
    .build()

Full Changelog: v0.1.0-alpha.4...v0.2.0-alpha.1

v0.1.0-alpha.4

Full Changelog: v0.1.0-alpha.3...v0.1.0-alpha.4

v0.1.0-alpha.3

Fixed

• Fixed PyPI project description URLs that were returning 404 errors
• Documentation links now point to correct locations

Full Changelog: v0.1.0-alpha.2...v0.1.0-alpha.3

v0.1.0-alpha.2

Added

• Agent Submission API: New submit_agent() function for direct submission to Platform Core
  • Validates definition before submission
  • Supports custom base_url for staging/testing environments
  • Supports auto_deploy option for automatic deployment after approval
  • Returns SubmissionResult with review_id and tracking_url
• Submission Tracking: New track_submission() function to monitor review status
  • Retrieves current review status from Platform Core
  • Returns feedback from Platform Core's review process
  • Shows agent_id and marketplace_url when approved
• Domain Entities for Submission:
  • SubmissionResult: Immutable entity representing submission outcome
  • SubmissionStatus: Enum for submission lifecycle states (PENDING_REVIEW, ACCEPTED, REJECTED, DRAFT)
  • ReviewFeedback: Value object for Platform Core feedback
  • FeedbackCategory: Categorizes feedback (SECURITY, COMPLIANCE, QUALITY, etc.)
  • FeedbackSeverity: Severity levels (ERROR, WARNING, INFO)
• Platform Client Adapters:
  • HttpPlatformClient: Placeholder for future Platform Core API integration
  • MockPlatformClient: Fully functional mock for testing and development
  • Includes special test cases for authentication errors, network errors, and rejections
• Use Cases:
  • SubmitDefinitionUseCase: Orchestrates validation, export, and submission workflow
  • TrackSubmissionUseCase: Retrieves submission status from Platform Core
• Error Handling:
  • SubmissionError: Base error for submission failures
  • AuthenticationError: Invalid or expired API key
  • NetworkError: Network connectivity issues
• Examples: New examples/submit_agent_example.py demonstrating end-to-end submission workflow

Changed

• Updated DefinitionService to include submit() and track_submission() methods
• Enhanced service_factory to inject MockPlatformClient by default
• Updated package exports in __init__.py to include submission-related APIs
• Updated README.md with submission workflow documentation

Documentation

• Added "Submitting Agents to Platform" section to README
• Added comprehensive docstrings for all submission-related APIs
• Included Platform Constitution compliance notes in all submission documentation
• Created detailed implementation plan (IMPLEMENTATION_PLAN_v0.1.0-alpha.2.md)

Platform Constitution Compliance

• SDK can submit but NOT approve (Platform Core has final authority)
• Submission does NOT create an Execution
• Submission does NOT incur billing (unless platform policy explicitly states)
• All submission workflows respect platform governance boundaries

Notes

• Currently uses MockPlatformClient for testing until Platform Core API is available
• Real HTTP communication will be enabled when Platform Core API endpoints are ready
• This is an alpha release - API may change based on Platform Core requirements

Full Changelog: v0.1.0-alpha.1...v0.1.0-alpha.2

v0.1.0-alpha.1

Added

• Initial alpha release of Ainalyn SDK
• Agent Definition builders (AgentBuilder, WorkflowBuilder, NodeBuilder, etc.)
• Fluent API for defining task-oriented agents
• Validation system (SchemaValidator, StaticAnalyzer)
• YAML export functionality for agent definitions
• CLI tool (ainalyn command) for validation and export
• Full type hints support (PEP 561)
• Hexagonal architecture with clean separation of concerns

Notes

• This is an alpha release for early adopters and testing
• API may change in future versions based on feedback

Full Changelog: https://github.com/CoreNovus/ainalyn-sdk/commits/v0.1.0-alpha.1