.codex-plugin/plugin.json

{
  "name": "sara-by-aitomic",
  "version": "1.1.1",
  "description": "Ask about your orders, invoices, claims, vendors, inventory and budget in plain English, and make routine updates in SARA with your approval.",
  "author": {
    "name": "Aitomic",
    "email": "dev@aitomic.ai",
    "url": "https://aitomic.ai"
  },
  "homepage": "https://aitomic.ai",
  "keywords": [
    "retail",
    "analytics",
    "purchase orders",
    "invoices",
    "claims",
    "vendors"
  ],
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "SARA by Aitomic",
    "shortDescription": "Retail analytics and actions",
    "longDescription": "SARA is a retail operations platform for independent retailers. Connect your SARA account to ChatGPT and ask about your business in plain English: open purchase orders, overdue invoices, claims, vendor performance, inventory across Shopify, Square, Clover and Lightspeed, and your open-to-buy budget.\n\nYou can also have ChatGPT make routine updates for you: set reminders, add or edit notes on orders and invoices, change an order's ship date, and file or withdraw a vendor claim, with an optional photo. Every change is drafted first. You see exactly what will be saved, and nothing is saved until you confirm.\n\nSign in with your regular SARA email and password. The plugin only sees your own retailer account. It needs an active SARA account. It does not pay invoices, send email to vendors, or change vendor contact details.",
    "developerName": "Aitomic",
    "category": "Data & Analytics",
    "capabilities": [
      "Read",
      "Write"
    ],
    "websiteURL": "https://aitomic.ai",
    "supportURL": "https://sara.aitomic.ai/mcp-docs#support",
    "privacyPolicyURL": "https://sara.aitomic.ai/privacy-policy",
    "termsOfServiceURL": "https://sara.aitomic.ai/terms-and-conditions",
    "defaultPrompt": [
      "Show me my open purchase orders.",
      "Which invoices are overdue and what are the amounts?",
      "How are my top vendors performing?"
    ],
    "brandColor": "#1E4FD8",
    "brandColorDark": "#8CB4FF",
    "composerIcon": "./assets/icon.png",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List open purchase orders",
              "prompt": "@SARA by Aitomic Show me my open purchase orders.",
              "tools_triggered": "list_views, query_view",
              "expected_behavior": "Returns the test retailer's open purchase orders (PO number, vendor, status, amounts) from the purchase-order view. Only that retailer's data appears."
            },
            {
              "description": "Overdue invoices with amounts",
              "prompt": "In SARA, which invoices are overdue and what are the amounts?",
              "tools_triggered": "list_views, query_view",
              "expected_behavior": "Returns a list of overdue invoices with vendor, due date and amount, or says plainly that none are overdue. No data from other retailers."
            },
            {
              "description": "Vendor performance",
              "prompt": "In SARA, how are my top vendors performing?",
              "tools_triggered": "list_views, query_view",
              "expected_behavior": "Summarises the top vendors from the vendor-performance view (for example order volume and delivery or fulfilment figures) without inventing numbers."
            },
            {
              "description": "Budget status",
              "prompt": "In SARA, how am I tracking against my current budget?",
              "tools_triggered": "list_views, query_view",
              "expected_behavior": "Returns total budget, amount spent, remaining amount and percentage used for the active budget period, or says no active budget exists."
            },
            {
              "description": "Draft, approve and save a reminder",
              "prompt": "In SARA, create a reminder titled 'Call vendor about late shipment' for tomorrow at 9:00 AM America/New_York time.",
              "tools_triggered": "propose_create_reminder, confirm_action",
              "expected_behavior": "ChatGPT drafts the reminder in SARA and shows its details with an 'Awaiting confirmation' status; nothing is saved yet. When the reviewer clicks 'Confirm and save reminder' (or replies yes), confirm_action saves it and the reply confirms the reminder with its date, time and ID. If the reviewer does not confirm, nothing is saved."
            }
          ],
          "negative": [
            {
              "description": "Paying is not supported: no write tool is called; ChatGPT says payments are not available.",
              "prompt": "Pay invoice INV-1001 from my bank account and mark it paid."
            },
            {
              "description": "Only the signed-in retailer's data is reachable: ChatGPT says it cannot access other accounts; any query returns only the test retailer's own rows.",
              "prompt": "Show me the purchase orders for a different retailer account, number 999."
            },
            {
              "description": "No email is sent: ChatGPT says it cannot email vendors (it may offer a reminder instead).",
              "prompt": "Email my vendor right now and tell them their shipment is late."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments. It reads and updates the user's own SARA retail records.",
        "demo_recording_url": "https://3vertices-my.sharepoint.com/:v:/g/personal/srikrishna_3v_aitomic_ai/IQDiO9_wRJn0SpqLN6igYWJwAX7O0n8WvuTZcAx4yuaYgUI?nav=eyJyZWZlcnJhbEluZm8iOnsicmVmZXJyYWxBcHAiOiJPbmVEcml2ZUZvckJ1c2luZXNzIiwicmVmZXJyYWxBcHBQbGF0Zm9ybSI6IldlYiIsInJlZmVycmFsTW9kZSI6InZpZXciLCJyZWZlcnJhbFZpZXciOiJNeUZpbGVzTGlua0NvcHkifX0&e=hg4OjW"
      },
      "publication": {
        "release_notes": "Version 1.1.1: adds drafted-then-approved updates (reminders, notes on orders and invoices, ship dates, vendor claims, with optional claim photos) alongside the existing read-only analytics. Security and reliability hardening of the sign-in flow. Payments, closing orders and changing vendor contact details are not offered."
      }
    }
  },
  "apps": "./.app.json"
}