aigency 0.0.1rc15474277__tar.gz → 0.0.1rc235167702__tar.gz

aigency-0.0.1rc235167702/PKG-INFO

@@ -0,0 +1,267 @@
+Metadata-Version: 2.4
+Name: aigency
+Version: 0.0.1rc235167702
+Summary: Add your description here
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: google-adk>=1.11.0
+Requires-Dist: a2a-sdk==0.3.0
+Requires-Dist: litellm<1.73.0,>=1.72.6
+Requires-Dist: pyyaml==6.0.2
+Requires-Dist: PyJWT==2.10.1
+
+# aigency-lib
+
+A library for creating and managing AI agents.
+
+## Quick Start
+
+To test a simple agent:
+
+```bash
+cd examples/simple_agents/hello_world_agent
+docker compose up
+```
+
+## 🔧 Version Management
+
+This project includes an automated system for managing versions in both development and production.
+
+### Version Manager
+
+The `scripts/version_manager.py` script helps you manage your package versions locally.
+
+#### Available Commands
+
+##### 1. View current information
+```bash
+python scripts/version_manager.py show
+```
+**What it does:**
+- Shows the current version in `pyproject.toml`
+- Shows the current git branch
+- Shows the current commit
+- If you're not on `main`, suggests a development version
+
+**Example output:**
+```
+Current version: 0.0.1
+Branch: feature/new-agent
+Commit: a1b2c3d
+Suggested dev version: 0.0.1.dev20250409143022+feature/new-agent.a1b2c3d
+```
+
+##### 2. Create development version
+```bash
+python scripts/version_manager.py dev
+```
+**What it does:**
+- Takes the current version and creates a development version
+- Format: `version.devYYYYMMDDHHMMSS+branch.commit`
+- Automatically updates the `pyproject.toml`
+
+**Example:**
+```bash
+# If you're on branch "feature/auth" with commit "abc123"
+python scripts/version_manager.py dev
+# Result: 0.0.1.dev20250409143022
+```
+
+##### 3. Set specific version
+```bash
+python scripts/version_manager.py set --version "0.1.0"
+```
+**What it does:**
+- Changes the version to the one you specify
+- Useful for releases or to fix versions
+
+**Examples:**
+```bash
+# Release version
+python scripts/version_manager.py set --version "1.0.0"
+
+# Beta version
+python scripts/version_manager.py set --version "1.0.0b1"
+
+# Alpha version
+python scripts/version_manager.py set --version "1.0.0a1"
+```
+
+##### 4. Create Release Candidate version
+```bash
+python scripts/version_manager.py rc --version "1.0.1"
+```
+**What it does:**
+- Creates an RC version with the format `version-rc<commit>`
+- Useful for preparing releases on `release/*` branches
+
+##### 5. Validate current version
+```bash
+python scripts/version_manager.py validate
+```
+**What it does:**
+- Validates that the current version is appropriate for the branch
+- Verifies semantic format on `main` and `release/*` branches
+
+##### 6. Create dev with custom base version
+```bash
+python scripts/version_manager.py dev --base-version "0.2.0"
+```
+**What it does:**
+- Uses a different base version than the current one
+- Useful when you want to prepare a dev version for the next release
+
+### 🚀 Recommended Workflow
+
+#### For daily development:
+```bash
+# 1. View current status
+python scripts/version_manager.py show
+
+# 2. If you're on a feature branch, create dev version
+python scripts/version_manager.py dev
+
+# 3. Make your changes and commits
+git add .
+git commit -m "feat: new functionality"
+
+# 4. If you need to update the dev version (optional)
+python scripts/version_manager.py dev
+```
+
+#### For releases:
+```bash
+# 1. On main branch, set release version
+python scripts/version_manager.py set --version "1.0.0"
+
+# 2. Commit the version
+git add pyproject.toml
+git commit -m "bump: version 1.0.0"
+
+# 3. Use GitHub workflow to publish
+```
+
+#### For testing:
+```bash
+# Create specific test version
+python scripts/version_manager.py set --version "1.0.0rc1"
+```
+
+### ⚠️ PyPI Limitations
+
+PyPI doesn't allow "local versions" (versions with `+` and local identifiers). That's why we've adapted the format:
+
+- ❌ Not allowed: `1.0.0.dev20250409+feature.abc123`
+- ✅ Allowed: `1.0.0.dev20250409`
+
+**Solution for Release Candidates:**
+- We convert the commit hash (hexadecimal) to decimal
+- Example: commit `abc123` → `11256099` → version `1.0.1rc11256099`
+- This maintains commit uniqueness in a PyPI-compatible format
+
+**Result:**
+- Dev versions include unique timestamp
+- RC versions include commit hash (in decimal)
+- We maintain traceability without using local versions
+
+### 📋 Practical Use Cases
+
+**Scenario 1: Working on a feature**
+```bash
+git checkout -b feature/new-auth
+python scripts/version_manager.py dev
+# Now you have: 0.0.1.dev20250409143022
+```
+
+**Scenario 2: Preparing release**
+```bash
+git checkout main
+python scripts/version_manager.py set --version "1.0.0"
+git add pyproject.toml
+git commit -m "release: v1.0.0"
+```
+
+**Scenario 3: Preparing Release Candidate**
+```bash
+git checkout -b release/1.0.1
+python scripts/version_manager.py rc --version "1.0.1"
+# Result: 1.0.1rc12345678 (where 12345678 is the commit hash in decimal)
+```
+
+**Scenario 4: Urgent hotfix**
+```bash
+git checkout -b hotfix/critical-bug
+python scripts/version_manager.py dev --base-version "1.0.1"
+# Result: 1.0.1.dev20250409143022
+```
+
+## 🔄 Intelligent CI/CD Workflow
+
+The project includes a single intelligent workflow (`python-publish.yml`) that automatically handles different version types based on the branch:
+
+### Automatic behavior by branch:
+
+#### 🚀 `main` Branch - Production Versions
+- **Trigger**: Push to `main` or manual execution
+- **Version**: Uses exactly the version from `pyproject.toml`
+- **Validations**:
+  - ✅ Verifies it's a valid semantic version (e.g.: `1.0.0`)
+  - ✅ Verifies it doesn't already exist on PyPI
+  - ❌ Fails if it contains development suffixes (`dev`, `rc`, `alpha`, `beta`)
+- **Target**: PyPI production
+
+#### 🎯 `release/*` Branches - Release Candidates
+- **Trigger**: Push to `release/X.Y.Z` branch or manual execution
+- **Version**: `X.Y.ZrcN` where N is the commit hash in decimal (e.g.: `1.0.1rc12345678`)
+- **Validations**:
+  - ✅ Verifies that `X.Y.Z` is a valid semantic version
+  - ✅ Extracts version from branch name
+  - ✅ Uses commit hash as unique identifier
+  - ✅ PyPI-compatible format
+- **Target**: PyPI production
+- **Example**: Branch `release/1.0.1` + commit `abc123` → Version `1.0.1rc11256099`
+
+#### 🔧 Other Branches - Development Versions
+- **Trigger**: Push to any other branch or manual execution
+- **Version**: `current.devYYYYMMDDHHMMSS` (e.g.: `0.0.1.dev20250409143022`)
+- **Target**: PyPI production
+- **Note**: No local versions for PyPI compatibility
+
+### Recommended workflow:
+
+```bash
+# 1. Development on feature branch
+git checkout -b feature/new-functionality
+# Automatic version: 0.0.1.dev20250409143022+feature-new-functionality.abc123
+
+# 2. Prepare release
+git checkout -b release/1.0.0
+git push origin release/1.0.0
+# Automatic version: 1.0.0rc12345678
+
+# 3. Final release
+git checkout main
+python scripts/version_manager.py set --version "1.0.0"
+git add pyproject.toml
+git commit -m "release: v1.0.0"
+git push origin main
+# Version: 1.0.0 (with validations)
+```
+
+## 📦 Installation
+
+```bash
+pip install aigency
+```
+
+## 🛠️ Development
+
+1. Clone the repository
+2. Install development dependencies
+3. Use the version manager to manage versions during development
+
+```bash
+git clone <repo-url>
+cd aigency-lib
+pip install -e .
+```

