@marktoflow/integrations 2.0.0-alpha.7 → 2.0.0-alpha.9

package/README.md

@@ -1,5 +1,7 @@
 # @marktoflow/integrations
 
+> **Author:** Scott Glover <scottgl@gmail.com>
+
 Standard integrations for marktoflow - connect to Slack, GitHub, Jira, Gmail, and more.
 
 ## Overview
@@ -8,27 +10,48 @@ Standard integrations for marktoflow - connect to Slack, GitHub, Jira, Gmail, an
 
 ## Features
 
-### Service Integrations (11)
+### Service Integrations (30)
 
 - **Slack** - Send messages, manage channels, socket mode
+- **Microsoft Teams** - Channel messages, chats, meetings, collaboration
 - **GitHub** - Create PRs, issues, comments, manage repos
 - **Jira** - Create/update issues, transitions, search
 - **Gmail** - Send emails, read inbox, manage labels, webhook triggers
 - **Outlook** - Send emails, read calendar/inbox, webhook triggers
+- **Google Sheets** - Spreadsheet operations, read/write data
+- **Google Calendar** - Calendar events, scheduling
+- **Google Drive** - File storage and management
+- **Google Docs** - Document creation and editing
 - **Linear** - Issue tracking and project management
 - **Notion** - Database operations, page management
 - **Discord** - Bot interactions, message management
 - **Airtable** - Spreadsheet database operations
 - **Confluence** - Wiki page management
+- **Telegram** - Bot messaging and interactions
+- **WhatsApp** - Business messaging API
+- **Stripe** - Payment processing, subscriptions, invoicing
+- **Shopify** - E-commerce store management, products, orders
+- **Twilio** - SMS, voice calls, WhatsApp, phone numbers
+- **SendGrid** - Transactional email delivery
+- **Mailchimp** - Email marketing campaigns and automation
+- **Zendesk** - Customer support tickets and users
+- **Asana** - Task and project management
+- **Trello** - Kanban boards and cards
+- **Dropbox** - Cloud file storage and sharing
+- **AWS S3** - Amazon object storage
+- **Supabase** - PostgreSQL database with real-time subscriptions
+- **PostgreSQL** - Direct PostgreSQL database access
+- **MySQL** - Direct MySQL database access
 - **HTTP** - Generic HTTP requests with auth
 
-### AI Agent Adapters (4)
+### AI Agent Adapters (6)
 
 - **Ollama** - Local LLM integration
-- **Claude Code** - Anthropic Claude integration
-- **OpenCode** - OpenCode AI integration
-- **GitHub Copilot** - GitHub Copilot CLI integration
-- **GitHub Copilot** - GitHub Copilot CLI integration
+- **Claude Agent** - Anthropic Claude Agent SDK integration
+- **Claude Code** - Anthropic Claude Code CLI integration
+- **OpenAI Codex** - OpenAI Codex SDK integration
+- **OpenCode** - OpenCode AI integration (75+ backends)
+- **GitHub Copilot** - GitHub Copilot SDK integration
 
 ## Installation
 
