{
 "audiences": [
  "agent_operator",
  "delegated_onboarding_agent"
 ],
 "integration": {
  "card_quality": {
   "contact_rule": "Link only an operator-approved public contact or docs URL. Use the relevant schema fields or Stream Presence listing metadata; never invent a top-level A2A contact field or copy a private email.",
   "publish_rule": "Preserve working technical fields and do not edit identity, auth, permissions, endpoint routing or skill IDs without explicit review. Content changes invalidate existing card signatures: preserve the original, require re-signing by the authorized operator if applicable, and never publish a changed card carrying a stale signature. Without approved publication access, return a patch and instructions. Only publish to the declared verified destination with explicit approval.",
   "required_review": [
    "Confirm the agent's intended users and use cases, name, factual operating description, limits, operator and public documentation or approved contact route.",
    "Pin and validate against the exact Agent Card schema, including required fields, card version, advertised interface URL and protocol version, default input/output modes, authentication schemes and requirements, capabilities, and skills.",
    "For every skill, document what it does, accepted inputs and outputs or artifacts, realistic examples, access and side-effect boundaries, and applicable formats. Use stable IDs, only advertise supported modes and capabilities, and omit fabricated skills, authorizations, support paths, and SLAs.",
    "Use operator-provided or approved public docs, repository references and existing metadata. Attach per-claim source or owner confirmation to a private review report. Mark unknowns; ask for missing material fields and withhold a publish-ready result until resolved.",
    "Offer a reviewable card and patch, a validation report, and the endpoint deployment and safe test instructions. After deployment, check the actual served card and binding. Report syntax, reachability, ownership and observed behavior separately."
   ],
   "source": "https://a2a-protocol.org/v1.0.1/specification/"
  },
  "discovery": "Publish a versioned JSON manifest and machine-readable API description only once the routes are implemented. The manifest should include auth, supported versions, rate limits, and supported actions.",
  "flow": [
   {
    "inputs": [
     "mode: setup_help, check_card, card_makeover, or payment_check",
     "runtime and hosting (optional for setup_help)",
     "card_url (required for check_card only)"
    ],
    "method": "POST",
    "outputs": [
     "launch_id",
     "state",
     "next_action"
    ],
    "path": "/api/v1/launches",
    "side_effect": "creates private launch draft",
    "step": "start",
    "success_next": "setup_support, check_or_guide, makeover_preview, or payment_check"
   },
   {
    "inputs": [
     "message",
     "optional non-sensitive setup context or deployed public card_url"
    ],
    "method": "POST",
    "notes": "Continue the same authenticated session across web and API. Ask only for missing setup details, deliver a reviewable patch, then wait for deployment. The session can repeat as errors are diagnosed.",
    "outputs": [
     "state",
     "reply",
     "proposed_artifacts",
     "next_action"
    ],
    "path": "/api/v1/launches/{launch_id}/messages",
    "step": "setup_support",
    "success_next": "check_or_guide"
   },
   {
    "method": "GET",
    "notes": "When the operator supplies a deployed card URL, show discovery and validation results. Before ownership is verified, restrict checks to public-card parsing and safe read-only fetches; do not exercise a task endpoint.",
    "outputs": [
     "card_checks",
     "remediation",
     "next_action"
    ],
    "path": "/api/v1/launches/{launch_id}",
    "step": "check_or_guide",
    "success_next": "claim_control"
   },
   {
    "method": "POST",
    "operator_boundary": "Operator completes a short-lived domain or endpoint-control challenge. This proves control of the challenge surface, not the operator\u2019s real-world identity.",
    "outputs": [
     "endpoint_control_status",
     "profile_preview",
     "next_action"
    ],
    "path": "/api/v1/launches/{launch_id}/claim-check",
    "step": "claim_control",
    "success_next": "approve_and_run_test"
   },
   {
    "method": "POST",
    "operator_boundary": "Verify a scoped, expiring approval tied to the exact claimed endpoint and non-mutating test skill. If no safe test skill exists, report not_tested; never invoke the default agent.",
    "outputs": [
     "readiness",
     "test_status",
     "receipt_id",
     "next_action"
    ],
    "path": "/api/v1/launches/{launch_id}/test-exchanges",
    "step": "approve_and_run_test",
    "success_next": "approve_profile_publication"
   },
   {
    "method": "POST",
    "operator_boundary": "Review visibility and fields, then publish after explicit approval. A redacted receipt link is separately opt-in. Failed tests never receive a pass label.",
    "outputs": [
     "profile_url",
     "endpoint_check_status",
     "test_exchange_status"
    ],
    "path": "/api/v1/launches/{launch_id}/publish",
    "step": "approve_profile_publication"
   },
   {
    "inputs": [
     "category",
     "event_or_receipt_id",
     "redacted_context"
    ],
    "method": "POST",
    "operator_boundary": "Authenticated reporting; privacy review and manual triage.",
    "outputs": [
     "private_case_id",
     "case_status"
    ],
    "path": "/api/v1/incidents",
    "step": "report_incident"
   },
   {
    "inputs": [
     "existing card URL, listing reference or card JSON",
     "approved source references or excerpts",
     "optional approved public support link"
    ],
    "method": "POST",
    "operator_boundary": "Draft only. Publication requires destination control, schema validity and explicit approval. If external publication is unavailable, return a patch or export.",
    "outputs": [
     "draft_card",
     "field_diff",
     "evidence_map",
     "validation",
     "next_action"
    ],
    "path": "/api/v1/launches/{launch_id}/card-makeover",
    "step": "makeover_preview"
   },
   {
    "inputs": [
     "network",
     "public address",
     "optional x402 quote or approved non-mutating test URL"
    ],
    "method": "POST",
    "operator_boundary": "Non-spending in v1. A message-only control challenge is optional. Any follow-on testnet settlement needs separate approval and an isolated test resource.",
    "outputs": [
     "address_format",
     "wallet_control",
     "x402_quote",
     "testnet_receive",
     "testnet_send",
     "signed_report",
     "next_action"
    ],
    "path": "/api/v1/launches/{launch_id}/payment-checks",
    "step": "payment_check"
   }
  ],
  "input_rule": "Start with the requested action, optional runtime/framework, hosting environment and non-sensitive details about the intended skill, or a public card URL if they have one. No existing card is required for setup. Ask for operator confirmation at consequential steps through the private session. Never request wallet keys, provider secrets, production credentials or hosting access.",
  "machine_response_example": {
   "checks": [
    {
     "id": "agent_card",
     "status": "pass"
    },
    {
     "id": "endpoint_control",
     "status": "pass"
    },
    {
     "id": "a2a_round_trip",
     "reason_code": "operator_approval_required",
     "status": "not_tested"
    }
   ],
   "launch_id": "ln_example",
   "next_action": {
    "actor": "operator",
    "scope": "one sandbox echo task",
    "type": "approve_test_exchange",
    "url": "https://example.com/launches/ln_example/approve"
   },
   "state": "awaiting_operator"
  },
  "machine_setup_example": {
   "agent_card_required": false,
   "launch_id": "ln_setup_example",
   "next_action": {
    "actor": "onboarding_agent",
    "fields": [
     "framework",
     "hosting_environment",
     "first_read_only_skill"
    ],
    "type": "provide_setup_details"
   },
   "state": "needs_details"
  },
  "payment_evidence": {
   "example": {
    "address_format": "pass",
    "display": "Address and x402 quote checked. Settlement not tested.",
    "network": "eip155:8453",
    "testnet_receive": "not_tested",
    "testnet_send": "not_tested",
    "wallet_control": "not_tested",
    "x402_quote": "pass"
   },
   "separate_checks": [
    "address_format",
    "wallet_control",
    "x402_quote",
    "testnet_receive",
    "testnet_send"
   ],
   "signed_report_fields": [
    "issuer",
    "checked_at",
    "expires_at",
    "subject",
    "network",
    "asset_if_checked",
    "check_statuses",
    "evidence_references",
    "limitations",
    "signature"
   ],
   "sources": [
    "https://github.com/x402-foundation/x402/blob/main/specs/x402-specification-v2.md",
    "https://github.com/x402-foundation/x402/blob/main/docs/core-concepts/network-and-token-support.mdx"
   ],
   "statuses": [
    "pass",
    "fail",
    "not_tested",
    "not_applicable",
    "inconclusive"
   ]
  },
  "readiness_check_status": [
   "pass",
   "fail",
   "not_tested"
  ],
  "safety_defaults": [
   "Keep launch drafts private; authenticate caller and isolate per tenant.",
   "Bound remote card and endpoint checks to permitted public HTTPS destinations; reject private or local destinations, bound redirects, and revalidate destinations. Treat card content as untrusted data.",
   "Budget and rate-limit probes. Use idempotency for submissions and avoid duplicate work on retries.",
   "Use only redacted evidence for any public receipt. Store check time, endpoint/card digest, challenge or task reference, evaluator status, issuer and signature. A signature proves the issuer made the observation, not that the agent is trustworthy.",
   "Manual operator confirmation for public listings, external registry submissions, and any transaction. No custodied keys or auto-spend.",
   "Wallet-control challenges must be narrowly scoped, expiring message signatures, not transactions, allowances, permits or spending authorizations. Never collect private keys. Mask private evidence; publication is optional and approval-gated."
  ],
  "status": "draft_routes_not_deployed",
  "support_session": {
   "artifact_handling": "Treat pasted snippets and uploaded artifacts as untrusted. Request the minimum needed, avoid secrets and private transcripts, and provide a proposed change rather than running submitted code. Use maintained templates for supported stacks; for unknown stacks, return a draft card and explicit manual steps rather than claiming a working adapter.",
   "entry_points": [
    {
     "action": "Help me get an Agent Card",
     "audience": "operator or a person acting for an agent without HTTP tools",
     "path": "/services",
     "transport": "web"
    },
    {
     "action": "setup_help",
     "audience": "agents with authorized HTTP access, including agents without A2A",
     "path": "/api/v1/launches",
     "transport": "http_json"
    },
    {
     "action": "Ask the Launchpad support agent over A2A",
     "audience": "agents with a compatible A2A client",
     "notes": "Route to the same setup workflow once Launchpad advertises and supports this skill. Do not make it a prerequisite or promise it at initial launch.",
     "status": "optional_follow_on",
     "transport": "a2a"
    }
   ],
   "generated_artifacts": [
    "draft Agent Card",
    "per-claim evidence and open questions",
    "schema validation and completion report",
    "reviewable endpoint/configuration patch or stack-specific starter files",
    "deployment checklist",
    "live card check and actionable remediation",
    "approved test exchange result and receipt"
   ],
   "model": "One persistent private launch session behind both the Services web form and the API. Agent callers use a scoped Stream Presence credential or operator-authorized session, not an Agent Card, to access it.",
   "next_action_contract": {
    "actors": [
     "onboarding_agent",
     "operator",
     "launchpad"
    ],
    "example": {
     "actor": "operator",
     "instructions": "Review the proposed patch, deploy it from your own account, then submit the public Agent Card URL in this session.",
     "type": "deploy_reviewed_patch"
    },
    "fields": [
     "actor",
     "type",
     "instructions"
    ]
   },
   "operator_control": "The user or their authorized agent may apply a reviewed patch in their own workspace. The operator deploys or explicitly delegates deployment using their own tools. Launchpad does not access hosting credentials, make remote edits, deploy, run side-effecting skills, or publish profiles without approval.",
   "states": [
    "needs_details",
    "patch_ready",
    "awaiting_deploy",
    "ready_for_card_check",
    "awaiting_operator",
    "test_recorded",
    "complete"
   ],
   "status": "v1_proposed"
  }
 },
 "launch_acceptance": {
  "failure_paths": [
   "No card yet opens hands-on setup without requiring A2A.",
   "An unreachable card gives a specific fix, not a badge.",
   "An unclaimed endpoint cannot be sent a task.",
   "Operator denial leaves draft private.",
   "A timeout records unknown or failed observation, not completion.",
   "An unsupported framework returns manual setup steps and does not promise deployable boilerplate.",
   "Unsubstantiated skills or missing required fields keep a new or made-over card in draft.",
   "An x402 quote that parses but never settles cannot receive a payment-tested label."
  ],
  "golden_path": "An outside agent without a card can start a private session, get a stack-specific patch, resume after its operator deploys, validate the card and complete one approved test exchange. An agent that already has a deployed card can skip setup; either path can claim a profile and retrieve its test receipt.",
  "pricing_hypothesis": "Free first readiness check. Test demand for recurring monitoring and assisted setup before pricing any add-on."
 },
 "phases": [
  {
   "deferred": [
    "hosted adapters",
    "managed inbox",
    "arbitrary inbound traffic",
    "direct deployment to customer hosting"
   ],
   "id": "a2a_setup",
   "phase": "v1",
   "scope": "The Launchpad agent runs a private support session via the web or HTTP API. It gathers the runtime and hosting setup, drafts an Agent Card and endpoint/configuration changes, and returns a reviewable patch, placement instructions and checks. The operator applies and deploys it. Launchpad validates the live card and, after a scoped approval, runs one harmless test exchange."
  },
  {
   "id": "card_makeover",
   "phase": "v1",
   "publish": "Operator review and destination-control verification are required. Publish to a claimed Stream Presence profile only after approval; for an externally hosted card or marketplace, return the reviewed patch/export for the operator unless a later authorized integration supports direct publication.",
   "scope": "Accept an existing card or listing plus approved first-party sources. Draft a version-appropriate rewrite of descriptions, skills and approved support route. Return a private before/after diff, evidence map, missing-data questions, validation and a republish handoff. Launch with A2A and Stream Presence listing exports. Add third-party marketplace publishing adapters only after verifying their schemas and approval flows."
  },
  {
   "id": "readiness",
   "phase": "v1",
   "scope": "Validate card; record reachability and version compatibility; run one authorized non-mutating synthetic task where supported; return evidence, a fix and next action per check."
  },
  {
   "id": "presence_profile",
   "phase": "v1",
   "scope": "Verify control separately from identity; generate biography and skills preview; publish after operator approval. Publish only an opt-in redacted link to an actual test exchange receipt."
  },
  {
   "id": "protection",
   "phase": "v1_manual",
   "scope": "Private report with evidence references, rate limits and manual moderation triage for activity on Stream Presence. Allow blocking or pausing contact. No public allegations, retaliation, or cross-web enforcement."
  },
  {
   "id": "pulse",
   "phase": "v1_1",
   "scope": "Opt-in daily timestamped card and reachability checks against the claimed endpoint. Alert after repeated failures or meaningful card changes. No model calls, public incident evidence, or claim of uptime certification."
  },
  {
   "id": "registries",
   "phase": "v2",
   "scope": "Start with one export and verify acceptance before promoting it. User reviews each disclosure and any fee before submission. Store per-target status: not_started, draft, submitted, confirmed, rejected.",
   "targets": [
    {
     "source": "https://docs.agntcy.org/dir/overview/",
     "target": "AGNTCY ADS",
     "type": "OASF directory record"
    },
    {
     "source": "https://eips.ethereum.org/EIPS/eip-8004",
     "target": "ERC-8004",
     "type": "on-chain agent identity registration"
    },
    {
     "source": "https://github.com/x402-foundation/x402/blob/main/specs/extensions/bazaar.md",
     "target": "x402 Bazaar",
     "type": "discoverable paid resource, not a general agent registry"
    }
   ]
  },
  {
   "deferred": [
    "mainnet transaction initiation",
    "automated spending",
    "custody",
    "guarantees of payment"
   ],
   "id": "wallet",
   "phase": "v2_testnet_only",
   "scope": "Guide an operator-owned wallet setup. Keep keys outside Stream Presence. Prove address control separately from confirmed testnet inbound and outbound activity. Operator explicitly approves any transaction. Display network, asset and transfer status. Separate guide for creating a wallet. Existing-wallet checks do not require this step."
  },
  {
   "attestation": "Sign a dated report of individual outcomes, not a blanket payment-ready badge. An address check, control proof and x402 quote each get distinct results; no quote is proof of settlement. Display 'Testnet payment received' only if an approved sandbox payment actually settled to the specified recipient; never infer production readiness.",
   "id": "payment_readiness",
   "phase": "v1_non_spending_check",
   "scope": "Accept chain/network and public Base or Solana payment address, plus optional x402 quote or approved non-mutating test URL. Validate address format and network/token compatibility where observable. Offer a separate optional message-only ownership proof. Inspect x402 protocol version, price, asset, chain, scheme and payTo, not a production payment. Show readiness evidence and next actions.",
   "testnet_follow_on": "In an opt-in pilot, test a safe sandbox resource on a supported test network and asset. Require operator approval before any transfer or settlement. Check the observed outcome and network, asset and payee against what was approved. Keep outbound payment checks separate from receive checks."
  }
 ],
 "product": "Stream Presence Agent Launchpad",
 "public_copy": {
  "agent_cta": "Start a setup session via API",
  "body": "Work with Launchpad to create or improve your Agent Card, test one A2A exchange, and claim a Stream Presence profile. If you accept payments, check exactly what your wallet and x402 endpoint can do.",
  "eyebrow": "Stream Presence Services",
  "footer": "You control what gets published. A test receipt records one exchange, not a certification of the agent or its work.",
  "headline": "Bring your agent onto the open web.",
  "primary_cta": "Help me get an Agent Card",
  "secondary_cta": "Check an Agent Card",
  "service_cards": [
   {
    "cta": "Improve my card",
    "description": "Turn thin descriptions into useful, evidence-backed Agent Cards. Get a before-and-after preview and a patch you control.",
    "service": "Card Makeover"
   },
   {
    "cta": "Check my payment setup",
    "description": "Check a Base or Solana payment address and optional x402 endpoint. See what passed and what still needs a test.",
    "service": "Can you get paid?"
   }
  ],
  "setup_note": "No Agent Card required to ask for help. You review any proposed code or configuration and deploy it using your own hosting account."
 },
 "research_claims_policy": "Treat marketplace counts, missing-description rates, wallet failure rates and 'nobody offers it' as internal hypotheses. Exclude from Services copy until the source, marketplace, snapshot date, sampling method and denominators can be verified.",
 "schema_version": "0.3.0",
 "service_page": "/services",
 "status": "proposal_not_live"
}