superacli 1.1.2 → 1.1.4

package/plugins/plugins.json

@@ -217,6 +217,69 @@
         "manifest_path": "plugins/nextest/plugin.json"
       }
     },
+    {
+      "name": "mysql",
+      "description": "MySQL CLI plugin with version and query wrappers plus passthrough",
+      "tags": ["mysql", "database", "sql", "passthrough"],
+      "source": {
+        "type": "bundled",
+        "manifest_path": "plugins/mysql/plugin.json"
+      }
+    },
+    {
+      "name": "mongosh",
+      "description": "mongosh CLI plugin with ping and eval wrappers plus passthrough",
+      "tags": ["mongosh", "mongodb", "mongo", "database", "passthrough"],
+      "source": {
+        "type": "bundled",
+        "manifest_path": "plugins/mongosh/plugin.json"
+      }
+    },
+    {
+      "name": "blogwatcher",
+      "description": "Hybrid BlogWatcher plugin with remote docs, safe wrappers, and passthrough",
+      "tags": ["blogwatcher", "blogs", "rss", "skills", "passthrough"],
+      "source": {
+        "type": "bundled",
+        "manifest_path": "plugins/blogwatcher/plugin.json"
+      }
+    },
+    {
+      "name": "himalaya",
+      "description": "Himalaya email CLI plugin with safe read-only wrappers and passthrough",
+      "tags": ["himalaya", "email", "imap", "smtp", "passthrough"],
+      "source": {
+        "type": "bundled",
+        "manifest_path": "plugins/himalaya/plugin.json"
+      }
+    },
+    {
+      "name": "wacli",
+      "description": "wacli WhatsApp CLI plugin with safe read-only wrappers",
+      "tags": ["wacli", "whatsapp", "messages", "chat", "contacts"],
+      "source": {
+        "type": "bundled",
+        "manifest_path": "plugins/wacli/plugin.json"
+      }
+    },
+    {
+      "name": "xurl",
+      "description": "Hybrid xurl plugin with remote docs and safe read-only X API wrappers",
+      "tags": ["xurl", "x", "twitter", "skills", "api"],
+      "source": {
+        "type": "bundled",
+        "manifest_path": "plugins/xurl/plugin.json"
+      }
+    },
+    {
+      "name": "clix",
+      "description": "Hybrid clix plugin with remote docs and safe read-only X wrappers",
+      "tags": ["clix", "x", "twitter", "skills", "agents"],
+      "source": {
+        "type": "bundled",
+        "manifest_path": "plugins/clix/plugin.json"
+      }
+    },
     {
       "name": "cline",
       "description": "Cline CLI plugin with rich non-interactive task wrappers and passthrough",

package/plugins/wacli/README.md

@@ -0,0 +1,52 @@
+# wacli Plugin Harness
+
+This plugin integrates `wacli` into dcli with safe read-only wrappers for local WhatsApp state and diagnostics.
+
+## Why This Scope
+
+`wacli` manages a personal WhatsApp session and store. The wrapped commands in this plugin are intentionally limited to read-only inspection and diagnostics.
+
+- no auth QR flow wrapper
+- no sync loop wrapper
+- no send or group mutation wrappers
+- no wildcard passthrough in v1
+
+## Prerequisites
+
+Ensure `wacli` is available on your machine:
+
+```bash
+wacli --version
+```
+
+If you use a non-default store, pass `--store /path/to/store`. The upstream default is `~/.wacli`.
+
+## Available Commands
+
+```bash
+# Version and diagnostics
+dcli wacli cli version --json
+dcli wacli doctor run --json
+dcli wacli auth status --json
+
+# Chats and messages
+dcli wacli chats list --json
+dcli wacli chats show --jid 1234567890@s.whatsapp.net --json
+dcli wacli messages list --chat 1234567890@s.whatsapp.net --limit 20 --json
+dcli wacli messages search --query meeting --limit 20 --json
+dcli wacli messages show --chat 1234567890@s.whatsapp.net --id MSG123 --json
+dcli wacli messages context --chat 1234567890@s.whatsapp.net --id MSG123 --before 3 --after 3 --json
+
+# Contacts and groups
+dcli wacli contacts search --query alice --json
+dcli wacli contacts show --jid 1234567890@s.whatsapp.net --json
+dcli wacli groups list --json
+dcli wacli groups info --jid 123456789@g.us --json
+```
+
+## Notes
+
+- Wrapped commands always request upstream `--json` output and return parsed data in the dcli envelope.
+- `wacli` stores session keys and message history under `~/.wacli` by default; treat that directory as sensitive.
+- Upstream store locking means read commands can fail if another `wacli` process already holds the same store.
+- Use upstream `wacli` directly for interactive auth, sync, send, media download, and group mutation flows.

package/plugins/wacli/plugin.json

@@ -0,0 +1,260 @@
+{
+  "name": "wacli",
+  "version": "0.1.0",
+  "description": "wacli WhatsApp CLI plugin with safe read-only wrappers",
+  "source": "https://github.com/steipete/wacli",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "wacli"
+    }
+  ],
+  "commands": [
+    {
+      "namespace": "wacli",
+      "resource": "cli",
+      "action": "version",
+      "description": "Show wacli CLI version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wacli",
+        "baseArgs": ["--version"],
+        "parseJson": false,
+        "missingDependencyHelp": "Please install wacli to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "wacli",
+      "resource": "doctor",
+      "action": "run",
+      "description": "Run wacli diagnostics as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wacli",
+        "baseArgs": ["doctor", "--json"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install wacli to use this command."
+      },
+      "args": [
+        { "name": "store", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "wacli",
+      "resource": "auth",
+      "action": "status",
+      "description": "Show authentication status as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wacli",
+        "baseArgs": ["auth", "status", "--json"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install wacli to use this command."
+      },
+      "args": [
+        { "name": "store", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "wacli",
+      "resource": "chats",
+      "action": "list",
+      "description": "List chats as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wacli",
+        "baseArgs": ["chats", "list", "--json"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install wacli to use this command."
+      },
+      "args": [
+        { "name": "store", "type": "string", "required": false },
+        { "name": "query", "type": "string", "required": false },
+        { "name": "limit", "type": "integer", "required": false }
+      ]
+    },
+    {
+      "namespace": "wacli",
+      "resource": "chats",
+      "action": "show",
+      "description": "Show a chat by JID as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wacli",
+        "baseArgs": ["chats", "show", "--json"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install wacli to use this command."
+      },
+      "args": [
+        { "name": "jid", "type": "string", "required": true },
+        { "name": "store", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "wacli",
+      "resource": "messages",
+      "action": "list",
+      "description": "List messages as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wacli",
+        "baseArgs": ["messages", "list", "--json"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install wacli to use this command."
+      },
+      "args": [
+        { "name": "store", "type": "string", "required": false },
+        { "name": "chat", "type": "string", "required": false },
+        { "name": "limit", "type": "integer", "required": false },
+        { "name": "before", "type": "string", "required": false },
+        { "name": "after", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "wacli",
+      "resource": "messages",
+      "action": "search",
+      "description": "Search messages as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wacli",
+        "baseArgs": ["messages", "search", "--json"],
+        "positionalArgs": ["query"],
+        "flagsBeforePositionals": false,
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install wacli to use this command."
+      },
+      "args": [
+        { "name": "query", "type": "string", "required": true },
+        { "name": "store", "type": "string", "required": false },
+        { "name": "chat", "type": "string", "required": false },
+        { "name": "from", "type": "string", "required": false },
+        { "name": "limit", "type": "integer", "required": false },
+        { "name": "before", "type": "string", "required": false },
+        { "name": "after", "type": "string", "required": false },
+        { "name": "type", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "wacli",
+      "resource": "messages",
+      "action": "show",
+      "description": "Show a specific message as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wacli",
+        "baseArgs": ["messages", "show", "--json"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install wacli to use this command."
+      },
+      "args": [
+        { "name": "chat", "type": "string", "required": true },
+        { "name": "id", "type": "string", "required": true },
+        { "name": "store", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "wacli",
+      "resource": "messages",
+      "action": "context",
+      "description": "Show message context as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wacli",
+        "baseArgs": ["messages", "context", "--json"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install wacli to use this command."
+      },
+      "args": [
+        { "name": "chat", "type": "string", "required": true },
+        { "name": "id", "type": "string", "required": true },
+        { "name": "before", "type": "integer", "required": false },
+        { "name": "after", "type": "integer", "required": false },
+        { "name": "store", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "wacli",
+      "resource": "contacts",
+      "action": "search",
+      "description": "Search contacts as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wacli",
+        "baseArgs": ["contacts", "search", "--json"],
+        "positionalArgs": ["query"],
+        "flagsBeforePositionals": false,
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install wacli to use this command."
+      },
+      "args": [
+        { "name": "query", "type": "string", "required": true },
+        { "name": "store", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "wacli",
+      "resource": "contacts",
+      "action": "show",
+      "description": "Show a contact by JID as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wacli",
+        "baseArgs": ["contacts", "show", "--json"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install wacli to use this command."
+      },
+      "args": [
+        { "name": "jid", "type": "string", "required": true },
+        { "name": "store", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "wacli",
+      "resource": "groups",
+      "action": "list",
+      "description": "List groups as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wacli",
+        "baseArgs": ["groups", "list", "--json"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install wacli to use this command."
+      },
+      "args": [
+        { "name": "store", "type": "string", "required": false },
+        { "name": "query", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "wacli",
+      "resource": "groups",
+      "action": "info",
+      "description": "Show group info as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wacli",
+        "baseArgs": ["groups", "info", "--json"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install wacli to use this command."
+      },
+      "args": [
+        { "name": "jid", "type": "string", "required": true },
+        { "name": "store", "type": "string", "required": false }
+      ]
+    }
+  ]
+}

package/plugins/xurl/README.md

@@ -0,0 +1,52 @@
+# xurl Plugin Harness
+
+This plugin is a hybrid harness for `xurl`: it indexes the upstream `SKILL.md` and `README.md` into the local skills catalog and exposes a curated set of safe read-only X API wrappers.
+
+## Why This Scope
+
+`xurl` can post, like, follow, upload media, manage auth state, and make arbitrary raw API requests. The wrapped commands in this plugin intentionally focus on low-risk inspection workflows.
+
+- upstream agent docs are indexed into the skills catalog
+- read-only wrappers are exposed for common account and timeline lookups
+- no wildcard passthrough in v1
+- no auth mutation, posting, social mutations, media upload, stream, or webhook wrappers
+
+## Install
+
+```bash
+supercli plugins install xurl --json
+```
+
+## Explore Indexed Skills
+
+```bash
+supercli skills list --catalog --provider xurl --json
+supercli skills get xurl:root.skill
+supercli skills get xurl:root.readme
+```
+
+## Available CLI Commands
+
+```bash
+# Wrapped status commands
+supercli xurl cli version --json
+supercli xurl auth status --json
+supercli xurl apps list --json
+
+# Wrapped read-only JSON commands
+supercli xurl account whoami --json
+supercli xurl users show --target XDevelopers --json
+supercli xurl posts show --target https://x.com/XDevelopers/status/123 --json
+supercli xurl posts search --query "from:XDevelopers" --max-results 10 --json
+supercli xurl timeline list --max-results 10 --json
+supercli xurl mentions list --max-results 10 --json
+supercli xurl social followers --of XDevelopers --max-results 20 --json
+supercli xurl social following --of XDevelopers --max-results 20 --json
+```
+
+## Notes
+
+- Wrapped JSON commands force `NO_COLOR=1` so dcli can parse upstream pretty-printed JSON reliably.
+- `~/.xurl` stores app credentials and tokens. Never paste its contents into chat or logs.
+- Use upstream `xurl` directly for OAuth setup, posting, likes, follows, DMs, media upload, raw requests, streams, and webhooks.
+- Removing the plugin also removes its registered skills provider from the local catalog.

package/plugins/xurl/plugin.json

@@ -0,0 +1,239 @@
+{
+  "name": "xurl",
+  "version": "0.1.0",
+  "description": "Hybrid xurl plugin with remote agent docs and safe read-only X API wrappers",
+  "source": "https://github.com/xdevplatform/xurl",
+  "checks": [
+    { "type": "binary", "name": "curl" },
+    { "type": "binary", "name": "xurl" }
+  ],
+  "post_install": {
+    "script": "scripts/post-install.js",
+    "runtime": "node",
+    "timeout_ms": 15000
+  },
+  "post_uninstall": {
+    "script": "scripts/post-uninstall.js",
+    "runtime": "node",
+    "timeout_ms": 15000
+  },
+  "commands": [
+    {
+      "namespace": "xurl",
+      "resource": "cli",
+      "action": "version",
+      "description": "Show xurl CLI version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "xurl",
+        "baseArgs": ["version"],
+        "parseJson": false,
+        "missingDependencyHelp": "Please install xurl to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "xurl",
+      "resource": "auth",
+      "action": "status",
+      "description": "Show xurl authentication status",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "xurl",
+        "baseArgs": ["auth", "status"],
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install xurl to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "xurl",
+      "resource": "apps",
+      "action": "list",
+      "description": "List registered xurl apps",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "xurl",
+        "baseArgs": ["auth", "apps", "list"],
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install xurl to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "xurl",
+      "resource": "account",
+      "action": "whoami",
+      "description": "Show the authenticated X account as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "xurl",
+        "baseArgs": ["whoami"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "env": { "NO_COLOR": "1" },
+        "missingDependencyHelp": "Please install xurl to use this command."
+      },
+      "args": [
+        { "name": "app", "type": "string", "required": false },
+        { "name": "auth", "type": "string", "required": false },
+        { "name": "username", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "xurl",
+      "resource": "users",
+      "action": "show",
+      "description": "Look up an X user by username as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "xurl",
+        "baseArgs": ["user"],
+        "positionalArgs": ["target"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "env": { "NO_COLOR": "1" },
+        "missingDependencyHelp": "Please install xurl to use this command."
+      },
+      "args": [
+        { "name": "target", "type": "string", "required": true },
+        { "name": "app", "type": "string", "required": false },
+        { "name": "auth", "type": "string", "required": false },
+        { "name": "username", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "xurl",
+      "resource": "posts",
+      "action": "show",
+      "description": "Read a post by ID or URL as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "xurl",
+        "baseArgs": ["read"],
+        "positionalArgs": ["target"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "env": { "NO_COLOR": "1" },
+        "missingDependencyHelp": "Please install xurl to use this command."
+      },
+      "args": [
+        { "name": "target", "type": "string", "required": true },
+        { "name": "app", "type": "string", "required": false },
+        { "name": "auth", "type": "string", "required": false },
+        { "name": "username", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "xurl",
+      "resource": "posts",
+      "action": "search",
+      "description": "Search recent posts as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "xurl",
+        "baseArgs": ["search"],
+        "positionalArgs": ["query"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "env": { "NO_COLOR": "1" },
+        "missingDependencyHelp": "Please install xurl to use this command."
+      },
+      "args": [
+        { "name": "query", "type": "string", "required": true },
+        { "name": "max-results", "type": "integer", "required": false },
+        { "name": "app", "type": "string", "required": false },
+        { "name": "auth", "type": "string", "required": false },
+        { "name": "username", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "xurl",
+      "resource": "timeline",
+      "action": "list",
+      "description": "Show the home timeline as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "xurl",
+        "baseArgs": ["timeline"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "env": { "NO_COLOR": "1" },
+        "missingDependencyHelp": "Please install xurl to use this command."
+      },
+      "args": [
+        { "name": "max-results", "type": "integer", "required": false },
+        { "name": "app", "type": "string", "required": false },
+        { "name": "auth", "type": "string", "required": false },
+        { "name": "username", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "xurl",
+      "resource": "mentions",
+      "action": "list",
+      "description": "Show mentions as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "xurl",
+        "baseArgs": ["mentions"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "env": { "NO_COLOR": "1" },
+        "missingDependencyHelp": "Please install xurl to use this command."
+      },
+      "args": [
+        { "name": "max-results", "type": "integer", "required": false },
+        { "name": "app", "type": "string", "required": false },
+        { "name": "auth", "type": "string", "required": false },
+        { "name": "username", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "xurl",
+      "resource": "social",
+      "action": "followers",
+      "description": "List followers as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "xurl",
+        "baseArgs": ["followers"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "env": { "NO_COLOR": "1" },
+        "missingDependencyHelp": "Please install xurl to use this command."
+      },
+      "args": [
+        { "name": "of", "type": "string", "required": false },
+        { "name": "max-results", "type": "integer", "required": false },
+        { "name": "app", "type": "string", "required": false },
+        { "name": "auth", "type": "string", "required": false },
+        { "name": "username", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "xurl",
+      "resource": "social",
+      "action": "following",
+      "description": "List following accounts as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "xurl",
+        "baseArgs": ["following"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "env": { "NO_COLOR": "1" },
+        "missingDependencyHelp": "Please install xurl to use this command."
+      },
+      "args": [
+        { "name": "of", "type": "string", "required": false },
+        { "name": "max-results", "type": "integer", "required": false },
+        { "name": "app", "type": "string", "required": false },
+        { "name": "auth", "type": "string", "required": false },
+        { "name": "username", "type": "string", "required": false }
+      ]
+    }
+  ]
+}