@@ -242,6 +265,117 @@ inputs:
   body: 'Don't forget our meeting at 2pm'
 ```
 
+### Microsoft Teams
+
+Team collaboration and communication via Microsoft Graph API.
+
+**Setup**:
+
+```bash
+export TEAMS_ACCESS_TOKEN=your-access-token
+# Or use client credentials:
+export TEAMS_CLIENT_ID=your-client-id
+export TEAMS_CLIENT_SECRET=your-secret
+export TEAMS_TENANT_ID=your-tenant-id
+```
+
+**Actions**:
+
+- `listTeams` - List teams user is a member of
+- `listChannels` - List channels in a team
+- `createChannel` - Create a channel in a team
+- `sendMessage` - Send message to a channel
+- `listMessages` - List messages in a channel
+- `replyToMessage` - Reply to a message
+- `sendChatMessage` - Send message in a chat
+- `createMeeting` - Create an online meeting
+- `listTeamMembers` - List members of a team
+- `addTeamMember` - Add member to a team
+
+**Example**:
+
+```yaml
+tools:
+  teams:
+    sdk: 'teams'
+    auth:
+      access_token: '${TEAMS_ACCESS_TOKEN}'
+
+steps:
+  - action: teams.sendMessage
+    inputs:
+      teamId: '${TEAM_ID}'
+      channelId: '${CHANNEL_ID}'
+      content: 'Deployment complete!'
+      contentType: 'html'
+```
+
+### Stripe
+
+Payment processing and subscription management.
+
+**Setup**:
+
+```bash
+export STRIPE_API_KEY=sk_test_your-key
+```
+
+**Actions**:
+
+**Customers:**
+- `createCustomer` - Create a customer
+- `getCustomer` - Get customer by ID
+- `updateCustomer` - Update customer
+- `deleteCustomer` - Delete customer
+- `listCustomers` - List customers
+
+**Payment Intents:**
+- `createPaymentIntent` - Create payment intent
+- `getPaymentIntent` - Get payment intent
+- `confirmPaymentIntent` - Confirm payment
+- `cancelPaymentIntent` - Cancel payment
+
+**Subscriptions:**
+- `createSubscription` - Create subscription
+- `getSubscription` - Get subscription
+- `updateSubscription` - Update subscription
+- `cancelSubscription` - Cancel subscription
+- `listSubscriptions` - List subscriptions
+
+**Invoices:**
+- `createInvoice` - Create invoice
+- `getInvoice` - Get invoice
+- `finalizeInvoice` - Finalize invoice
+- `payInvoice` - Pay invoice
+- `sendInvoice` - Send invoice
+
+**Example**:
+
+```yaml
+tools:
+  stripe:
+    sdk: 'stripe'
+    auth:
+      api_key: '${STRIPE_API_KEY}'
+
+steps:
+  - action: stripe.createCustomer
+    inputs:
+      email: 'customer@example.com'
+      name: 'John Doe'
+      metadata:
+        source: 'workflow'
+    output_variable: customer
+
+  - action: stripe.createPaymentIntent
+    inputs:
+      amount: 2000
+      currency: 'usd'
+      customer: '{{ customer.id }}'
+      description: 'Service subscription'
+    output_variable: payment
+```
+
 ### Linear
 
 Modern issue tracking.
@@ -326,6 +460,231 @@ export CONFLUENCE_API_TOKEN=your-token
 - `updatePage` - Update page
 - `deletePage` - Delete page
 
+### Google Sheets
+
+Spreadsheet operations for Google Sheets.
+
+**Setup**:
+
+```bash
+export GOOGLE_SHEETS_CLIENT_ID=your-client-id
+export GOOGLE_SHEETS_CLIENT_SECRET=your-secret
+export GOOGLE_SHEETS_REFRESH_TOKEN=your-refresh-token
+```
+
+**Actions**:
+
+- `getSpreadsheet` - Get spreadsheet metadata
+- `getValues` - Read cell values
+- `updateValues` - Update cell values
+- `appendValues` - Append rows to sheet
+
+**Example**:
+
+```yaml
+action: google-sheets.updateValues
+inputs:
+  spreadsheetId: '1BxiMVs0XRA5...'
+  range: 'Sheet1!A1:B2'
+  values:
+    - [Name, Email]
+    - [John Doe, john@example.com]
+```
+
+### Google Calendar
+
+Calendar event management.
+
+**Setup**:
+
+```bash
+export GOOGLE_CALENDAR_CLIENT_ID=your-client-id
+export GOOGLE_CALENDAR_CLIENT_SECRET=your-secret
+export GOOGLE_CALENDAR_REFRESH_TOKEN=your-refresh-token
+```
+
+**Actions**:
+
+- `listEvents` - List calendar events
+- `createEvent` - Create calendar event
+- `updateEvent` - Update event
+- `deleteEvent` - Delete event
+
+**Example**:
+
+```yaml
+action: google-calendar.createEvent
+inputs:
+  calendarId: primary
+  summary: 'Team Meeting'
+  start:
+    dateTime: '2024-01-25T14:00:00-07:00'
+  end:
+    dateTime: '2024-01-25T15:00:00-07:00'
+```
+
+### Google Drive
+
+File storage and management.
+
+**Setup**:
+
+```bash
+export GOOGLE_DRIVE_CLIENT_ID=your-client-id
+export GOOGLE_DRIVE_CLIENT_SECRET=your-secret
+export GOOGLE_DRIVE_REFRESH_TOKEN=your-refresh-token
+```
+
+**Actions**:
+
+- `listFiles` - List files in Drive
+- `getFile` - Get file metadata
+- `uploadFile` - Upload file
+- `downloadFile` - Download file
+- `deleteFile` - Delete file
+
+### Google Docs
+
+Document creation and editing.
+
+**Setup**:
+
+```bash
+export GOOGLE_DOCS_CLIENT_ID=your-client-id
+export GOOGLE_DOCS_CLIENT_SECRET=your-secret
+export GOOGLE_DOCS_REFRESH_TOKEN=your-refresh-token
+```
+
+**Actions**:
+
+- `getDocument` - Get document content
+- `createDocument` - Create new document
+- `updateDocument` - Batch update document
+- `appendText` - Append text to document
+
+### Telegram
+
+Telegram bot messaging.
+
+**Setup**:
+
+```bash
+export TELEGRAM_BOT_TOKEN=your-bot-token
+```
+
+**Actions**:
+
+- `sendMessage` - Send message to chat
+- `sendPhoto` - Send photo
+- `sendDocument` - Send document
+- `getUpdates` - Get bot updates
+
+**Example**:
+
+```yaml
+action: telegram.sendMessage
+inputs:
+  chatId: '123456789'
+  text: 'Hello from marktoflow!'
+```
+
+### WhatsApp
+
+WhatsApp Business API messaging.
+
+**Setup**:
+
+```bash
+export WHATSAPP_PHONE_NUMBER_ID=your-phone-id
+export WHATSAPP_ACCESS_TOKEN=your-access-token
+```
+
+**Actions**:
+
+- `sendMessage` - Send text message
+- `sendTemplate` - Send message template
+- `sendMedia` - Send media (image, video, document)
+
+**Example**:
+
+```yaml
+action: whatsapp.sendMessage
+inputs:
+  to: '+1234567890'
+  text: 'Hello from marktoflow!'
+```
+
+### Supabase
+
+PostgreSQL database with real-time capabilities.
+
+**Setup**:
+
+```bash
+export SUPABASE_URL=https://your-project.supabase.co
+export SUPABASE_KEY=your-anon-key
+```
+
+**Actions**:
+
+- `select` - Query records
+- `insert` - Insert records
+- `update` - Update records
+- `delete` - Delete records
+- `rpc` - Call stored procedure
+
+**Example**:
+
+```yaml
+action: supabase.select
+inputs:
+  table: users
+  filters:
+    email: 'eq.user@example.com'
+```
+
+### PostgreSQL
+
+Direct PostgreSQL database access.
+
+**Setup**:
+
+```bash
+export POSTGRES_HOST=localhost
+export POSTGRES_PORT=5432
+export POSTGRES_USER=postgres
+export POSTGRES_PASSWORD=your-password
+export POSTGRES_DATABASE=mydb
+```
+
+**Actions**:
+
+- `query` - Execute SQL query
+- `insert` - Insert records
+- `update` - Update records
+- `delete` - Delete records
+
+### MySQL
+
+Direct MySQL database access.
+
+**Setup**:
+
+```bash
+export MYSQL_HOST=localhost
+export MYSQL_PORT=3306
+export MYSQL_USER=root
+export MYSQL_PASSWORD=your-password
+export MYSQL_DATABASE=mydb
+```
+
+**Actions**:
+
+- `query` - Execute SQL query
+- `insert` - Insert records
+- `update` - Update records
+- `delete` - Delete records
+
 ### HTTP
 
 Generic HTTP requests with authentication.
@@ -347,6 +706,273 @@ inputs:
     key: value
 ```
 
