← Files KostivoARCHIVED FILE

plugin.json

6.36 KB · Nov 21, 2026 · 00:17 UTC

↓ Download file

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "kostivo-family-finance",
  "version": "1.0.0",
  "description": "Your family's finances in Kostivo: expenses, income, budgets and fixed costs, plus changes you approve first.",
  "author": {
    "name": "Kostivo",
    "url": "https://kostivo.de"
  },
  "homepage": "https://kostivo.de",
  "keywords": [
    "family finance",
    "budgeting",
    "expenses",
    "income",
    "household"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Kostivo",
        "shortDescription": "Family finance planning",
        "longDescription": "Ask about your family's finances in Kostivo: today at a glance, expenses for a day, week or month, income, budgets, fixed costs and savings plans, and Kosti's treasury. Each connection covers one family, which you choose when you connect. To change something, Kostivo first shows a proposal of exactly what will change and writes only after you approve it. If you do not allow changes when you connect, the connection stays read-only. Requires KostiPro, Kostivo's paid plan, for the connected family.",
        "developerName": "Kostivo",
        "category": "Finance",
        "websiteURL": "https://kostivo.de",
        "supportURL": "https://kostivo.de/imprint",
        "privacyPolicyURL": "https://kostivo.de/privacy",
        "termsOfServiceURL": "https://kostivo.de/agb",
        "logo": "assets/kostivo-icon.png",
        "composerIcon": "assets/kostivo-icon.png",
        "defaultPrompt": "Give me an overview of my family's finances today."
      },
      "review": {
        "demo_recording_url": "https://youtu.be/u9dxSwoJfTg",
        "prompts": [
          "Give me an overview of my family's finances today.",
          "Summarize our expenses for this month by budget.",
          "Show our income, budgets and fixed costs, including savings plans.",
          "Prepare a change to one of our budgets and show me exactly what would change.",
          "How is Kosti's treasury doing today?"
        ],
        "test_cases": {
          "positive": [
            {
              "description": "OAuth sign-in and family isolation. Connect with the reviewer account and choose its family on the consent page.",
              "prompt": "Connect to my Kostivo family account and tell me which family's finances this connection can access.",
              "tools_triggered": "OAuth authorization; get_my_day",
              "expected_behavior": "The user signs in and consents in the browser and chooses exactly one family. get_my_day returns that family's name. The answer names only this family and never implies access to another."
            },
            {
              "description": "Today's overview and expenses for a week.",
              "prompt": "Give me an overview of today and summarize my expenses for this week.",
              "tools_triggered": "get_my_day; get_expenses",
              "expected_behavior": "get_my_day returns today's expenses, what is left of each budget this month and the treasury state; get_expenses with period week returns Monday to Sunday with totals per budget. The assistant reports only returned values, in the family's currency."
            },
            {
              "description": "Finance items: income, budgets, fixed costs and savings plans.",
              "prompt": "Show me our income, budgets and fixed costs, including savings plans.",
              "tools_triggered": "get_finances",
              "expected_behavior": "get_finances returns regular and one-off income, budgets, housing, loans, insurance, contracts, taxes, building-savings contracts, stock savings plans and savings accounts, each with its charge for the month. The assistant reports only returned values, in the family's currency."
            },
            {
              "description": "Propose a change and apply it only after explicit approval. Requires a connection where 'allow changes' was ticked on the consent page.",
              "prompt": "Raise one of our budgets by 50 euros from this month. Show me exactly what changes before you apply it.",
              "tools_triggered": "get_finances; propose_changes; apply_changes (only after approval)",
              "expected_behavior": "propose_changes returns the exact change and a proposal_id and writes nothing. The assistant shows the change and waits. Only after the user approves does it call apply_changes with that proposal_id. The budget gets a new version from this month; earlier months stay unchanged. Calling apply_changes again with the same proposal_id writes nothing twice."
            },
            {
              "description": "Kosti's treasury, the app's reward system.",
              "prompt": "How is Kosti's treasury doing today?",
              "tools_triggered": "get_treasury",
              "expected_behavior": "get_treasury returns level, nuts, today's daily nut and bookings, and the treasures and decorations earned. The assistant presents them as Kostivo's reward system, not as a savings balance, and says the daily nut is collected in the Kostivo app."
            }
          ],
          "negative": [
            {
              "description": "A read-only connection must not write. Connect without ticking 'allow changes'. propose_changes answers that the permission is missing (insufficient_scope, scope finances:write) and the assistant offers to connect again; nothing is written.",
              "prompt": "Add an expense of 12.50 euros for the bakery today."
            },
            {
              "description": "Fixed costs cannot be deleted and past months are never rewritten. Kostivo refuses to delete a fixed cost; the assistant offers to end it from a month instead, through a proposal the user approves first. Nothing is written without approval.",
              "prompt": "Delete our insurance completely, including all past months."
            },
            {
              "description": "Only the connected family. The connection covers the one family chosen at sign-in; the assistant must not claim or attempt access to any other family or person.",
              "prompt": "Also show me the expenses of my sister's family in Kostivo."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "First version of Kostivo for ChatGPT: read your family's finances and make changes you approve first."
      },
      "apps": "./.app.json"
    }
  }
}

SHA-256: 6b1f33873f754c6facab0f510796e8757d134800579f14ecddf76f1813cfd3b6