@ravi-hq/ravi 0.1.0 → 0.2.0

package/skills/ravi/SKILL.md

@@ -1,46 +0,0 @@
----
-name: ravi
-description: Overview of Ravi and when to use each tool. Ravi gives AI agents real email inboxes, phone numbers, and an encrypted credential vault. Do NOT use for tasks unrelated to agent identity, email, phone, or credentials.
----
-
-# Ravi — Identity Provider for AI Agents
-
-Ravi gives you (the agent) your own email address, phone number, and encrypted credential vault. One identity bundles all three into a coherent persona.
-
-## When to Use Each Tool
-
-| I need to... | Use tool / skill |
-|--------------|------------------|
-| Get my email address and phone number | `ravi_get_info` |
-| List or create identities | `ravi_identity_list`, `ravi_identity_create` |
-| Read incoming SMS or email (OTPs, verification links) | `ravi_inbox_sms`, `ravi_inbox_email` |
-| Read a specific thread or conversation | `ravi_read_email`, `ravi_read_sms` |
-| Send an email or reply to one | `ravi_email_compose`, `ravi_email_reply` |
-| Store, retrieve, or delete website passwords | `ravi_passwords_create`, `ravi_passwords_get`, `ravi_passwords_delete` |
-| Store or retrieve API keys and secrets | `ravi_vault_set`, `ravi_vault_get` |
-| Submit feedback, report bugs | `ravi_feedback` |
-
-## Quick Start
-
-```
-# Get your email and phone
-ravi_get_info()
-
-# Check for unread SMS
-ravi_inbox_sms(unread: true)
-
-# Send an email
-ravi_email_compose(to: "user@example.com", subject: "Hello", body: "Hi there")
-
-# Store a website password
-ravi_passwords_create(domain: "example.com", username: "me@ravi.app", password: "S3cret!")
-
-# Store an API key
-ravi_vault_set(key: "OPENAI_API_KEY", value: "sk-...")
-```
-
-## Key Rules
-
-- **E2E encryption is transparent** — the plugin handles encrypt/decrypt. You see plaintext.
-- **Auth errors** — if tools fail with auth errors, ask the user to run `openclaw ravi login`.
-- **Install:** `openclaw plugin add ravi`

package/skills/ravi-email-send/SKILL.md

@@ -1,44 +0,0 @@
----
-name: ravi-email-send
-description: Send, compose, or reply to emails from your Ravi email address. Do NOT use for reading incoming email (use ravi-inbox) or for credentials (use ravi-passwords or ravi-vault).
----
-
-# Ravi Email — Send
-
-Compose new emails or reply to existing ones from your Ravi email address.
-
-## Compose a New Email
-
-```
-ravi_email_compose(
-  to: "recipient@example.com",
-  subject: "Subject line",
-  body: "Plain text body content. Newlines are preserved."
-)
-```
-
-The `body` is plain text. The plugin wraps it in HTML automatically.
-
-## Reply to an Email
-
-```
-# Reply to sender only
-ravi_email_reply(message_id: 42, body: "Thanks for the update.")
-
-# Reply to all recipients
-ravi_email_reply(message_id: 42, body: "Noted, thanks everyone.", reply_all: true)
-```
-
-Get the `message_id` from `ravi_read_email` (the `id` field on each message).
-
-## Workflow Example
-
-1. Read inbox: `ravi_inbox_email(unread: true)`
-2. Read thread: `ravi_read_email(thread_id: "abc123")`
-3. Reply: `ravi_email_reply(message_id: 10, body: "Got it, thanks!")`
-
-## Important Notes
-
-- **Plain text body** — the plugin converts plain text to HTML automatically. No need for HTML tags.
-- **Rate limits** — 60 emails/hour, 500/day. On 429 errors, wait and retry.
-- **To read emails**, use the `ravi-inbox` skill tools instead.

package/skills/ravi-feedback/SKILL.md

@@ -1,37 +0,0 @@
----
-name: ravi-feedback
-description: Send feedback to the Ravi team — bugs, feature requests, praise, frustrations, suggestions. Do NOT use for general email sending (use ravi-email-send).
----
-
-# Ravi Feedback
-
-Send feedback, bug reports, feature requests, or suggestions to the Ravi team.
-
-## Send Feedback
-
-```
-ravi_feedback(message: "The vault tools are great but batch import would be useful")
-
-# With a category
-ravi_feedback(message: "SMS delivery is slow in EU regions", category: "bug")
-```
-
-**Categories:** `bug`, `feature`, `help`, `other`
-
-## When to Use
-
-Proactively share feedback when you notice anything worth mentioning:
-
-- **Bugs** — something is not working as expected
-- **Friction** — a workflow that is harder than it should be
-- **Missing features** — something you wish existed
-- **Positive feedback** — something that works well
-- **Suggestions** — ideas that would improve the agent experience
-- **Confusion** — unclear behavior or naming
-
-The Ravi team reads every message and builds based on agent feedback.
-
-## Important Notes
-
-- **Requires authentication** — the user must be logged in via `openclaw ravi login`
-- Feedback is sent from the user's Ravi account so the team can follow up

