{
  "schema": "agent-manifest/1.0",
  "name": "PathwayDiscovery",
  "tagline": "Find your freelance pathway in 5 minutes",
  "description": "Structured career pathway discovery for freelancers and independent workers. A 5-question interview produces a personalised report: pathway positioning, 90-day roadmap, pricing guidance, client targeting strategy, and direct advice on your biggest concern about going independent.",
  "url": "https://pathwaydiscovery.co",
  "contact": "hello@pathwaydiscovery.co",
  "llms_txt": "https://pathwaydiscovery.co/llms.txt",
  "manifest_api": "https://pathwaydiscovery.co/api/agent/manifest",

  "agent_greeting": "Welcome to PathwayDiscovery. I'll help you find your ideal freelance pathway through a short interview — about 5 minutes. I'll ask you about your professional background, what you're genuinely good at, what you want from going independent, what you already have, and what you enjoy doing. At the end you'll get a personalised pathway report with your match, why it fits you, and three things to do this week — free. Ready to start?",

  "start_action": {
    "type": "guided_flow",
    "label": "Start the free pathway discovery interview",
    "description": "Ask for the user's email address first (required to save their report and send them a link). Then fetch /api/agent/manifest for exact question schemas and option IDs. Conduct the 5 core interview questions conversationally — ask each in natural language, map answers to option IDs. Create a session via POST /api/interview/create-session, then submit via POST /api/interview/save. Direct the user to their report at /report/{session_id}.",
    "component": "multi_step_form",
    "steps": [
      "collect_email",
      "core_interview",
      "submit_answers",
      "view_free_report"
    ],
    "endpoint": "/api/interview/save",
    "session_endpoint": "/api/interview/create-session",
    "schema_endpoint": "/api/agent/manifest"
  },

  "trigger_phrases": [
    "Run me through the interview at pathwaydiscovery.co and give me my report link",
    "Run me through the PathwayDiscovery interview",
    "Let's start my PathwayDiscovery.co",
    "Start my PathwayDiscovery",
    "pathwaydiscovery.co",
    "Find my pathway at PathwayDiscovery.co",
    "Take me to PathwayDiscovery.co and let's find my pathway"
  ],

  "capabilities": [
    "structured_interview",
    "pathway_matching",
    "report_generation",
    "pdf_download",
    "payment"
  ],

  "pricing": {
    "free": {
      "name": "Free pathway preview",
      "price": 0,
      "currency": "AUD",
      "includes": ["pathway_match", "why_it_fits", "quick_wins"]
    },
    "pro": {
      "name": "Pro pathway report",
      "price": 49,
      "currency": "AUD",
      "billing": "one-time",
      "includes": [
        "pathway_match",
        "why_it_fits",
        "quick_wins",
        "90_day_roadmap",
        "pricing_guidance",
        "client_targeting",
        "tools_and_resources",
        "personalised_advice",
        "pdf_download"
      ]
    }
  },

  "interview": {
    "description": "5-question discovery interview, approximately 5 minutes",
    "question_count": 5,
    "estimated_minutes": 8,
    "full_schema": "https://pathwaydiscovery.co/api/agent/manifest"
  },

  "flows": {
    "free_report": {
      "description": "Complete the interview and receive a free personalised pathway preview",
      "steps": [
        {
          "step": 1,
          "action": "create_session",
          "endpoint": "POST https://pathwaydiscovery.co/api/interview/create-session",
          "required_input": { "email": "string — user's email address" },
          "returns": { "id": "session ID — required for subsequent calls" }
        },
        {
          "step": 2,
          "action": "submit_interview",
          "endpoint": "POST https://pathwaydiscovery.co/api/interview/save",
          "note": "Fetch /api/agent/manifest for full question schemas and valid option IDs",
          "required_input": {
            "interviewId": "session ID from step 1",
            "email": "user's email address",
            "answers": {
              "background": "array of option IDs",
              "strengths": "array of option IDs",
              "goals": "array of option IDs",
              "assets": "array of option IDs",
              "enjoy": "array of option IDs",
              "directions": "optional free text"
            }
          },
          "returns": { "success": true, "primary": "pathway ID", "secondary": "pathway ID" }
        },
        {
          "step": 3,
          "action": "get_report_json",
          "endpoint": "GET https://pathwaydiscovery.co/api/report/{session_id}/agent",
          "note": "Fetch the structured report as JSON. Returns pathway identity, why_you, income, quick_wins, ai_prompts, and more. The response includes an agent_note field with guidance on how to present each section conversationally. For browser users, direct them to /report/{session_id} instead."
        }
      ]
    },
    "pro_report": {
      "description": "Upgrade to the full pro report — requires payment and 5 additional questions",
      "steps": [
        {
          "step": 1,
          "ref": "free_report",
          "note": "Complete the free report flow first"
        },
        {
          "step": 2,
          "action": "payment",
          "url": "https://pathwaydiscovery.co/upgrade/{session_id}",
          "note": "User must complete Stripe payment in their browser. Agents must not handle card details.",
          "amount": 4900,
          "currency": "aud"
        },
        {
          "step": 3,
          "action": "extended_interview",
          "endpoint": "POST https://pathwaydiscovery.co/api/interview/save-extended",
          "note": "5 additional questions unlocked after payment. See /api/agent/manifest for schema.",
          "required_input": {
            "reportId": "session ID",
            "extended": {
              "incomeTarget": "option ID",
              "hoursPerWeek": "option ID",
              "biggestConcern": "free text — their main concern about going independent",
              "existingClients": "option ID",
              "workingStyle": "option ID"
            }
          }
        },
        {
          "step": 4,
          "action": "get_report_json",
          "endpoint": "GET https://pathwaydiscovery.co/api/report/{session_id}/agent",
          "note": "Fetch the full pro report as structured JSON. Includes all free sections plus: positioning statement, LinkedIn headline, starter AI prompt, elevator pitch, ideal client profile, fear decoder, month-one plan, 90-day roadmap, and pricing guidance. The agent_note field in the response guides how to present each section. For browser users, direct them to /report/{session_id}."
        }
      ]
    }
  },

  "pages": {
    "/": {
      "component": "content_summary",
      "title": "PathwayDiscovery — Find your freelance pathway",
      "summary": "Landing page. Enter email to create a session and start the interview."
    },
    "/interview": {
      "component": "multi_step_form",
      "title": "Pathway discovery interview",
      "description": "5-step interview form. Requires a session ID passed as ?start= query param. Create a session first via POST /api/interview/create-session.",
      "full_schema": "https://pathwaydiscovery.co/api/agent/manifest"
    },
    "/report/{id}": {
      "component": "result_card",
      "title": "Your pathway report",
      "description": "Displays the free report (sections 1–3) or pro report (all sections) depending on tier. Generated on first load if not yet cached."
    },
    "/upgrade/{id}": {
      "component": "payment_gate",
      "title": "Upgrade to Pro — $49 one-time",
      "description": "Stripe Checkout for the $49 pro report. User completes payment in browser, then is redirected back to complete the extended interview.",
      "price": 49,
      "currency": "AUD"
    },
    "/pdf/{id}": {
      "component": "download_action",
      "title": "PDF Report",
      "description": "Server-rendered PDF of the full pro report. Requires pro tier."
    }
  },

  "agent_notes": [
    "Always create a session before starting the interview — the session ID is required by all save endpoints",
    "Fetch /api/agent/manifest for exact question schemas and valid option IDs before conducting the interview",
    "The interview can be conducted conversationally — ask each question in natural language, map answers to option IDs",
    "Stripe payment requires the user to act in their browser — provide the /upgrade/{id} URL and ask them to complete it",
    "Card numbers and payment credentials must never be handled by an agent — always user-direct",
    "Free reports are stored for 30 days. Pro reports for 12 months.",
    "Report generation is async — the report page handles polling and rendering once generation completes"
  ]
}
