@agentapps/app.open-meteo 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,79 @@
1
+ # Open-Meteo
2
+
3
+ Lets an agent look up places by name and get their weather from the free
4
+ [Open-Meteo](https://open-meteo.com/) APIs: current conditions, daily and hourly forecasts up to
5
+ 16 days, recent past days, and historical weather back to 1940. No account or API key is needed.
6
+ It calls three Open-Meteo hosts: `geocoding-api.open-meteo.com` (place search),
7
+ `api.open-meteo.com` (forecast) and `archive-api.open-meteo.com` (historical weather). All tools
8
+ are read-only.
9
+
10
+ ## Tools
11
+
12
+ | Tool | What it does | Writes? |
13
+ |---|---|---|
14
+ | `search-locations` | Find places by name or postal code; returns coordinates, country, region, time zone, population | no |
15
+ | `get-forecast` | Current conditions, daily forecast (1-16 days), optional hourly values (up to 7 days), optional recent past days (up to 92) | no |
16
+ | `get-historical-weather` | Daily values for any range of up to 366 days from 1940-01-01 to yesterday; hourly for up to 7 days | no |
17
+
18
+ All tools are `readOnlyHint: true`, `destructiveHint: false`, `idempotentHint: true`,
19
+ `openWorldHint: true`, `sensitive: false`.
20
+
21
+ Typical flow: `search-locations name:Barcelona` -> take `latitude`/`longitude` ->
22
+ `get-forecast latitude:41.38879 longitude:2.15899`.
23
+
24
+ Notes:
25
+
26
+ - Time series are columnar: `time: [...]` plus one array per variable, with a `units` object and
27
+ a `weather_description` array that translates the WMO `weather_code`.
28
+ - Variables can be chosen per call (`dailyVariables`, `hourlyVariables`, `currentVariables`,
29
+ up to 10 each) using Open-Meteo's names, for example `uv_index_max` or `snowfall_sum`. See
30
+ <https://open-meteo.com/en/docs> and <https://open-meteo.com/en/docs/historical-weather-api>.
31
+ - Results are capped at 7 days of hourly data and 366 days of daily data per call to stay under
32
+ the 50,000-character tool result limit; the tools reject larger requests before calling the
33
+ API.
34
+ - The returned `location` is the model grid cell, which can be a few km from the requested
35
+ point.
36
+ - The latest ~5 days of the historical archive come from weather-model analysis until the ERA5
37
+ reanalysis catches up, so they may be revised; `get-forecast` with `pastDays` also covers them.
38
+ - The CLI turns numeric values into numbers, so a postal code with a leading zero loses it
39
+ (`name:08001` becomes `8001`, quotes do not help). Pass the arguments as one JSON object
40
+ instead: `agentapps open-meteo tool search-locations '{"name":"08001"}'`.
41
+
42
+ ## Setup
43
+
44
+ ```bash
45
+ agentapps install app.open-meteo open-meteo
46
+ # no secrets needed
47
+ agentapps open-meteo tools
48
+ ```
49
+
50
+ No account or key is needed.
51
+
52
+ ## Terms of use
53
+
54
+ From <https://open-meteo.com/en/terms> and <https://open-meteo.com/en/licence>:
55
+
56
+ - **Non-commercial use only** on the free API: no subscriptions, ads or integration into
57
+ commercial products. Commercial use needs a paid Open-Meteo plan, which uses different hosts
58
+ (`customer-*`) and an API key; this app does not support that yet (every declared secret is
59
+ required in Agent Apps, so an optional key is not possible without forcing one on everybody).
60
+ - **Rate limits** on the free API: under 600 calls per minute, 5,000 per hour, 10,000 per day
61
+ and 300,000 per month. The app retries a short `429` once or twice and otherwise reports
62
+ `[RATE_LIMITED]`.
63
+ - **Attribution**: data are CC BY 4.0. Show a link next to the data, for example
64
+ "Weather data by Open-Meteo.com" linking to <https://open-meteo.com/>. Every result carries an
65
+ `attribution` field for this. Place search data come from GeoNames (CC BY 4.0).
66
+
67
+ ## Logos
68
+
69
+ | File | Source | Changes |
70
+ |---|---|---|
71
+ | assets/logo-mono.svg | The logo in the header of open-meteo.com: `src/lib/assets/icons/sun.svelte` in [open-meteo/open-meteo-website](https://github.com/open-meteo/open-meteo-website) (commit 3fbe71f), imported as `Logo` by `src/lib/components/header/header.svelte`. The glyph is the Bootstrap Icons "cloud-sun" icon (MIT), which Open-Meteo uses as its logo. | removed `fill="currentColor"`, `class`, `style` and the Svelte `{width}`/`{height}` props; paths unchanged |
72
+ | assets/logo.svg | not added | - |
73
+
74
+ TODO (`assets/logo.svg`): no official colour logo found that meets the rules. Searched: the
75
+ open-meteo.com home page and header (only the single-colour `currentColor` SVG above, used for
76
+ `logoMono`), `/en/terms` and `/en/licence` (no press or brand page), the
77
+ `open-meteo/open-meteo-website` repo `static/` (the coloured "om" app icon exists only as PNG,
78
+ largest `android-chrome-512x512.png`, below the 1024x1024 minimum; no SVG). Add one when an
79
+ official SVG or a 1024px PNG exists, or ask the maintainers.
package/agentapp.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "id": "app.open-meteo",
3
3
  "name": "Open-Meteo",
4
- "version": "1.0.0",
4
+ "version": "1.0.1",
5
5
  "description": "Look up places by name and get weather from the free Open-Meteo APIs (no key): current conditions, daily and hourly forecasts up to 16 days, and historical weather back to 1940. Free tier is for non-commercial use only; data are CC BY 4.0.",
6
6
  "tagline": "Weather forecasts and historical weather for any place, from Open-Meteo",
7
7
  "author": { "name": "Pablo López Torres", "email": "pablolopeztorres@gmail.com" },
package/dist/app.js CHANGED
@@ -21528,7 +21528,7 @@ class AppInstance {
21528
21528
  success: false,
21529
21529
  error: {
21530
21530
  code: ErrorCode.UNAUTHORIZED,
21531
- message: `Missing required user secret(s): ${missingSecrets.join(", ")}. ` + `Configure them for this installation before using ${this.config.id}.`
21531
+ message: `Missing required Installation secret(s): ${missingSecrets.join(", ")}. ` + `Configure them for this installation before using ${this.config.id}.`
21532
21532
  },
21533
21533
  duration: 0
21534
21534
  });
@@ -23600,7 +23600,7 @@ function registerTools(app) {
23600
23600
  var app = createApp({
23601
23601
  id: "app.open-meteo",
23602
23602
  name: "Open-Meteo",
23603
- version: "1.0.0",
23603
+ version: "1.0.1",
23604
23604
  description: "Look up places by name and get weather from the free Open-Meteo APIs (no key): current conditions, daily and hourly forecasts up to 16 days, and historical weather back to 1940. Free tier is for non-commercial use only; data are CC BY 4.0.",
23605
23605
  tagline: "Weather forecasts and historical weather for any place, from Open-Meteo",
23606
23606
  author: { name: "Pablo López Torres", email: "pablolopeztorres@gmail.com" },
package/package.json CHANGED
@@ -1,11 +1,28 @@
1
1
  {
2
2
  "name": "@agentapps/app.open-meteo",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
+ "description": "Weather forecasts and historical weather for any place, from Open-Meteo",
5
+ "license": "MIT",
6
+ "author": "Pablo López Torres <pablolopeztorres@gmail.com>",
7
+ "keywords": [
8
+ "agent-apps",
9
+ "open-meteo",
10
+ "weather",
11
+ "forecast",
12
+ "historical weather",
13
+ "geocoding",
14
+ "climate"
15
+ ],
4
16
  "type": "module",
5
17
  "main": "./dist/app.js",
6
18
  "exports": {
7
19
  ".": "./dist/app.js",
8
20
  "./agentapp.json": "./agentapp.json",
9
21
  "./package.json": "./package.json"
22
+ },
23
+ "repository": {
24
+ "type": "git",
25
+ "url": "https://github.com/agentapps/agentapps.git",
26
+ "directory": "apps/open-meteo"
10
27
  }
11
28
  }