v2.1.0

CyniaAgents v2.1.0 – Import Path Modernization

🚀 Highlights

• Unified and explicit imports – Existing components previously relied on relative imports, which caused missing syntax highlighting, autocomplete, and IDE hints.
  To fix this, all public APIs and base components are now exposed through the cynia_agents package namespace.

  Example change:

  # Before
  import component_base
  
  # After
  from cynia_agents import component_base

  This ensures consistent tooling support and improves the development experience both inside the package and for external users.

🛠 Internal Improvements

• Updated project structure to cleanly export stable interfaces for Agents, Components, configuration helpers, logging utilities, and artifact management.
• Refined namespace layout to prevent IDE confusion and reinforce long-term API stability.

❤️ Thank you to everyone providing feedback while we refine the developer experience of CyniaAgents!

v2.0.0

CyniaAgents v2.0.0 – pip install, CLI entry point & smoother component workflow

🧱 Highlights

• pip installation – CyniaAgents can now be installed from PyPI:

  pip install cynia-agents

  Installation adds the cynia-agents executable to your bin/PATH so you can launch the app directly from the terminal.

• New CLI entry point – Run CyniaAgents anywhere with:

  cynia-agents

  No more cloning two repos and shuffling code around just to start.

• Component Center: Import from folder – A new Import Component action lets users pick a local component folder and CyniaAgents will snapshot-copy it into the internal components/ directory automatically. This removes the need to manually duplicate repositories into components/.

• Developer-friendly dev mode – For rapid iteration, run:

  cynia-agents dev

  This starts the app and treats the current working directory as the component. CyniaAgents creates a temporary link inside components/ so file edits reflect instantly without extra copying.

• Unified management remains – The framework continues to provide a single place for API, configuration, logs, and artifacts—now with a dramatically easier setup path.

🔧 How it works

• User import (copy semantics): Choosing Import Component makes a snapshot copy of the selected folder into components/, ensuring a stable, self-contained version for use.
• Developer debug (link semantics): cynia-agents dev creates a temporary link in components/ pointing to your current folder, enabling live-edit development without duplicating files.

⚠️ Notes & compatibility

• No breaking changes expected for existing users; manual copies in components/ continue to work.
• If you previously ran from source, you can safely switch to the new CLI. The internal layout under components/ is unchanged—only the way you get components in there is improved.

🚀 Quick start

# 1) Install
pip install cynia-agents

# 2) Run the app
cynia-agents

# 3a) Users: Import a component folder (snapshot copy) via the Component Center
# 3b) Developers: Start live dev with your current folder as a component
cynia-agents dev

v1.2.0

🚀 v1.2.0 - Enhanced Component Management & Version Control

We’re excited to announce a major update to CyniaAgents, featuring significant enhancements in component management, version compatibility checks, and hot reload capabilities!

🌟 What's New?

🛡️ Robust Component Management

• Global Component Loading Guard: Prevents infinite loops and ensures stability with the new ComponentLoadGuard class.
• Advanced Hot Reload System: Dynamically manage components without restarting, including improved error recovery, dependency tracking, and performance monitoring.

📌 Version Management & Compatibility

• Components now include detailed metadata (version, author_name, author_link, and supported_framework_versions).
• Automatic framework compatibility checks ensure safe and stable operation.
• Easy synchronization of version numbers between .env and .env.example files.

🎨 Improved User Interface

• UI cards now display component version details, author information, and compatibility statuses clearly and intuitively.

📝 Documentation & Configuration Updates

• Streamlined installation instructions for single-file and multi-file components in the README.
• Expanded documentation for version management and compatibility behavior in COMPONENT_DEVELOPMENT.md.

⚙️ Configuration Enhancements

• New options (VERSION_NUMBER and FORCE_LOAD_UNSUPPORTED_COMPONENT) allow precise control over framework versioning and compatibility behavior.

📥 How to Update

Simply pull the latest changes from the repository and update your environment variables according to the updated .env.example.

We appreciate your continued support! Happy coding with CyniaAgents! 🐾✨

---

What's Changed

• Add hot reload system for dynamic component management by @Zhou-Shilin in #11
• Add comprehensive version management for components by @Zhou-Shilin in #12

Full Changelog: v1.1.0...v1.2.0

v1.1.0

What's Changed

• Add image support in ask by @Zhou-Shilin in #8
• Allow identifing components with missing dependencies by @Zhou-Shilin in #9

Full Changelog: v1.0.0...v1.1.0

v1.0.0

What's Changed

• Modular component framework by @Zhou-Shilin in #1
• Add configuration center UI by @Zhou-Shilin in #2
• Refactor LLM helper with conversation object by @Zhou-Shilin in #3
• Improve component development docs by @Zhou-Shilin in #4
• Add folder component support by @Zhou-Shilin in #5
• Add component requirements and unified logging by @Zhou-Shilin in #6
• Add artifact center functionality by @Zhou-Shilin in #7

New Contributors

• @Zhou-Shilin made their first contribution in #1

Full Changelog: https://github.com/CyniaAI/CyniaAgents/commits/v1.0.0