{"openapi":"3.1.0","info":{"title":"Pakish.NET shared hosting discovery","version":"1.2.0","description":"Public discovery plus durable inquiry, private nonbinding estimates and bounded hosting replies. Estimates reuse LuraFlow checkout preview. Formal MCP/A2A transport endpoints and operation schemas are described at /agent-protocols.json; the A2A Agent Card is /.well-known/agent-card.json. No email send, inbox ingestion, quote acceptance, ordering, payment or provisioning operation is exposed by these website APIs."},"servers":[{"url":"https://pakish.net"}],"security":[],"paths":{"/api/agent-commerce/inquiries":{"post":{"operationId":"submitHostingInquiry","summary":"Persist a consented inquiry and queue it for staff review","security":[],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Private UUID chosen by the client. Reuse it only for retries of the identical submission."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostingInquiry"}}}},"responses":{"202":{"description":"Inquiry and staff handoff durably saved; contact unverified; no message sent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InquiryReceipt"}}}},"400":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"401":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"403":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"409":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"413":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"415":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"429":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"503":{"description":"Pilot disabled, configuration/storage unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}}}}},"/api/agent-commerce/quotes":{"post":{"operationId":"requestHostingEstimate","summary":"Save a nonbinding LuraFlow checkout preview, clarification or human-review result","security":[{"InquiryGrant":[]}],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Private UUID chosen by the client. Reuse it only for retries of the identical submission."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"inquiry_id":{"type":"string","format":"uuid"},"offer_id":{"type":["string","null"]}},"required":["inquiry_id"]}}}},"responses":{"200":{"description":"Saved estimate or explicit clarification/human-review result; never purchase acceptance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostingEstimate"}}}},"202":{"description":"Duplicate request is still processing; retry with the same key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostingEstimate"}}}},"400":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"401":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"403":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"409":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"413":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"415":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"429":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"503":{"description":"Pilot disabled, configuration/storage unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}}}}},"/api/agent-commerce/quotes/{id}":{"get":{"operationId":"readHostingEstimate","summary":"Read an estimate using its owning inquiry's private grant","security":[{"InquiryGrant":[]}],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Private saved estimate; expiry/catalog changes require refresh","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostingEstimate"}}}},"400":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"401":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"403":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"404":{"description":"Estimate not found in the authorized inquiry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"409":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"413":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"415":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"429":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"503":{"description":"Pilot disabled, configuration/storage unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}}}}},"/api/agent-commerce/replies":{"post":{"operationId":"askHostingAssistant","summary":"Save a bounded catalog-backed reply; no message is sent","security":[{"InquiryGrant":[]}],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Private UUID chosen by the client. Reuse it only for retries of the identical submission."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostingReplyInput"}}}},"responses":{"200":{"description":"Encrypted reply persisted; three-reply pilot budget and human takeover enforced","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostingReply"}}}},"400":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"401":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"403":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"409":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"413":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"415":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"429":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"503":{"description":"Pilot disabled, configuration/storage unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}}}},"get":{"operationId":"readHostingConversation","summary":"Read the authorized inquiry's saved replies","security":[{"InquiryGrant":[]}],"responses":{"200":{"description":"Private historical replies; saved prices retain their original expiry","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"replies":{"type":"array","items":{"$ref":"#/components/schemas/HostingReply"}},"automation_paused":{"type":"boolean"}},"required":["replies","automation_paused"]}}}},"400":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"401":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"403":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"409":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"413":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"415":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"429":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"503":{"description":"Pilot disabled, configuration/storage unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}}}}},"/api/agent-commerce/replies/{id}/draft":{"get":{"operationId":"downloadUnsentHostingDraft","summary":"Prepare an unsent email document for human review","security":[{"InquiryGrant":[]}],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Unsent RFC822 draft. No provider send or inbox ingestion is implied; contact/thread remain unverified","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"filename":{"type":"string"},"draft":{"type":"string"},"notification_status":{"const":"not_sent"},"contact_verified":{"const":false}},"required":["filename","draft","notification_status","contact_verified"]}}}},"400":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"401":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"403":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"404":{"description":"Reply not in the authorized inquiry"},"409":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"413":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"415":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"429":{"description":"Request rejected; no successful intake or purchase is implied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}},"503":{"description":"Pilot disabled, configuration/storage unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceError"}}}}}}},"/agent-catalog.json":{"get":{"operationId":"getSharedHostingCatalog","summary":"Read shared hosting offers and purchase-review requirements","responses":{"200":{"description":"Published website catalog; checkout verification required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}}}}}},"/agent-openapi.json":{"get":{"operationId":"getDiscoveryApiDescription","summary":"Read this API description","responses":{"200":{"description":"OpenAPI 3.1 document for the available GET operations","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"securitySchemes":{"InquiryGrant":{"type":"http","scheme":"bearer","bearerFormat":"inquiry-scoped grant","description":"Private 24-hour grant returned after durable inquiry intake. IDs alone grant no access. Send in Authorization only, never in query strings."}},"schemas":{"EmailDraftContext":{"type":"object","additionalProperties":false,"properties":{"subject":{"type":"string","minLength":1,"maxLength":160},"message_id":{"type":"string","maxLength":243},"references":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":243}},"auto_submitted":{"enum":["no","auto-generated","auto-replied"]},"precedence":{"enum":["","normal","bulk","list","junk"]}},"required":["subject","message_id","references","auto_submitted","precedence"]},"HostingReplyInput":{"type":"object","additionalProperties":false,"properties":{"message":{"type":"string","minLength":1,"maxLength":2000},"email":{"anyOf":[{"$ref":"#/components/schemas/EmailDraftContext"},{"type":"null"}]}},"required":["message"]},"HostingReply":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"inquiry_id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"message":{"type":"string"},"text":{"type":"string"},"language":{"enum":["en","roman","ur"]},"status":{"enum":["answered","needs_clarification","human_review"]},"context":{"type":"object","additionalProperties":false,"properties":{"offer_id":{"type":["string","null"]},"product_id":{"type":["string","null"]}},"required":["offer_id"]},"quote":{"anyOf":[{"$ref":"#/components/schemas/HostingEstimate"},{"type":"null"}]},"automation_paused":{"type":"boolean"},"notification_status":{"const":"not_sent"},"email":{"anyOf":[{"$ref":"#/components/schemas/EmailDraftContext"},{"type":"null"}]}},"required":["id","inquiry_id","created_at","message","text","language","status","context","quote","automation_paused","notification_status","email"]},"CommerceError":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]},"HostingInquiry":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":2,"maxLength":100},"email":{"type":"string","format":"email","maxLength":254},"website_count":{"type":"integer","minimum":1,"maximum":1000},"requirements":{"type":"string","minLength":10,"maxLength":2000},"consent":{"const":true},"offer_id":{"type":["string","null"],"maxLength":150}},"required":["name","email","website_count","requirements","consent"]},"InquiryReceipt":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"status":{"const":"awaiting_staff_review"},"contact_verified":{"const":false},"notification_status":{"const":"not_sent"},"created":{"type":"boolean"},"access_expires_at":{"type":"string","format":"date-time"},"access_token":{"type":"string","description":"Private grant: do not log, publish or forward it to third parties."},"review_url":{"type":"string","format":"uri"}},"required":["id","status","contact_verified","notification_status","created","access_expires_at","access_token","review_url"]},"HostingEstimate":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"inquiry_id":{"type":"string","format":"uuid"},"offer_id":{"type":["string","null"]},"status":{"type":"string","enum":["processing","indicative","needs_clarification","needs_human_review","expired"]},"reason":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"},"catalog_revision":{"type":"string"},"engine":{"enum":["luraflow_checkout_preview",null]},"currency":{"const":"PKR"},"subtotal_minor":{"type":["integer","null"],"minimum":0},"setup_fee_minor":{"type":["integer","null"],"minimum":0},"discount_minor":{"type":["integer","null"],"minimum":0},"estimated_amount_due_minor":{"type":["integer","null"],"minimum":0},"renewal_amount_minor":{"type":["integer","null"],"minimum":0},"tax_minor":{"type":"null"},"final_total_minor":{"type":"null"},"lines":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"description":{"type":"string"},"quantity":{"type":"integer","minimum":1},"unit_price_minor":{"type":"integer","minimum":0},"line_total_minor":{"type":"integer"}},"required":["description","quantity","unit_price_minor","line_total_minor"]}},"non_binding":{"const":true},"quotation_only":{"type":"boolean","description":"When true, catalog-validated estimates do not require payment readiness and never expose a checkout URL. Financial authority is unchanged."},"checkout_verification_required":{"const":true},"checkout_authority":{"const":"WHMCS"},"checkout_url":{"type":["string","null"],"format":"uri"}},"required":["id","inquiry_id","offer_id","status","reason","created_at","expires_at","catalog_revision","engine","currency","subtotal_minor","setup_fee_minor","discount_minor","estimated_amount_due_minor","renewal_amount_minor","tax_minor","final_total_minor","lines","non_binding","quotation_only","checkout_verification_required","checkout_authority","checkout_url"]},"Offer":{"type":"object","additionalProperties":false,"required":["offer_id","billing_cycle","term_months","trial_days","currency","money_unit","published_first_term_amount_minor","published_renewal_amount_minor","setup_fee_minor","tax_included","final_total_minor","price_status","availability","promotion_code","eligibility","checkout_url"],"properties":{"offer_id":{"type":"string"},"billing_cycle":{"type":"string","enum":["quarterly","annually","triennially"]},"term_months":{"type":"integer","enum":[3,12,36]},"trial_days":{"type":"integer","enum":[0,90]},"currency":{"const":"PKR"},"money_unit":{"const":"minor"},"published_first_term_amount_minor":{"type":["integer","null"],"minimum":0},"published_renewal_amount_minor":{"type":"integer","minimum":0},"setup_fee_minor":{"type":"null"},"tax_included":{"type":"null"},"final_total_minor":{"type":"null"},"price_status":{"const":"indicative"},"availability":{"const":"staff_review_required"},"promotion_code":{"type":"string"},"eligibility":{"type":"string"},"checkout_url":{"type":"string","format":"uri"}}},"Product":{"type":"object","additionalProperties":false,"required":["product_id","name","description","website_limit","storage_gb","service_url","offers"],"properties":{"product_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"website_limit":{"type":"integer","minimum":0},"storage_gb":{"type":"integer","minimum":0},"service_url":{"type":"string","format":"uri"},"offers":{"type":"array","items":{"$ref":"#/components/schemas/Offer"}}}},"Catalog":{"type":"object","additionalProperties":false,"required":["schema_version","catalog_revision","status","read_only","category","provenance","commerce","links","products"],"properties":{"schema_version":{"const":"1.0.0"},"catalog_revision":{"type":"string","pattern":"^[a-f0-9]{16}$"},"status":{"const":"discovery_only"},"read_only":{"const":true},"category":{"const":"shared-hosting"},"provenance":{"type":"object","additionalProperties":false,"required":["source","verified_at","valid_until","checkout_verification_required","note"],"properties":{"source":{"const":"published_catalog"},"verified_at":{"type":"null"},"valid_until":{"type":"null"},"checkout_verification_required":{"const":true},"note":{"type":"string"}}},"commerce":{"type":"object","additionalProperties":false,"required":["checkout_authority","migration_target","migration_status","customer_review_required","transaction_capabilities"],"properties":{"checkout_authority":{"const":"LURAFLOW"},"migration_target":{"const":"LURAFLOW"},"migration_status":{"const":"in_progress"},"customer_review_required":{"const":true},"transaction_capabilities":{"type":"array","maxItems":0,"items":{"type":"string"}}}},"links":{"type":"object","additionalProperties":false,"required":["guide","catalog","openapi","protocols","agent_card","contact","terms","refund_policy"],"properties":{"guide":{"type":"string","format":"uri"},"catalog":{"type":"string","format":"uri"},"openapi":{"type":"string","format":"uri"},"protocols":{"type":"string","format":"uri"},"agent_card":{"type":"string","format":"uri"},"contact":{"type":"string","format":"uri"},"terms":{"type":"string","format":"uri"},"refund_policy":{"type":"string","format":"uri"}}},"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}}}}}