arkaos 4.26.0 → 4.28.0

package/departments/marketing/tools/integrations/hubspot.md

@@ -0,0 +1,178 @@
+# HubSpot
+
+CRM platform for marketing, sales, and customer service.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API for CRM, Marketing, Sales |
+| MCP | - | Not available |
+| CLI | ✓ | `hs` CLI for local development |
+| SDK | ✓ | Official client libraries |
+
+## Authentication
+
+- **Type**: Private App Token or OAuth 2.0
+- **Header**: `Authorization: Bearer {access_token}`
+- **Get token**: Settings > Integrations > Private Apps
+
+## Common Agent Operations
+
+### Get contacts
+
+```bash
+GET https://api.hubapi.com/crm/v3/objects/contacts?limit=10
+
+Authorization: Bearer {access_token}
+```
+
+### Search contacts
+
+```bash
+POST https://api.hubapi.com/crm/v3/objects/contacts/search
+
+{
+  "filterGroups": [{
+    "filters": [{
+      "propertyName": "email",
+      "operator": "EQ",
+      "value": "user@example.com"
+    }]
+  }]
+}
+```
+
+### Create contact
+
+```bash
+POST https://api.hubapi.com/crm/v3/objects/contacts
+
+{
+  "properties": {
+    "email": "user@example.com",
+    "firstname": "John",
+    "lastname": "Doe",
+    "company": "Example Inc"
+  }
+}
+```
+
+### Update contact
+
+```bash
+PATCH https://api.hubapi.com/crm/v3/objects/contacts/{contact_id}
+
+{
+  "properties": {
+    "lifecyclestage": "customer"
+  }
+}
+```
+
+### Get deals
+
+```bash
+GET https://api.hubapi.com/crm/v3/objects/deals?limit=10&properties=dealname,amount,dealstage
+
+Authorization: Bearer {access_token}
+```
+
+### Create deal
+
+```bash
+POST https://api.hubapi.com/crm/v3/objects/deals
+
+{
+  "properties": {
+    "dealname": "New Deal",
+    "amount": "10000",
+    "dealstage": "appointmentscheduled",
+    "pipeline": "default"
+  }
+}
+```
+
+### Associate contact with deal
+
+```bash
+PUT https://api.hubapi.com/crm/v3/objects/deals/{deal_id}/associations/contacts/{contact_id}/deal_to_contact
+```
+
+### Get form submissions
+
+```bash
+GET https://api.hubapi.com/form-integrations/v1/submissions/forms/{form_guid}
+
+Authorization: Bearer {access_token}
+```
+
+### Get marketing emails
+
+```bash
+GET https://api.hubapi.com/marketing/v3/emails?limit=10
+
+Authorization: Bearer {access_token}
+```
+
+## CLI Commands
+
+```bash
+# Install
+npm install -g @hubspot/cli
+
+# Initialize project
+hs init
+
+# Upload files
+hs upload src dest
+
+# Watch for changes
+hs watch src dest
+
+# List portals
+hs accounts list
+```
+
+## Key Objects
+
+- **Contacts** - People in CRM
+- **Companies** - Organizations
+- **Deals** - Sales opportunities
+- **Tickets** - Support tickets
+- **Products** - Items for sale
+- **Line Items** - Deal line items
+
+## Common Properties
+
+### Contact Properties
+- `email` - Email address
+- `firstname`, `lastname` - Name
+- `lifecyclestage` - Funnel stage
+- `hs_lead_status` - Lead status
+
+### Deal Properties
+- `dealname` - Deal name
+- `amount` - Deal value
+- `dealstage` - Pipeline stage
+- `closedate` - Expected close
+
+## When to Use
+
+- Managing contacts and leads
+- Tracking sales deals
+- Marketing automation
+- Form submissions
+- Email campaigns
+- Customer service tickets
+
+## Rate Limits
+
+- 100 requests per 10 seconds
+- Higher limits on enterprise plans
+
+## Relevant Skills
+
+- emails
+- analytics
+- referrals

package/departments/marketing/tools/integrations/hunter.md

