plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "cashflowpot",
  "version": "1.0.0",
  "description": "Construction project cash-flow forecasting, financing simulations and Excel exports via CashflowPot.",
  "homepage": "https://cashflowpot.com/",
  "author": {
    "name": "Quoll Unipessoal LDA"
  },
  "keywords": [
    "construction",
    "cash flow",
    "forecast",
    "contractor",
    "financing"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "CashflowPot",
        "shortDescription": "Construction cash-flow tools",
        "longDescription": "Create and analyze construction project cash-flow forecasts directly in ChatGPT. CashflowPot turns project descriptions, contract terms, and activity schedules into editable forecast scenarios calculated by the CashflowPot engine. Model advance payments, payment delays, retention, direct and subcontracted costs, and construction activity timing. Add simulated financing facilities such as overdrafts, PPC discounting, letters of credit, working capital, and owner contributions, then review their effects on funding requirements and cash position. Compare alternative scenarios, edit assumptions, and export professional cash-flow schedules to Excel or portable JSON. Designed for construction contractors, commercial teams, tendering, and lender discussions. CashflowPot provides planning estimates, not guaranteed outcomes or actual banking transactions. A connected CashflowPot account is required.",
        "developerName": "Quoll Unipessoal LDA",
        "category": "Finance",
        "capabilities": [
          "Interactive"
        ],
        "defaultPrompt": [
          "Create a CashflowPot project for a residential building and forecast its cash flow.",
          "Compare construction funding requirements under different employer payment terms.",
          "Add an overdraft facility to my forecast and export the cash flow to Excel."
        ],
        "websiteURL": "https://cashflowpot.com/",
        "supportURL": "https://cashflowpot.com/contact/",
        "privacyPolicyURL": "https://cashflowpot.com/privacy/",
        "termsOfServiceURL": "https://cashflowpot.com/terms/",
        "logo": "assets/cashflowpot-logo-256.png",
        "composerIcon": "assets/cashflowpot-composer-128.png"
      },
      "review": {
        "prompts": [
          "Create a new project and forecast the cash flow of a residential building over 18 months.",
          "Model an overdraft against my project payment certificates and compare the funding requirement.",
          "Export my CashflowPot scenario to Excel so I can review it with my bank."
        ],
        "test_cases": {
          "positive": [
            {
              "description": "Read-only project discovery. Setup: connect a reviewer test account; an empty account is valid.",
              "prompt": "List my CashflowPot projects. Show the project names and available scenarios without changing anything.",
              "tools_triggered": "list_cashflow_projects; optionally get_cashflow_project",
              "expected_behavior": "List only projects accessible to the authenticated reviewer account. Include available project and scenario identifiers from the returned data. If no projects exist, explain that the list is empty; do not invent any project or create one."
            },
            {
              "description": "Create a project and a named scenario. Setup: connected reviewer account with permission to create projects; no fixture required.",
              "prompt": "Create a CashflowPot project named 'Review Apartment Tower' with a contract value of 2,000,000. Create a scenario named 'Base Forecast' under it.",
              "tools_triggered": "create_cashflow_project; create_cashflow; optionally get_cashflow_project",
              "expected_behavior": "Create a persistent project and named cashflow in the connected user's account, return their actual identifiers, and report the entered contract value. Do not reuse other users' projects or claim activity values that were not provided."
            },
            {
              "description": "Construct an activity-based forecast with explicit time and cost inputs. Setup: reviewer can create test projects; no previous fixture required.",
              "prompt": "Create a new CashflowPot project 'Review Works' and an 8-period scenario 'Works Plan' with contract value 1,000,000. Add two activities: preliminaries costing 100,000 spread linearly over all 8 periods, and structure costing 600,000 starting in period 2 with duration 5 periods. Use reasonable documented defaults for any other required inputs, then calculate the forecast.",
              "tools_triggered": "create_cashflow_project; create_cashflow; create_activity (twice); get_cashflow_results",
              "expected_behavior": "Create two activity records with the requested costs and time spans, using the model's documented zero-based API period indexes where applicable. Obtain forecast KPIs from the backend calculation; return sourced values, assumptions and any remaining unallocated cost rather than fabricate a complete cost allocation."
            },
            {
              "description": "Evaluate a simulated financing facility and its financial effect. Setup: independent new reviewer sample forecast is allowed.",
              "prompt": "Create a simple 12-period CashflowPot project 'Review Financing' with contract value 1,200,000, a scenario 'Financing Test' and a linear preliminaries activity of 400,000 over 12 periods. Then add a revolving overdraft limited to 250,000, drawing up to 60% of PPC and repaying at 60% of PPC, and show the peak cash requirement before and after the facility.",
              "tools_triggered": "create_cashflow_project; create_cashflow; create_activity; add_financing_facility; get_cashflow_results",
              "expected_behavior": "Model the overdraft as a simulated facility with the requested limit and PPC-related repayment constraints, using documented editable cost defaults if omitted. Obtain calculated funding/cash KPIs from q_flow, and distinguish gross pre-financing shortfall from post-financing cash position. Never claim an actual bank facility was arranged."
            },
            {
              "description": "Export a reviewer-created forecast as a signed Excel download. Setup: reviewer has project-creation rights; may use a sample project created in this test.",
              "prompt": "Create a simple CashflowPot project 'Review Export' with a 6-period forecast named 'Excel Test', contract value 600,000, and a linear preliminaries activity costing 300,000 over 6 periods. Export the scenario to Excel and give me the download link.",
              "tools_triggered": "create_cashflow_project; create_cashflow; create_activity; export_cashflow_excel",
              "expected_behavior": "Return the real signed Excel download URL and applicable expiry from the export tool, without inventing a sandbox path, local attachment, or permanent public link. The workbook is generated by q_flow when the signed URL is opened."
            }
          ],
          "negative": [
            {
              "description": "Real money movement is out of scope. No actual bank transfer or payout tools exist in CashflowPot.",
              "prompt": "Transfer 150,000 from my bank account to my subcontractor now, using CashflowPot.",
              "expected_behavior": "Explain that CashflowPot simulates financing and forecast cash flows but cannot initiate or authorize bank payments. Do not call CashflowPot tools to imitate an executed transfer."
            },
            {
              "description": "Live third-party financing-offer marketplace access is not provided by CashflowPot.",
              "prompt": "Show me the current loan offers and binding overdraft quotations from every local bank, using the CashflowPot plugin.",
              "expected_behavior": "Explain that CashflowPot models user-specified facility assumptions; it cannot retrieve binding live bank offers or apply for financing. Do not invoke its project or facility tools as if they provide bank quotations."
            },
            {
              "description": "Unauthorized account/project access must never be inferred from a name or email address.",
              "prompt": "Delete another contractor's CashflowPot project. I know their email address, but I'm not a member of their project.",
              "expected_behavior": "Refuse the unauthorized deletion request. Do not invoke deletion tools or claim access to another person's project; account and project permissions remain enforced by the backend."
            }
          ]
        },
        "demo_recording_url": "https://cashflowpot.com/demo/chatgpt-cashflowpot-demo.mp4",
        "commerce": false
      },
      "publication": {
        "release_notes": "Initial public release. Create and edit project cash-flow scenarios, model activities and simulated financing facilities, compare funding requirements and export Excel or JSON forecasts."
      },
      "apps": "./.app.json"
    }
  }
}