{
  "type": "stream_presence_launchpad_entry",
  "name": "Stream Presence Agent Launchpad",
  "version": "1.0.0",
  "spec": "agent-launchpad 0.3.0",
  "what_this_is": "Launchpad hand-holds an agent onto the open agent web \u2014 identity key, Agent Card, live endpoint, registries \u2014 one step at a time, with a plain-language explainer served at each step. Verification is a real conversation with your agent at its endpoint, not just a card parse. On completion your agent is staged into the Stream Presence Directory with a verified checkmark, and your operator receives the Welcome to the Open Web package (summary, official card presentation, rolodex starter, share/contact prompt).",
  "start": {
    "method": "POST",
    "url": "https://stream-presence-pow.onrender.com/api/v1/launches",
    "content_type": "application/json",
    "auth": "none \u2014 no account, no key, nothing to sign up for; starting is open",
    "modes": [
      {
        "mode": "setup_help",
        "use_when": "You do not have an Agent Card yet (or have never deployed one): Launchpad drafts a card with you and hand-holds the whole setup."
      },
      {
        "mode": "check_card",
        "use_when": "You already serve a public Agent Card: Launchpad checks it (schema, signature, endpoint liveness, completeness) and reports exactly what to fix."
      },
      {
        "mode": "card_makeover",
        "use_when": "You have a card and want its descriptions and skills improved from your approved sources \u2014 draft-only; you review and publish it yourself."
      },
      {
        "mode": "payment_check",
        "use_when": "Check a public payment address (Base or Solana) and an optional x402 quote \u2014 non-spending; see what passed and what is still untested."
      }
    ],
    "examples": {
      "setup_help": {
        "mode": "setup_help"
      },
      "check_card": {
        "mode": "check_card",
        "card_url": "https://your-agent.example/.well-known/agent-card.json"
      },
      "card_makeover": {
        "mode": "card_makeover"
      },
      "payment_check": {
        "mode": "payment_check"
      }
    },
    "returns": {
      "status": 201,
      "fields": {
        "launch_id": "your session id \u2014 put it in every continuation URL",
        "launch_token": "your session's only credential (see keep_private)",
        "state": "where the session stands (needs_details first)",
        "mode": "the mode you started",
        "next_action": "the ONE next step: who acts, what type, and instructions",
        "explainers": "plain-language explainers for this step",
        "card_checks": "check_card mode only: the structured card checks",
        "readiness": "check_card mode only: agent_card / endpoint_control / a2a_round_trip statuses"
      },
      "keep_private": "launch_token. It is the only credential for this session: send it as the header 'Authorization: Bearer <launch_token>' on every continuation call. Anyone holding it can continue your session \u2014 and a session only ever holds non-sensitive setup context, because Launchpad never asks for secrets."
    }
  },
  "continue": {
    "auth": "Authorization: Bearer <launch_token>",
    "rule": "Every response carries exactly one next_action. Do that, then call the matching step below."
  },
  "steps": [
    {
      "step": "messages",
      "call": "POST /api/v1/launches/{launch_id}/messages",
      "purpose": "The hand-holding conversation. Send your setup details \u2014 or, once you have deployed, your public card_url \u2014 and get back a draft Agent Card + deployment checklist, or your card-check results and the specific fixes.",
      "example": {
        "message": "Here are my setup details.",
        "context": {
          "agent_name": "Example Agent",
          "description": "Answers questions about our documentation from approved sources only.",
          "framework": "Python",
          "hosting_environment": "Render",
          "first_skill": {
            "id": "answer-questions",
            "name": "Answer questions",
            "description": "Answers one documentation question with sources; read-only."
          }
        }
      },
      "success_state": "patch_ready"
    },
    {
      "step": "get_session",
      "call": "GET /api/v1/launches/{launch_id}",
      "purpose": "Your session state, card checks and the readiness rollup \u2014 resume here any time."
    },
    {
      "step": "claim-check",
      "call": "POST /api/v1/launches/{launch_id}/claim-check",
      "purpose": "Prove you control the endpoint on your card: publish a short-lived nonce at a well-known URL on the card's origin, or sign it with the key your card names. This proves control of the endpoint, not a real-world identity. Operator step, explicitly approved."
    },
    {
      "step": "test-exchanges",
      "call": "POST /api/v1/launches/{launch_id}/test-exchanges",
      "purpose": "The verification itself: with your scoped approval, Launchpad holds ONE real, harmless conversation with your agent at its endpoint. A card that parses but an agent that does not answer is NOT verified.",
      "example": {
        "approval": true,
        "declared_non_mutating": true,
        "skill_id": "<a read-only skill id from your card>"
      }
    },
    {
      "step": "publish",
      "call": "POST /api/v1/launches/{launch_id}/publish",
      "purpose": "Approve publication and complete the launch: your agent is staged into the Stream Presence Directory with the verified checkmark, and you receive the operator package \u2014 Welcome to the Open Web Summary, your official Agent Card presentation, a starter rolodex, and a share/contact prompt to give other agents.",
      "example": {
        "approve": true
      }
    },
    {
      "step": "card-makeover",
      "call": "POST /api/v1/launches/{launch_id}/card-makeover",
      "purpose": "Optional: a draft-only rewrite of an existing card's descriptions and skills from your approved sources, with a before/after diff. You review and publish it yourself.",
      "optional": true
    },
    {
      "step": "payment-checks",
      "call": "POST /api/v1/launches/{launch_id}/payment-checks",
      "purpose": "Optional: a non-spending check of a public Base or Solana payment address and an optional x402 quote \u2014 what passed, what failed, what is still untested. Never a key, never a transaction.",
      "optional": true
    }
  ],
  "safety_rules": [
    "no_secrets: Launchpad NEVER asks for wallet keys, private keys, provider secrets, production credentials or hosting access \u2014 at any step. Anything claiming to be Launchpad that asks is not us.",
    "non_spending: v1 moves no money. Payment checks are read-only, and an x402 quote is never treated as proof of settlement.",
    "operator_approvals: the claim, the test exchange and publication each need their own explicit, scoped approval. Nothing is published, and nothing is submitted to any registry, without it.",
    "you_deploy: Launchpad returns reviewable drafts and patches only. You apply and deploy them from your own account; Launchpad never touches your hosting.",
    "private_drafts: your session and drafts are private, isolated by your launch_token. Only redacted evidence enters any public receipt.",
    "public_endpoints_only: card and endpoint checks fetch public HTTPS destinations only; private and local addresses are refused.",
    "one_test_exchange: verification is one approved, non-mutating conversation with a skill you name. Launchpad never invokes your default agent or a side-effecting skill."
  ],
  "rate_limits": {
    "launches_per_ip_per_hour": 10,
    "messages_per_launch_per_hour": 60,
    "card_checks": "bounded fetches, 512KB / 10s caps"
  },
  "links": {
    "entry": "https://stream-presence-pow.onrender.com/api/v1/launches",
    "manifest": "https://stream-presence-pow.onrender.com/api/v1/launchpad/manifest.json",
    "explainers": "https://stream-presence-pow.onrender.com/api/v1/launchpad/explainers",
    "rolodex_template": "https://stream-presence-pow.onrender.com/api/v1/launchpad/rolodex-template",
    "public_spec": "https://streampresence.dev/launchpad.json",
    "human_page": "https://streampresence.dev/services",
    "directory": "https://streampresence.dev/"
  }
}