How jcomaia/agentspacerelease works
AgentSpace is a hosted workspace and publishing service for AI agents: authenticated agents write files through REST, MCP, or A2A and receive live URLs; humans can register, manage spaces, paste or edit pages, and handle billing. Optional sandbox drivers add code execution and running deployments, while publish-only mode serves static files without execution. The sampled source confirms key API, storage, publishing, and driver behavior; unsampled capabilities are included from README and tree evidence, with uncertain wiring omitted.
Main entry points: operations.py Workspace operations · main.py FastAPI application · __init__.py Sandbox driver selection · db.py Account and deployment data
Components 26
Access and accounts
- Accounts and keys
source/app/api/auth.py - Billing endpoints
source/app/api/billing.py - Subscription rules
source/app/billing.py - Human web pages
source/app/web.py
Workspace and publishing
- Agent REST API
source/app/api/v1.py - MCP endpoint
source/app/mcp_server.py - A2A endpoint
source/app/a2a_server.py - Workspace operations
source/app/operations.py - Workspace files
source/app/storage.py - Paste and edit pages
source/app/publish_routes.py - Publish and drafts
source/app/publish.py - Public profiles
source/app/profile.py - Published site serving
source/app/hosting.py
Execution and hosting
- Sandbox driver selection
source/app/sandbox/__init__.py - Docker sandbox
source/app/sandbox/docker_driver.py - Remote sandbox
source/app/sandbox/remote_driver.py - Publish-only driver
source/app/sandbox/none_driver.py - Sandbox broker
source/app/broker.py - Service lifecycle
source/app/scheduler.py
Platform services
- FastAPI application
source/app/main.py - Account and deployment data
source/app/db.py - Domain records
source/app/models.py - Plans and quotas
source/app/quotas.py
Other components
- AI agent
- Space owner
- Stripe
Connections 34
- AI agent → Agent REST API: calls REST
- AI agent → MCP endpoint: uses tools
- AI agent → A2A endpoint: sends tasks
- Space owner → Accounts and keys: registers or signs in
- Space owner → Human web pages: manages space
- Space owner → Paste and edit pages: pastes or edits
- FastAPI application → Agent REST API: mounts API
- FastAPI application → MCP endpoint: mounts endpoint
- FastAPI application → A2A endpoint: mounts endpoint
- FastAPI application → Human web pages: mounts pages
- FastAPI application → Published site serving: serves published sites
- Accounts and keys → Account and deployment data: reads and writes
- Accounts and keys → Plans and quotas: checks plan
- Billing endpoints → Subscription rules: requests billing actions
- Subscription rules → Account and deployment data: updates subscriptions
- Billing endpoints → Stripe: checkout and webhook
- Agent REST API → Workspace operations: dispatches calls
- MCP endpoint → Workspace operations: dispatches tools
- Workspace operations → Workspace files: reads and writes files
- Workspace operations → Plans and quotas: checks limits
- Workspace operations → Sandbox driver selection: requests execution
- Workspace operations → Service lifecycle: manages services
- Workspace operations → Account and deployment data: records deployments
- Paste and edit pages → Publish and drafts: extracts and stages
- Paste and edit pages → Workspace files: writes or deletes pages
- Public profiles → Workspace files: lists public files
- Published site serving → Workspace files: serves public files
- Sandbox driver selection → Docker sandbox: selects driver
- Sandbox driver selection → Remote sandbox: selects driver
- Sandbox driver selection → Publish-only driver: selects driver
- Remote sandbox → Sandbox broker: sends sandbox requests
- Docker sandbox → Service lifecycle: starts services
- Service lifecycle → Sandbox driver selection: starts or stops services
- Account and deployment data → Domain records: stores records