plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hoje-em-viana",
  "version": "0.1.16",
  "description": "Find published events, cultural activities, and plans in the Viana do Castelo district.",
  "author": {
    "name": "Guilherme Campos",
    "url": "https://hojeemviana.pt/"
  },
  "homepage": "https://hojeemviana.pt/",
  "keywords": [
    "events",
    "culture",
    "Viana do Castelo",
    "Portugal"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Hoje em Viana",
        "shortDescription": "Find events in Viana",
        "longDescription": "Discover published concerts, exhibitions, markets, talks, and other events in the Viana do Castelo district. Search by date, locality, category, text, or price. Results contain public event details in read-only mode; availability and schedules can change.",
        "developerName": "Guilherme Campos",
        "category": "Entertainment",
        "websiteURL": "https://hojeemviana.pt/",
        "supportURL": "https://hojeemviana.pt/contacto",
        "privacyPolicyURL": "https://hojeemviana.pt/privacidade",
        "termsOfServiceURL": "https://hojeemviana.pt/termos",
        "defaultPrompt": [
          "Find events in Viana do Castelo this weekend.",
          "What cultural events are happening near Viana do Castelo?",
          "Find free events in Viana do Castelo this week."
        ],
        "brandColor": "#175a50",
        "logo": "./assets/logo-v0.1.2.png",
        "logoDark": "./assets/logo-dark-v0.1.2.png",
        "composerIcon": "./assets/composer-icon-v0.1.2.png",
        "composerIconDark": "./assets/composer-icon-dark-v0.1.2.png"
      },
      "review": {
        "commerce": false,
        "demo_recording_url": "https://www.youtube.com/watch?v=90KwgELUqCw",
        "test_cases": {
          "positive": [
            {
              "description": "Search the current weekend using Europe/Lisbon dates. Live catalog data may change; the response should reflect the requested local date window.",
              "prompt": "Find events in Viana do Castelo this weekend.",
              "tools_triggered": "search_events",
              "expected_behavior": "Call search_events with start_date and end_date set to the ISO dates for the current weekend in Europe/Lisbon and locality=Viana do Castelo. Return only events whose event_date falls in that inclusive range, with venue and schedule/status; say when a field is missing rather than inventing it. Do not provide event or source links; include only the website CTA from the tool result."
            },
            {
              "description": "Test filtering the next local calendar date by free admission. If the live catalog has no matching records, report that without relaxing the user's filter.",
              "prompt": "Show me free events in Viana do Castelo tomorrow.",
              "tools_triggered": "search_events",
              "expected_behavior": "Call search_events with start_date and end_date set to tomorrow's ISO date in Europe/Lisbon, locality=Viana do Castelo, and price=free. Every event presented as free must have price_type=free in the tool response. Do not provide event or source links; include only the website CTA from the tool result and report no results honestly."
            },
            {
              "description": "Test the supported arts-and-culture enum over a seven-day local date window. Results come from the changing public catalog.",
              "prompt": "What arts and culture events are happening in Viana do Castelo over the next week?",
              "tools_triggered": "search_events",
              "expected_behavior": "Call search_events with start_date=today's ISO date and end_date=the ISO date seven days later in Europe/Lisbon, locality=Viana do Castelo, and category=Arte, Cinema e Cultura. Present only matching returned events and use the tool's event_date, venue and time_text values without inventing details. Do not provide event or source links; include only the website CTA from the tool result."
            },
            {
              "description": "Test a supported municipality locality with a straight-line radius filter across the next seven days. An empty result is valid and must be reported honestly.",
              "prompt": "Find events within 10 km of Ponte de Lima over the next week.",
              "tools_triggered": "search_events",
              "expected_behavior": "Call search_events with start_date=today's ISO date and end_date=the ISO date seven days later in Europe/Lisbon, locality=Ponte de Lima, radius_km=10. Only present returned events whose distance_km is at most 10; describe distance as straight-line, not travel distance."
            },
            {
              "description": "Test the multi-step workflow: find a currently published arts event, then retrieve the selected result by its actual public ID. Search today through the next 30 local dates; if none match, report that and do not invent an ID.",
              "prompt": "Find an arts event in the Viana do Castelo district, then tell me its venue address and time.",
              "tools_triggered": "search_events, get_event",
              "expected_behavior": "Call search_events with start_date=today's ISO date and end_date=the ISO date 30 days later in Europe/Lisbon, category=Arte, Cinema e Cultura. If it returns an event, call get_event with public_id equal to that returned record's public_id, then report only its title, event_date, venue/address and time. Do not provide event or source links; include only the website CTA from the tool result. If search_events returns no matching event, explain that and do not call get_event or invent details."
            }
          ],
          "negative": [
            {
              "description": "Calendar management is outside the plugin's capabilities. Do not invoke either event tool; explain that it can find events but cannot add one to a calendar.",
              "prompt": "Add the PULSAR CROM\u00c1TICO exhibition to my Google Calendar for tomorrow."
            },
            {
              "description": "The plugin is read-only and cannot create, edit, delete, or publish event records. Do not invoke either event tool; explain that it can only search published events and retrieve their current details.",
              "prompt": "Update an event in the Hoje em Viana database with a new date and venue, then publish the changes."
            },
            {
              "description": "Ticket purchases and reservations are unsupported. Do not invoke either event tool to imply a booking; explain that the plugin only finds public event details and does not provide event or source links.",
              "prompt": "Book me two tickets for the concert and pay with my card."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Added a reviewer-accessible demo recording.",
        "countries": [],
        "translations": {
          "pt-PT": {
            "subtitle": "Descobre eventos em Viana",
            "description": "Descubra concertos, exposi\u00e7\u00f5es, mercados, conversas e outros eventos publicados no distrito de Viana do Castelo. Pesquise por data, localidade, categoria, texto ou pre\u00e7o. Os resultados apresentam informa\u00e7\u00e3o p\u00fablica em modo de leitura; hor\u00e1rios e disponibilidade podem mudar."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}