plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "business-days",
  "version": "1.0.2",
  "description": "Count workdays, office days and PTO days between two dates, add business days for an SLA due date, or list bank holidays and school breaks. Ask \"how many working days are there between 14 July and 18 August in Germany?\", \"what date is 37 business days after 11 August in England?\", \"is Monday a bank holiday in Bavaria?\" or \"what are the school holidays in Bavaria?\".",
  "keywords": [
    "workdays",
    "office days",
    "bank holiday",
    "school holidays",
    "PTO",
    "SLA deadline",
    "statutory holidays"
  ],
  "author": {
    "name": "HI\u1ebeU V\u0168 TRUNG NGUYEN",
    "email": "support@openkrill.app",
    "url": "https://tools.openkrill.app/"
  },
  "homepage": "https://tools.openkrill.app/",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Business Days & Workday Calc",
        "shortDescription": "Workdays, holidays, SLA & PTO",
        "longDescription": "Count workdays, office days and PTO days between two dates, add business days for an SLA due date, or list bank holidays and school breaks. Ask \"how many working days are there between 14 July and 18 August in Germany?\", \"what date is 37 business days after 11 August in England?\", \"is Monday a bank holiday in Bavaria?\" or \"what are the school holidays in Bavaria?\".\n\nBusiness Days and Workday Calculator does the date arithmetic exactly and reads each country's public holidays from Nager.Date, the UK's bank holidays from GOV.UK and school holidays from OpenHolidays, so the result does not depend on a guess about which days are holidays. People also call it OpenKrill Business Days. It does not count trading days, banking days, or settlement days.\n\nIt says how it counted. A working day is any day that is not a weekend day (Saturday and Sunday unless you set another weekend) and not a public holiday of the country or region. When you add days, the start date is day 0 and is not counted; when you count a range, both ends are counted unless you say otherwise. Bank holidays that are not days off, optional days and half days such as Christmas Eve count as working days.\n\nAdd a region (for example DE-BY, GB-SCT or US-CA) to include that region's holidays. Without one, holidays that only some regions keep are not counted, and the answer lists them so you can see the difference.\n\nIt covers more than 200 countries and territories for public holidays and a smaller set, mostly in Europe, for school holidays. It moves up to 1000 business days at a time and reads up to eight calendar years in one question. Company closures, local observances and legal deadline rules are not included, so check the official calendar and the contract before relying on a date.\n\nIt stores nothing about you: answers are cached for up to 24 hours, and the only lasting record is a daily count of calls per tool.",
        "developerName": "HI\u1ebeU V\u0168 TRUNG NGUYEN",
        "category": "Business & Operations",
        "capabilities": [
          "Counts workdays, office days and PTO days between two dates for a country or region",
          "Adds or subtracts business days from a date, skipping weekends and public holidays",
          "Lists bank holidays and statutory public holidays of a country and year, by region",
          "Lists school holidays and school breaks where they are published",
          "States how days were counted, including the weekend and which holidays were applied"
        ],
        "websiteURL": "https://tools.openkrill.app/",
        "privacyPolicyURL": "https://tools.openkrill.app/privacy",
        "termsOfServiceURL": "https://tools.openkrill.app/terms",
        "supportURL": "https://tools.openkrill.app/support",
        "defaultPrompt": [
          "How many working days are there between 14 July and 18 August 2026 in Germany?",
          "What date is 37 business days after 11 August 2026 in England?",
          "List the public holidays in Bavaria in 2027"
        ],
        "brandColor": "#2B6CB0",
        "brandColorDark": "#63A4E8",
        "composerIcon": "./assets/icon.svg",
        "logo": "./assets/icon.svg"
      },
      "review": {
        "demo_recording_url": "https://tools.openkrill.app/demos/business-days.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "businessDays 26 of 36 calendar days, 10 weekend days, no holidays on working days, with the conventions listed. Check against: https://date.nager.at/api/v3/PublicHolidays/2026/DE has no nationwide holiday between 2026-07-14 and 2026-08-18.",
              "prompt": "How many working days are there between 14 July 2026 and 18 August 2026 in Germany?",
              "tools_triggered": "count_business_days",
              "expected_behavior": "Calls count_business_days with country \"DE\", startDate \"2026-07-14\" and endDate \"2026-08-18\"."
            },
            {
              "description": "resultDate 2026-10-02, a Friday, with Summer Bank Holiday 2026-08-31 listed under holidaysSkipped; the start date is not counted. Check against: https://date.nager.at/api/v3/PublicHolidays/2026/GB lists 2026-08-31 for GB-ENG, GB-WLS and GB-NIR.",
              "prompt": "What date is 37 business days after 11 August 2026 in England?",
              "tools_triggered": "add_business_days",
              "expected_behavior": "Calls add_business_days with country \"GB\", region \"GB-ENG\", startDate \"2026-08-11\" and days 37."
            },
            {
              "description": "Nationwide holidays plus those that apply in DE-BY, such as Epiphany on 2027-01-06 and Corpus Christi, each with a weekday and a dayOff flag; holidays only other states keep are absent. Check against: https://date.nager.at/api/v3/PublicHolidays/2027/DE (entries with global true or DE-BY in counties).",
              "prompt": "List the public holidays in Bavaria in 2027.",
              "tools_triggered": "list_holidays",
              "expected_behavior": "Calls list_holidays with country \"DE\", year 2027, region \"DE-BY\" and kind \"public\"."
            },
            {
              "description": "businessDays 18 of 27 calendar days, 8 weekend days, and Christmas Day 2026-12-25 listed under holidaysOnWorkdays. St. Stephen's Day 2026-12-26 falls on a Saturday. Check against: https://date.nager.at/api/v3/PublicHolidays/2026/CA (2026-12-25 nationwide; 2026-12-26 listed for CA-ON).",
              "prompt": "How many working days are there from 5 December to 31 December 2026 in Ontario, Canada?",
              "tools_triggered": "count_business_days",
              "expected_behavior": "Calls count_business_days with country \"CA\", region \"CA-ON\", startDate \"2026-12-05\" and endDate \"2026-12-31\"."
            },
            {
              "description": "A schoolHolidays list for DE-BY with start and end dates, including the Christmas holidays that begin on 2026-12-24 and end on 2027-01-08. Check against: https://openholidaysapi.org/SchoolHolidays?countryIsoCode=DE&validFrom=2027-01-01&validTo=2027-12-31&subdivisionCode=DE-BY",
              "prompt": "What are the school holidays in Bavaria in 2027?",
              "tools_triggered": "list_holidays",
              "expected_behavior": "Calls list_holidays with country \"DE\", year 2027, region \"DE-BY\" and kind \"school\"."
            }
          ],
          "negative": [
            {
              "description": "A plain calendar-day difference does not depend on holidays; the tools exist for counts that skip weekends and holidays. Expected: Does not call a tool; answers 121 days directly.",
              "prompt": "How many calendar days are there between 1 March and 30 June 2026?"
            },
            {
              "description": "The plugin lists public holidays and counts days; it does not give employment or legal advice. Expected: Does not call a tool to decide the legal question; answers in general terms and may offer to list the holidays.",
              "prompt": "Can my employer in Germany make me work on a public holiday?"
            },
            {
              "description": "Time zone conversion is not something the plugin does; it works with dates and holidays only. Expected: Does not call a tool; converts the time zone directly.",
              "prompt": "What time is it in Tokyo when it is 9 am on Monday in Berlin?"
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Counts working days between two dates, adds or subtracts business days, and lists public holidays (Nager.Date) and school holidays (OpenHolidays) by country and region, stating how days were counted. Wording now includes workday, PTO, SLA and bank-holiday terms people already use. Answers are cached for 24 hours; read-only, no sign-in."
      },
      "apps": "./.app.json"
    }
  }
}