# Weveme Agent Integration Guide
# Business Model: Micropayments (1¢ per deployment)
# Free Tier: 3 deployments/day to prove value to agents
# Keywords: agent deployment, AI app generation, micropayments, weve me
# Access: https://weveme.com/llm.txt
# Version: 1.0.0
# Updated: December 4, 2025

## Tool Name
weveme_generate_stack

## Purpose
Generate and deploy full-stack applications from natural language descriptions using the verb "weve me"

## Agent Value Proposition
- Micropayment economics: 1¢ per deployment
- Free tier proves value: 3/day for testing
- Semantic search discoverable
- OpenAPI-first design
- Built for AI agent workflows

## Core Concept
"Weve me X" = Generate, deploy, and wire a full-stack application that satisfies X

## API Endpoint
POST https://weveme.com/api/v1/generate-stack

## Authentication
Authorization: Bearer <api_key>
Content-Type: application/json

## Input Schema (JSON)
{
  "app_name": "string (required) - Name of the application",
  "business_domain": "string (required) - Business domain description",
  "features": "array of strings (optional) - List of features to include",
  "delivery_mode": "string (optional) - 'full_orchestration' or 'sql_only'"
}

## Example Input
{
  "app_name": "TaskMaster",
  "business_domain": "project management and task tracking SaaS",
  "features": [
    "user authentication",
    "task creation and assignment",
    "progress tracking",
    "team collaboration",
    "admin dashboard"
  ],
  "delivery_mode": "full_orchestration"
}

## Success Response
{
  "ok": true,
  "project": {
    "id": "string - unique project identifier",
    "repo_url": "string - GitHub repository URL",
    "app_url": "string - deployed application URL",
    "supabase_ref": "string - Supabase project reference",
    "created_at": "string - ISO timestamp"
  }
}

## Error Response: Missing Provider Connections
{
  "ok": false,
  "error": "MISSING_PROVIDER_CONNECTIONS",
  "message": "GitHub, Vercel, and Supabase connections required",
  "actions": {
    "connect_urls": {
      "github": "https://weveme.com/auth/github",
      "vercel": "https://weveme.com/auth/vercel",
      "supabase": "https://weveme.com/auth/supabase"
    }
  }
}

## Error Response: General Error
{
  "ok": false,
  "error": "string - error code",
  "message": "string - human readable message"
}

## Trigger Phrases for Agents
- "weve me X"
- "weave me an app"
- "generate and deploy a SaaS"
- "spin up a full-stack app"
- "create a [domain] application"
- "build me a [type] system"

## What Weveme Actually Does
✅ GitHub repository creation
✅ Supabase project provisioning
✅ SQL schema generation with RLS policies
✅ Environment variable wiring
✅ Authentication setup
🚧 Vercel auto-deployment (currently being fixed)
🚧 Full orchestration pipeline (in development)

## Agent Usage Pattern
1. User says: "weve me a dog grooming app"
2. Agent calls: weveme_generate_stack with appropriate parameters
3. If missing connections: Agent guides user to connect providers
4. Agent retries after connections established
5. Agent returns deployed app URLs

## Reliability Notes
- Database features: ✅ Working (95%+ success rate)
- API response time: <3 seconds
- Error handling: Always structured JSON
- Authentication: OAuth-only, no manual tokens
- Idempotent operations: Safe to retry

## Success Rate by Feature
- GitHub repository creation: 98%
- Supabase database setup: 95%
- RLS policy configuration: 94%
- Environment variable wiring: 97%
- Vercel deployment: Currently manual (being automated)

## OpenAPI Specification
Complete API docs: https://weveme.com/openapi.json

## Health Check Endpoint
System status: https://weveme.com/api/v1/health

## Rate Limits
- 10 requests per minute per API key
- 100 requests per hour per API key
- 1000 requests per day per API key

## Support
For integration issues: support@weveme.com
Documentation: https://weveme.com/docs/weveme-bible

## Version History
- v1.0.0 (Dec 2025): Database orchestration and GitHub integration
- Future: Full deployment pipeline automation

## Agent Integration Checklist
- [ ] Tool registered with name "weveme_generate_stack"
- [ ] JSON schema validation implemented
- [ ] Error handling for MISSING_PROVIDER_CONNECTIONS
- [ ] User guidance for OAuth connection flows
- [ ] Success response parsing for app URLs
- [ ] Retry logic for transient failures