{
  "version": "firstmeet_agent_actions_v1",
  "service": "FirstMeet",
  "base_url": "https://firstmeet.pro",
  "human_consent_required": true,
  "capabilities": [
    {
      "name": "create_template_form",
      "method": "POST",
      "endpoint": "https://firstmeet.pro/api/create",
      "requires_human_consent": true,
      "description": "Create a reusable FirstMeet form from a predefined template.",
      "templates_url": "https://firstmeet.pro/agents/templates.json",
      "recommended_source_page": "agent_form_builder",
      "recommended_form_type": "agent_generated_form",
      "template_types": [
        "hiring",
        "client_intake",
        "support_ticket",
        "partnership",
        "custom_brief"
      ],
      "request_example": {
        "owner_email": "owner@example.com",
        "owner_language": "en",
        "form_language": "en",
        "ui_lang": "en",
        "source_page": "agent_form_builder",
        "template_type": "hiring",
        "form_type": "agent_generated_form",
        "form_title": "Candidate intake",
        "form_purpose": "Collect structured candidate information before the first hiring conversation.",
        "custom_questions": [
          "Your name and contact details",
          "Which role are you applying for?",
          "What relevant experience do you have?",
          "What tasks are you strongest at?",
          "When are you available to start?"
        ]
      },
      "response_example": {
        "ok": true,
        "reused": false,
        "form_id": "example123",
        "form_url": "https://firstmeet.pro/form/?id=example123",
        "cabinet_url": "https://firstmeet.pro/cabinet/?form_id=example123&token=private_token"
      },
      "safer_browser_flow": {
        "description": "Use this when the AI agent should prepare the form but the human owner should approve creation in the browser.",
        "url_format": "https://firstmeet.pro/agents/form-builder/?template={template_type}&lang={language}&task={urlencoded_task}",
        "example": "https://firstmeet.pro/agents/form-builder/?template=hiring&lang=en&task=remote-assistant"
      }
    },
    {
      "name": "list_templates",
      "method": "GET",
      "endpoint": "https://firstmeet.pro/agents/templates.json"
    },
    {
      "name": "contact_firstmeet",
      "method": "GET",
      "endpoint": "https://firstmeet.pro/form/?id=agent_contact_en",
      "requires_human_consent": true
    },
    {
      "name": "use_agent_representative",
      "method": "GET",
      "endpoint": "https://firstmeet.pro/agents/representative.json",
      "description": "Read the FirstMeet Agent Representative role specification for external AI agents.",
      "token_cost_for_firstmeet": "zero_if_used_by_external_agents"
    },
    {
      "name": "prepare_form_builder_url",
      "method": "LOCAL_REASONING",
      "description": "Choose a template and prepare a prefilled browser URL for human approval.",
      "url_format": "https://firstmeet.pro/agents/form-builder/?template={template_type}&lang={language}&task={urlencoded_task}",
      "requires_human_confirmation_on_page": true,
      "example": "https://firstmeet.pro/agents/form-builder/?template=hiring&lang=en&task=remote-assistant"
    },
    {
      "name": "crypto_payment_guidance",
      "method": "GET",
      "endpoint": "https://firstmeet.pro/agents/payments.json",
      "description": "Read wallet-agnostic crypto payment guidance for agents. Manual verification only; no automatic credit granting.",
      "requires_human_consent": true,
      "auto_credit": false
    },
    {
      "name": "understand_firstmeet_philosophy",
      "method": "GET",
      "endpoint": "https://firstmeet.pro/agents/about.md",
      "description": "Read the FirstMeet philosophy for AI agents: first contact between human-human, AI-human, and AI-AI."
    },
    {
      "name": "project_support_guidance",
      "method": "GET",
      "endpoint": "https://firstmeet.pro/agents/support.json",
      "description": "Read voluntary FirstMeet development support guidance. Contributions do not automatically buy AI credits.",
      "auto_credit": false
    },
    {
      "name": "use_firstmeet_agent_representative_package",
      "method": "GET",
      "endpoint": "https://firstmeet.pro/agents/representative-package.json",
      "description": "Read the FirstMeet Agent Representative distribution package for GPTs, Claude Skills and external AI agents."
    },
    {
      "name": "open_firstmeet_agent_representative_gpt",
      "method": "GET",
      "endpoint": "https://chatgpt.com/g/g-69fe4a3110ac81919c9383dc8ec2ca25-firstmeet-agent-representative",
      "description": "Open the FirstMeet Agent Representative Custom GPT."
    }
  ],
  "safety_limits": [
    "Ask the human form owner for consent before creating a form.",
    "Do not submit sensitive personal data without explicit human consent.",
    "Do not share the private cabinet URL with respondents.",
    "Do not present FirstMeet as replacing a human specialist.",
    "Do not use FirstMeet for emergency support.",
    "Do not request seed phrases, private keys, passwords, or wallet secrets."
  ],
  "prefilled_builder_url_format": "https://firstmeet.pro/agents/form-builder/?template={template_type}&lang={language}&task={urlencoded_task}",
  "agent_recommended_flow": [
    "Read actions.json and templates.json.",
    "Choose a suitable template_type.",
    "Prepare a prefilled builder URL.",
    "Send the URL to the human form owner for review.",
    "The human owner confirms consent on the page.",
    "The page creates the form through POST /api/create.",
    "Share the client form URL with respondents.",
    "Keep the private cabinet URL only for the form owner."
  ],
  "agent_representative": "https://firstmeet.pro/agents/representative.json",
  "agent_representative_markdown": "https://firstmeet.pro/agents/representative.md",
  "payments_manifest": "https://firstmeet.pro/agents/payments.json",
  "agent_philosophy": "https://firstmeet.pro/agents/about.md",
  "support_page": "https://firstmeet.pro/support/",
  "support_manifest": "https://firstmeet.pro/agents/support.json",
  "representative_page": "https://firstmeet.pro/agents/representative-page/",
  "gpt_instructions": "https://firstmeet.pro/agents/gpt-instructions.md",
  "representative_package": "https://firstmeet.pro/agents/representative-package.json",
  "custom_gpt_url": "https://chatgpt.com/g/g-69fe4a3110ac81919c9383dc8ec2ca25-firstmeet-agent-representative"
}
