plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "gaston",
  "version": "1.0.0",
  "description": "Ask about the expenses, budgets and categories in your Gast\u00f3n book, and add an expense to your Gast\u00f3n Inbox to confirm later.",
  "author": {
    "name": "Maximo Varela",
    "url": "https://gaston.cash"
  },
  "homepage": "https://gaston.cash",
  "keywords": [
    "expenses",
    "budget",
    "personal finance",
    "spending"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Gast\u00f3n",
        "shortDescription": "Ask about your expenses",
        "longDescription": "Gast\u00f3n is a personal expense tracker. Connect your Gast\u00f3n account to ask about the spending you have recorded: totals for a month or any date range, spending by category, how each budget is doing, and the categories you use. You can also ask for an expense to be added. It goes to your Gast\u00f3n Inbox as a pending item and only becomes an expense once you confirm it in the Gast\u00f3n app.\n\nWho it is for: people who already track their expenses in Gast\u00f3n on the web, iOS or Android.\n\nLimits: it reads and adds to your personal book only. It cannot edit or delete expenses, change budgets or categories, move money, or connect to a bank. Anything it adds waits in the Inbox until you confirm it. Amounts are shown in your display currency. A fifth tool reports balances between the members of a shared book; through ChatGPT only your personal book is read, so it always answers that there are none. You can disconnect at any time in Gast\u00f3n on the web (gaston.cash) under Settings, Assistants.",
        "developerName": "Maximo Varela",
        "category": "Finance",
        "capabilities": [
          "Look up expenses and totals",
          "Check budget status",
          "List categories",
          "Add an expense to the Inbox for confirmation"
        ],
        "websiteURL": "https://gaston.cash",
        "supportURL": "https://gaston.cash/legal/support",
        "privacyPolicyURL": "https://gaston.cash/legal/privacy",
        "termsOfServiceURL": "https://gaston.cash/legal/terms",
        "defaultPrompt": [
          "How much did I spend this month?",
          "How are my budgets doing?",
          "Add a 1500 ARS coffee expense for today."
        ],
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Total spending for a month",
              "prompt": "How much did I spend in October 2026?",
              "tools_triggered": "queryExpenses",
              "expected_behavior": "States one total in Argentine pesos for 1 to 31 October 2026, taken from the tool result. With the sample data alone the total is ARS 214,300; it is higher if pending Inbox items were confirmed in the app."
            },
            {
              "description": "Spending for one category over a date range",
              "prompt": "How much did I spend on Food & Dining in September 2026?",
              "tools_triggered": "listCategories, queryExpenses",
              "expected_behavior": "Reports the Food & Dining total for September 2026. With the sample data that is ARS 127,100 across three expenses. It may look the category up with listCategories first, or skip that and group one queryExpenses call by category."
            },
            {
              "description": "Budget status",
              "prompt": "How are my budgets doing?",
              "tools_triggered": "getBudgetStatus",
              "expected_behavior": "Lists the two yearly budgets of the test account, Food & Dining and Transportation, each with its limit, the amount spent in 2026 and what remains, without inventing budgets that do not exist."
            },
            {
              "description": "List categories",
              "prompt": "What categories do I have in Gast\u00f3n?",
              "tools_triggered": "listCategories",
              "expected_behavior": "Lists the nine categories of the test account: Bills & Utilities, Education, Entertainment, Food & Dining, Healthcare, Shopping, Taxes & Fees, Transportation and Travel."
            },
            {
              "description": "Add an expense for the user to confirm",
              "prompt": "Add a 1500 ARS coffee expense for today.",
              "tools_triggered": "addExpenseToInbox",
              "expected_behavior": "Adds a pending item of ARS 1,500 described as coffee, dated today, to the Gast\u00f3n Inbox, and tells the user it is not saved as an expense until they confirm it in the Gast\u00f3n app. It does not appear in totals before that."
            }
          ],
          "negative": [
            {
              "description": "Deleting is not supported. Gast\u00f3n has no tool that edits or deletes, so the safe response is to say so and point the user to the Gast\u00f3n app, without calling a tool.",
              "prompt": "Delete my last expense."
            },
            {
              "description": "Invalid amount. The server refuses an amount with more than two decimals, so 12.3456 is never stored as written. The safe response is to say so and ask for a valid amount.",
              "prompt": "Add an expense of exactly 12.3456 US dollars for lunch."
            },
            {
              "description": "Unknown category. The id does not exist in the user's book, so the server refuses it and nothing is added under that id. The safe response is to say the category was not found, and then either ask which real category to use or add the expense without a category and say so.",
              "prompt": "Add a 2000 ARS expense for books in the category with id cmxxxxxxxxxxxxxxxxxxxxxxxx."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/Q524o723CG8",
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments."
      },
      "publication": {
        "release_notes": "Initial release: look up expenses, budgets and categories, and add an expense to the Inbox for confirmation."
      },
      "apps": "./.app.json"
    }
  }
}