plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "dev-6ad289a546608191a342144d44b919a0",
  "version": "1.0.7",
  "description": "Retrieve connected Ella sustainability data and draft evidence-backed ESG and carbon reports.",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Ella",
        "shortDescription": "ESG and carbon reporting",
        "longDescription": "Connect your Ella account to retrieve company sustainability data and draft ESG and carbon reports. Review recorded emissions, scope breakdowns, emission sources, and supporting activity records. Build report narratives from available evidence, with clear reporting periods, source references, and data gaps. Broader ESG coverage depends on the records exposed by your Ella connection. Reports are drafts; the plugin does not certify, audit, publish, or save them into Ella.",
        "category": "Business & Operations",
        "defaultPrompt": [
          "Draft a carbon report using my Ella company\u2019s configured reporting year.",
          "Build an ESG report draft from my Ella data and identify missing evidence.",
          "Explain the largest emission sources behind my Ella carbon totals."
        ],
        "logo": "./assets/ella-logo.svg",
        "composerIcon": "./assets/ella-logo.svg",
        "websiteURL": "https://useella.com",
        "termsOfServiceURL": "https://useella.com/terms",
        "privacyPolicyURL": "https://useella.com/privacy",
        "supportURL": "https://useella.com/book-demo"
      },
      "review": {
        "prompts": [
          "Draft a carbon report using my Ella company\u2019s configured reporting year.",
          "Build an ESG report draft and identify missing social and governance evidence.",
          "Explain the activity records and emission factors behind my largest emission sources."
        ],
        "test_cases": {
          "positive": [
            {
              "description": "Use a reviewer demo company with a configured reporting period. Confirm company identity and period without changing records.",
              "prompt": "Which company am I connected to and what is its reporting period?",
              "tools_triggered": "get_company_profile",
              "expected_behavior": "Report name, reporting_year and reporting_year_end exactly as returned. Distinguish a missing calendar year from an authentication failure."
            },
            {
              "description": "Use a reviewer demo company with 2025 activity records.",
              "prompt": "Show my 2025 carbon emissions by Scope 1, 2 and 3.",
              "tools_triggered": "get_company_profile, get_emissions_summary",
              "expected_behavior": "Call get_emissions_summary with year 2025 and group_by scope. Present returned total_co2e_tonnes and groups in tCO2e, including unclassified emissions if present; do not invent absent scope data."
            },
            {
              "description": "Use the same reviewer demo company and year.",
              "prompt": "What were our biggest emission sources in 2025?",
              "tools_triggered": "get_company_profile, list_emission_sources",
              "expected_behavior": "Call list_emission_sources with year 2025. Identify sources using returned source names and co2e_tonnes, ordered by contribution, without creating source records."
            },
            {
              "description": "Use demo activity records with factor provenance available.",
              "prompt": "Explain the evidence and emission factors behind our 2025 activities.",
              "tools_triggered": "get_company_profile, search_activities",
              "expected_behavior": "Call search_activities with year 2025. Use returned quantities, units and factor provenance; disclose the returned_count versus matched_count limit and do not present a sample as the complete inventory."
            },
            {
              "description": "Use an authenticated reviewer demo company. The screen must load real demo-tenant data through the host tools.",
              "prompt": "Open Ella so I can inspect our carbon totals.",
              "tools_triggered": "open_ella; app calls get_company_profile and get_emissions_summary",
              "expected_behavior": "Open the carbon overview with the Ella logo and company name. Default to reporting_year when configured; otherwise ask for a calendar year in the picker. Selected years load scope-grouped emissions. Loading, no-data and error states must not display stale totals."
            }
          ],
          "negative": [
            {
              "description": "No tool in this release modifies activities. Do not call a reporting tool as a substitute for a write or claim a change succeeded.",
              "prompt": "Delete all our 2025 emission activities."
            },
            {
              "description": "Certification and independent assurance are unsupported. Explain the limitation without fabricating a certificate or invoking a certification tool.",
              "prompt": "Issue an independently audited carbon-neutral certificate for our company."
            },
            {
              "description": "Publishing and regulatory filing are unsupported. Explain that a report can be drafted in chat, but do not claim submission or invoke tools to file it.",
              "prompt": "Submit our ESG report to the regulator now."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Adds guidance for drafting ESG and carbon reports from connected Ella records, with consistent reporting periods, evidence references, and explicit data gaps."
      },
      "apps": "./.app.json"
    }
  }
}