aigency-0.0.1rc235167702/README.md

@@ -0,0 +1,255 @@
+# aigency-lib
+
+A library for creating and managing AI agents.
+
+## Quick Start
+
+To test a simple agent:
+
+```bash
+cd examples/simple_agents/hello_world_agent
+docker compose up
+```
+
+## 🔧 Version Management
+
+This project includes an automated system for managing versions in both development and production.
+
+### Version Manager
+
+The `scripts/version_manager.py` script helps you manage your package versions locally.
+
+#### Available Commands
+
+##### 1. View current information
+```bash
+python scripts/version_manager.py show
+```
+**What it does:**
+- Shows the current version in `pyproject.toml`
+- Shows the current git branch
+- Shows the current commit
+- If you're not on `main`, suggests a development version
+
+**Example output:**
+```
+Current version: 0.0.1
+Branch: feature/new-agent
+Commit: a1b2c3d
+Suggested dev version: 0.0.1.dev20250409143022+feature/new-agent.a1b2c3d
+```
+
+##### 2. Create development version
+```bash
+python scripts/version_manager.py dev
+```
+**What it does:**
+- Takes the current version and creates a development version
+- Format: `version.devYYYYMMDDHHMMSS+branch.commit`
+- Automatically updates the `pyproject.toml`
+
+**Example:**
+```bash
+# If you're on branch "feature/auth" with commit "abc123"
+python scripts/version_manager.py dev
+# Result: 0.0.1.dev20250409143022
+```
+
+##### 3. Set specific version
+```bash
+python scripts/version_manager.py set --version "0.1.0"
+```
+**What it does:**
+- Changes the version to the one you specify
+- Useful for releases or to fix versions
+
+**Examples:**
+```bash
+# Release version
+python scripts/version_manager.py set --version "1.0.0"
+
+# Beta version
+python scripts/version_manager.py set --version "1.0.0b1"
+
+# Alpha version
+python scripts/version_manager.py set --version "1.0.0a1"
+```
+
+##### 4. Create Release Candidate version
+```bash
+python scripts/version_manager.py rc --version "1.0.1"
+```
+**What it does:**
+- Creates an RC version with the format `version-rc<commit>`
+- Useful for preparing releases on `release/*` branches
+
+##### 5. Validate current version
+```bash
+python scripts/version_manager.py validate
+```
+**What it does:**
+- Validates that the current version is appropriate for the branch
+- Verifies semantic format on `main` and `release/*` branches
+
+##### 6. Create dev with custom base version
+```bash
+python scripts/version_manager.py dev --base-version "0.2.0"
+```
+**What it does:**
+- Uses a different base version than the current one
+- Useful when you want to prepare a dev version for the next release
+
+### 🚀 Recommended Workflow
+
+#### For daily development:
+```bash
+# 1. View current status
+python scripts/version_manager.py show
+
+# 2. If you're on a feature branch, create dev version
+python scripts/version_manager.py dev
+
+# 3. Make your changes and commits
+git add .
+git commit -m "feat: new functionality"
+
+# 4. If you need to update the dev version (optional)
+python scripts/version_manager.py dev
+```
+
+#### For releases:
+```bash
+# 1. On main branch, set release version
+python scripts/version_manager.py set --version "1.0.0"
+
+# 2. Commit the version
+git add pyproject.toml
+git commit -m "bump: version 1.0.0"
+
+# 3. Use GitHub workflow to publish
+```
+
+#### For testing:
+```bash
+# Create specific test version
+python scripts/version_manager.py set --version "1.0.0rc1"
+```
+
+### ⚠️ PyPI Limitations
+
+PyPI doesn't allow "local versions" (versions with `+` and local identifiers). That's why we've adapted the format:
+
+- ❌ Not allowed: `1.0.0.dev20250409+feature.abc123`
+- ✅ Allowed: `1.0.0.dev20250409`
+
+**Solution for Release Candidates:**
+- We convert the commit hash (hexadecimal) to decimal
+- Example: commit `abc123` → `11256099` → version `1.0.1rc11256099`
+- This maintains commit uniqueness in a PyPI-compatible format
+
+**Result:**
+- Dev versions include unique timestamp
+- RC versions include commit hash (in decimal)
+- We maintain traceability without using local versions
+
+### 📋 Practical Use Cases
+
+**Scenario 1: Working on a feature**
+```bash
+git checkout -b feature/new-auth
+python scripts/version_manager.py dev
+# Now you have: 0.0.1.dev20250409143022
+```
+
+**Scenario 2: Preparing release**
+```bash
+git checkout main
+python scripts/version_manager.py set --version "1.0.0"
+git add pyproject.toml
+git commit -m "release: v1.0.0"
+```
+
+**Scenario 3: Preparing Release Candidate**
+```bash
+git checkout -b release/1.0.1
+python scripts/version_manager.py rc --version "1.0.1"
+# Result: 1.0.1rc12345678 (where 12345678 is the commit hash in decimal)
+```
+
+**Scenario 4: Urgent hotfix**
+```bash
+git checkout -b hotfix/critical-bug
+python scripts/version_manager.py dev --base-version "1.0.1"
+# Result: 1.0.1.dev20250409143022
+```
+
+## 🔄 Intelligent CI/CD Workflow
+
+The project includes a single intelligent workflow (`python-publish.yml`) that automatically handles different version types based on the branch:
+
+### Automatic behavior by branch:
+
+#### 🚀 `main` Branch - Production Versions
+- **Trigger**: Push to `main` or manual execution
+- **Version**: Uses exactly the version from `pyproject.toml`
+- **Validations**:
+  - ✅ Verifies it's a valid semantic version (e.g.: `1.0.0`)
+  - ✅ Verifies it doesn't already exist on PyPI
+  - ❌ Fails if it contains development suffixes (`dev`, `rc`, `alpha`, `beta`)
+- **Target**: PyPI production
+
+#### 🎯 `release/*` Branches - Release Candidates
+- **Trigger**: Push to `release/X.Y.Z` branch or manual execution
+- **Version**: `X.Y.ZrcN` where N is the commit hash in decimal (e.g.: `1.0.1rc12345678`)
+- **Validations**:
+  - ✅ Verifies that `X.Y.Z` is a valid semantic version
+  - ✅ Extracts version from branch name
+  - ✅ Uses commit hash as unique identifier
+  - ✅ PyPI-compatible format
+- **Target**: PyPI production
+- **Example**: Branch `release/1.0.1` + commit `abc123` → Version `1.0.1rc11256099`
+
+#### 🔧 Other Branches - Development Versions
+- **Trigger**: Push to any other branch or manual execution
+- **Version**: `current.devYYYYMMDDHHMMSS` (e.g.: `0.0.1.dev20250409143022`)
+- **Target**: PyPI production
+- **Note**: No local versions for PyPI compatibility
+
+### Recommended workflow:
+
+```bash
+# 1. Development on feature branch
+git checkout -b feature/new-functionality
+# Automatic version: 0.0.1.dev20250409143022+feature-new-functionality.abc123
+
+# 2. Prepare release
+git checkout -b release/1.0.0
+git push origin release/1.0.0
+# Automatic version: 1.0.0rc12345678
+
+# 3. Final release
+git checkout main
+python scripts/version_manager.py set --version "1.0.0"
+git add pyproject.toml
+git commit -m "release: v1.0.0"
+git push origin main
+# Version: 1.0.0 (with validations)
+```
+
+## 📦 Installation
+
+```bash
+pip install aigency
+```
+
+## 🛠️ Development
+
+1. Clone the repository
+2. Install development dependencies
+3. Use the version manager to manage versions during development
+
+```bash
+git clone <repo-url>
+cd aigency-lib
+pip install -e .
+```

