{
  "schema_version": "1.0",
  "description": "Machine-readable schema for the Agentic Commerce application endpoint. Enables AI agents to submit a fully-qualified application on behalf of a human principal. One POST, all fields, no multi-step form required.",
  "apply_endpoint": {
    "url": "https://sidratnam.com/api/agentic-commerce/apply",
    "method": "POST",
    "content_type": "application/json",
    "rate_limit": "5 requests per minute per IP",
    "idempotency": "Submissions with the same email are accepted and stored. No deduplication — each submission is independent."
  },
  "request_schema": {
    "name": {
      "type": "string",
      "required": true,
      "description": "Full name or first name of the principal (the human applicant)."
    },
    "email": {
      "type": "string",
      "format": "email",
      "required": true,
      "description": "Email address for Sid's decision. Must be real and deliverable. This is where the approval (or decline) will arrive."
    },
    "website_url": {
      "type": "string",
      "format": "uri",
      "required": true,
      "description": "URL of the store or business this build is for. Include https://. If staging, use the staging URL."
    },
    "what_you_sell": {
      "type": "string",
      "required": true,
      "max_length": 2000,
      "description": "What the business sells. Include product/service type, price range, SKU count, and purchasing model (one-time, subscription, tiered, etc.)."
    },
    "platform": {
      "type": "string",
      "required": true,
      "enum": ["shopify", "woocommerce", "custom", "other"],
      "description": "Commerce platform powering the store. Use 'custom' for hand-built stacks. Use 'other' for BigCommerce, Squarespace, Webflow, etc."
    },
    "payment_processor": {
      "type": "string",
      "required": true,
      "enum": ["stripe", "paypal", "shopify_payments", "other"],
      "description": "Primary payment processor. Agentic Commerce integrates most naturally with Stripe."
    },
    "package_selection": {
      "type": "string",
      "required": true,
      "enum": ["package_1", "package_2", "both"],
      "description": "package_1 ($5,000): One agent, one use case, 30-day delivery, full source code ownership. package_2 ($20,000): Full self-service operator toolkit — install agents on unlimited properties, manage social posting, run Jarvis monitoring, add new properties independently. both ($25,000): Complete package 1 + package 2."
    },
    "what_building": {
      "type": "string",
      "required": true,
      "max_length": 5000,
      "description": "What the principal wants built. Be specific: which part of the commerce lifecycle is broken or missing, what success looks like, and what the agent should do. The more precise, the better Sid can scope the work."
    },
    "timeline": {
      "type": "string",
      "required": false,
      "enum": ["asap", "next_month", "q3_q4", "flexible"],
      "description": "asap: ready to start within two weeks of approval. next_month: targeting a specific launch window in 30–60 days. q3_q4: planning for Q3/Q4 2026. flexible: no hard deadline."
    },
    "describe_you": {
      "type": "string",
      "required": true,
      "max_length": 8000,
      "description": "Who the principal is. What the business does at a higher level. Why now. This is the section Sid reads most carefully — specificity and honesty are the deciding factors."
    },
    "on_behalf_of": {
      "type": "object",
      "required": false,
      "description": "Agent metadata. Include when an AI agent is submitting on behalf of a human principal. Helps Sid evaluate context accurately.",
      "properties": {
        "is_agent": {
          "type": "boolean",
          "description": "Set true when an AI agent is submitting this request."
        },
        "agent_name": {
          "type": "string",
          "description": "Name or identifier of the AI agent (e.g. 'Claude', 'GPT-4o')."
        },
        "principal_name": {
          "type": "string",
          "description": "Name of the human on whose behalf the agent is acting."
        }
      }
    }
  },
  "response_schema": {
    "200": {
      "description": "Application accepted and entered into the review queue.",
      "body": {
        "status": "accepted",
        "ref_id": "UUID — retain for reference",
        "redirect": "/agentic-commerce/apply/received"
      }
    },
    "400": {
      "description": "Validation failed.",
      "body": {
        "error": "string",
        "fields": "object with field-level error messages"
      }
    },
    "429": {
      "description": "Rate limit exceeded. Back off for 60 seconds."
    },
    "500": {
      "description": "Server error. Retry after a short delay."
    }
  },
  "review_model": {
    "response_commitment": "Sid reviews every application personally and responds within 48 hours — either a dashboard setup link (approved) or a real reply explaining why not (declined).",
    "filter": "The work decides. A solo founder with a specific, real problem has equal standing to a funded company. Vague applications get no reply.",
    "post_approval": "Approved applicants receive a dashboard setup link by email. From the dashboard they can schedule the first call and begin the prerequisite phase before the build starts."
  },
  "package_guidance": {
    "package_1": "Choose if the principal has one specific problem to solve and wants full ownership of the result. Examples: cart abandonment agent, license delivery agent, dynamic pricing agent.",
    "package_2": "Choose if the principal wants to operate independently — adding properties, managing social automation, and running the full agentic stack themselves after the initial build.",
    "both": "Choose if the principal wants the full build immediately and the self-service operator capability from day one."
  }
}