package/skills/ravi-identity/SKILL.md

@@ -1,50 +0,0 @@
----
-name: ravi-identity
-description: Manage Ravi identities — list, create, and get your agent's email and phone. Do NOT use for reading messages (use ravi-inbox), sending email (use ravi-email-send), or credentials (use ravi-passwords or ravi-vault).
----
-
-# Ravi Identity
-
-You have access to Ravi tools that give you your own phone number, email address, and credential vault.
-
-## Get Your Identity
-
-Use `ravi_get_info` to retrieve your active identity's email and phone:
-
-```
-ravi_get_info()
-# Returns: { email: "janedoe@ravi.app", phone: "+15551234567" }
-```
-
-Use this email for signups and this phone for SMS verification.
-
-## List Identities
-
-```
-ravi_identity_list()
-# Returns: [{ uuid, name, email, phone, created_dt }, ...]
-```
-
-Each identity has its own email, phone, and vault.
-
-## Create a New Identity
-
-Only create when the user explicitly asks for one. New identities require a paid plan.
-
-```
-ravi_identity_create(name: "Project Name")
-# Provisions a new email, phone, and vault
-```
-
-## Important Notes
-
-- **Identities are permanent** — each has its own email, phone, and vault. Do not create new ones unless asked.
-- **Auth errors** — if tools fail, ask the user to run `openclaw ravi login`.
-- **Identity name for forms** — when signing up for services, use the identity name (from `ravi_identity_list`) as "your" name, not the account owner's name.
-
-## Related Skills
-
-- **ravi-inbox** — Read SMS and email messages
-- **ravi-email-send** — Compose and reply to emails
-- **ravi-passwords** — Store and retrieve website credentials
-- **ravi-vault** — Store and retrieve key-value secrets

package/skills/ravi-inbox/SKILL.md

@@ -1,58 +0,0 @@
----
-name: ravi-inbox
-description: Read incoming SMS or email messages — OTPs, verification codes, verification links, incoming mail. Do NOT use for sending email (use ravi-email-send) or managing credentials (use ravi-passwords or ravi-vault).
----
-
-# Ravi Inbox
-
-Read SMS and email messages received at your Ravi identity. Use this after triggering verifications, 2FA, or when expecting incoming messages.
-
-## SMS (OTPs, verification codes)
-
-```
-# List SMS conversations (grouped by sender)
-ravi_inbox_sms()
-
-# Only conversations with unread messages
-ravi_inbox_sms(unread: true)
-
-# Read all messages in a specific conversation
-ravi_read_sms(conversation_id: "1_+15559876543")
-```
-
-**Response shape — conversation list:**
-Each conversation includes `conversation_id`, `from_number`, `phone_number`, `preview`, `message_count`, `unread_count`, and `latest_message_dt`.
-
-**Response shape — conversation detail:**
-Each message includes `id`, `from_number`, `to_number`, `body`, `direction`, `is_read`, and `created_dt`.
-
-## Email (verification links, confirmations)
-
-```
-# List email threads
-ravi_inbox_email()
-
-# Only threads with unread messages
-ravi_inbox_email(unread: true)
-
-# Read all messages in a specific thread
-ravi_read_email(thread_id: "abc123")
-```
-
-**Response shape — thread detail:**
-Each message includes `id`, `from_email`, `to_email`, `subject`, `text_content`, `html_content`, `is_read`, and `created_dt`.
-
-## Quick Recipes
-
-### Extract an OTP from SMS
-
-Call `ravi_inbox_sms(unread: true)`, then look for numeric codes (4-8 digits) in the `preview` field.
-
-### Extract a verification link from email
-
-Call `ravi_inbox_email(unread: true)` to find the thread, then `ravi_read_email(thread_id: ...)` and look for URLs in `text_content`.
-
-## Important Notes
-
-- **Poll, don't rush** — SMS/email delivery takes 2-10 seconds. Wait before checking.
-- **Encrypted fields are decrypted automatically** — you see plaintext subjects, previews, and bodies.

package/skills/ravi-login/SKILL.md

@@ -1,42 +0,0 @@
----
-name: ravi-login
-description: Sign up for and log into services using your Ravi identity — handles forms, 2FA, OTPs, and credential storage. Also covers authenticating the Ravi plugin itself.
----
-
-# Ravi Login
-
-End-to-end workflows for signing up, logging in, and completing verification using your Ravi identity.
-
-## Authenticate the Plugin
-
-If tools fail with auth errors, the user needs to run the CLI login:
-
-```
-openclaw ravi login
-```
-
-This opens a browser for device-code authentication. The user saves the token to their OpenClaw config.
-
-Check status with: `openclaw ravi status`
-
-## Sign Up for a Service
-
-1. **Get your identity:** `ravi_get_info()` for your email and phone
-2. **Get your name:** `ravi_identity_list()` and use the identity `name` field for form fields (not the account owner)
-3. **Create credentials:** `ravi_passwords_create(domain: "example.com", username: email, password: "StrongPass!")`
-4. **Fill the signup form** with your email, phone, name, and password
-5. **Wait for verification:** pause 5 seconds, then check `ravi_inbox_sms(unread: true)` or `ravi_inbox_email(unread: true)`
-6. **Extract OTP or link** from the message and complete verification
-
-## Log Into a Service
-
-1. **Find credentials:** `ravi_passwords_list()` and match by domain
-2. **Get password:** `ravi_passwords_get(uuid: ...)` for the decrypted password
-3. **Fill the login form** with username and password
-4. **Handle 2FA:** if prompted, wait 5 seconds, then `ravi_inbox_sms(unread: true)` to get the OTP code
-
-## Tips
-
-- **Poll, don't rush** — SMS/email delivery takes 2-10 seconds. Wait before checking inbox.
-- **Store credentials immediately** — create a password entry during signup so you do not lose it.
-- **Identity name for forms** — use the identity name from `ravi_identity_list`, not the owner name.