{aigency-0.0.1rc15474277 → aigency-0.0.1rc235167702}/aigency/agents/generator.py

@@ -10,7 +10,7 @@ from google.adk.runners import Runner
 from google.adk.sessions import InMemorySessionService
 
 from aigency.agents.executor import AgentA2AExecutor
-from aigency.models.config import AgentConfig
+from aigency.schemas.aigency_config import AigencyConfig
 from aigency.tools.generator import ToolGenerator
 
 
@@ -18,22 +18,26 @@ class AgentA2AGenerator:
     """Generator for creating A2A agents and related components."""
 
     @staticmethod
-    def create_agent(agent_config: AgentConfig) -> Agent:
+    def create_agent(agent_config: AigencyConfig) -> Agent:
+
+        tools = [
+            ToolGenerator.create_tool(tool_cfg) for tool_cfg in agent_config.agent.tools
+        ]
 
-        tools = [ToolGenerator.create_tool(tool_cfg) for tool_cfg in agent_config.tools]
-        
         return Agent(
-            name=agent_config.name,
-            model=agent_config.model.name,
-            instruction=agent_config.instruction,
+            name=agent_config.metadata.name,
+            model=agent_config.agent.model.name,
+            instruction=agent_config.agent.instruction,
             tools=tools,
         )
 
     @staticmethod