+### Twilio
+
+SMS, voice calls, WhatsApp messaging, and phone number management.
+
+**Setup**:
+
+```bash
+export TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+export TWILIO_AUTH_TOKEN=your-auth-token
+```
+
+**Actions**:
+
+- `sendSMS` - Send SMS message
+- `makeCall` - Make phone call
+- `sendWhatsApp` - Send WhatsApp message
+- `listMessages` - List sent/received messages
+- `sendVerification` - Send verification code
+
+**Example**:
+
+```yaml
+action: twilio.sendSMS
+inputs:
+  to: '+1234567890'
+  from: '+0987654321'
+  body: 'Your verification code is 123456'
+```
+
+### SendGrid
+
+Transactional email delivery service.
+
+**Setup**:
+
+```bash
+export SENDGRID_API_KEY=SG.your-api-key
+```
+
+**Actions**:
+
+- `sendEmail` - Send single email
+- `sendMultiple` - Send multiple emails
+
+**Example**:
+
+```yaml
+action: sendgrid.sendEmail
+inputs:
+  to: 'user@example.com'
+  from: 'noreply@yourapp.com'
+  subject: 'Welcome!'
+  html: '<h1>Welcome to our service!</h1>'
+```
+
+### Shopify
+
+E-commerce platform for online stores.
+
+**Setup**:
+
+```bash
+export SHOPIFY_SHOP=your-store.myshopify.com
+export SHOPIFY_ACCESS_TOKEN=shpat_your-token
+```
+
+**Actions**:
+
+- `getProducts` - List products
+- `createProduct` - Create product
+- `createOrder` - Create order
+- `createCustomer` - Create customer
+- `updateInventoryLevel` - Update inventory
+
+**Example**:
+
+```yaml
+action: shopify.createProduct
+inputs:
+  title: 'New Product'
+  body_html: '<p>Product description</p>'
+  vendor: 'Your Brand'
+  variants:
+    - price: '29.99'
+      sku: 'PROD-001'
+```
+
+### Zendesk
+
+Customer support ticketing platform.
+
+**Setup**:
+
+```bash
+export ZENDESK_SUBDOMAIN=your-company
+export ZENDESK_EMAIL=support@yourcompany.com
+export ZENDESK_TOKEN=your-api-token
+```
+
+**Actions**:
+
+- `createTicket` - Create support ticket
+- `updateTicket` - Update ticket
+- `addComment` - Add comment to ticket
+- `createUser` - Create user
+- `search` - Search tickets/users
+
+**Example**:
+
+```yaml
+action: zendesk.createTicket
+inputs:
+  subject: 'Login Issue'
+  comment:
+    body: 'User cannot log in to account'
+  priority: 'high'
+```
+
+### Mailchimp
+
+Email marketing automation platform.
+
+**Setup**:
+
+```bash
+export MAILCHIMP_API_KEY=your-api-key
+export MAILCHIMP_SERVER=us1
+```
+
+**Actions**:
+
+- `getLists` - Get mailing lists
+- `addMember` - Add member to list
+- `createCampaign` - Create email campaign
+- `sendCampaign` - Send campaign
+- `addMemberTags` - Add tags to member
+
+**Example**:
+
+```yaml
+action: mailchimp.addMember
+inputs:
+  email_address: 'user@example.com'
+  status: 'subscribed'
+  merge_fields:
+    FNAME: 'John'
+    LNAME: 'Doe'
+```
+
+### Asana
+
+Task and project management platform.
+
+**Setup**:
+
+```bash
+export ASANA_ACCESS_TOKEN=your-personal-access-token
+```
+
+**Actions**:
+
+- `createTask` - Create task
+- `updateTask` - Update task
+- `getTasksInProject` - Get project tasks
+- `createProject` - Create project
+- `addComment` - Add comment to task
+
+**Example**:
+
+```yaml
+action: asana.createTask
+inputs:
+  name: 'Implement new feature'
+  notes: 'Add user authentication'
+  projects: ['project-gid-123']
+  due_on: '2026-02-01'
+```
+
+### Trello
+
+Visual project management with boards and cards.
+
+**Setup**:
+
+```bash
+export TRELLO_API_KEY=your-api-key
+export TRELLO_TOKEN=your-token
+```
+
+**Actions**:
+
+- `createCard` - Create card
+- `updateCard` - Update card
+- `createList` - Create list
+- `addCommentToCard` - Add comment
+- `addChecklistToCard` - Add checklist
+
+**Example**:
+
+```yaml
+action: trello.createCard
+inputs:
+  name: 'New Task'
+  desc: 'Task description'
+  idList: 'list-id-123'
+  due: '2026-02-01'
+```
+
+### Dropbox
+
+Cloud file storage and collaboration.
+
+**Setup**:
+
+```bash
+export DROPBOX_ACCESS_TOKEN=your-access-token
+```
+
+**Actions**:
+
+- `uploadFile` - Upload file
+- `downloadFile` - Download file
+- `listFolder` - List folder contents
+- `createFolder` - Create folder
+- `createSharedLink` - Create shared link
+
+**Example**:
+
+```yaml
+action: dropbox.uploadFile
+inputs:
+  path: '/documents/report.pdf'
+  contents: '${file_contents}'
+  mode: 'overwrite'
+```
+
+### AWS S3
+
+Amazon Simple Storage Service for object storage.
+
+**Setup**:
+
+```bash
+export AWS_REGION=us-east-1
+export AWS_ACCESS_KEY_ID=your-access-key
+export AWS_SECRET_ACCESS_KEY=your-secret-key
+```
+
+**Actions**:
+
+- `uploadObject` - Upload object
+- `getObject` - Get object
+- `listObjects` - List bucket objects
+- `deleteObject` - Delete object
+- `createBucket` - Create bucket
+
+**Example**:
+
+```yaml
+action: aws-s3.uploadObject
+inputs:
+  bucket: 'my-bucket'
+  key: 'uploads/file.txt'
+  body: 'File contents'
+  contentType: 'text/plain'
+```
+
 ## AI Agent Adapters
 
 ### Ollama
