Upload folder using huggingface_hub

app.py

@@ -4,7 +4,7 @@ from fastapi.responses import JSONResponse
 from contextlib import asynccontextmanager
 import os
 
-from src.opencode_api.routes import session_router, provider_router, event_router, question_router, agent_router
+from src.opencode_api.routes import session_router, provider_router, event_router, question_router, agent_router, docs_router
 from src.opencode_api.provider import (
     register_provider, 
     AnthropicProvider, 
@@ -73,6 +73,7 @@ app.include_router(provider_router)
 app.include_router(event_router)
 app.include_router(question_router)
 app.include_router(agent_router)
+app.include_router(docs_router)
 
 
 @app.get("/")
@@ -81,7 +82,9 @@ async def root():
         "name": "OpenCode API",
         "version": "0.1.0",
         "status": "running",
-        "docs": "/docs",
+        "docs": "/api-docs",
+        "swagger": "/docs",
+        "redoc": "/redoc"
     }
 
 

src/opencode_api/routes/__init__.py

@@ -3,5 +3,6 @@ from .provider import router as provider_router
 from .event import router as event_router
 from .question import router as question_router
 from .agent import router as agent_router
+from .docs import router as docs_router
 
-__all__ = ["session_router", "provider_router", "event_router", "question_router", "agent_router"]
+__all__ = ["session_router", "provider_router", "event_router", "question_router", "agent_router", "docs_router"]

src/opencode_api/routes/docs.py

@@ -0,0 +1,90 @@
+from fastapi import APIRouter
+from typing import List, Dict, Any
+
+router = APIRouter(prefix="/api-docs", tags=["Documentation"])
+
+API_INFO = {
+    "title": "OpenCode API Documentation",
+    "description": "Human-readable summary of available endpoints, their jobs, and how to interact with them.",
+    "auth": {
+        "type": "Bearer Token",
+        "header": "Authorization: Bearer ACCESS2026",
+        "description": "Most endpoints require this token for access."
+    },
+    "endpoints": [
+        {
+            "path": "/health",
+            "method": "GET",
+            "job": "Check system health and status.",
+            "interaction": "Send a GET request. No auth required.",
+            "example": "curl https://auxteam-opencode-api.hf.space/health"
+        },
+        {
+            "path": "/provider",
+            "method": "GET",
+            "job": "List available LLM providers (e.g., blablador, openai, anthropic).",
+            "interaction": "Send GET request with Bearer token.",
+            "example": "curl -H 'Authorization: Bearer ACCESS2026' https://auxteam-opencode-api.hf.space/provider"
+        },
+        {
+            "path": "/session",
+            "method": "POST",
+            "job": "Create a new chat session.",
+            "interaction": "Send POST request. Optional JSON body: {'title': 'My Session', 'model_id': 'alias-large'}.",
+            "example": "curl -X POST -H 'Authorization: Bearer ACCESS2026' https://auxteam-opencode-api.hf.space/session"
+        },
+        {
+            "path": "/session",
+            "method": "GET",
+            "job": "List all active chat sessions.",
+            "interaction": "Send GET request with Bearer token.",
+            "example": "curl -H 'Authorization: Bearer ACCESS2026' https://auxteam-opencode-api.hf.space/session"
+        },
+        {
+            "path": "/session/{session_id}/message",
+            "method": "POST",
+            "job": "Send a message to the agent and receive a streaming response.",
+            "interaction": "Send POST request with JSON body. Returns Server-Sent Events (SSE).",
+            "payload": {
+                "content": "Message string (required)",
+                "model_id": "Optional model ID (defaults to alias-large)",
+                "system": "Optional system prompt override"
+            },
+            "example": "curl -X POST -H 'Authorization: Bearer ACCESS2026' -H 'Content-Type: application/json' -d '{\"content\": \"Hi\"}' https://auxteam-opencode-api.hf.space/session/{id}/message"
+        },
+        {
+            "path": "/session/{session_id}/abort",
+            "method": "POST",
+            "job": "Cancel an ongoing message generation.",
+            "interaction": "Send POST request with Bearer token.",
+            "example": "curl -X POST -H 'Authorization: Bearer ACCESS2026' https://auxteam-opencode-api.hf.space/session/{id}/abort"
+        },
+        {
+            "path": "/question",
+            "method": "GET",
+            "job": "List questions waiting for user input (used by QuestionTool).",
+            "interaction": "Send GET request. Returns list of pending question requests.",
+            "example": "curl -H 'Authorization: Bearer ACCESS2026' https://auxteam-opencode-api.hf.space/question"
+        },
+        {
+            "path": "/question/{request_id}/reply",
+            "method": "POST",
+            "job": "Answer a pending question from the agent.",
+            "interaction": "Send POST request with JSON body: {'answers': [['Label1'], ['Label2']]}.",
+            "example": "curl -X POST -H 'Authorization: Bearer ACCESS2026' -H 'Content-Type: application/json' -d '{\"answers\": [[\"Yes\"]]}' https://auxteam-opencode-api.hf.space/question/{id}/reply"
+        },
+        {
+            "path": "/agent",
+            "method": "GET",
+            "job": "List available agent configurations.",
+            "interaction": "Send GET request.",
+            "example": "curl -H 'Authorization: Bearer ACCESS2026' https://auxteam-opencode-api.hf.space/agent"
+        }
+    ]
+}
+
+@router.get("")
+@router.get("/")
+async def get_api_docs():
+    """Return a human-readable summary of the API."""
+    return API_INFO