@sulala/agent 0.1.1 → 0.1.3

package/registry/news.md

@@ -0,0 +1,64 @@
+---
+name: news
+description: Fetch news and articles via the Perigon API. Use when the user asks for news, headlines, or articles on a topic.
+homepage: https://www.perigon.io
+metadata:
+  {
+    "sulala": {
+      "emoji": "📰",
+      "requires": { "bins": ["curl"], "env": ["PERIGON_API_KEY"] }
+    }
+  }
+---
+
+# News (Perigon API)
+
+Use **run_command** with `curl` to fetch articles from the Perigon API. Add `curl` to ALLOWED_BINARIES.
+
+Requires `PERIGON_API_KEY`. Set it in `.env` or in the skill config (dashboard Skills page). Config key in `skills.entries.news` is `PERIGON_API_KEY`.
+
+**IMPORTANT:** Use `binary: "sh"` and `args: ["-c", "curl ..."]` so `$PERIGON_API_KEY` expands, or pass the key in the URL when calling curl.
+
+## When to Use
+
+- "Get me the latest news"
+- "Headlines about [topic]"
+- "Find articles on [subject]"
+
+## API
+
+Base URL: `https://api.perigon.io/v1`
+
+### All articles (recent)
+
+```bash
+curl -s -X GET "https://api.perigon.io/v1/articles/all?apiKey=$PERIGON_API_KEY" -H "Content-Type: application/json"
+```
+
+### With query (topic, keyword)
+
+Append `&q=keyword` to the URL. Example:
+
+```bash
+curl -s -X GET "https://api.perigon.io/v1/articles/all?apiKey=$PERIGON_API_KEY&q=climate" -H "Content-Type: application/json"
+```
+
+### Reading key from config
+
+If `PERIGON_API_KEY` is not set in the environment, read from Sulala config:
+
+```
+CONFIG_PATH="${SULALA_CONFIG_PATH:-$HOME/.sulala/config.json}"
+PERIGON_API_KEY=$(cat "$CONFIG_PATH" 2>/dev/null | python3 -c "import sys,json; d=json.load(sys.stdin); e=d.get('skills',{}).get('entries',{}).get('news',{}); print(e.get('PERIGON_API_KEY',''))" 2>/dev/null)
+```
+
+Then use `$PERIGON_API_KEY` in the curl URL.
+
+## Response
+
+Returns JSON with an array of articles (title, description, url, source, published date, etc.). Parse with `python3 -c "import sys,json; d=json.load(sys.stdin); ..."` to summarize or filter for the user.
+
+## Notes
+
+- Get an API key at https://www.perigon.io
+- Add `api.perigon.io` to ALLOWED_CURL_HOSTS if you restrict curl by host.

package/registry/skills-registry.json

@@ -0,0 +1,40 @@
+{
+  "skills": [
+    {
+      "slug": "apple-notes",
+      "name": "apple-notes",
+      "description": "Manage Apple Notes via the memo CLI on macOS. Use when the user asks to add a note, list notes, search notes, or manage note folders.",
+      "version": "1.0.0"
+    },
+    {
+      "slug": "files",
+      "name": "files",
+      "description": "Basic file operations via run_command. Use when the user asks to list files, show file contents, search within files, or inspect directories.",
+      "version": "1.0.0"
+    },
+    {
+      "slug": "git",
+      "name": "git",
+      "description": "Basic Git operations via run_command. Use when the user asks to check status, diff, log, branch, or perform simple git commands.",
+      "version": "1.0.0"
+    },
+    {
+      "slug": "weather",
+      "name": "weather",
+      "description": "Get current weather and forecasts (no API key required). Uses Open-Meteo.",
+      "version": "1.0.0"
+    },
+    {
+      "slug": "bluesky",
+      "name": "bluesky",
+      "description": "Post to Bluesky (AT Protocol). Use when the user asks to post a tweet/thread to Bluesky, share content on Bluesky, or post news from a URL.",
+      "version": "1.0.0"
+    },
+    {
+      "slug": "news",
+      "name": "news",
+      "description": "Fetch news and articles via the Perigon API. Use when the user asks for news, headlines, or articles on a topic.",
+      "version": "1.0.0"
+    }
+  ]
+}

package/registry/weather.md

@@ -0,0 +1,32 @@
+---
+name: weather
+description: Get current weather and forecasts (no API key required).
+homepage: https://open-meteo.com/en/docs
+metadata:
+  {
+    "sulala": {
+      "emoji": "🌤️",
+      "requires": { "bins": ["curl"] }
+    }
+  }
+---
+
+# Weather
+
+Use **run_command** with `curl` to fetch weather from Open-Meteo (free, no API key). Add `curl` to ALLOWED_BINARIES.
+
+## Open-Meteo
+
+Geocoding (city → lat, lon):
+```bash
+curl -s "https://geocoding-api.open-meteo.com/v1/search?name=London&count=1"
+```
+
+Current weather (use lat, lon from geocoding):
+```bash
+curl -s "https://api.open-meteo.com/v1/forecast?latitude=51.5&longitude=-0.12&current_weather=true"
+```
+
+Returns JSON with temp, windspeed, weathercode, etc.
+
+Docs: https://open-meteo.com/en/docs