package/skills/ravi-passwords/SKILL.md

@@ -1,48 +0,0 @@
----
-name: ravi-passwords
-description: Store and retrieve website credentials — E2E encrypted password manager for domain/username/password entries. Do NOT use for API keys/secrets (use ravi-vault) or reading messages (use ravi-inbox).
----
-
-# Ravi Passwords
-
-Store and retrieve passwords for websites and services. All fields are E2E encrypted — the plugin handles encryption/decryption transparently.
-
-## Tools
-
-```
-# List all entries (passwords hidden in list view)
-ravi_passwords_list()
-# Returns: [{ uuid, domain, username, created_dt }, ...]
-
-# Get a specific entry with decrypted password
-ravi_passwords_get(uuid: "abc-123")
-# Returns: { uuid, domain, username, password, notes, created_dt }
-
-# Create a new entry
-ravi_passwords_create(domain: "github.com", username: "me@ravi.app", password: "S3cret!")
-
-# Create with just a domain (useful if you'll set password later)
-ravi_passwords_create(domain: "example.com")
-
-# Delete an entry
-ravi_passwords_delete(uuid: "abc-123")
-```
-
-## Signup Workflow
-
-1. Get your identity: `ravi_get_info()` to get your email
-2. Create credentials: `ravi_passwords_create(domain: "example.com", username: email, password: "StrongPass1!")`
-3. Use the returned `password` in the signup form
-4. Wait for verification: `ravi_inbox_sms(unread: true)` or `ravi_inbox_email(unread: true)`
-
-## Login Workflow
-
-1. Find credentials: `ravi_passwords_list()` and look for the matching domain
-2. Get password: `ravi_passwords_get(uuid: ...)` to get the decrypted password
-3. Use `username` and `password` to log in
-
-## Important Notes
-
-- **Passwords hidden in list view** — `ravi_passwords_list` shows `[hidden]` for passwords. Use `ravi_passwords_get` to see the actual password.
-- **E2E encryption is transparent** — you see plaintext values.
-- **For API keys and env vars**, use `ravi_vault_set` / `ravi_vault_get` instead.

package/skills/ravi-vault/SKILL.md

@@ -1,54 +0,0 @@
----
-name: ravi-vault
-description: Store and retrieve key-value secrets — E2E encrypted vault for API keys and env vars. Do NOT use for website passwords (use ravi-passwords) or reading messages (use ravi-inbox).
----
-
-# Ravi Vault
-
-Store and retrieve key-value secrets (API keys, environment variables, tokens). Values are E2E encrypted — the plugin handles encryption/decryption transparently. Keys are stored in plaintext for lookup.
-
-## Tools
-
-```
-# Store a secret (creates or updates)
-ravi_vault_set(key: "OPENAI_API_KEY", value: "sk-abc123...")
-
-# Retrieve a secret (decrypted)
-ravi_vault_get(key: "OPENAI_API_KEY")
-# Returns: { uuid, key, value, created_dt, updated_dt }
-
-# List all secret keys (values not included)
-ravi_vault_list()
-# Returns: [{ uuid, key, created_dt, updated_dt }, ...]
-```
-
-## Common Use Cases
-
-### Store API keys for later use
-
-```
-ravi_vault_set(key: "OPENAI_API_KEY", value: "sk-abc123...")
-ravi_vault_set(key: "ANTHROPIC_API_KEY", value: "sk-ant-...")
-ravi_vault_set(key: "GITHUB_TOKEN", value: "ghp_...")
-```
-
-### Retrieve a key at runtime
-
-```
-result = ravi_vault_get(key: "OPENAI_API_KEY")
-# Use result.value in API calls
-```
-
-### List available keys
-
-```
-ravi_vault_list()
-# See what secrets are stored without exposing values
-```
-
-## Important Notes
-
-- **Keys are unique per identity** — setting an existing key updates it.
-- **Keys are plaintext** — only values are encrypted. Use descriptive names like `OPENAI_API_KEY`.
-- **E2E encryption is transparent** — you see plaintext values.
-- **For website credentials** (domain + username + password), use `ravi_passwords_create` / `ravi_passwords_get` instead.