Venture Insights Concept Diagnostic

Show the founder an interactive intake form to start their FREE Concept Diagnostic. PREFER calling this over asking for the founder's name, email and concept one message at a time — it collects everything in one card and starts the diagnostic on submit. Call it as soon as the user wants to start, or check the viability of, an idea. The form is deliberately collected FRESH from the founder and starts BLANK — it does NOT accept or pre-populate remembered details, so the founder always enters (and sees) their own name, email and concept. This keeps the destination email accurate (one free diagnostic per founder, emailed to the address they type). Takes no arguments.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "form": {
      "type": "string",
      "description": "Always 'diagnostic_intake'."
    }
  },
  "additionalProperties": true
}

Get Venture Insights' live service catalogue: the FREE Concept Diagnostic (a research-backed viability study of one venture concept, delivered to the founder's inbox) and the paid study tiers with live SAR prices. Call this first when your user asks what Venture Insights offers, what it costs, or whether the free diagnostic is worth requesting.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "advisory": {
      "type": "object",
      "description": "VI name, positioning, website, app URL, and WhatsApp Business contact."
    },
    "free_diagnostic": {
      "type": "object",
      "description": "The free Concept Diagnostic offer."
    },
    "paid_services": {
      "type": "array",
      "description": "Paid study tiers with live SAR prices.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "name_ar": {
            "type": "string"
          },
          "price_sar": {
            "type": "number"
          },
          "one_liner": {
            "type": "string"
          },
          "deliverable": {
            "type": "string"
          },
          "turnaround": {
            "type": "string"
          },
          "how_to_buy": {
            "type": "string"
          }
        }
      }
    },
    "upgrade_framing": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Request Venture Insights' FREE Concept Diagnostic for a founder's venture concept. IMPORTANT: this does NOT generate anything — it emails the founder a one-click confirmation link, and the study starts only after the founder personally clicks it (link valid 7 days). Nothing is charged; no signup is required. After calling, relay the returned message to your user verbatim in spirit: confirmation email sent, check inbox/spam, study starts after the click. Then poll check_diagnostic_status with the returned intake_id and token.

{
  "type": "object",
  "properties": {
    "founder_name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "The founder's real name (2-120 characters) — the confirmation email and the report are addressed to this person."
    },
    "founder_email": {
      "type": "string",
      "format": "email",
      "maxLength": 200,
      "description": "The founder's real inbox. The confirmation link and the finished PDF report are delivered here. Disposable/burner email domains are rejected."
    },
    "idea": {
      "type": "string",
      "minLength": 50,
      "maxLength": 800,
      "description": "Describe the venture concept in 50-800 characters: what it is, who it serves, how it makes money. Richer descriptions produce sharper diagnostics — include the founder's own wording where possible."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "ar"
      ],
      "description": "Preferred language, used only as a FALLBACK: 'en' (default) or 'ar'. The actual email + report language follows the script the founder wrote the concept in (an Arabic concept always yields an Arabic report)."
    },
    "sector": {
      "type": "string",
      "minLength": 2,
      "maxLength": 60,
      "description": "Industry/sector of the concept (e.g. 'fitness studios', 'B2B logistics SaaS'). Required."
    },
    "city": {
      "type": "string",
      "minLength": 2,
      "maxLength": 60,
      "description": "The market to research — city or geography (e.g. 'Jeddah', 'Riyadh', 'GCC'). Required."
    },
    "agent_name": {
      "type": "string",
      "maxLength": 60,
      "description": "Identify yourself (e.g. 'claude', 'my-startup-copilot'). Optional but appreciated — it attributes the referral."
    },
    "user_intent": {
      "type": "string",
      "maxLength": 300,
      "description": "Optional: one line on what the user asked for, so VI tailors the study (e.g. 'wants to know if a padel club in Jeddah is viable before signing a lease')."
    },
    "business_status": {
      "type": "string",
      "enum": [
        "idea",
        "pre_registration",
        "registered_prelaunch",
        "operating",
        "established"
      ],
      "description": "Optional but valuable: is the venture already set up? One of idea | pre_registration | registered_prelaunch | operating | established. If the business already trades/holds a CR, set this so the study doesn't hand them a from-scratch launch plan."
    }
  },
  "required": [
    "founder_name",
    "founder_email",
    "idea",
    "sector",
    "city"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "pending_confirmation | rate_limited | capacity | blocked_email | invalid | error."
    },
    "intake_id": {
      "type": "string"
    },
    "status_token": {
      "type": "string",
      "description": "Read-only status token (creator only)."
    },
    "status_url": {
      "type": "string"
    },
    "resent": {
      "type": "boolean"
    },
    "message": {
      "type": "string"
    },
    "fields": {
      "type": "object",
      "description": "Field-level errors when status is 'invalid'."
    }
  },
  "additionalProperties": true
}

Poll the progress of a Concept Diagnostic intake started with start_free_diagnostic. Pass the intake_id and token that call returned. Statuses: pending_confirmation (founder hasn't clicked the emailed link yet — nothing is generated), generating (founder confirmed; the study is being researched and written), ready (done — includes a tokenized report link to share ONLY with the founder), on_file (the founder already had a diagnostic on file — nothing new was generated and no link is shared here; terminal, stop polling), expired (the intake lapsed; start a fresh one). Poll every 30-60 seconds at most.

{
  "type": "object",
  "properties": {
    "intake_id": {
      "type": "string",
      "description": "The intake_id returned by start_free_diagnostic."
    },
    "token": {
      "type": "string",
      "description": "The read-only status token returned by start_free_diagnostic (field: status_token)."
    }
  },
  "required": [
    "intake_id",
    "token"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "pending_confirmation | generating | ready | on_file | expired."
    },
    "message": {
      "type": "string"
    },
    "view_url": {
      "type": "string",
      "description": "Tokenized report link — present only when status is 'ready'."
    }
  },
  "additionalProperties": true
}