feat: deploy A2A server with Dockerfile, health endpoint, agent card

.well-known/agent-card.json

@@ -0,0 +1,19 @@
+{
+  "name": "SIN-Agent",
+  "description": "SIN A2A Agent",
+  "url": "https://localhost/a2a/v1",
+  "protocol": "A2A",
+  "version": "1.0.0",
+  "capabilities": ["chat", "task", "help"],
+  "commands": [
+    {"name": "agent.help", "description": "Show available commands"},
+    {"name": "agent.health", "description": "Check agent health"},
+    {"name": "agent.card", "description": "Show agent card"}
+  ],
+  "endpoints": {
+    "a2a": "/a2a/v1",
+    "health": "/health",
+    "card": "/.well-known/agent-card.json"
+  },
+  "status": "active"
+}

Dockerfile

@@ -0,0 +1,23 @@
+FROM node:22-slim
+
+WORKDIR /app
+
+# Install dependencies
+COPY package*.json ./
+RUN npm ci --omit=dev 2>/dev/null || npm install
+
+# Copy source
+COPY . .
+
+# Build if needed
+RUN npm run build 2>/dev/null || true
+
+# Expose port
+EXPOSE 7860
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=60s --retries=3 \
+  CMD curl -f http://localhost:7860/health || exit 1
+
+# Start
+CMD ["node", "server.js"]

HF-SPACE-RULE.md