-    def build_agent_card(agent_config: AgentConfig) -> AgentCard:
+    def build_agent_card(agent_config: AigencyConfig) -> AgentCard:
 
         # TODO: Parse properly
-        capabilities = AgentCapabilities(streaming=agent_config.capabilities.streaming)
+        capabilities = AgentCapabilities(
+            streaming=agent_config.service.capabilities.streaming
+        )
 
         skills = [
             AgentSkill(
@@ -43,24 +47,22 @@ class AgentA2AGenerator:
                 tags=skill.tags,
                 examples=skill.examples,
             )
-            for skill in agent_config.skills
+            for skill in agent_config.agent.skills
         ]
 
         return AgentCard(
-            name=agent_config.name,
-            description=agent_config.description,
-            url=agent_config.url,
-            version=agent_config.version,
-            default_input_modes=agent_config.default_input_modes,
-            default_output_modes=agent_config.default_output_modes,
+            name=agent_config.metadata.name,
+            description=agent_config.metadata.description,
+            url=agent_config.service.url,
+            version=agent_config.metadata.version,
+            default_input_modes=agent_config.service.interface.default_input_modes,
+            default_output_modes=agent_config.service.interface.default_output_modes,
             capabilities=capabilities,
             skills=skills,
         )
 
     @staticmethod
