Build plugins for agents that run on their owners’ machines.

{
  "schemaVersion": 1,
  "id": "open-meteo",
  "name": "Open-Meteo",
  "summary": "Current weather and forecasts for a latitude and longitude.",
  "publisher": "Your verified publisher name",
  "version": "1.0.0",
  "compatibility": { "minimum": "1.0.0" },
  "kind": "HTTP_CAPABILITY",
  "capabilities": [
    {
      "name": "read_forecast",
      "title": "Read a forecast",
      "description": "Reads the current temperature and forecast for a location.",
      "category": "RESEARCH",
      "effect": "READ",
      "risk": "LOW",
      "input": { "fields": [
        { "name": "latitude", "type": "number", "required": true },
        { "name": "longitude", "type": "number", "required": true }
      ] },
      "output": { "fields": [
        { "name": "temperature", "type": "number", "from": "current.temperature_2m" }
      ] },
      "http": {
        "method": "GET",
        "url": "https://api.open-meteo.com/v1/forecast?latitude={latitude}&longitude={longitude}&current=temperature_2m",
        "hosts": ["api.open-meteo.com"],
        "timeoutMs": 10000,
        "quotaPerHour": 60
      }
    }
  ]
}

import { z } from 'zod';
import { defineCapability } from '@xbam/tools';

export const readForecast = defineCapability({
  id: 'weather.read_forecast',          // family.verb_noun
  name: 'Read a forecast',
  description: 'Current temperature for a latitude and longitude.',
  category: 'RESEARCH',
  effect: 'READ',
  risk: 'LOW',
  input: z.object({ latitude: z.number(), longitude: z.number() }).strict(),
  output: z.object({ temperature: z.number() }).strict(),
  modelCallable: true,
  timeoutMs: 10_000,
  async run(input, ctx) {
    const answer = await ask('weather_forecast', input);   // through the Toolspace, never raw fetch
    return { temperature: answer.value.temperature };
  },
});