{"openapi":"3.1.0","info":{"title":"MCP Commercial Platform","version":"0.1.0"},"paths":{"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/ready":{"get":{"summary":"Ready","operationId":"ready_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/reporting/funnel":{"get":{"summary":"Reporting Funnel","operationId":"reporting_funnel_v1_reporting_funnel_get","parameters":[{"name":"product_id","in":"query","required":true,"schema":{"type":"string","title":"Product Id"}},{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"linkedin","title":"Source"}},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Since"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/checkout/session":{"post":{"summary":"Checkout","operationId":"checkout_v1_checkout_session_post","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":255,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account-checkout/session":{"post":{"summary":"Account Checkout","operationId":"account_checkout_v1_account_checkout_session_post","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":255,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCheckoutRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/stripe":{"post":{"summary":"Stripe Webhook","operationId":"stripe_webhook_v1_webhooks_stripe_post","parameters":[{"name":"Stripe-Signature","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/entitlements/verification-key":{"get":{"summary":"Entitlement Verification Key","operationId":"entitlement_verification_key_v1_entitlements_verification_key_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/entitlements/verify":{"post":{"summary":"Verify Entitlement","operationId":"verify_entitlement_v1_entitlements_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitlementVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitlementVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/entitlements/consume":{"post":{"summary":"Consume Entitlement","operationId":"consume_entitlement_v1_entitlements_consume_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitlementConsumeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitlementConsumeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/continuations/issue":{"post":{"summary":"Issue Continuation","operationId":"issue_continuation_v1_continuations_issue_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContinuationIssueRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContinuationIssueResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/continuations/resolve":{"post":{"summary":"Resolve Continuation","operationId":"resolve_continuation_v1_continuations_resolve_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContinuationResolveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContinuationResolveResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/google/start":{"get":{"summary":"Google Auth Start","operationId":"google_auth_start_v1_auth_google_start_get","parameters":[{"name":"continuation_token","in":"query","required":true,"schema":{"type":"string","title":"Continuation Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/google/callback":{"get":{"summary":"Google Auth Callback","operationId":"google_auth_callback_v1_auth_google_callback_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","title":"Code"}},{"name":"state","in":"query","required":true,"schema":{"type":"string","title":"State"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/session":{"get":{"summary":"Account Session Status","operationId":"account_session_status_v1_account_session_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/products/{product_id}/offer":{"get":{"summary":"Public Product Offer","operationId":"public_product_offer_v1_products__product_id__offer_get","parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"string","title":"Product Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/premium-boundary":{"post":{"summary":"Premium Boundary","operationId":"premium_boundary_v1_premium_boundary_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PremiumBoundaryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PremiumBoundaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/premium-execution/handoff":{"post":{"summary":"Premium Execution Handoff","operationId":"premium_execution_handoff_v1_premium_execution_handoff_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PremiumExecutionHandoffRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PremiumExecutionHandoffResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/premium-execution/execute":{"post":{"summary":"Premium Execution Execute","operationId":"premium_execution_execute_v1_premium_execution_execute_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SharedExecutionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/handoff":{"post":{"summary":"Create Handoff","operationId":"create_handoff_v1_handoff_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HandoffRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HandoffResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/events":{"post":{"summary":"Events","operationId":"events_v1_events_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommercialEventRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AccountCheckoutRequest":{"properties":{"product_id":{"type":"string","maxLength":64,"minLength":1,"title":"Product Id"},"source_channel":{"type":"string","enum":["linkedin","openai","claude","grok","regevidencehub","organic","directory","direct","unknown"],"title":"Source Channel","default":"regevidencehub"},"external_classification":{"type":"string","enum":["confirmed_external","automated_external","owner_test","synthetic","unknown"],"title":"External Classification","default":"owner_test"},"owner_test":{"type":"boolean","title":"Owner Test","default":false},"success_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Success Url"},"cancel_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Cancel Url"}},"additionalProperties":false,"type":"object","required":["product_id","success_url","cancel_url"],"title":"AccountCheckoutRequest"},"CheckoutRequest":{"properties":{"product_id":{"type":"string","maxLength":64,"minLength":1,"title":"Product Id"},"principal_ref":{"type":"string","maxLength":160,"minLength":8,"pattern":"^[A-Za-z0-9._:+-]+$","title":"Principal Ref"},"source_channel":{"type":"string","enum":["linkedin","openai","claude","grok","regevidencehub","organic","directory","direct","unknown"],"title":"Source Channel","default":"unknown"},"external_classification":{"type":"string","enum":["confirmed_external","automated_external","owner_test","synthetic","unknown"],"title":"External Classification","default":"unknown"},"owner_test":{"type":"boolean","title":"Owner Test","default":false},"success_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Success Url"},"cancel_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Cancel Url"}},"additionalProperties":false,"type":"object","required":["product_id","principal_ref","success_url","cancel_url"],"title":"CheckoutRequest"},"CheckoutResponse":{"properties":{"checkout_id":{"type":"string","title":"Checkout Id"},"stripe_session_id":{"type":"string","title":"Stripe Session Id"},"checkout_url":{"type":"string","title":"Checkout Url"}},"additionalProperties":false,"type":"object","required":["checkout_id","stripe_session_id","checkout_url"],"title":"CheckoutResponse"},"CommercialEventRequest":{"properties":{"product_id":{"type":"string","maxLength":64,"minLength":1,"title":"Product Id"},"event_type":{"type":"string","enum":["discovery_observed","free_execution","paid_intent","checkout_started","payment_succeeded","entitlement_activated","premium_fulfilled","repeat_use"],"title":"Event Type"},"source_channel":{"type":"string","enum":["linkedin","openai","claude","grok","regevidencehub","organic","directory","direct","unknown"],"title":"Source Channel","default":"unknown"},"commercial_intent":{"anyOf":[{"type":"string","enum":["report","batch","monitoring","export","api","team","workspace"]},{"type":"null"}],"title":"Commercial Intent"},"external_classification":{"type":"string","enum":["confirmed_external","automated_external","owner_test","synthetic","unknown"],"title":"External Classification","default":"unknown"},"owner_test":{"type":"boolean","title":"Owner Test","default":false},"object_count":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":1.0},{"type":"null"}],"title":"Object Count"},"multi_authority":{"type":"boolean","title":"Multi Authority","default":false}},"additionalProperties":false,"type":"object","required":["product_id","event_type"],"title":"CommercialEventRequest"},"ContinuationIssueRequest":{"properties":{"product_id":{"type":"string","maxLength":64,"minLength":1,"title":"Product Id"},"case_ref":{"type":"string","maxLength":160,"minLength":8,"pattern":"^[A-Za-z0-9._:+-]+$","title":"Case Ref"},"state_ref":{"type":"string","maxLength":160,"minLength":8,"pattern":"^[A-Za-z0-9._:+-]+$","title":"State Ref"}},"additionalProperties":false,"type":"object","required":["product_id","case_ref","state_ref"],"title":"ContinuationIssueRequest"},"ContinuationIssueResponse":{"properties":{"continuation_token":{"type":"string","title":"Continuation Token"},"expires_in_seconds":{"type":"integer","title":"Expires In Seconds"}},"additionalProperties":false,"type":"object","required":["continuation_token","expires_in_seconds"],"title":"ContinuationIssueResponse"},"ContinuationResolveRequest":{"properties":{"product_id":{"type":"string","maxLength":64,"minLength":1,"title":"Product Id"},"continuation_token":{"type":"string","maxLength":2048,"minLength":32,"title":"Continuation Token"}},"additionalProperties":false,"type":"object","required":["product_id","continuation_token"],"title":"ContinuationResolveRequest"},"ContinuationResolveResponse":{"properties":{"product_id":{"type":"string","title":"Product Id"},"case_ref":{"type":"string","title":"Case Ref"},"state_ref":{"type":"string","title":"State Ref"},"expires_at":{"type":"integer","title":"Expires At"}},"additionalProperties":false,"type":"object","required":["product_id","case_ref","state_ref","expires_at"],"title":"ContinuationResolveResponse"},"EntitlementConsumeRequest":{"properties":{"product_id":{"type":"string","maxLength":64,"minLength":1,"title":"Product Id"},"token":{"type":"string","maxLength":4096,"minLength":32,"title":"Token"},"units":{"type":"integer","maximum":1000.0,"minimum":1.0,"title":"Units","default":1}},"additionalProperties":false,"type":"object","required":["product_id","token"],"title":"EntitlementConsumeRequest"},"EntitlementConsumeResponse":{"properties":{"allowed":{"type":"boolean","title":"Allowed"},"product_id":{"type":"string","title":"Product Id"},"entitlement_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entitlement Code"},"usage_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Usage Limit"},"usage_consumed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Usage Consumed"},"usage_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Usage Remaining"},"reason":{"type":"string","enum":["ok","invalid_token","inactive","exhausted"],"title":"Reason","default":"ok"}},"additionalProperties":false,"type":"object","required":["allowed","product_id"],"title":"EntitlementConsumeResponse"},"EntitlementVerifyRequest":{"properties":{"product_id":{"type":"string","maxLength":64,"minLength":1,"title":"Product Id"},"principal_ref":{"type":"string","maxLength":160,"minLength":8,"pattern":"^[A-Za-z0-9._:+-]+$","title":"Principal Ref"}},"additionalProperties":false,"type":"object","required":["product_id","principal_ref"],"title":"EntitlementVerifyRequest"},"EntitlementVerifyResponse":{"properties":{"active":{"type":"boolean","title":"Active"},"entitlement_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entitlement Code"},"token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}},"additionalProperties":false,"type":"object","required":["active"],"title":"EntitlementVerifyResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HandoffRequest":{"properties":{"product_id":{"type":"string","maxLength":64,"minLength":1,"title":"Product Id"},"continuation_token":{"type":"string","maxLength":2048,"minLength":32,"title":"Continuation Token"},"source_channel":{"type":"string","enum":["linkedin","openai","claude","grok","regevidencehub","organic","directory","direct","unknown"],"title":"Source Channel","default":"unknown"},"return_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Return Url"}},"additionalProperties":false,"type":"object","required":["product_id","continuation_token"],"title":"HandoffRequest"},"HandoffResponse":{"properties":{"product_id":{"type":"string","title":"Product Id"},"handoff_url":{"type":"string","title":"Handoff Url"},"continuation_token":{"type":"string","title":"Continuation Token"},"account_required":{"type":"boolean","title":"Account Required","default":false},"case_restored":{"type":"boolean","title":"Case Restored","default":true},"entitlement_active":{"type":"boolean","title":"Entitlement Active","default":false},"next_action":{"type":"string","enum":["continue_free","offer_checkout","continue_premium"],"title":"Next Action","default":"continue_free"},"checkout_required":{"type":"boolean","title":"Checkout Required","default":false}},"additionalProperties":false,"type":"object","required":["product_id","handoff_url","continuation_token"],"title":"HandoffResponse"},"PremiumBoundaryRequest":{"properties":{"product_id":{"type":"string","maxLength":64,"minLength":1,"title":"Product Id"},"continuation_token":{"type":"string","maxLength":2048,"minLength":32,"title":"Continuation Token"},"premium_requested":{"type":"boolean","title":"Premium Requested","default":false}},"additionalProperties":false,"type":"object","required":["product_id","continuation_token"],"title":"PremiumBoundaryRequest"},"PremiumBoundaryResponse":{"properties":{"product_id":{"type":"string","title":"Product Id"},"case_restored":{"type":"boolean","title":"Case Restored","default":true},"account_required":{"type":"boolean","title":"Account Required"},"entitlement_active":{"type":"boolean","title":"Entitlement Active"},"next_action":{"type":"string","enum":["continue_free","require_account","offer_checkout","continue_premium"],"title":"Next Action"},"checkout_required":{"type":"boolean","title":"Checkout Required"},"entitlement_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entitlement Token"}},"additionalProperties":false,"type":"object","required":["product_id","account_required","entitlement_active","next_action","checkout_required"],"title":"PremiumBoundaryResponse"},"PremiumExecutionHandoffRequest":{"properties":{"product_id":{"type":"string","maxLength":64,"minLength":1,"title":"Product Id"},"continuation_token":{"type":"string","maxLength":2048,"minLength":32,"title":"Continuation Token"}},"additionalProperties":false,"type":"object","required":["product_id","continuation_token"],"title":"PremiumExecutionHandoffRequest"},"PremiumExecutionHandoffResponse":{"properties":{"product_id":{"type":"string","title":"Product Id"},"case_ref":{"type":"string","title":"Case Ref"},"state_ref":{"type":"string","title":"State Ref"},"entitlement_active":{"type":"boolean","title":"Entitlement Active","default":true},"entitlement_token":{"type":"string","title":"Entitlement Token"},"next_action":{"type":"string","const":"execute_product","title":"Next Action","default":"execute_product"}},"additionalProperties":false,"type":"object","required":["product_id","case_ref","state_ref","entitlement_token"],"title":"PremiumExecutionHandoffResponse"},"ProductExecutionResponse":{"properties":{"contract_version":{"type":"string","const":"reh-execution-v1","title":"Contract Version","default":"reh-execution-v1"},"product_id":{"type":"string","title":"Product Id"},"status":{"type":"string","enum":["executed","review_required","failed"],"title":"Status"},"execution_id":{"type":"string","title":"Execution Id"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"}},"additionalProperties":false,"type":"object","required":["product_id","status","execution_id"],"title":"ProductExecutionResponse"},"SharedExecutionRequest":{"properties":{"product_id":{"type":"string","maxLength":64,"minLength":1,"title":"Product Id"},"continuation_token":{"type":"string","maxLength":2048,"minLength":32,"title":"Continuation Token"}},"additionalProperties":false,"type":"object","required":["product_id","continuation_token"],"title":"SharedExecutionRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}