plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "ioreum-saju",
  "version": "1.0.0",
  "description": "Deterministic Korean saju (Four Pillars) charts: solar-term boundaries computed astronomically to the minute, true solar time from the birthplace, 10-year luck pillars, the zodiac-year boundary and a reference for the sixty day-pillar characters. Read-only calculation tools; no account needed.",
  "author": {
    "name": "ioreum",
    "email": "support@ioreum.com",
    "url": "https://www.ioreum.com/en"
  },
  "homepage": "https://www.ioreum.com/en/connector",
  "keywords": [
    "saju",
    "bazi",
    "four pillars",
    "korean zodiac",
    "astrology",
    "calendar"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "ioreum Saju",
        "shortDescription": "Korean saju charts, computed",
        "longDescription": "ioreum calculates Korean saju (\u56db\u67f1, Four Pillars of Destiny) charts the way a professional would: solar-term boundaries computed astronomically to the minute, true solar time from the birthplace, and the late-night hour convention. Ask for a chart, the 10-year luck pillars (daeun), which zodiac animal a January or February birth really belongs to, or a reference for any of the sixty day-pillar characters. Tools return calculated facts only and take nothing but the birth details you give them. Nothing here predicts events; treat it as reference and entertainment. Supported birth years: 1900 to 2050.",
        "developerName": "ioreum",
        "category": "Entertainment",
        "capabilities": [
          "Calculate a saju / BaZi chart",
          "List 10-year luck pillars",
          "Check the zodiac-year boundary",
          "Explain day-pillar characters"
        ],
        "websiteURL": "https://www.ioreum.com/en/connector",
        "supportURL": "https://www.ioreum.com/en/legal/business",
        "privacyPolicyURL": "https://www.ioreum.com/en/legal/privacy",
        "termsOfServiceURL": "https://www.ioreum.com/en/legal/terms",
        "defaultPrompt": [
          "Calculate my saju chart - born 1994-03-08 at 14:30 in Seoul, female.",
          "I was born on February 2, 1990. Am I really a Snake or still a Horse?",
          "Explain the gapja (\u7532\u5b50) day pillar character."
        ],
        "brandColor": "#B1402B",
        "brandColorDark": "#E8826C",
        "composerIcon": "./assets/icon.png",
        "composerIconDark": "./assets/icon-dark.png",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Full chart with birth time",
              "prompt": "Calculate my saju: born 1994-03-08 at 14:30 in Seoul, female.",
              "tools_triggered": "calculate_saju",
              "expected_behavior": "Returns the year, month, day and hour pillars (stem and branch each), the Day Master, the Five-Element distribution and a note on the true-solar-time adjustment applied to the birth hour."
            },
            {
              "description": "Chart without a birth time",
              "prompt": "Same birth, 1994-03-08 in Seoul, but I don't know the hour.",
              "tools_triggered": "calculate_saju",
              "expected_behavior": "Returns three pillars and states the hour pillar is left out because the time is unknown, instead of guessing it."
            },
            {
              "description": "10-year luck pillars",
              "prompt": "What are my 10-year luck pillars? Born 1988-11-21 at 06:10 in Busan, male.",
              "tools_triggered": "luck_pillars",
              "expected_behavior": "Returns the starting age and the list of ten-year pillars, with the direction (forward or backward) of the cycle."
            },
            {
              "description": "Zodiac-year boundary before ipchun",
              "prompt": "I was born on February 2, 1990. Am I a Snake or a Horse?",
              "tools_triggered": "check_zodiac_year",
              "expected_behavior": "Explains the saju year turns at ipchun (about February 4), so a February 2, 1990 birth belongs to the previous year's animal (Snake, \u5df1\u5df3), not the Horse."
            },
            {
              "description": "Day-pillar character reference",
              "prompt": "What is the \u4e19\u5348 day pillar like?",
              "tools_triggered": "day_master_character",
              "expected_behavior": "Returns the reference entry for the \u4e19\u5348 day pillar (its name, epithet and Day Master element), presented as reference, not as a prediction."
            }
          ],
          "negative": [
            {
              "description": "Event prediction is declined; the tools only calculate charts",
              "prompt": "Will I get the job I interviewed for next month?"
            },
            {
              "description": "Birth years outside 1900-2050 are rejected rather than invented",
              "prompt": "Calculate the saju chart for someone born on 1850-01-01."
            },
            {
              "description": "No reading from chat history; only explicit birth details are accepted",
              "prompt": "Here is my friend's whole chat history - read her fortune from it."
            }
          ]
        },
        "demo_recording_url": "https://www.ioreum.com/review/ioreum-saju-chatgpt-demo.mp4",
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments. Tools return calculated chart data only."
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial submission - 4 read-only saju calculation tools (chart, luck pillars, zodiac-year boundary, day-pillar reference). No auth, no UI components, no commerce."
      },
      "apps": "./.app.json"
    }
  }
}