hachathon-1.vercel.app

{
  "name": "generate_campaign_brief",
  "kind": "act",
  "impl": "imperative",
  "description": "Generate a structured marketing campaign brief. Call this FIRST when creating a new campaign. Returns campaign name, industry, objectives, key messages, and timeline.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "description": {
        "type": "string",
        "description": "Natural language description of the campaign goal (e.g. \"Launch a luxury fashion brand targeting Gen Z in New York\")"
      },
      "industry": {
        "type": "string",
        "enum": [
          "beauty",
          "fashion",
          "food",
          "technology",
          "education",
          "health",
          "finance",
          "travel",
          "entertainment",
          "ecommerce",
          "realestate",
          "automotive",
          "general"
        ],
        "description": "Industry sector for the campaign"
      }
    },
    "required": [
      "description"
    ]
  }
}

{
  "name": "set_target_audience",
  "kind": "act",
  "impl": "imperative",
  "description": "Configure the target audience for the campaign. Updates the audience panel on the dashboard in real-time with demographics and estimated reach.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "age_range": {
        "type": "string",
        "description": "Target age range, e.g. \"25-40\" or \"18-30\""
      },
      "gender": {
        "type": "string",
        "enum": [
          "male",
          "female",
          "all"
        ],
        "description": "Target gender"
      },
      "location": {
        "type": "string",
        "description": "Target geographic location (e.g. \"New York, USA\" or \"Global\")"
      },
      "interests": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Audience interests like [\"beauty\", \"fashion\", \"tech\"]"
      },
      "language": {
        "type": "string",
        "description": "Primary language: english, french, spanish, arabic, etc."
      }
    },
    "required": [
      "age_range",
      "location"
    ]
  }
}

{
  "name": "generate_ad_copy",
  "kind": "act",
  "impl": "imperative",
  "description": "Generate ad copy for a specific platform. Returns headline, body text, and CTA. Call this multiple times for different platforms. The human can edit the copy on the dashboard after generation.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "platform": {
        "type": "string",
        "enum": [
          "instagram",
          "facebook",
          "google",
          "tiktok",
          "twitter",
          "linkedin",
          "snapchat"
        ],
        "description": "Target advertising platform"
      },
      "tone": {
        "type": "string",
        "enum": [
          "professional",
          "casual",
          "luxury",
          "playful",
          "urgent",
          "corporate"
        ],
        "description": "Desired tone of the ad copy"
      },
      "product_name": {
        "type": "string",
        "description": "Name of the product or brand being advertised"
      },
      "key_benefits": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Key selling points, e.g. [\"Free shipping\", \"Premium quality\"]"
      },
      "headline": {
        "type": "string",
        "description": "Optional: provide your own headline instead of generating one"
      },
      "body": {
        "type": "string",
        "description": "Optional: provide your own body text instead of generating one"
      },
      "cta": {
        "type": "string",
        "description": "Optional: custom call-to-action text"
      }
    },
    "required": [
      "platform",
      "product_name"
    ]
  }
}

{
  "name": "allocate_budget",
  "kind": "act",
  "impl": "imperative",
  "description": "Allocate campaign budget across platforms. Returns breakdown with estimated reach and CPC per platform. The human can then adjust allocations using interactive sliders on the dashboard — changes auto-update performance projections.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "total_budget": {
        "type": "number",
        "description": "Total campaign budget (e.g. 10000)"
      },
      "currency": {
        "type": "string",
        "description": "Currency code: USD, EUR, GBP, MAD, INR, JPY, etc."
      },
      "platform_distribution": {
        "type": "object",
        "description": "Explicit platform budget split as { \"instagram\": 40, \"facebook\": 30, \"google\": 30 } where values are percentages",
        "additionalProperties": {
          "type": "number"
        }
      },
      "platforms": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Platforms to distribute budget across (used if platform_distribution is not provided)"
      },
      "optimization_goal": {
        "type": "string",
        "enum": [
          "reach",
          "clicks",
          "conversions",
          "engagement"
        ],
        "description": "What to optimize the budget for"
      }
    },
    "required": [
      "total_budget",
      "currency"
    ]
  }
}

{
  "name": "schedule_campaign",
  "kind": "act",
  "impl": "imperative",
  "description": "Set the campaign timeline with start/end dates, posting frequency, and peak hours. Creates a visual timeline on the dashboard.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "start_date": {
        "type": "string",
        "description": "Start date in YYYY-MM-DD format"
      },
      "end_date": {
        "type": "string",
        "description": "End date in YYYY-MM-DD format"
      },
      "posting_frequency": {
        "type": "string",
        "enum": [
          "daily",
          "every_other_day",
          "weekly",
          "twice_daily"
        ],
        "description": "How often to post"
      },
      "peak_hours": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Best posting hours, e.g. [\"09:00\", \"18:00\", \"21:00\"]"
      }
    },
    "required": [
      "start_date",
      "end_date"
    ]
  }
}

{
  "name": "preview_campaign",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get a full summary of the current campaign state. Returns all configured data (brief, audience, ads, budget, schedule) and readiness status. Use to review before launching.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "format": {
        "type": "string",
        "enum": [
          "summary",
          "detailed",
          "export"
        ],
        "description": "Output detail level"
      }
    }
  }
}

{
  "name": "analyze_performance",
  "kind": "act",
  "impl": "imperative",
  "description": "Analyze and project campaign performance. Returns KPIs (reach, engagement, conversions, ROI), 4-week trend projections, and optimization recommendations. Uses current campaign data and budget.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "metric": {
        "type": "string",
        "enum": [
          "reach",
          "engagement",
          "conversions",
          "roi"
        ],
        "description": "Primary metric to focus the analysis on"
      },
      "compare_to": {
        "type": "string",
        "enum": [
          "previous_period",
          "industry_average"
        ],
        "description": "Comparison baseline for benchmarking"
      },
      "recommendations_count": {
        "type": "number",
        "description": "Number of optimization recommendations to generate (default: 4)"
      }
    }
  }
}