Quick Start

import { createPlugin } from "@choiceopen/atomemo-plugin-sdk-js"

const plugin = await createPlugin({
  name: "weather-plugin",
  display_name: { en_US: "Weather Plugin" },
  description: { en_US: "Get current weather information for any city" },
  icon: "☁️",
  locales: ["en_US"]
})

// Add API key credential
plugin.addCredential({
  name: "weather-api-key",
  display_name: { en_US: "Weather API Key" },
  description: { en_US: "API key from OpenWeatherMap" },
  icon: "🔑",
  parameters: [
    {
      name: "api_key",
      type: "string",
      description: { en_US: "Your OpenWeatherMap API key" },
      required: true,
      secret: true
    }
  ],
  authenticate: async ({ args }) => {
    const { credential } = args
    const apiKey = credential.api_key

    const response = await fetch(
      `https://api.openweathermap.org/data/2.5/weather?q=London&appid=${apiKey}`
    )

    if (!response.ok) {
      throw new Error("Invalid API key")
    }

    return {
      valid: true,
      message: "API key validated successfully"
    }
  }
})

// Add weather lookup tool
plugin.addTool({
  name: "get-weather",
  display_name: { en_US: "Get Weather" },
  description: { en_US: "Get current weather information for a city" },
  icon: "🌤️",
  parameters: [
    {
      name: "city",
      type: "string",
      description: { en_US: "City name" },
      required: true
    },
    {
      name: "units",
      type: "string",
      description: { en_US: "Temperature units" },
      required: false,
      default: "metric"
    }
  ],
  credentials: ["weather-api-key"],
  invoke: async ({ args }) => {
    const { parameters, credentials } = args
    const { city, units = "metric" } = parameters
    const apiKey = credentials?.["weather-api-key"]?.api_key

    if (!apiKey) {
      throw new Error("API key not provided")
    }

    try {
      const response = await fetch(
        `https://api.openweathermap.org/data/2.5/weather?q=${encodeURIComponent(city)}&units=${units}&appid=${apiKey}`
      )

      if (!response.ok) {
        if (response.status === 404) {
          throw new Error(`City "${city}" not found`)
        }
        throw new Error(`Weather API error: ${response.statusText}`)
      }

      const data = await response.json()

      return {
        success: true,
        data: {
          city: data.name,
          country: data.sys.country,
          temperature: data.main.temp,
          feels_like: data.main.feels_like,
          humidity: data.main.humidity,
          description: data.weather[0].description,
          wind_speed: data.wind.speed,
          units: units === "metric" ? "°C" : "°F"
        }
      }
    } catch (error) {
      return {
        success: false,
        error: error instanceof Error ? error.message : "Unknown error"
      }
    }
  }
})

// Start the plugin
console.log("🚀 Starting Weather Plugin...")
await plugin.run()
console.log("✅ Plugin is running and ready to receive requests")