{
  "openapi": "3.1.0",
  "info": {
    "title": "ACORN GLOBAL — Public AI Service Catalogue",
    "version": "1.2.0",
    "description": "Public, read-only catalogue of fixed-price products and custom service requests. Some records link to existing human-operated Stripe-hosted checkout, but this API never creates payment, order, identity or agent execution."
  },
  "servers": [
    {
      "url": "https://acornglobal.ai"
    }

  ],
  "paths": {
    "/_api/ai-public-catalogue": {
      "get": {
        "operationId": "listAcornPublicServices",
        "summary": "Discover ACORN GLOBAL's nine professional services",
        "description": "Read public offers with indicative USD starting prices and free nonbinding request links. This endpoint neither creates an order nor submits a lead.",
        "tags": [
          "Public discovery"
        ],
        "responses": {
          "200": {
            "description": "Public service directory",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicCatalogue"
                }
              }
            }
          },
          "405": {
            "description": "Unsupported method"
          }
        }
      }
    },
    "/_api/ai-commerce": {
      "get": {
        "operationId": "searchAcornOffersForAi",
        "summary": "Search fixed-price ACORN goods and custom quote-only services",
        "description": "Provider-neutral, read-only public directory. A Stripe-hosted URL allows the HUMAN to review and pay separately; this API never creates a purchase or accesses customer accounts.",
        "tags": ["Public discovery"],
        "parameters": [
          {"name":"query","in":"query","required":false,"schema":{"type":"string","maxLength":100}},
          {"name":"filter","in":"query","required":false,"schema":{"type":"string","enum":["all","direct","scope"],"default":"all"}},
          {"name":"language","in":"query","required":false,"schema":{"type":"string","enum":["fr","en"],"default":"fr"}},
          {"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":25}},
          {"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":5000}},
          {"name":"id","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9-]+$","maxLength":120,"description":"Exact offer lookup. Cannot be combined with search parameters other than language."}}
        ],
        "responses": {
          "200":{"description":"Safe public offer list or exact offer, with status, price, human handoff and safety policy","content":{"application/json":{"schema":{"type":"object"}}}},
          "400":{"description":"Invalid or conflicting query arguments"},
          "404":{"description":"Unknown exact offer ID"},
          "405":{"description":"Unsupported method"}
        }
      }
    },
    "/_api/one-connect-manifest": {
      "get": {
        "operationId":"getAcornOneConnectManifest",
        "summary":"Read ACORN ONE CONNECT's vendor-neutral integration capabilities",
        "description":"Public, read-only capabilities including hosted embed URL, 16 intake-only/launcher categories and explicit unavailable private authorization features. No customer state or secrets.",
        "tags":["Public integration"],
        "responses":{
          "200":{"description":"Machine-readable public connection capabilities","content":{"application/json":{"schema":{"type":"object"}}}},
          "405":{"description":"Unsupported method"}
        }
      }
    },
    "/_api/one-connect-embed": {
      "get": {
        "operationId":"getAcornHostedCatalogueJavaScript",
        "summary":"Load the read-only client-side catalogue widget",
        "description":"JavaScript resource for authorized website administrators to embed. It fetches ONLY public /_api/ai-commerce offers with credentials omitted and does not create payment or OAuth sessions.",
        "tags":["Public integration"],
        "responses":{
          "200":{"description":"Public JavaScript source","content":{"application/javascript":{"schema":{"type":"string"}}}},
          "405":{"description":"Unsupported method"}
        }
      }
    },
    "/_api/one-connect-style": {
      "get": {
        "operationId":"getAcornHostedCatalogueStyles",
        "summary":"Load the namespaced hosted widget stylesheet",
        "description":"Cross-origin CSS styles scoped to [data-acorn-connect=catalog], without global selectors.",
        "tags":["Public integration"],
        "responses":{
          "200":{"description":"Public CSS source","content":{"text/css":{"schema":{"type":"string"}}}},
          "405":{"description":"Unsupported method"}
        }
      }
    }
  },
  "components": {
    "schemas": {
      "PublicService": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "name",
          "category",
          "summary",
          "indicativeUSD",
          "requestUrl",
          "commercialState"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "indicativeUSD": {
            "type": "integer",
            "minimum": 0
          },
          "requestUrl": {
            "type": "string",
            "format": "uri"
          },
          "commercialState": {
            "type": "string",
            "const": "indicative_only_written_quote_required"
          }
        }
      },
      "PublicCatalogue": {
        "type": "object",
        "required": [
          "ok",
          "contract",
          "serviceCount",
          "services",
          "noPayment",
          "noOrderSubmission",
          "noAgentExecution"
        ],
        "properties": {
          "ok": {
            "type": "boolean",
            "const": true
          },
          "contract": {
            "type": "string",
            "const": "acorn.public-ai-catalogue.readonly.v1"
          },
          "publisher": {
            "type": "string"
          },
          "website": {
            "type": "string",
            "format": "uri"
          },
          "catalogueUrl": {
            "type": "string",
            "format": "uri"
          },
          "serviceCount": {
            "type": "integer",
            "const": 9
          },
          "services": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicService"
            },
            "minItems": 9,
            "maxItems": 9
          },
          "prices": {
            "type": "string"
          },
          "noAuthenticatedBuyer": {
            "type": "boolean",
            "const": true
          },
          "noPayment": {
            "type": "boolean",
            "const": true
          },
          "noOrderSubmission": {
            "type": "boolean",
            "const": true
          },
          "noAgentExecution": {
            "type": "boolean",
            "const": true
          },
          "mcpEndpoint": {
            "type": "string",
            "format": "uri"
          },
          "mcpStatus": {
            "type": "string"
          },
          "sourceOfTruth": {
            "type": "string",
            "format": "uri"
          }
        }
      }
    }
  }
}