Update Python version requirements and fix compatibility issues

- Bump minimum Python version from 3.11 to 3.13 across all apps
- Add Python 3.11-3.13 test matrix to CLI workflow
- Document Python 3.11+ requirement in .env.example
- Fix Starlette Broadcast removal with in-process fallback implementation
- Add _InProcessBroadcast class for tests when Starlette Broadcast is unavailable
- Refactor API key validators to read live settings instead of cached values
- Update database models with explicit

docs/0_getting_started/3_cli.md

@@ -22,6 +22,12 @@ export AITBC_API_KEY=your-key                       # or use --api-key
 
 | Group | Key commands |
 |-------|-------------|
+| `agent` | `create`, `execute`, `network`, `learning` |
+| `multimodal` | `agent`, `process`, `convert`, `search` |
+| `optimize` | `self-opt`, `predict`, `tune` |
+| `openclaw` | `deploy`, `edge`, `routing`, `ecosystem` |
+| `marketplace advanced` | `models`, `analytics`, `trading`, `dispute` |
+| `swarm` | `join`, `coordinate`, `consensus` |
 | `client` | `submit`, `status`, `list`, `cancel`, `download`, `batch-submit` |
 | `miner` | `register`, `poll`, `mine`, `earnings`, `deregister` |
 | `wallet` | `balance`, `send`, `stake`, `backup`, `multisig-create` |
@@ -50,6 +56,66 @@ aitbc miner poll                                    # start accepting jobs
 aitbc wallet balance                                # check earnings
 ```
 
+## Advanced AI Agent Workflows
+
+```bash
+# Create and execute advanced AI agents
+aitbc agent create --name "MultiModal Agent" --workflow-file workflow.json --verification full
+aitbc agent execute agent_123 --inputs inputs.json --verification zero-knowledge
+
+# Multi-modal processing
+aitbc multimodal agent create --name "Vision-Language Agent" --modalities text,image --gpu-acceleration
+aitbc multimodal process agent_123 --text "Describe this image" --image photo.jpg
+
+# Autonomous optimization
+aitbc optimize self-opt enable agent_123 --mode auto-tune --scope full
+aitbc optimize predict agent_123 --horizon 24h --resources gpu,memory
+```
+
+## Agent Collaboration & Learning
+
+```bash
+# Create collaborative agent networks
+aitbc agent network create --name "Research Team" --agents agent1,agent2,agent3
+aitbc agent network execute network_123 --task research_task.json
+
+# Adaptive learning
+aitbc agent learning enable agent_123 --mode reinforcement --learning-rate 0.001
+aitbc agent learning train agent_123 --feedback feedback.json --epochs 50
+```
+
+## OpenClaw Edge Deployment
+
+```bash
+# Deploy to OpenClaw network
+aitbc openclaw deploy agent_123 --region us-west --instances 3 --auto-scale
+aitbc openclaw edge deploy agent_123 --locations "us-west,eu-central" --strategy latency
+
+# Monitor and optimize
+aitbc openclaw monitor deployment_123 --metrics latency,cost --real-time
+aitbc openclaw optimize deployment_123 --objective cost
+```
+
+## Advanced Marketplace Operations
+
+```bash
+# Advanced NFT model operations
+aitbc marketplace advanced models list --nft-version 2.0 --category multimodal
+aitbc marketplace advanced mint --model-file model.pkl --metadata metadata.json --royalty 5.0
+
+# Analytics and trading
+aitbc marketplace advanced analytics --period 30d --metrics volume,trends
+aitbc marketplace advanced trading execute --strategy arbitrage --budget 5000
+```
+
+## Swarm Intelligence
+
+```bash
+# Join swarm for collective optimization
+aitbc swarm join --role load-balancer --capability resource-optimization
+aitbc swarm coordinate --task network-optimization --collaborators 10
+```
+
 ## Configuration
 
 Config file: `~/.aitbc/config.yaml`
@@ -67,6 +133,18 @@ log_level: INFO
 | Auth error | `export AITBC_API_KEY=your-key` or `aitbc auth login` |
 | Connection refused | Check coordinator: `curl http://localhost:8000/v1/health` |
 | Unknown command | Update CLI: `pip install -e .` from monorepo root |
+| Agent command not found | Ensure advanced agent commands are installed: `pip install -e .` |
+| Multi-modal processing error | Check GPU availability: `nvidia-smi` |
+| OpenClaw deployment failed | Verify OpenClaw credentials and region access |
+| Marketplace NFT error | Check model file format and metadata structure |
+
+## Advanced Agent Documentation
+
+See [docs/11_agents/](../11_agents/) for detailed guides:
+- [Advanced AI Agents](../11_agents/advanced-ai-agents.md) - Multi-modal and adaptive agents
+- [Agent Collaboration](../11_agents/collaborative-agents.md) - Networks and learning
+- [OpenClaw Integration](../11_agents/openclaw-integration.md) - Edge deployment
+- [Swarm Intelligence](../11_agents/swarm/) - Collective optimization
 
 ## Full Reference