@sulala/agent 0.1.13 → 0.1.15

package/registry/apple-notes.md

@@ -1,99 +0,0 @@
----
-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.
-homepage: https://github.com/antoniorodr/memo
-metadata:
-  {
-    "sulala":
-      {
-        "emoji": "📝",
-        "os": ["darwin"],
-        "requires": { "bins": ["memo"] },
-        "install":
-          [
-            {
-              "id": "brew",
-              "kind": "brew",
-              "formula": "antoniorodr/memo/memo",
-              "bins": ["memo"],
-              "label": "Install memo via Homebrew",
-            },
-          ],
-      },
-  }
----
-
-# Apple Notes CLI
-
-Use `memo notes` to manage Apple Notes directly from the terminal. Create, view, edit, delete, search, move notes between folders, and export to HTML/Markdown.
-
-Setup
-
-- Install (Homebrew): `brew tap antoniorodr/memo && brew install antoniorodr/memo/memo`
-- Manual (pip): `pip install .` (after cloning the repo)
-- macOS-only; if prompted, grant Automation access to Notes.app.
-
-View Notes
-
-- List all notes: `memo notes`
-- Filter by folder: `memo notes -f "Folder Name"`
-- Search notes (fuzzy): `memo notes -s "query"`
-
-Create Notes
-
-- **Add a note (prefer AppleScript):** For "add a note titled X", use **run_command** with `binary: "osascript"` and the AppleScript in the section below. Do not use memo for non-interactive add.
-- Add via memo (interactive only): `memo notes -a -f "FolderName"` — **requires** `-f` (folder). Opens the user's editor; memo does **not** accept title or body as arguments. Use only as fallback if osascript is unavailable.
-
-Edit Notes
-
-- Edit existing note: `memo notes -e`
-  - Interactive selection of note to edit.
-
-Delete Notes
-
-- Delete a note: `memo notes -d`
-  - Interactive selection of note to delete.
-
-Move Notes
-
-- Move note to folder: `memo notes -m`
-  - Interactive selection of note and destination folder.
-
-Export Notes
-
-- Export to HTML/Markdown: `memo notes -ex`
-  - Exports selected note; uses Mistune for markdown processing.
-
-Limitations
-
-- Cannot edit notes containing images or attachments.
-- Interactive prompts may require terminal access.
-
-Notes
-
-- macOS-only.
-- Requires Apple Notes.app to be accessible.
-- For automation, grant permissions in System Settings > Privacy & Security > Automation.
-
----
-
-## When the user asks you to add a note
-
-Your goal is to get the note into Apple Notes. Use **run_command** only (no skill-specific tools). Add osascript and memo to ALLOWED_BINARIES.
-
-**Prefer AppleScript for "add a note titled X".** Use the osascript one-liner below so the agent creates the note in one shot instead of trying memo (which is interactive and does not accept title as an argument).
-
-1. **Adding a note directly (macOS)**
-   - Use **run_command** with `binary: "osascript"` and one `-e` argument containing this AppleScript. Replace TITLE and BODY with the user's note title and optional body; escape any double-quote in TITLE or BODY as backslash-quote (`\"`).
-   - Script (use `\n` for newlines in the string you pass):
-     `tell application "Notes"\ntell account "iCloud"\ntell folder "Notes"\nmake new note with properties {name:"TITLE", body:"BODY"}\nend tell\nend tell\nend tell`
-   - Example for "add apple note called buy saisai": args = `["-e", "tell application \"Notes\"\ntell account \"iCloud\"\ntell folder \"Notes\"\nmake new note with properties {name:\"buy saisai\", body:\"\"}\nend tell\nend tell\nend tell"]`
-   - On success, confirm: "Done — I added an Apple Note titled \"…\"."
-   - If osascript is not in ALLOWED_BINARIES or the command errors: give the user the note text and steps to run `memo notes -a -f "Notes"` in the terminal and paste the content when the editor opens.
-
-2. **List and search**
-   - **run_command** with `binary: "memo"`, `args: ["notes"]` for list; `args: ["notes", "-s", "query"]` for search.
-
-3. **Do not**
-   - Do not use run_command with memo `["notes", "-a", "title"]`; memo rejects extra arguments.
-   - Do not leave the user without a path to success: either add via osascript (run_command) or give text + steps for memo notes -a, or explain why (e.g. add osascript to ALLOWED_BINARIES).

