@miranda0808/maya-codex 0.1.0

package/payload/tools/integrations/resend.md

@@ -0,0 +1,168 @@
+# Resend
+
+Developer-friendly transactional email service with modern API.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Simple REST API for sending emails |
+| MCP | ✓ | Available via Resend MCP server |
+| CLI | - | Not available |
+| SDK | ✓ | Official SDKs for Node.js, Python, Go, etc. |
+
+## Authentication
+
+- **Type**: API Key
+- **Header**: `Authorization: Bearer {api_key}`
+- **Get key**: API Keys section in Resend dashboard
+
+## Common Agent Operations
+
+### Send email
+
+```bash
+POST https://api.resend.com/emails
+
+{
+  "from": "hello@example.com",
+  "to": ["user@example.com"],
+  "subject": "Welcome!",
+  "html": "<h1>Welcome to our app!</h1>"
+}
+```
+
+### Send with React template
+
+```bash
+POST https://api.resend.com/emails
+
+{
+  "from": "hello@example.com",
+  "to": ["user@example.com"],
+  "subject": "Welcome!",
+  "react": "WelcomeEmail",
+  "props": {
+    "name": "John"
+  }
+}
+```
+
+### Get email status
+
+```bash
+GET https://api.resend.com/emails/{email_id}
+```
+
+### List emails
+
+```bash
+GET https://api.resend.com/emails
+```
+
+### Send batch emails
+
+```bash
+POST https://api.resend.com/emails/batch
+
+[
+  {
+    "from": "hello@example.com",
+    "to": ["user1@example.com"],
+    "subject": "Welcome User 1"
+  },
+  {
+    "from": "hello@example.com",
+    "to": ["user2@example.com"],
+    "subject": "Welcome User 2"
+  }
+]
+```
+
+### List domains
+
+```bash
+GET https://api.resend.com/domains
+```
+
+### Verify domain
+
+```bash
+POST https://api.resend.com/domains/{domain_id}/verify
+```
+
+## Node.js SDK
+
+### Install
+
+```bash
+npm install resend
+```
+
+### Usage
+
+```typescript
+import { Resend } from 'resend';
+
+const resend = new Resend('re_xxx');
+
+await resend.emails.send({
+  from: 'hello@example.com',
+  to: 'user@example.com',
+  subject: 'Welcome!',
+  html: '<h1>Welcome!</h1>'
+});
+```
+
+### With React Email
+
+```typescript
+import { WelcomeEmail } from './emails/welcome';
+
+await resend.emails.send({
+  from: 'hello@example.com',
+  to: 'user@example.com',
+  subject: 'Welcome!',
+  react: WelcomeEmail({ name: 'John' })
+});
+```
+
+## Email Statuses
+
+- `queued` - Email queued for delivery
+- `sent` - Email sent to recipient server
+- `delivered` - Email delivered
+- `opened` - Email opened (if tracking enabled)
+- `clicked` - Link clicked (if tracking enabled)
+- `bounced` - Email bounced
+- `complained` - Marked as spam
+
+## Webhook Events
+
+| Event | When |
+|-------|------|
+| `email.sent` | Email sent |
+| `email.delivered` | Email delivered |
+| `email.opened` | Email opened |
+| `email.clicked` | Link clicked |
+| `email.bounced` | Email bounced |
+| `email.complained` | Spam complaint |
+
+## When to Use
+
+- Sending transactional emails
+- Welcome emails, password resets
+- Receipt and notification emails
+- Developer-friendly email integration
+- React-based email templates
+
+## Rate Limits
+
+- Free: 100 emails/day, 3,000/month
+- Pro: 100 emails/second
+- Higher limits on scale plans
+
+## Relevant Skills
+
+- email-sequence
+- onboarding-cro

package/payload/tools/integrations/rewardful.md

