A2A-CARD.md

# A2A-SIN-Code-backend Agent - Standard Card

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

---

## 📋 Core Identity

| Field | Value |
|-------|-------|
| **Name** | A2A-SIN-Code-backend Agent |
| **Description** | Autonomous Cloud Coder for Backend APIs, databases, and business logic |
| **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-backend.hf.space |
| **SEP-991** | `https://delqhi-a2a-sin-code-backend.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-backend.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.backend.create` - Create new files/modules
- `sin.code.backend.modify` - Modify existing code
- `sin.code.backend.test` - Run tests on generated code
- `sin.code.backend.deploy` - Prepare code for deployment
- `sin.code.backend.status` - Get current task status
- `sin.code.backend.health` - Agent health check

## 📡 Interfaces

| Interface | URL | Protocol |
|-----------|-----|----------|
| **Gradio UI** | https://delqhi-a2a-sin-code-backend.hf.space | HTTP/Gradio |
| **A2A API** | https://delqhi-a2a-sin-code-backend.hf.space/a2a/v1 | A2A Protocol |
| **Dashboard** | https://a2a.delqhi.com/agents/sin-code-backend | Web |
| **Docs Tab** | [Google Docs](https://docs.google.com/document/d/1RtoHn4I0GntuEEOHHkqoh_dMuGzgMwQz7_8oxAOpQbw/edit?tab=t.t.f41ffc3d9674ee0a) | 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 # backend-specific prompts
    └── utils/
        ├── logger.py      # Structured logging
        └── validators.py  # Code validation
```

## 🚀 Deployment

### Hugging Face Space (CPU-Basic)
```bash
# Install HF CLI
pip install -U huggingface_hub

# Login
huggingface-cli login

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

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

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

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

```bash
huggingface-cli variable set HF_HARDWARE "cpu-basic" --repo delqhi-a2a-sin-code-backend --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-backend

## 🛡️ 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-backend
- **Team Manager:** SIN-Zeus (dispatcher)

## 📜 License

Proprietary - OpenSIN-AI

---

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