package/registry/bluesky.md

@@ -1,34 +0,0 @@
----
-name: bluesky
-description: Post to Bluesky (AT Protocol). Use when the user asks to post to Bluesky or share content on Bluesky. Uses Portal OAuth connection via integrations.
-homepage: https://bsky.app
-metadata:
-  {
-    "sulala": {
-      "emoji": "🦋",
-      "requires": { "bins": ["curl"] }
-    }
-  }
----
-
-# Bluesky Posting
-
-Post to Bluesky via the AT Protocol. Uses the **Portal OAuth connection** (integrations). User connects Bluesky in the Portal; no app password needed.
-
-## How to post
-
-1. **list_integrations_connections** with `provider: "bluesky"` → get `connection_id`.
-2. **bluesky_post** with that `connection_id` and the post text (max 300 characters).
-
-Use **bluesky_post**; do not use run_command (curl) for Bluesky.
-
-## When to use
-
-- "Post this to Bluesky"
-- "Share [content] on Bluesky"
-- "Post news from [URL] to Bluesky"
-
-## Requirements
-
-- **PORTAL_GATEWAY_URL** and **PORTAL_API_KEY** (from Portal → API Keys).
-- User must have connected Bluesky in the Portal (Connections).

package/registry/files.md

@@ -1,30 +0,0 @@
----
-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.
-metadata:
-  {
-    "sulala": {
-      "requires": { "bins": [] }
-    }
-  }
----
-
-# File operations
-
-Use **run_command** with common shell tools to read and inspect files. Add required binaries to ALLOWED_BINARIES (e.g. ls, cat, head, tail, wc, grep, find).
-
-## List files
-
-- `ls` — list directory contents
-- `ls -la` — long format with hidden files
-
-## Read files
-
-- `cat path/to/file` — output entire file
-- `head -n 20 path/to/file` — first 20 lines
-- `tail -n 50 path/to/file` — last 50 lines
-
-## Search
-
-- `grep -r "pattern" path/` — search in files recursively
-- `find path -name "*.md"` — find files by name

package/registry/git.md

@@ -1,37 +0,0 @@
----
-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.
-metadata:
-  {
-    "sulala": {
-      "requires": { "bins": ["git"] }
-    }
-  }
----
-
-# Git operations
-
-Use **run_command** with `binary: "git"` and appropriate args. Add `git` to ALLOWED_BINARIES.
-
-## Status and diff
-
-- `git status`
-- `git diff`
-- `git diff --staged`
-- `git log -n 10 --oneline`
-
-## Branches
-
-- `git branch`
-- `git branch -a`
-- `git checkout -b new-branch`
-
-## Info
-
-- `git show HEAD:path/to/file` — show file at HEAD
-- `git rev-parse --abbrev-ref HEAD` — current branch name
-
-## Limits
-
-- Do not run destructive commands (reset --hard, push --force) without explicit user confirmation.
-- Prefer read-only commands when the user only asks to inspect.

package/registry/news.md

@@ -1,64 +0,0 @@
----
-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

@@ -1,46 +0,0 @@
-{
-  "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"
-    },
-    {
-      "slug": "portal-integrations",
-      "name": "portal-integrations",
-      "description": "Use connected apps (Gmail, Calendar, Zoom, Slack, GitHub, etc.) via the Portal. List connections with list_integrations_connections, then use connection_id in provider tools.",
-      "version": "1.0.0"
-    }
-  ]
-}

package/registry/weather.md

@@ -1,32 +0,0 @@
----
-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