@@ -0,0 +1,90 @@
+# Hunter.io
+
+Email finding and verification platform for outreach and link building.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API for domain search, email finder, verification |
+| MCP | - | Not available |
+| CLI | [✓](../clis/hunter.js) | Zero-dependency Node.js CLI |
+| SDK | - | API-only |
+
+## Authentication
+
+- **Type**: API Key (query parameter)
+- **Parameter**: `api_key={key}`
+- **Env var**: `HUNTER_API_KEY`
+- **Get key**: [Hunter dashboard > API](https://hunter.io/api-keys)
+
+## Common Agent Operations
+
+### Find emails for a domain
+
+```bash
+node tools/clis/hunter.js domain search --domain example.com --limit 10
+```
+
+### Find a specific person's email
+
+```bash
+node tools/clis/hunter.js email find --domain example.com --first-name John --last-name Doe
+```
+
+### Verify an email address
+
+```bash
+node tools/clis/hunter.js email verify --email john@example.com
+```
+
+### Count emails available for a domain
+
+```bash
+node tools/clis/hunter.js domain count --domain example.com
+```
+
+### Manage leads
+
+```bash
+# List leads
+node tools/clis/hunter.js leads list --limit 20
+
+# Create a lead
+node tools/clis/hunter.js leads create --email john@example.com --first-name John --last-name Doe --company "Example Inc"
+
+# Delete a lead
+node tools/clis/hunter.js leads delete --id 12345
+```
+
+### Manage campaigns
+
+```bash
+# List campaigns
+node tools/clis/hunter.js campaigns list
+
+# Get campaign details
+node tools/clis/hunter.js campaigns get --id 12345
+
+# Start/pause a campaign
+node tools/clis/hunter.js campaigns start --id 12345
+node tools/clis/hunter.js campaigns pause --id 12345
+```
+
+### Check account usage
+
+```bash
+node tools/clis/hunter.js account info
+```
+
+## Rate Limits
+
+- Free plan: 25 searches/month, 50 verifications/month
+- Paid plans scale with tier
+- API rate limit: 10 requests/second
+
+## Use Cases
+
+- **Link building**: Find email contacts at target domains for outreach
+- **Prospecting**: Build lead lists from company domains
+- **Verification**: Clean email lists before sending campaigns

package/departments/marketing/tools/integrations/hyperframes.md

@@ -0,0 +1,180 @@
+# Hyperframes
+
+Open-source programmatic video framework from HeyGen. Create videos from HTML/CSS/JS — no React, no proprietary DSL. Designed for AI agent workflows.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | - | Library, not a hosted service |
+| MCP | - | - |
+| CLI | Yes | `npx hyperframes render` |
+| SDK | Yes | Node.js/TypeScript package |
+
+## Why Hyperframes
+
+- **LLM-native**: AI models generate better HTML than React components — plain web standards, no framework DSL
+- **Deterministic**: Same input always produces identical output (ideal for automation)
+- **Open source**: Apache 2.0 license, zero per-render fees
+- **Agent-friendly**: Any coding agent that can write HTML can create videos
+
+## Install
+
+```bash
+npm install hyperframes
+```
+
+Requires: Node.js 22+, Chrome/Chromium (for rendering)
+
+## Quick Start
+
+```typescript
+import { render } from "hyperframes";
+
+await render({
+  frames: [
+    {
+      html: `
+        <div style="display:flex; align-items:center; justify-content:center;
+                    height:100%; background:#000; color:#fff; font-family:system-ui;">
+          <h1 style="font-size:64px;">Welcome to Acme</h1>
+        </div>
+      `,
+      duration: 3,
+    },
+    {
+      html: `
+        <div style="display:flex; flex-direction:column; align-items:center;
+                    justify-content:center; height:100%; background:#000; color:#fff;
+                    font-family:system-ui;">
+          <h2 style="font-size:48px;">Ship faster with AI</h2>
+          <p style="font-size:24px; color:#888;">Try it free today</p>
+        </div>
+      `,
+      duration: 3,
+    },
+  ],
+  output: "intro.mp4",
+  width: 1080,
+  height: 1920, // 9:16 vertical
+  fps: 30,
+});
+```
+
+## Core Concepts
+
+### Frames
+
+Each frame is an HTML document rendered at a specific point in the timeline. Think of it as a slide with a duration.
+
+```typescript
+{
+  html: "<div>...</div>",  // Full HTML content
+  duration: 3,              // Seconds to display
+  css?: "body { ... }",     // Optional external CSS
+}
+```
+
+### Transitions
+
+CSS transitions and animations work between frames:
+
+```html
+<div style="animation: fadeIn 0.5s ease-in;">
+  <h1>Slide In</h1>
+</div>
+<style>
+  @keyframes fadeIn {
+    from { opacity: 0; transform: translateY(20px); }
+    to { opacity: 1; transform: translateY(0); }
+  }
+</style>
+```
+
+### Data-Driven Videos
+
+Generate frames from data for batch production:
+
+```typescript
+const features = ["Analytics", "Automation", "AI Insights"];
+
+const frames = features.map((feature) => ({
+  html: `
+    <div style="display:flex; align-items:center; justify-content:center;
+                height:100%; background:linear-gradient(135deg, #667eea, #764ba2);
+                color:#fff; font-family:system-ui;">
+      <h1 style="font-size:56px;">${feature}</h1>
+    </div>
+  `,
+  duration: 2.5,
+}));
+
+await render({ frames, output: "features.mp4", width: 1080, height: 1920 });
+```
+
+## Common Marketing Templates
+
+### Product Announcement
+
+```typescript
+const frames = [
+  { html: hookSlide("Something new is here"), duration: 2 },
+  { html: featureSlide(title, description, screenshot), duration: 4 },
+  { html: ctaSlide("Try it free →", url), duration: 3 },
+];
+```
+
+### Testimonial Video
+
+```typescript
+const frames = [
+  { html: quoteSlide(testimonial.text), duration: 4 },
+  { html: attributionSlide(testimonial.author, testimonial.company), duration: 2 },
+  { html: ctaSlide("Join 1,000+ happy customers"), duration: 3 },
+];
+```
+
+### Stats/Metrics Video
+
+```typescript
+const metrics = [
+  { label: "Users", value: "10,000+" },
+  { label: "Uptime", value: "99.9%" },
+  { label: "NPS", value: "72" },
+];
+
+const frames = metrics.map(m => ({
+  html: metricSlide(m.label, m.value),
+  duration: 2.5,
+}));
+```
+
+## Aspect Ratios
+
+| Platform | Width | Height | Ratio |
+|----------|-------|--------|-------|
+| TikTok/Reels/Shorts | 1080 | 1920 | 9:16 |
+| YouTube | 1920 | 1080 | 16:9 |
+| Instagram Feed | 1080 | 1080 | 1:1 |
+| Instagram Feed | 1080 | 1350 | 4:5 |
+
+## Hyperframes vs. Remotion
+
+| Factor | Hyperframes | Remotion |
+|--------|-------------|----------|
+| Language | HTML/CSS/JS | React/TypeScript |
+| Agent compatibility | Better (plain HTML) | Good (needs React knowledge) |
+| Animation | CSS transitions/keyframes | Spring physics, interpolation |
+| Cloud rendering | Not built-in | Lambda (AWS) |
+| License | Apache 2.0 (free) | Company license for commercial use |
+| Ecosystem | New, growing | Mature, large community |
+
+**Use Hyperframes when:** AI agent is generating the video, simple animations, batch templated content, cost-sensitive.
+
+**Use Remotion when:** Complex animations needed, already using React, need Lambda for massive scale, want larger ecosystem.
+
+## Relevant Skills
+
+- video
+- social
+- ad-creative

package/departments/marketing/tools/integrations/instantly.md

@@ -0,0 +1,104 @@
+# Instantly.ai
+
+Cold email platform with built-in email warmup and campaign management at scale.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API for campaigns, leads, accounts, analytics |
+| MCP | - | Not available |
+| CLI | [✓](../clis/instantly.js) | Zero-dependency Node.js CLI |
+| SDK | - | API-only |
+
+## Authentication
+
+- **Type**: API Key (query parameter)
+- **Parameter**: `api_key={key}`
+- **Env var**: `INSTANTLY_API_KEY`
+- **Get key**: [Instantly Settings > Integrations > API](https://app.instantly.ai/app/settings/integrations)
+
+## Common Agent Operations
+
+### Manage campaigns
+
+```bash
+# List campaigns
+node tools/clis/instantly.js campaigns list --limit 20
+
+# Get campaign details
+node tools/clis/instantly.js campaigns get --id cam_abc123
+
+# Check campaign status
+node tools/clis/instantly.js campaigns status --id cam_abc123
+
+# Launch a campaign
+node tools/clis/instantly.js campaigns launch --id cam_abc123
+
+# Pause a campaign
+node tools/clis/instantly.js campaigns pause --id cam_abc123
+```
+
+### Manage leads
+
+```bash
+# List leads in a campaign
+node tools/clis/instantly.js leads list --campaign-id cam_abc123 --limit 50
+
+# Add a lead
+node tools/clis/instantly.js leads add --campaign-id cam_abc123 --email john@example.com --first-name John --last-name Doe --company "Example Inc"
+
+# Delete a lead
+node tools/clis/instantly.js leads delete --campaign-id cam_abc123 --email john@example.com
+
+# Check lead status
+node tools/clis/instantly.js leads status --campaign-id cam_abc123 --email john@example.com
+```
+
+### Manage email accounts
+
+```bash
+# List connected accounts
+node tools/clis/instantly.js accounts list --limit 20
+
+# Check account status
+node tools/clis/instantly.js accounts status --account-id me@example.com
+
+# Check warmup status
+node tools/clis/instantly.js accounts warmup-status --account-id me@example.com
+```
+
+### View analytics
+
+```bash
+# Campaign analytics
+node tools/clis/instantly.js analytics campaign --campaign-id cam_abc123 --start 2024-01-01 --end 2024-01-31
+
+# Step-by-step analytics
+node tools/clis/instantly.js analytics steps --campaign-id cam_abc123
+
+# Account-level analytics
+node tools/clis/instantly.js analytics account --start 2024-01-01 --end 2024-01-31
+```
+
+### Manage blocklist
+
+```bash
+# List blocked emails/domains
+node tools/clis/instantly.js blocklist list
+
+# Add to blocklist
+node tools/clis/instantly.js blocklist add --entries "competitor.com,spam@example.com"
+```
+
+## Rate Limits
+
+- API rate limits vary by plan
+- Recommended: stay under 10 requests/second
+
+## Use Cases
+
+- **Link building at scale**: Run large-volume outreach campaigns with built-in warmup
+- **Campaign management**: Launch, pause, and monitor cold email campaigns
+- **Account health**: Monitor email account warmup and deliverability
+- **Analytics**: Track open rates, reply rates, and campaign performance