@@ -0,0 +1,62 @@
+# 🚨 HUGGING FACE SPACE HARDWARE RULE (PRIORITY -7 — ABSOLUT, KEINE AUSNAHMEN) 🚨
+
+**ABSOLUTES VERBOT: KEINE GPU/ZeroGPU SPACES FÜR A2A AGENT RUNTIMES!**
+
+## WARUM
+
+- HF Free Tier erlaubt UNBEGRENZT CPU-Basic Spaces gleichzeitig ($0)
+- GPU/ZeroGPU Spaces haben Quota-Limit (8x) und benötigen Payment
+- Alle Agent Spaces MÜSSEN auf CPU-Basic laufen
+
+## PFLICHTEN
+
+1. **JEDES HF Space MUSS auf `cpu-basic` Hardware konfiguriert sein**
+2. **NIEMALS** GPU, ZeroGPU, oder paid Hardware für Agent Runtimes
+3. **IMMER** Keep-Alive-Ping alle 5 Minuten (verhindert 48h Sleep)
+
+## PFLICHT-DATEIEN FÜR JEDES HF SPACE
+
+Jedes HF Space MUSS diese Dateien enthalten:
+
+1. **Dockerfile** — Node.js/Python Container Definition
+2. **A2A Server** — Express/FastAPI mit A2A Protocol (`server.js` oder `app.py`)
+3. **Agent Logic** — Die eigentliche Agenten-Funktionalität
+4. **Health Endpoint** — `/health` Endpoint für Monitoring
+5. **A2A Card** — `/.well-known/agent-card.json` für Agent Discovery
+
+## KORREKTE SPACE ERSTELLUNG
+
+```bash
+# 1. Space erstellen
+curl -X POST https://huggingface.co/api/repos/create \
+  -H "Authorization: Bearer $HF_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "sin-my-agent", "type": "space", "sdk": "docker"}'
+
+# 2. Hardware auf CPU-Basic setzen
+curl -X POST https://huggingface.co/api/spaces/{owner}/{space}/hardware \
+  -H "Authorization: Bearer $HF_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"flavor": "cpu-basic"}'
+
+# 3. Dockerfile + Code deployen (via git push)
+git clone https://huggingface.co/spaces/{owner}/{space}
+cp Dockerfile server.js package.json .well-known/agent-card.json {space}/
+cd {space} && git add . && git commit -m "deploy agent" && git push
+```
+
+## KEEP-ALIVE PFLICHT
+
+Jedes Space MUSS Keep-Alive-Ping haben (alle 5min) um 48h Sleep zu verhindern.
+
+## KOSTEN
+
+| Hardware | Kosten | Max gleichzeitig |
+|----------|--------|-----------------|
+| cpu-basic | **$0** | **UNBEGRENZT** |
+| zerogpu | FREE | 8 pro Account |
+| gpu (T4) | $288/Mo | Unbegrenzt (Payment) |
+
+**FAZIT: CPU-Basic = $0, UNBEGRENZT Spaces!**
+
+Siehe auch: [Global Dev Docs HF Space Hardware Standard](https://github.com/OpenSIN-AI/Global-Dev-Docs-Standard/blob/main/standards/hf-space-hardware.md)

app.py

@@ -0,0 +1 @@
+print("SIN A2A Agent running")

package.json

@@ -0,0 +1,14 @@
+{
+  "name": "a2a-sin-agent-base",
+  "version": "1.0.0",
+  "description": "SIN A2A Agent Base Server",
+  "main": "server.js",
+  "scripts": {
+    "start": "node server.js",
+    "dev": "node --watch server.js",
+    "build": "echo 'No build step needed'"
+  },
+  "dependencies": {
+    "express": "^4.21.0"
+  }
+}

server.js

@@ -0,0 +1,133 @@
+const express = require('express');
+const path = require('path');
+const fs = require('fs');
+
+const app = express();
+const PORT = process.env.PORT || 7860;
+
+// Agent name from env or default
+const AGENT_NAME = process.env.AGENT_NAME || 'SIN-Agent';
+const AGENT_DESCRIPTION = process.env.AGENT_DESCRIPTION || 'SIN A2A Agent';
+
+// Middleware
+app.use(express.json());
+app.use(express.static(path.join(__dirname, 'public')));
+
+// Health endpoint
+app.get('/health', (req, res) => {
+  res.json({
+    status: 'ok',
+    agent: AGENT_NAME,
+    timestamp: new Date().toISOString(),
+    uptime: process.uptime(),
+    version: '1.0.0'
+  });
+});
+
+// A2A Card endpoint
+app.get('/.well-known/agent-card.json', (req, res) => {
+  const cardPath = path.join(__dirname, '.well-known', 'agent-card.json');
+  if (fs.existsSync(cardPath)) {
+    res.json(JSON.parse(fs.readFileSync(cardPath, 'utf8')));
+  } else {
+    res.json({
+      name: AGENT_NAME,
+      description: AGENT_DESCRIPTION,
+      url: `https://${process.env.SPACE_HOST || 'localhost'}/a2a/v1`,
+      protocol: 'A2A',
+      version: '1.0.0',
+      capabilities: ['chat', 'task'],
+      status: 'active'
+    });
+  }
+});
+
+// A2A v1 endpoint
+app.post('/a2a/v1', async (req, res) => {
+  try {
+    const { action, params } = req.body;
+    
+    switch (action) {
+      case 'agent.help':
+        res.json({
+          result: {
+            name: AGENT_NAME,
+            description: AGENT_DESCRIPTION,
+            commands: ['help', 'health', 'status'],
+            version: '1.0.0'
+          }
+        });
+        break;
+      
+      case 'agent.health':
+        res.json({
+          result: {
+            status: 'ok',
+            agent: AGENT_NAME,
+            uptime: process.uptime()
+          }
+        });
+        break;
+      
+      case 'agent.card':
+        res.json({
+          result: {
+            name: AGENT_NAME,
+            description: AGENT_DESCRIPTION,
+            protocol: 'A2A',
+            version: '1.0.0'
+          }
+        });
+        break;
+      
+      default:
+        res.json({
+          result: {
+            message: `Unknown action: ${action}. Use 'agent.help' for available commands.`,
+            agent: AGENT_NAME
+          }
+        });
+    }
+  } catch (error) {
+    res.status(500).json({
+      error: error.message,
+      agent: AGENT_NAME
+    });
+  }
+});
+
+// A2A GET endpoint
+app.get('/a2a/v1', (req, res) => {
+  res.json({
+    name: AGENT_NAME,
+    description: AGENT_DESCRIPTION,
+    protocol: 'A2A',
+    version: '1.0.0',
+    endpoints: {
+      post: '/a2a/v1',
+      card: '/.well-known/agent-card.json',
+      health: '/health'
+    }
+  });
+});
+
+// Root endpoint
+app.get('/', (req, res) => {
+  res.json({
+    name: AGENT_NAME,
+    description: AGENT_DESCRIPTION,
+    status: 'active',
+    endpoints: {
+      health: '/health',
+      a2a: '/a2a/v1',
+      card: '/.well-known/agent-card.json'
+    }
+  });
+});
+
+// Start server
+app.listen(PORT, '0.0.0.0', () => {
+  console.log(`${AGENT_NAME} listening on port ${PORT}`);
+  console.log(`Health: http://localhost:${PORT}/health`);
+  console.log(`A2A: http://localhost:${PORT}/a2a/v1`);
+});