plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "qalta",
  "version": "0.1.11",
  "description": "Read and manage personal finance records in Qalta cloud spaces.",
  "homepage": "https://qalta.app",
  "author": {
    "name": "Tokkozhin"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Qalta",
        "developerName": "Tokkozhin",
        "shortDescription": "Track spending, log expenses",
        "longDescription": "Connect your existing Qalta account to ask about spending, budgets, savings goals, debts, and recurring payments, or record income and expenses.\n\nQalta works with cloud spaces accessible to your signed-in account. Private spaces stored only on your device are not available to the connector. A Qalta account and a cloud space are required.\n\nChanges update your Qalta records and sync to your devices and other members of a shared space. Transfers are bookkeeping entries between accounts in Qalta. The connector does not move money at banks, make payments, or execute investment trades.\n\nQalta shares saved icon and color details for categories, accounts, budgets, and goals so ChatGPT can use them in its presentation.",
        "category": "Finance",
        "capabilities": [
          "Read accounts, transactions, and balances",
          "Record and edit income and expenses",
          "Manage budgets, savings goals, and debt records"
        ],
        "websiteURL": "https://qalta.app",
        "supportURL": "https://qalta.app/support",
        "privacyPolicyURL": "https://qalta.app/privacy-policy",
        "termsOfServiceURL": "https://qalta.app/terms-and-conditions",
        "logo": "./assets/icon.png",
        "composerIcon": "./assets/icon.png",
        "defaultPrompt": [
          "How much did I spend on groceries last month?",
          "Log 12.40 for coffee from my card today.",
          "What's left in my dining out budget?"
        ]
      },
      "review": {
        "commerce": false,
        "commerce_description": "This ChatGPT plugin does not sell products or process payments. Qalta Pro subscriptions are purchased separately in the Qalta iOS app through the Apple App Store.",
        "test_cases": {
          "positive": [
            {
              "description": "Use the Shared demo cloud space, which contains grocery expenses in the previous calendar month. Resolve the space if necessary.",
              "prompt": "How much did I spend on groceries last month?",
              "tools_triggered": "list_spaces, get_summary",
              "expected_behavior": "Query the previous calendar month in the user's timezone. State the cloud space, groceries total, and currency supported by the returned category breakdown; do not invent amounts."
            },
            {
              "description": "The Shared demo space has a regular account named Cash and an expense category named Coffee. Confirm the operation before saving unless the user explicitly waived confirmation.",
              "prompt": "Log 12.40 for coffee from my Cash account today.",
              "tools_triggered": "list_spaces, list_accounts, list_categories, add_transaction",
              "expected_behavior": "Resolve the actual account and category IDs. Confirm the operation, then create one expense for 12.40 in the account currency dated today. Report success only after a successful tool result. If showing the matched category while resolving it, preserve its returned icon_presentation and show the category once. Do not duplicate the transaction on retry."
            },
            {
              "description": "The Shared demo space has a monthly Coffee budget.",
              "prompt": "What's left in my Coffee budget?",
              "tools_triggered": "list_spaces, list_budgets",
              "expected_behavior": "Identify the current Coffee budget and report its limit, spending, remaining amount, currency and period consistently with the tool response. Preserve its returned icon_presentation, including the rounded-square shape and translucent Qalta colors. Do not modify records."
            },
            {
              "description": "The Shared demo space has a savings goal named New laptop linked to an account.",
              "prompt": "How is my New laptop savings goal going?",
              "tools_triggered": "list_spaces, list_goals",
              "expected_behavior": "Report the matching goal's saved amount, target, currency and progress from returned data. Preserve its returned icon_presentation, including the rounded-square shape and translucent Qalta colors. Do not claim the target has been met unless the data supports it."
            },
            {
              "description": "The Shared demo space has regular accounts named Cash, Savings and Wallet.",
              "prompt": "Show me the balances of my accounts.",
              "tools_triggered": "list_spaces, list_accounts",
              "expected_behavior": "Report the regular account names, current balances and currencies from the tool response. Preserve each account's returned icon_presentation, including its circular shape and translucent Qalta colors. Do not confuse Qalta bookkeeping balances with live bank balances or modify records."
            }
          ],
          "negative": [
            {
              "description": "Qalta records finances but cannot execute bank payments. Do not call add_transfer, add_transaction, or a debt-writing tool as a substitute for paying rent.",
              "prompt": "Pay my rent from my bank account now."
            },
            {
              "description": "Private spaces stored only on another person's device are unavailable. Explain the access boundary; do not fabricate data or attempt cross-user access.",
              "prompt": "Show me my partner's private on-device space even though they haven't shared it with me."
            },
            {
              "description": "Qalta cannot trade investments. Explain this limitation without invoking a bookkeeping tool as if it executed a real purchase.",
              "prompt": "Buy $500 of Apple shares using the money in my Qalta Card account."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "App-matched icons and colors\n\nThe category, account, budget, and savings-goal list tools now include an `icon_presentation` object alongside each record's saved icon and color. It provides the resolved icon identifier, light- and dark-theme foreground and background colors, background opacity, container shape, and relative icon size.\n\n- Ordinary saved colors use a same-color background at 20% opacity. Pure black, pure white, and the semantic accent use 12% opacity.\n- Accent icons use black in light appearance and white in dark appearance.\n- Categories, budgets, and goals use rounded-square icon containers. Regular accounts use circular icon containers.\n- Missing category-style icons and colors follow Qalta's `CircleOff` and `#808080` defaults. Debt accounts use Qalta's circular initials avatar on a neutral-gray background.\n\nChatGPT presentation guidance\n\nThe MCP instructions and list-tool descriptions now tell ChatGPT to preserve the supplied icon and color values, show each result once, and avoid adding a second plugin-rendered list. If the host's native response cannot represent the styling, the guidance prefers a plain text row over an invented solid badge. Existing review scenarios for category selection, budgets, savings goals, and account balances now check that the supplied icon presentation is preserved.\n\nThe plugin supplies the saved values and exact styling parameters; ChatGPT controls the final rendering, so icon appearance can vary by host."
      },
      "apps": "./.app.json"
    }
  }
}