@@ -0,0 +1,147 @@
+# Rewardful
+
+Affiliate and referral tracking for Stripe-based SaaS businesses.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API for affiliates, referrals, commissions |
+| MCP | - | Not available |
+| CLI | - | Not available |
+| SDK | - | API-only, JavaScript snippet for tracking |
+
+## Authentication
+
+- **Type**: API Key
+- **Header**: `Authorization: Bearer {api_secret}`
+- **Get key**: Settings > API in Rewardful dashboard
+
+## Common Agent Operations
+
+### List affiliates
+
+```bash
+GET https://api.getrewardful.com/v1/affiliates
+```
+
+### Get affiliate by ID
+
+```bash
+GET https://api.getrewardful.com/v1/affiliates/{affiliate_id}
+```
+
+### Search affiliate by email
+
+```bash
+GET https://api.getrewardful.com/v1/affiliates?email=affiliate@example.com
+```
+
+### Get referral by Stripe customer
+
+```bash
+GET https://api.getrewardful.com/v1/referrals?stripe_customer_id={customer_id}
+```
+
+### List referrals for affiliate
+
+```bash
+GET https://api.getrewardful.com/v1/referrals?affiliate_id={affiliate_id}
+```
+
+### Get commission details
+
+```bash
+GET https://api.getrewardful.com/v1/commissions/{commission_id}
+```
+
+### List commissions
+
+```bash
+GET https://api.getrewardful.com/v1/commissions?affiliate_id={affiliate_id}
+```
+
+### Create affiliate link
+
+```bash
+POST https://api.getrewardful.com/v1/affiliates/{affiliate_id}/links
+
+{
+  "token": "custom-link-token",
+  "url": "https://example.com/pricing"
+}
+```
+
+### Update affiliate
+
+```bash
+PUT https://api.getrewardful.com/v1/affiliates/{affiliate_id}
+
+{
+  "first_name": "John",
+  "last_name": "Doe",
+  "paypal_email": "john@example.com"
+}
+```
+
+## JavaScript Tracking
+
+### Install snippet
+
+```html
+<script>
+(function(w,r){w._rwq=r;w[r]=w[r]||function(){(w[r].q=w[r].q||[]).push(arguments)}})(window,'rewardful');
+</script>
+<script async src='https://r.wdfl.co/rw.js' data-rewardful='YOUR_API_KEY'></script>
+```
+
+### Track conversion manually
+
+```javascript
+rewardful('convert', { email: 'customer@example.com' });
+```
+
+## Webhook Events
+
+| Event | When |
+|-------|------|
+| `affiliate.created` | New affiliate signs up |
+| `affiliate.approved` | Affiliate approved |
+| `referral.created` | New referral tracked |
+| `referral.converted` | Referral becomes customer |
+| `commission.created` | Commission generated |
+| `commission.paid` | Commission paid out |
+
+## Key Objects
+
+- **Affiliate** - Partner promoting your product
+- **Referral** - Tracked visit/lead from affiliate
+- **Commission** - Earned payment for affiliate
+- **Campaign** - Program with specific terms
+- **Link** - Tracking URL for affiliate
+
+## Integration with Stripe
+
+Rewardful automatically:
+1. Tracks referral cookie when user visits via affiliate link
+2. Associates Stripe customer with referral on checkout
+3. Creates commissions when subscriptions are paid
+4. Handles recurring commissions for subscriptions
+
+## When to Use
+
+- Setting up affiliate/referral programs for SaaS
+- Tracking referral attribution from Stripe payments
+- Managing affiliate relationships
+- Processing affiliate payouts
+- Analyzing referral program performance
+
+## Rate Limits
+
+- 120 requests per minute
+- Contact support for higher limits
+
+## Relevant Skills
+
+- referral-program
+- pricing-strategy

package/payload/tools/integrations/salesforce.md

