plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "the-happy-giraffe-budget",
  "version": "1.0.0",
  "description": "Set up a budget the Happy Giraffe way: pay your bills, then live on one weekly number called Happy Money.",
  "author": {
    "name": "The Happy Giraffe Company",
    "email": "hello@happygiraffe.org",
    "url": "https://happygiraffe.org"
  },
  "homepage": "https://happygiraffe.org",
  "keywords": [
    "budget",
    "budgeting",
    "personal finance",
    "spreadsheet"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "The Happy Giraffe Budget",
        "shortDescription": "One weekly number to live on",
        "longDescription": "Tell it about your money in your own words, or upload a bank statement, and it helps you set up your budget the Happy Giraffe way. Pay your bills, then live on one weekly number called Happy Money. No categories to track.\n\nIt looks two years ahead, so the bills that only come once or twice a year are covered too. You see your weekly Happy Money, three simple checks that show your plan works on the right days, and a graph of your next two years. Change anything and it updates right away.\n\nWhen you are done, you get your budget as a spreadsheet to keep. It does not connect to your bank or move any money. It works out your numbers from what you tell it.",
        "developerName": "The Happy Giraffe Company",
        "category": "Finance",
        "capabilities": [
          "Set up a weekly budget",
          "Answer budgeting questions",
          "Download a budget spreadsheet"
        ],
        "websiteURL": "https://happygiraffe.org/",
        "supportURL": "https://happygiraffe.org/app_faq/",
        "privacyPolicyURL": "https://happygiraffe.org/privacy-policy-page/",
        "termsOfServiceURL": "https://happygiraffe.org/wp-content/uploads/2024/11/2024-11-26-Happy-Giraffe-Terms-Conditions.pdf",
        "defaultPrompt": [
          "Help me set up my first budget.",
          "I get paid every other Friday. Help me make a budget.",
          "Here's my bank statement. Help me build a budget from it."
        ],
        "brandColor": "#E8822A",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Set up a first budget from income and bills given in conversation",
              "prompt": "Help me make a budget.",
              "tools_triggered": "start_budget_setup, update_budget",
              "expected_behavior": "Opens with the five steps, asks for the money available today and the income with short forms, then the regular bills in three short forms (home; car, debt and subscriptions; family, giving and savings), then a tick the ones you have checklist of bills that come once or twice a year such as car registration and Christmas, then one form for the amounts of the ticked ones, then whether that is everything. No Happy Money number is shown yet."
            },
            {
              "description": "Show the finished budget once the person says the list is complete",
              "prompt": "That's everything for now.",
              "tools_triggered": "update_budget",
              "expected_behavior": "Shows the budget card (weekly Happy Money, the highest amount keeping all three checks green; three checks; two year balance graph), explains it in plain words and gives the spreadsheet link."
            },
            {
              "description": "Try a what-if change",
              "prompt": "What if I put $50 a week into savings?",
              "tools_triggered": "update_budget",
              "expected_behavior": "Adds a weekly savings bill and shows the updated card with a lower Happy Money and the checks still green."
            },
            {
              "description": "Answer a common budgeting question",
              "prompt": "Does my Happy Money reset every week?",
              "tools_triggered": "answer_budget_question",
              "expected_behavior": "Explains that it does not reset: what is left over carries into the next week, and overspending carries over too."
            },
            {
              "description": "Get the budget as a spreadsheet",
              "prompt": "Can I get this as a spreadsheet?",
              "tools_triggered": "get_budget_spreadsheet",
              "expected_behavior": "Returns a download link that works for 24 hours. The file opens in Excel or Google Sheets with the same income, bills and weekly Happy Money."
            }
          ],
          "negative": [
            {
              "description": "Investment advice is out of scope: the budget plugin is not called and gives no investment advice; ChatGPT may answer on its own.",
              "prompt": "Which stocks should I buy with my extra money?"
            },
            {
              "description": "It cannot move money or pay bills: no tool moves money; if the plugin is asked, it says plainly that it can't pay rent from a bank account and only helps plan for it.",
              "prompt": "Pay my rent from my checking account."
            },
            {
              "description": "Unrelated request should not use the plugin: the budget plugin is not called; ChatGPT writes the poem on its own.",
              "prompt": "Write me a poem about giraffes."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell anything or process payments.",
        "demo_recording_url": "https://youtu.be/8p-D1wwVy1E"
      },
      "publication": {
        "release_notes": "First release: set up a weekly budget, see Happy Money and the three checks, ask common questions, and download the budget spreadsheet."
      },
      "apps": "./.app.json"
    }
  }
}