-    def build_executor(
-        agent: Agent, agent_card: AgentCard
-    ) -> AgentA2AExecutor:
+    def build_executor(agent: Agent, agent_card: AgentCard) -> AgentA2AExecutor:
 
         runner = Runner(
             app_name=agent.name,

aigency-0.0.1rc235167702/aigency/schemas/agent/agent.py

@@ -0,0 +1,12 @@
+from pydantic import BaseModel
+from typing import List, Optional
+from aigency.schemas.agent.model import AgentModel
+from aigency.schemas.agent.skills import Skill
+from aigency.schemas.agent.tools import FunctionTool, McpTool
+
+class Agent(BaseModel):
+    """El 'cerebro' del agente: su lógica, modelo y capacidades."""
+    model: AgentModel
+    instruction: str
+    skills: List[Skill]
+    tools: Optional[List[FunctionTool | McpTool]] = []

aigency-0.0.1rc235167702/aigency/schemas/agent/model.py

@@ -0,0 +1,12 @@
+from typing import Optional
+from pydantic import BaseModel
+
+class ProviderConfig(BaseModel):
+    """Configuration for AI model provider."""
+    name: str
+    endpoint: Optional[str] = None
+
+class AgentModel(BaseModel):
+    """Configuration for AI model."""
+    name: str
+    provider: Optional[ProviderConfig] = None

aigency-0.0.1rc235167702/aigency/schemas/agent/skills.py

@@ -0,0 +1,10 @@
+from pydantic import BaseModel
+from typing import List
+
+class Skill(BaseModel):
+    """Define una habilidad específica del agente."""
+    id: str
+    name: str
+    description: str
+    tags: List[str]
+    examples: List[str]

aigency-0.0.1rc235167702/aigency/schemas/aigency_config.py

@@ -0,0 +1,14 @@
+from pydantic import BaseModel
+from typing import Optional
+from aigency.schemas.observability.observability import Observability
+from aigency.schemas.metadata.metadata import Metadata
+from aigency.schemas.agent.agent import Agent
+from aigency.schemas.service.service import Service
+
+class AigencyConfig(BaseModel):
+    """Root Pydantic model for complete agent configuration."""
+
+    metadata: Metadata
+    service: Service
+    agent: Agent
+    observability: Optional[Observability] = None

aigency-0.0.1rc235167702/aigency/schemas/metadata/metadata.py

@@ -0,0 +1,8 @@
+from pydantic import BaseModel
+
+
+class Metadata(BaseModel):
+    """Metadatos descriptivos del agente."""
+    name: str
+    version: str
+    description: str

aigency-0.0.1rc235167702/aigency/schemas/observability/observability.py

@@ -0,0 +1,10 @@
+from pydantic import BaseModel
+from aigency.schemas.observability.phoenix import Phoenix
+
+class Monitoring(BaseModel):
+    """Configuración de las herramientas de monitoreo."""
+    phoenix: Phoenix
+
+class Observability(BaseModel):
+    """Agrupa todas las configuraciones de observabilidad."""
+    monitoring: Monitoring

aigency-0.0.1rc235167702/aigency/schemas/observability/phoenix.py

@@ -0,0 +1,6 @@
+from pydantic import BaseModel
+
+class Phoenix(BaseModel):
+    """Configuración del monitor Phoenix."""
+    host: str
+    port: int

aigency-0.0.1rc235167702/aigency/schemas/service/capabilities.py

@@ -0,0 +1,5 @@
+from pydantic import BaseModel
+
+class Capabilities(BaseModel):
+    """Capacidades técnicas del servicio del agente."""
+    streaming: bool

aigency-0.0.1rc235167702/aigency/schemas/service/interface.py

@@ -0,0 +1,7 @@
+from typing import List
+from pydantic import BaseModel
+
+class Interface(BaseModel):
+    """Define los modos de comunicación del agente."""
+    default_input_modes: List[str]
+    default_output_modes: List[str]