@@ -0,0 +1,150 @@
+# Salesforce
+
+Enterprise CRM platform for sales, service, and marketing.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API, SOAP API, Bulk API |
+| MCP | - | Not available |
+| CLI | ✓ | Salesforce CLI (`sf`) |
+| SDK | ✓ | JSforce, simple-salesforce, etc. |
+
+## Authentication
+
+- **Type**: OAuth 2.0 (Web Server Flow or JWT Bearer)
+- **Header**: `Authorization: Bearer {access_token}`
+- **Instance URL**: Use instance_url from auth response
+
+## Common Agent Operations
+
+### Query records (SOQL)
+
+```bash
+GET https://{instance}.salesforce.com/services/data/v59.0/query?q=SELECT+Id,Name,Email+FROM+Contact+LIMIT+10
+
+Authorization: Bearer {access_token}
+```
+
+### Get record by ID
+
+```bash
+GET https://{instance}.salesforce.com/services/data/v59.0/sobjects/Contact/{record_id}
+
+Authorization: Bearer {access_token}
+```
+
+### Create record
+
+```bash
+POST https://{instance}.salesforce.com/services/data/v59.0/sobjects/Contact
+
+{
+  "FirstName": "John",
+  "LastName": "Doe",
+  "Email": "john@example.com",
+  "AccountId": "{account_id}"
+}
+```
+
+### Update record
+
+```bash
+PATCH https://{instance}.salesforce.com/services/data/v59.0/sobjects/Contact/{record_id}
+
+{
+  "Title": "Senior Developer"
+}
+```
+
+### Search records (SOSL)
+
+```bash
+GET https://{instance}.salesforce.com/services/data/v59.0/search?q=FIND+{searchTerm}+IN+ALL+FIELDS+RETURNING+Contact(Id,Name,Email)
+
+Authorization: Bearer {access_token}
+```
+
+### Get opportunities
+
+```bash
+GET https://{instance}.salesforce.com/services/data/v59.0/query?q=SELECT+Id,Name,Amount,StageName,CloseDate+FROM+Opportunity+WHERE+IsClosed=false
+
+Authorization: Bearer {access_token}
+```
+
+### Describe object
+
+```bash
+GET https://{instance}.salesforce.com/services/data/v59.0/sobjects/Contact/describe
+
+Authorization: Bearer {access_token}
+```
+
+## CLI Commands
+
+```bash
+# Authenticate
+sf org login web
+
+# Query records
+sf data query --query "SELECT Id, Name FROM Account LIMIT 10"
+
+# Create record
+sf data create record --sobject Account --values "Name='New Account'"
+
+# Deploy metadata
+sf project deploy start
+
+# Run Apex
+sf apex run --file script.apex
+```
+
+## SOQL Examples
+
+```sql
+-- Get contacts with accounts
+SELECT Id, Name, Email, Account.Name
+FROM Contact
+WHERE Account.Industry = 'Technology'
+
+-- Get opportunities by stage
+SELECT StageName, COUNT(Id)
+FROM Opportunity
+GROUP BY StageName
+
+-- Get recent leads
+SELECT Id, Name, Company, Status
+FROM Lead
+WHERE CreatedDate = LAST_N_DAYS:30
+ORDER BY CreatedDate DESC
+```
+
+## Key Objects
+
+- **Lead** - Potential customer
+- **Contact** - Person at account
+- **Account** - Company/organization
+- **Opportunity** - Sales deal
+- **Case** - Support ticket
+- **Campaign** - Marketing campaign
+
+## When to Use
+
+- Enterprise CRM operations
+- Complex sales processes
+- Multi-object relationships
+- Custom object management
+- Marketing campaign tracking
+
+## Rate Limits
+
+- 15,000 API calls per 24 hours (Enterprise)
+- Higher limits available
+
+## Relevant Skills
+
+- email-sequence
+- analytics-tracking
+- paid-ads

package/payload/tools/integrations/savvycal.md

