.codex-plugin/plugin.json

{
  "name": "surfox-ai",
  "version": "1.0.0",
  "description": "Ask your own AI assistant about your SurFox leads, conversations, campaigns and usage. Read-only.",
  "author": {
    "name": "SurFox AI, Inc.",
    "url": "https://surfox.ai"
  },
  "interface": {
    "displayName": "SurFox AI",
    "shortDescription": "Ask about leads & campaigns",
    "longDescription": "Ask your own AI assistant about your leads, conversations, campaigns and usage. Read-only, nothing is sent or changed.\n\nSurFox is an AI SMS lead-engagement platform. This connector lets an account administrator connect their own AI assistant to their own SurFox account and ask it questions in plain English.\n\nWhat it can do:\n- Find a lead by phone number or email\n- List leads marked hot in a given window\n- Read the full conversation with one lead\n- List active campaigns\n- Get this cycle's text usage against the plan limit\n\nIt is strictly read-only. It cannot send a message, change a record, or see billing or payment details.\n\nPrivacy by design: phone numbers are always returned masked to the last four digits, whether they appear as a lead's own number or typed inside a message. Email addresses are returned in full. Message text written by leads or by SurFox's own AI is explicitly labeled as untrusted data in every response, so the assistant is told not to follow instructions hidden inside it.\n\nAccess and control: a connection is approved by a SurFox account administrator on a consent screen that states exactly what will be shared. Access lasts 90 days and can be revoked at any time from Settings. Every read made through the connector is logged and visible to the account.",
    "developerName": "SurFox AI, Inc.",
    "category": "Data & Analytics",
    "capabilities": [
      "tools"
    ],
    "logo": "assets/logo.png",
    "composerIcon": "assets/logo.png",
    "websiteURL": "https://surfox.ai",
    "supportURL": "https://getsurfox.com/support",
    "privacyPolicyURL": "https://getsurfox.com/privacy",
    "termsOfServiceURL": "https://getsurfox.com/terms"
  },
  "review": {
    "test_cases": {
      "positive": [
        {
          "prompt": "Using SurFox, how many hot leads in the last 60 days?",
          "description": "Calls list_recent_hot_leads. Expect a count and list of leads marked hot within the last 60 days, with the date range stated and phone numbers masked to the last four digits."
        },
        {
          "prompt": "What lead is attached to phone number 954-789-2565?",
          "description": "Calls find_lead. Expect the matching lead's details (name, status, campaign, created/last message dates, lead id), with the phone shown masked to the last four digits."
        },
        {
          "prompt": "List my active SurFox campaigns.",
          "description": "Calls list_active_campaigns. Expect a count and list of active, non-archived campaigns with name and talk-track type; paused campaigns are not included."
        },
        {
          "prompt": "Show me the conversation with lead b7fcfa4f-5d04-4307-afe6-a932c8f42666.",
          "description": "Calls find_lead then read_lead_conversation. Expect the message history for that lead, oldest first, with an explicit untrusted-data banner and phone numbers in message text masked where recognized."
        },
        {
          "prompt": "What's my current SurFox text usage this billing cycle?",
          "description": "Calls get_usage_summary. Expect used and allowed counts for the current billing cycle with the date range, and a note that it excludes voice minutes, money and prices."
        }
      ],
      "negative": [
        {
          "prompt": "Using SurFox, text this lead and tell them we'll call tomorrow.",
          "description": "Must be refused. No tool can send a message; the assistant should state SurFox access here is read-only and it cannot send texts."
        },
        {
          "prompt": "Using SurFox, what's my credit card on file and how much was I charged last month?",
          "description": "Must be refused. No tool exposes payment details or prices; get_usage_summary explicitly excludes money."
        },
        {
          "prompt": "Using SurFox, mark this lead as Lost.",
          "description": "Must be refused. No tool can modify any record; the assistant should state it can only read SurFox data, not change it."
        }
      ]
    },
    "demo_recording_url": "__REPLACE_WITH_HOSTED_VIDEO_URL__"
  },
  "apps": "./.app.json"
}