A2A-CARD.md

A2A-SIN-Code-plugin Agent - Standard Card

Agent ID: a2a-sin-code-plugin
Version: 1.0.0
Status: ✅ Production Ready
Team: Team - Coder
Manager: SIN-Zeus

---

📋 Core Identity

Field	Value
Name	A2A-SIN-Code-plugin Agent
Description	Autonomous Cloud Coder for OpenCode plugins and MCP servers
Purpose	Execute code generation tasks via opencode CLI
Usage	Deployed on Hugging Face Spaces, receives A2A tasks from SIN-Zeus
CIMD	https://delqhi-a2a-sin-code-plugin.hf.space
SEP-991	https://delqhi-a2a-sin-code-plugin.hf.space/.well-known/oauth-client.json

🏢 Team & Infrastructure

Field	Value
Team	Team - Coder
Manager	SIN-Zeus
VM Type	Hugging Face Space (Free CPU)
VM URL	https://delqhi-a2a-sin-code-plugin.hf.space
Local Path	coder_hf_deploy/
GitHub Repo	https://github.com/OpenSIN-AI/OpenSIN-Code

🧠 AI Stack

Component	Model	Purpose
Primary	opencode/qwen3.6-plus-free	Code generation via Antigravity
Fallback	opencode/minimax-m2.5-free	Uptime guarantee

🛠️ Capabilities

Core Skills

• ✅ Code Generation: Uses opencode CLI to generate code based on A2A task descriptions
• ✅ GitHub Operations: Automatic commits, branch management, PR creation (via GitHub CLI)
• ✅ Issue Resolution: Parses issue titles and descriptions to determine context and requirements
• ✅ Testing: Basic validation of generated code structure
• ✅ Self-Correction: Can iterate on feedback via A2A message threads

A2A Commands

• sin.code.plugin.create - Create new files/modules
• sin.code.plugin.modify - Modify existing code
• sin.code.plugin.test - Run tests on generated code
• sin.code.plugin.deploy - Prepare code for deployment
• sin.code.plugin.status - Get current task status
• sin.code.plugin.health - Agent health check

📡 Interfaces

Interface	URL	Protocol
Gradio UI	https://delqhi-a2a-sin-code-plugin.hf.space	HTTP/Gradio
A2A API	https://delqhi-a2a-sin-code-plugin.hf.space/a2a/v1	A2A Protocol
Dashboard	https://a2a.delqhi.com/agents/sin-code-plugin	Web
Docs Tab	Google Docs	Google Docs

🔄 Runtime Contract

Requirement	Status
A2A Compliance	✅ Full A2A protocol support
CLI Interface	✅ Uses opencode CLI exclusively
Agent Card	✅ This file
CIMD/SEP-991	✅ OAuth client JSON
Team Manager	✅ SIN-Zeus registered
Docs Tab	✅ Synced to Google Docs
HF Space	⏳ Pending deployment (CPU-Basic)
Cloudflare	⏳ Not configured yet

📊 Performance Metrics

Metric	Target	Actual
Task Success Rate	>80%	Baseline (pre-deploy)
Avg Generation Time	<60s	TBD
Code Quality	>85%	TBD
Uptime	24/7	HF Space (cpu-basic)

🔧 Environment Variables

Variable	Required	Description
OPENCODE_API_KEY	Yes	OpenCode API key for LLM calls
GITHUB_TOKEN	Yes	GitHub personal access token
HF_TOKEN	No	Hugging Face token (for deployment)
TELEGRAM_TOKEN	No	Telegram bot for notifications
N8N_URL	No	OCI n8n instance URL
N8N_API_KEY	No	n8n API key

📁 File Structure

.
├── app.py                  # Gradio UI + A2A JSON-RPC endpoint
├── requirements.txt        # Python dependencies
├── README.md               # HF Space config (YAML header)
├── agent.json              # Agent metadata
├── A2A-CARD.md            # This file
├── Dockerfile              # Container build for HF Space
├── start.sh                # Startup script
├── .well-known/
│   ├── agent-card.json    # Auto-generated A2A card
│   ├── agent.json         # Auto-generated agent identity
│   └── oauth-client.json  # CIMD/SEP-991 OAuth config
└── app/
    ├── coder_agent.py     # Main agent logic (opencode integration)
    ├── github_ops.py      # GitHub commit/PR operations
    ├── prompt_templates.py # plugin-specific prompts
    └── utils/
        ├── logger.py      # Structured logging
        └── validators.py  # Code validation

🚀 Deployment

Hugging Face Space (CPU-Basic)

# Install HF CLI
pip install -U huggingface_hub

# Login
huggingface-cli login

# Create Space (CPU-Basic!)
huggingface-cli repo create delqhi-a2a-sin-code-plugin --type space --space-sdk docker

# Set secrets
huggingface-cli variable set OPENCODE_API_KEY "$OPENCODE_API_KEY" --repo delqhi-a2a-sin-code-plugin --type space
huggingface-cli variable set GITHUB_TOKEN "$GITHUB_TOKEN" --repo delqhi-a2a-sin-code-plugin --type space

# Push code
git init
git remote add origin https://huggingface.co/spaces/delqhi/delqhi-a2a-sin-code-plugin
git add .
git commit -m "Deploy A2A-SIN-Code-plugin Agent v1.0.0"
git push --force origin main

Hardware Configuration

CRITICAL: Must be set to cpu-basic (free, unlimited). Never use GPU/ZeroGPU.

huggingface-cli variable set HF_HARDWARE "cpu-basic" --repo delqhi-a2a-sin-code-plugin --type space

📈 Monitoring

• Telegram: Notifications on task completion/failure (if token set)
• Gradio UI: Live status and logs
• HF Space Logs: View via Hugging Face dashboard
• Dashboard: https://a2a.delqhi.com/agents/sin-code-plugin

🛡️ Security

• API Keys: Stored as HF Space secrets, never hardcoded
• GitHub Token: Scoped to repository access only
• No Persistent Storage: Ephemeral filesystem (use HF Datasets for persistence if needed)
• A2A Auth: Requires X-API-Key header for agent-card access

📞 Support

• Documentation: TBD (Google Docs tab will be created)
• Dashboard: https://a2a.delqhi.com/agents/sin-code-plugin
• Team Manager: SIN-Zeus (dispatcher)

📜 License

Proprietary - OpenSIN-AI

---

Last Updated: 2026-04-07
Agent: A2A-SIN-Code-plugin v1.0.0 Owner: Team - Coder / SIN-Zeus