WebAgents Manual Testing Guide

cd /Users/vs/dev/webagents
source .venv/bin/activate

# Verify dependencies
pip show multilspy litellm fastapi uvicorn

# Set API keys (optional, for LLM-powered features)
export OPENAI_API_KEY="your-key-here"

python examples/skills/run_skill_demos.py

# Get the public keys for token verification
curl http://localhost:8000/auth-demo/.well-known/jwks.json

# Start REPL with auth-demo agent
webagents repl auth-demo

# In REPL:
/auth status
/auth token http://localhost:9000/other-agent

python examples/skills/run_skill_demos.py

webagents repl lsp-demo

# In REPL:
/lsp status

# Test goto_definition
curl -X POST http://localhost:8000/lsp-demo/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Find the definition of BaseAgent in webagents/agents/core/base_agent.py"}]
  }'

python examples/skills/run_skill_demos.py

webagents repl plugin-demo

# In REPL:
/plugin list
/plugin search calculator

cd webagents/cli/webui
pnpm install
pnpm build
cd ../../..

python examples/skills/run_skill_demos.py

open http://localhost:8000/webui-demo/ui

python examples/ucp_commerce/run_commerce_demo.py

# Get merchant's UCP profile
curl http://localhost:8000/ucp-merchant/.well-known/ucp

curl http://localhost:8000/ucp-merchant/ucp/services

# Create checkout session
curl -X POST http://localhost:8000/ucp-merchant/checkout-sessions \
  -H "Content-Type: application/json" \
  -d '{
    "line_items": [{"item": {"id": "quick_analysis"}, "quantity": 1}],
    "buyer": {"email": "test@example.com", "full_name": "Test User"}
  }'

# Create example agents directory
mkdir -p ~/.webagents/agents
cp examples/skills/AGENT-*.md ~/.webagents/agents/

# Start daemon
webagentsd start --port 8765 --watch ~/.webagents/agents

webagents list

# Health check
curl http://localhost:8765/health

# Agent info
curl http://localhost:8765/agents/auth-demo

# Chat completion
curl -X POST http://localhost:8765/agents/auth-demo/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"messages": [{"role": "user", "content": "Hello"}]}'

# Modify an agent file
echo "# Updated" >> ~/.webagents/agents/AGENT-auth-demo.md

webagentsd stop

webagents repl

/help                    # Show available commands
/agents                  # List available agents
/switch auth-demo        # Switch to specific agent
/skills                  # List loaded skills
/tools                   # List available tools
/clear                   # Clear conversation
/quit                    # Exit REPL

> Hello, what can you do?
> /switch lsp-demo
> Find the definition of UCPSkill

# Terminal 1: Start commerce demo
python examples/ucp_commerce/run_commerce_demo.py

# Terminal 2: Use client to discover merchant
curl -X POST http://localhost:8000/ucp-client/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Discover services at http://localhost:8000/ucp-merchant"}]
  }'

# Start two agents
python examples/skills/run_skill_demos.py

# REPL: Generate token
webagents repl auth-demo
/auth token http://localhost:8000/another-agent

webagents repl lsp-demo
> List all classes in webagents/agents/core/base_agent.py
> Find where UCPSkill is defined
> Show the hover documentation for the BaseAgent class

# Daemon logs
tail -f ~/.webagents/logs/daemon.log

# Enable debug logging
WEBAGENTS_DEBUG=1 webagentsd start

cd /Users/vs/dev/webagents

# Core skill tests (fast)
.venv/bin/pytest tests/test_local_auth_skill.py tests/test_lsp_skill.py \
  tests/test_plugin_skill.py tests/test_webui_skill.py \
  tests/test_skill_integration.py -v

# UCP tests
.venv/bin/pytest tests/test_ucp_skill.py tests/test_ucp_commerce.py -v

# Full test suite
.venv/bin/pytest tests/ --ignore=tests/integration -q