{
  "_meta": {
    "purpose": "Semantic action layer for TH Analytica — descriptive only, not a live API.",
    "status": "DRAFT — not connected to production. For agent readiness preparation only.",
    "created": "2026-04-20",
    "organization": "TH Analytica",
    "organization_id": "https://th-analytica.com/entity/th-analytica#organization",
    "contact": "thhullin@gmail.com",
    "training": "not allowed",
    "analysis": "allowed"
  },
  "actions": [
    {
      "id": "quick_check_request",
      "label": "AI Readiness Quick-Check",
      "purpose": "Request an automated AI Readiness assessment for a given domain or organization website. Produces a quantified AI Readiness score and a summary of structural gaps.",
      "entry_url": "https://th-analytica.com/quick-check",
      "required_fields": [
        {
          "name": "domain",
          "type": "string",
          "description": "The website URL to be assessed (e.g. https://example.com).",
          "required": true
        },
        {
          "name": "contact_email",
          "type": "string",
          "description": "Email address to receive the assessment report.",
          "required": true
        }
      ],
      "optional_fields": [
        {
          "name": "organization_name",
          "type": "string",
          "description": "Name of the organization being assessed."
        },
        {
          "name": "language",
          "type": "string",
          "description": "Preferred report language. Supported: de-CH, en.",
          "default": "de-CH"
        }
      ],
      "expected_outcome": "An AI Readiness score (0–100%) with identified structural deficiencies and a prioritized improvement list.",
      "human_review_required": false,
      "delivery_method": "email",
      "estimated_delivery": "immediate (automated)",
      "live_endpoint": null,
      "notes": "This action is currently handled via the web form at /quick-check. A programmatic endpoint (/api/quickcheck) exists but is not publicly documented for agent use."
    },
    {
      "id": "consultation_request",
      "label": "AI Readiness Consultation",
      "purpose": "Request a strategic advisory session with Thomas Hullin on AI Visibility architecture, GEO strategy, or entity clarity for an organization.",
      "entry_url": "https://th-analytica.com/anfrage",
      "required_fields": [
        {
          "name": "contact_name",
          "type": "string",
          "description": "Full name of the requesting person.",
          "required": true
        },
        {
          "name": "contact_email",
          "type": "string",
          "description": "Email address for follow-up.",
          "required": true
        },
        {
          "name": "topic",
          "type": "string",
          "description": "Brief description of the consultation topic or question.",
          "required": true
        }
      ],
      "optional_fields": [
        {
          "name": "organization_name",
          "type": "string",
          "description": "Organization the requester represents."
        },
        {
          "name": "website",
          "type": "string",
          "description": "Organization website URL."
        },
        {
          "name": "preferred_language",
          "type": "string",
          "description": "Preferred communication language. Supported: de-CH, en.",
          "default": "de-CH"
        }
      ],
      "expected_outcome": "A scheduled consultation call or written response from Thomas Hullin within 2 business days.",
      "human_review_required": true,
      "delivery_method": "email",
      "estimated_delivery": "1–2 business days",
      "live_endpoint": null,
      "notes": "All consultation requests require human review by Thomas Hullin. No automated processing. Sent via /anfrage contact form."
    },
    {
      "id": "contact_request",
      "label": "General Contact",
      "purpose": "Send a general inquiry to TH Analytica regarding services, pricing, availability, or partnership.",
      "entry_url": "https://th-analytica.com/anfrage",
      "required_fields": [
        {
          "name": "contact_name",
          "type": "string",
          "description": "Full name of the person making the inquiry.",
          "required": true
        },
        {
          "name": "contact_email",
          "type": "string",
          "description": "Email address for response.",
          "required": true
        },
        {
          "name": "message",
          "type": "string",
          "description": "Content of the inquiry.",
          "required": true
        }
      ],
      "optional_fields": [
        {
          "name": "phone",
          "type": "string",
          "description": "Phone number for callback."
        }
      ],
      "expected_outcome": "A response from TH Analytica within 2 business days.",
      "human_review_required": true,
      "delivery_method": "email",
      "estimated_delivery": "1–2 business days",
      "live_endpoint": null,
      "notes": "Handled manually by Thomas Hullin. No automated responses for general inquiries."
    }
  ],
  "future_readiness": {
    "status": "planned — not implemented",
    "notes": "The following steps would convert this descriptive file into a live agent-compatible action layer:",
    "next_steps": [
      "Define a formal OpenAPI 3.1 specification at /openapi.json covering the above actions",
      "Add potentialAction (ContactAction, OrderAction) to the Organization JSON-LD schema",
      "Expose a JSON response endpoint for quick_check_request (/api/quickcheck)",
      "Register action endpoints in ai-actions.json and reference from ai-discovery.json",
      "Add x-ai-action metadata headers to action endpoints for agent discoverability"
    ]
  }
}