Registry Manager Tool Documentation

Overview

The RegistryManagerTool provides comprehensive management of both tool and agent registries. It handles adding, removing, and updating registry entries, and automatically creates A2A (Agent-to-Agent) model cards with cryptographic identities.

File: tools/registry_manager_tool.py Class: RegistryManagerTool Version: 1.0.0 Status: ✅ Active

Architecture

Design Principles

Dual Registry Support: Manages both tool and agent registries

Model Card Creation: Automatically creates A2A model cards

Cryptographic Identity: Integrates with IDManagerAgent for identities

Persistent Storage: Saves registries to JSON files

Error Handling: Comprehensive error handling

Core Components

class RegistryManagerTool(BaseTool):
    - memory_agent: MemoryAgent - For workspace management
    - tool_registry_path: Path - Tools registry file path
    - agent_registry_path: Path - Agents registry file path
    - model_cards_path: Path - Model cards directory

Available Actions

1. add

Adds a new tool or agent to the registry.

Parameters:

registry_type (str, required): "tool" or "agent"

action (str, required): "add"

item_id (str, required): Unique identifier

item_config (Dict, required): Item configuration

Returns:

Tuple[bool, str]  # (success, message)

2. remove

Removes a tool or agent from the registry.

Parameters:

registry_type (str, required): "tool" or "agent"

action (str, required): "remove"

item_id (str, required): Item to remove

Returns:

Tuple[bool, str]  # (success, message)

3. update

Updates an existing tool or agent in the registry.

Parameters:

registry_type (str, required): "tool" or "agent"

action (str, required): "update"

item_id (str, required): Item to update

item_config (Dict, required): Updated configuration

Returns:

Tuple[bool, str]  # (success, message)

Usage

Add Tool to Registry

from tools.registry_manager_tool import RegistryManagerTool
from agents.memory_agent import MemoryAgent

tool = RegistryManagerTool(memory_agent=memory_agent)
Add tool
success, message = await tool.execute(
    registry_type="tool",
    action="add",
    item_id="custom_analyzer",
    item_config={
        "name": "Custom Analyzer",
        "description": "Specialized analysis tool",
        "version": "1.0.0",
        "enabled": True,
        "commands": [...],
        "access_control": {...}
    }
)

Update Agent Registry

# Update agent
success, message = await tool.execute(
    registry_type="agent",
    action="update",
    item_id="analysis_agent",
    item_config={
        "name": "Updated Analysis Agent",
        "description": "Enhanced analysis capabilities",
        "version": "2.0.0"
    }
)

Remove from Registry

# Remove tool
success, message = await tool.execute(
    registry_type="tool",
    action="remove",
    item_id="old_tool"
)

Model Card Creation

Automatic Model Card Generation

When adding or updating items, the tool automatically:

Creates cryptographic identity via IDManagerAgent

Generates public/private key pair

Creates A2A model card JSON

Signs the model card

Saves to model cards directory

Model Card Structure

{
    "id": "item_id",
    "name": "Item Name",
    "description": "Item description",
    "type": "tool" | "agent",
    "version": "1.0.0",
    "enabled": true,
    "commands": [...],
    "access_control": {...},
    "identity": {
        "public_key": "0x...",
        "signature": "..."
    },
    "a2a_endpoint": "https://mindx.internal/{item_id}/a2a"
}

Features

1. Dual Registry Management

Manages both:

Tool Registry: data/config/official_tools_registry.json

Agent Registry: data/config/official_agents_registry.json

2. A2A Model Cards

Creates model cards for:

Agent-to-Agent communication

Cryptographic verification

Identity management

Endpoint definition

3. Identity Integration

Integrates with IDManagerAgent:

Automatic wallet creation

Public key generation

Message signing

Identity verification

4. Persistent Storage

Saves registries to:

JSON files

Model cards directory

Maintains registry structure

Limitations

Current Limitations

No Validation: Limited validation of item configs

No Rollback: No rollback for failed operations

No Versioning: No version history

No Conflict Resolution: No handling of conflicts

Basic Error Messages: Simple error messages

Recommended Improvements

Enhanced Validation: Comprehensive config validation

Rollback Support: Rollback failed operations

Version Control: Registry versioning

Conflict Resolution: Handle concurrent updates

Better Error Messages: Detailed error information

Backup System: Automatic registry backups

Audit Trail: Track all registry changes

Integration

With IDManagerAgent

Creates identities:

id_manager = await IDManagerAgent.get_instance()
public_key, _ = await id_manager.create_new_wallet(item_id)

With Memory Agent

Manages model cards directory:

self.model_cards_path = self.memory_agent.get_agent_data_directory("a2a_model_cards")

Examples

Complete Registry Management

# 1. Add new tool
await tool.execute("tool", "add", "new_tool", {...})

2. Update tool
await tool.execute("tool", "update", "new_tool", {...})

3. Remove tool
await tool.execute("tool", "remove", "new_tool")

Technical Details

Dependencies

core.id_manager_agent.IDManagerAgent: Identity management

agents.memory_agent.MemoryAgent: Workspace management

core.bdi_agent.BaseTool: Base tool class

Registry File Paths

Tools: data/config/official_tools_registry.json

Agents: data/config/official_agents_registry.json

Model Cards: data/memory/agent_workspaces/a2a_model_cards/

Future Enhancements

Validation Framework: Comprehensive validation

Version Control: Registry versioning

Backup System: Automatic backups

Audit Logging: Change tracking

Conflict Resolution: Concurrent update handling

Schema Validation: JSON schema validation

API Integration: REST API for registry access

---