Sami Vacation Stays FAQ Agent

{
  "protocolVersion": "0.3.0",
  "name": "Sami Vacation Stays FAQ Agent",
  "description": "Answers questions about Sami Vacation Stays \u2014 a personalized Panama vacation hospitality service \u2014 from its published FAQ and question/answer pairs. Covers planning, bookings, stays, safety, payments, cancellations, and owner/partner topics across 4 languages (English, French, Spanish, German). Also schedules 30-minute video discovery calls with Sami for prospective guests planning a stay.",
  "url": "https://www.samivacationstays.com/api/a2a",
  "preferredTransport": "JSONRPC",
  "provider": {
    "organization": "Sami Vacation Stays",
    "url": "https://www.samivacationstays.com"
  },
  "version": "1.1.0",
  "documentationUrl": "https://www.samivacationstays.com/faq",
  "iconUrl": "https://www.samivacationstays.com/logo-no-border.png",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "faq",
      "name": "Answer FAQ questions",
      "description": "Match a free-text question against the Sami Vacation Stays FAQ and return the best answer, plus related questions. Send \"list\" to receive all 30 questions for a language. Pass a `locale` (en, fr, es, de) in message metadata to search a single language.",
      "tags": [
        "faq",
        "panama",
        "vacation",
        "travel",
        "hospitality",
        "bookings",
        "stays"
      ],
      "examples": [
        "Is Panama safe for tourists?",
        "How is Sami different from a regular booking platform?",
        "What is the cancellation policy?",
        "How do payments work?",
        "How does the planning process work?",
        "list"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain"
      ]
    },
    {
      "id": "list-availability",
      "name": "List discovery-call availability",
      "description": "Return Sami's open 30-minute discovery-call slots. Send a DataPart: {\"skill\":\"list-availability\",\"from\":\"YYYY-MM-DD\",\"to\":\"YYYY-MM-DD\",\"timeZone\":\"America/Panama\"}. All three fields are optional; the default window is the next 14 days in America/Panama and it may span at most 31 days. Returns a DataPart whose `slots` maps each YYYY-MM-DD to an array of ISO-8601 start times.",
      "tags": [
        "availability",
        "scheduling",
        "calendar",
        "panama",
        "vacation"
      ],
      "examples": [
        "{\"skill\":\"list-availability\"}",
        "{\"skill\":\"list-availability\",\"from\":\"2026-08-01\",\"to\":\"2026-08-08\",\"timeZone\":\"America/New_York\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "book-discovery-call",
      "name": "Book a discovery call with Sami",
      "description": "Book a 30-minute Google Meet call with Sami. Send a DataPart: {\"skill\":\"book-discovery-call\",\"intent\":\"stay\",\"name\":\"...\",\"email\":\"...\",\"start\":\"2026-08-03T14:00:00Z\",\"timeZone\":\"America/Toronto\",\"language\":\"en\",\"notes\":\"...\"}. `start` must be an ISO-8601 instant with an explicit offset, at least 120 minutes ahead. IMPORTANT \u2014 this skill is for prospective guests only. `intent` must be one of: stay, long-stay, extended-stay, group-travel, digital-nomad. Requests declaring owner-inquiry, vendor, supplier, partnership, sales, marketing, recruiting, other, or any other value, are refused: use the contact form at https://www.samivacationstays.com/contact instead. Returns a DataPart with `bookingUid`, `start`, `end`, and `meetingUrl`.",
      "tags": [
        "booking",
        "scheduling",
        "meeting",
        "google-meet",
        "panama",
        "vacation",
        "consultation"
      ],
      "examples": [
        "{\"skill\":\"book-discovery-call\",\"intent\":\"stay\",\"name\":\"Ada Lovelace\",\"email\":\"ada@example.com\",\"start\":\"2026-08-03T14:00:00Z\",\"timeZone\":\"Europe/London\",\"notes\":\"Family of four, Playa Blanca, first week of September.\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    }
  ],
  "supportsAuthenticatedExtendedCard": false
}