@@ -373,24 +999,127 @@ steps:
       prompt: 'Explain quantum computing'
 ```
 
+### Claude Agent
+
+Anthropic Claude Agent SDK integration with agentic workflows.
+
+**Setup**:
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-your-key
+```
+
+**Features**:
+
+- Multi-turn conversations with memory
+- Tool calling and custom tools
+- Streaming responses
+- Extended thinking mode
+
+**Example**:
+
+```yaml
+tools:
+  claude:
+    adapter: claude-agent
+    config:
+      model: claude-3-5-sonnet-20241022
+
+steps:
+  - action: claude.send
+    inputs:
+      prompt: 'Analyze this codebase'
+      tools:
+        - name: read_file
+          description: Read file contents
+    output_variable: analysis
+```
+
 ### Claude Code
 
-Anthropic Claude integration.
+Anthropic Claude Code CLI integration.
 
 **Setup**:
 
 ```bash
+# Install Claude Code CLI
+# Follow: https://github.com/anthropics/claude-code
+
 export ANTHROPIC_API_KEY=sk-ant-your-key
 ```
 
+**Features**:
+
+- File-based context awareness
+- Native MCP server integration
+- Extended reasoning capabilities
+
+### OpenAI Codex
+
+OpenAI Codex SDK integration with workflow execution capabilities.
+
+**Setup**:
+
+```bash
+# Authenticate via Codex CLI
+# Follow OpenAI Codex documentation for setup
+```
+
+**Features**:
+
+- Code generation and analysis
+- Function calling support
+- Streaming responses
+- Sandboxed execution environment
+
+**Example**:
+
+```yaml
+tools:
+  codex:
+    adapter: openai-codex
+    config:
+      model: codex-latest
+
+steps:
+  - action: codex.complete
+    inputs:
+      prompt: 'Write a function to sort an array'
+    output_variable: code
+```
+
 ### OpenCode
 
-OpenCode AI integration.
+OpenCode AI integration supporting 75+ backends.
 
 **Setup**:
 
 ```bash
-export OPENCODE_API_KEY=your-key
+# Configure OpenCode
+opencode /connect
+```
+
+**Features**:
+
+- GitHub Copilot backend (free with subscription)
+- Ollama for local models
+- Multiple cloud providers (GPT-4, Claude, Gemini)
+- CLI and server modes
+
+**Example**:
+
+```yaml
+tools:
+  opencode:
+    adapter: opencode
+    config:
+      backend: copilot # or ollama, claude, gpt-4, etc.
+
+steps:
+  - action: opencode.complete
+    inputs:
+      prompt: 'Explain async/await in JavaScript'
+    output_variable: explanation
 ```
 
 ### GitHub Copilot