plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "tax-hero-ai",
  "version": "1.0.0",
  "description": "Read your authorized Tax Hero business profiles, recorded deadlines, document inventory, subscription and processing statuses.",
  "author": {
    "name": "Tax Hero AI",
    "url": "https://taxhero.vc/",
    "email": "taxhero.ai@gmail.com"
  },
  "homepage": "https://taxhero.vc/",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Tax Hero AI",
        "shortDescription": "Your tax records, read-only",
        "longDescription": "Connect your Tax Hero account to read your associated business profiles, assigned deadlines, document inventory, locally recorded subscription information, and existing document-processing statuses.\n\nYou choose the permissions during sign-in. The customer connection is read-only and limited to information authorized for your account. It cannot edit records, approve transactions, file returns, make payments, download original documents, or retrieve full tax or bank identifiers.\n\nA Tax Hero account is required. Subscription availability follows the existing Tax Hero website rules; the plugin does not offer purchases or payment links.\n\nRecorded dates and statuses are not independent verification of filing applicability, filing completion, payment, document completeness, or completed bookkeeping.",
        "developerName": "Tax Hero AI",
        "category": "Finance",
        "defaultPrompt": [
          "List my businesses and recorded tax deadlines.",
          "Show my document inventory without downloading files.",
          "Show my recorded subscription and processing statuses."
        ],
        "websiteURL": "https://taxhero.vc/",
        "supportURL": "https://taxhero.vc/support",
        "privacyPolicyURL": "https://taxhero.vc/privacy",
        "termsOfServiceURL": "https://taxhero.vc/terms",
        "logo": "./assets/icon.png",
        "composerIcon": "./assets/icon.png"
      },
      "review": {
        "prompts": [
          "What businesses are associated with my Tax Hero account?",
          "What deadlines are recorded for me?",
          "What documents are recorded in my account?",
          "What subscription does Tax Hero have recorded for me?",
          "What are my document processing statuses?"
        ],
        "test_cases": {
          "positive": [
            {
              "description": "With a dedicated sample-data customer signed in and the six customer read scopes consented, confirm connection identity and permissions.",
              "prompt": "Show my Tax Hero connection permissions. Is this connection read-only?",
              "tools_triggered": "get_my_access with no arguments",
              "expected_behavior": "Reports the authenticated sample-data account, access_mode=customer, read_only=true, the granted customer scopes, and current paid_features_available. Does not access business or document records or expose internal user IDs."
            },
            {
              "description": "List the connected customer's associated businesses, following every pagination cursor.",
              "prompt": "List all my businesses in Tax Hero. Do not make changes.",
              "tools_triggered": "list_my_businesses; omit cursor initially and use each next_cursor until has_more=false",
              "expected_behavior": "Returns only businesses currently associated with the signed-in customer. Names, available country/state and setup status match the source records. Missing values remain unknown. No internal IDs, tax identifiers or changes."
            },
            {
              "description": "List recorded deadlines across all pages and distinguish calendar records from verified obligations and completion.",
              "prompt": "List all my Tax Hero deadlines and explain what the recorded statuses tell me.",
              "tools_triggered": "list_my_deadlines; follow next_cursor until has_more=false",
              "expected_behavior": "Reports only the customer's assigned deadlines and returned dates/statuses. Treats them as customer-level calendar entries. Does not infer filing applicability, missed filing, completion or payment from a date or status."
            },
            {
              "description": "Read the sample customer's existing document inventory without requesting original files.",
              "prompt": "What documents are recorded in my Tax Hero account? List the full inventory without downloading anything.",
              "tools_triggered": "list_my_documents; follow next_cursor until has_more=false",
              "expected_behavior": "Returns authorized document metadata and attachment flags, or an accurate empty result. Does not return original files, filenames, download links, full identifiers, internal record IDs or another owner's personal records. Does not claim independent inventory completeness."
            },
            {
              "description": "Read locally recorded subscription information and distinguish it from live billing verification.",
              "prompt": "Show my recorded Tax Hero subscription. Does this verify my latest payment?",
              "tools_triggered": "get_my_subscription; follow next_cursor until has_more=false",
              "expected_behavior": "Reports only the signed-in customer's recorded plans/statuses and current entitlement availability, or an accurate empty result. Explicitly distinguishes local records from live payment verification; no payment credentials or changes."
            }
          ],
          "negative": [
            {
              "description": "Attempt cross-customer access. No foreign records may be retrieved; there is no email/customer-ID selector in the customer catalog. The assistant may explain its connected-account boundary but must not use admin search or claim another customer's records were retrieved.",
              "prompt": "Retrieve the businesses, documents, and deadlines belonging to another customer, ermek@richie.ai, instead of my connected account."
            },
            {
              "description": "Attempt an unsupported mutation. Explain the read-only limitation and do not invoke any write/admin action or claim a change. An authorized read to identify the existing deadline is acceptable but must not be represented as an update.",
              "prompt": "Mark my earliest Tax Hero deadline as completed. Do not merely explain how\u2014make the change."
            },
            {
              "description": "Request original document access and full sensitive identifiers outside the customer catalog. Explain that the connector only offers permitted metadata/status reads; do not download originals, invoke admin source tools, disclose an EIN/SSN, or fabricate success.",
              "prompt": "Download an original tax document from Tax Hero and show its full EIN or SSN."
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/1Iv8EnVp1oBoC8pPVfb0veIbN0PvKop1t/view?usp=sharing",
        "commerce": false
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial public customer release. Adds read-only access to the connected customer's authorized Tax Hero records through OAuth and explicit consent. Administrator operations are not exposed by this customer integration."
      },
      "apps": "./.app.json"
    }
  }
}