@@ -0,0 +1,181 @@
+# SavvyCal
+
+Scheduling platform API for managing scheduling links, events, availability slots, and webhooks.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API v1 - scheduling links, events, webhooks |
+| MCP | - | Not available |
+| CLI | ✓ | [savvycal.js](../clis/savvycal.js) |
+| SDK | - | No official SDK |
+
+## Authentication
+
+- **Type**: Bearer Token (Personal Access Token or OAuth 2.0)
+- **Header**: `Authorization: Bearer {token}`
+- **Get key**: Developer Settings in SavvyCal dashboard (create a Personal Access Token)
+
+## Common Agent Operations
+
+### Get current user
+
+```bash
+GET https://api.savvycal.com/v1/me
+```
+
+### List scheduling links
+
+```bash
+GET https://api.savvycal.com/v1/scheduling-links
+```
+
+### Get a scheduling link
+
+```bash
+GET https://api.savvycal.com/v1/scheduling-links/{id}
+```
+
+### Create a scheduling link
+
+```bash
+POST https://api.savvycal.com/v1/scheduling-links
+
+{
+  "name": "30 Minute Meeting",
+  "slug": "30min",
+  "duration_minutes": 30
+}
+```
+
+### Update a scheduling link
+
+```bash
+PATCH https://api.savvycal.com/v1/scheduling-links/{id}
+
+{
+  "name": "Updated Meeting Name"
+}
+```
+
+### Delete a scheduling link
+
+```bash
+DELETE https://api.savvycal.com/v1/scheduling-links/{id}
+```
+
+### Duplicate a scheduling link
+
+```bash
+POST https://api.savvycal.com/v1/scheduling-links/{id}/duplicate
+```
+
+### Toggle link state (active/disabled)
+
+```bash
+POST https://api.savvycal.com/v1/scheduling-links/{id}/toggle
+```
+
+### Get available time slots
+
+```bash
+GET https://api.savvycal.com/v1/scheduling-links/{id}/slots
+```
+
+### List events
+
+```bash
+GET https://api.savvycal.com/v1/events
+```
+
+### Get an event
+
+```bash
+GET https://api.savvycal.com/v1/events/{id}
+```
+
+### Create an event
+
+```bash
+POST https://api.savvycal.com/v1/events
+
+{
+  "scheduling_link_id": "{link_id}",
+  "start_at": "2024-01-20T10:00:00Z",
+  "name": "John Doe",
+  "email": "john@example.com"
+}
+```
+
+### Cancel an event
+
+```bash
+POST https://api.savvycal.com/v1/events/{id}/cancel
+```
+
+### List webhooks
+
+```bash
+GET https://api.savvycal.com/v1/webhooks
+```
+
+### Create a webhook
+
+```bash
+POST https://api.savvycal.com/v1/webhooks
+
+{
+  "url": "https://example.com/webhook",
+  "events": ["event.created", "event.canceled"]
+}
+```
+
+## Key Metrics
+
+### Scheduling Link Data
+- `id` - Unique link identifier
+- `name` - Display name
+- `slug` - URL slug
+- `duration_minutes` - Meeting duration
+- `state` - Active or disabled
+- `url` - Full scheduling URL
+
+### Event Data
+- `id` - Unique event identifier
+- `name` - Invitee name
+- `email` - Invitee email
+- `start_at` / `end_at` - Event timing
+- `status` - Event status
+- `scheduling_link` - Associated scheduling link
+
+## Parameters
+
+### List Events
+- `before` / `after` - Pagination cursors
+- `limit` - Results per page (default 20, max 100)
+
+### List Scheduling Links
+- `before` / `after` - Pagination cursors
+- `limit` - Results per page
+
+## When to Use
+
+- Managing scheduling links programmatically
+- Retrieving booked events for CRM or analytics sync
+- Checking available time slots for custom booking UIs
+- Automating scheduling link creation for campaigns
+- Monitoring booking activity via webhooks
+
+## Rate Limits
+
+- Not officially documented
+- Implement retry logic with exponential backoff
+- Monitor for HTTP 429 responses
+
+## Relevant Skills
+
+- lead-generation
+- sales-automation
+- appointment-scheduling
+- customer-onboarding