Spaces:

OpenSIN-AI
/

a2a-sin-code-tool

Running

App Files Files Community

a2a-sin-code-tool / A2A-CARD.md

SIN-Deploy-Bot

Deploy via automated script [skip ci]

f3cdcbc 3 months ago

preview code

Raw

History Blame Contribute Delete

6.42 kB

A2A-SIN-Code-tool Agent - Standard Card

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

📋 Core Identity

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

📡 Interfaces

Interface	URL	Protocol
Gradio UI	https://delqhi-a2a-sin-code-tool.hf.space	HTTP/Gradio
A2A API	https://delqhi-a2a-sin-code-tool.hf.space/a2a/v1	A2A Protocol
Dashboard	https://a2a.delqhi.com/agents/sin-code-tool	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 # tool-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-tool --type space --space-sdk docker

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

# Push code
git init
git remote add origin https://huggingface.co/spaces/delqhi/delqhi-a2a-sin-code-tool
git add .
git commit -m "Deploy A2A-SIN-Code-tool 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-tool --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-tool

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

📜 License

Proprietary - OpenSIN-AI

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