Hypermode Agents

.trunk/configs/.vale.ini

@@ -15,4 +15,7 @@ Google.Exclamation = OFF
 Google.Parens = OFF
 Google.We = OFF
 Google.Passive = OFF
-CommentDelimiters = {/*, */}
+CommentDelimiters = {/*, */}
+
+[agents/*.mdx]
+Google.Quotes = NO

agents/agent-gallery/music-recommendation.mdx

@@ -0,0 +1,49 @@
+---
+title: "Music Recommendation Agent"
+sidebarTitle: "Music Recommendation Agent"
+description:
+  "Create a music recommendation agent that can recommend music based on your
+  preferences and create new Spotify playlists"
+---
+
+![Music Recommendation Agent](/images/agents/agent-gallery/music-recommendation.png)
+
+## Instructions
+
+```text
+Identity:
+BeatBuddy is a friendly, knowledgeable music recommendation agent that helps users discover new artists,
+create playlists by mood or genre, and suggest songs based on their favorites.
+
+Context:
+BeatBuddy provides general music recommendations, not tied to any specific service or company.
+It can suggest new artists, generate curated playlists for different moods or genres, and
+recommend songs similar to those the user already likes. BeatBuddy's goal is to make
+music discovery fun, personalized, and easy for everyone.
+```
+
+## Connections
+
+- **Spotify** - Spotify is a digital music service that gives you access to
+  millions of songs.
+
+## Example conversation
+
+```text
+Me: Create a playlist with the same beat as Candyman by Xtina. I want it to determine
+the bpm and run a search for similar bpm and then a visual similarity search within that
+of candyman for more pop songs before creating, naming, opening, and playing my new playlist.
+```
+
+```text
+Agent: Here's the plan:
+
+"Candyman" by Christina Aguilera is a pop song with a swing/jazz influence and an energetic,
+upbeat tempo. Its BPM (beats per minute) is widely reported as 172.
+
+I will search for pop songs with a similar BPM (around 170–175) and then filter for those with a similar energetic, retro-pop feel.
+
+I'll create, name, and open your new playlist, then play it for you.
+
+Let's get started!
+```

agents/agent-gallery/social-media.mdx

@@ -0,0 +1,31 @@
+---
+title: "Social Media Expert"
+sidebarTitle: "Social Media Expert"
+description:
+  "Create a social media expert agent that can draft social media content and
+  run campaigns based on your products and brand."
+---
+
+![Example conversation](/images/agents/agent-gallery/social-media-intern.png)
+
+## Instructions
+
+```text
+You are a social media expert, skilled at educating developers about deep technical concepts in a format friendly for social media.
+
+Tools:
+- GitHub: Access the user's GitHub repository.
+- Notion: Schedule workouts based on the user's availability.
+```
+
+## Connections
+
+- **GitHub** - GitHub is a web-based Git repository hosting service.
+- **Notion** - Notion is a service for notes, docs, tasks, and databases.
+- **Ref** - Ref is a service for finding references.
+
+## Example conversation
+
+```text
+Analyze my hyper-news GitHub repo and create 10-20 social media posts about concepts from the repo, including Dgraph, Modus, and MCP
+```

agents/agent-gallery/workout-scheduling.mdx

@@ -0,0 +1,81 @@
+---
+title: "Workout Scheduling Agent"
+sidebarTitle: "Workout Scheduling Agent"
+description:
+  "Create a workout scheduling agent that can schedule workouts based on your
+  preferences and Strava data and calendar availability."
+---
+
+![Workout Scheduling Agent](/images/agents/agent-gallery/workout-scheduling.png)
+
+## Instructions
+
+```text
+Identity:
+You are PulseCoach, a friendly and knowledgeable personal training advisor.
+
+Context:
+You analyze the user's Strava workout data across all activity types. Your goal is to help the user
+achieve general fitness improvements by reviewing recent workouts, identifying trends, and
+suggesting a balanced, personalized training schedule. Offer clear, actionable advice and
+adapt recommendations based on the user's progress and feedback.
+
+Tools:
+- Strava: Access the user's Strava workout data.
+- Calendar: Schedule workouts based on the user's availability.
+```
+
+## Connections
+
+- **Strava** - Designed by athletes, for athletes, Strava's mobile app and
+  website connect millions of runners and cyclists through the sports they love.
+- **Google Calendar** - Google Calendar is a service for creating, managing, and
+  organizing schedules and events.
+
+## Example conversation
+
+```text
+You: "I want to start running again. Can you help me create a workout schedule?"
+
+Agent: "Based on your recent Strava data, I see you've been consistently running for the past month. I can help you create a personalized workout schedule."
+
+You: "Sounds good. Can you suggest a schedule for the next week?"
+
+Agent: "Here's a suggested workout schedule for the next week:
+
+Monday: Rest day
+Tuesday: 30-minute jog
+Wednesday: Rest day
+Thursday: 45-minute jog
+Friday: Rest day
+Saturday: 1-hour jog
+Sunday: Rest day
+
+I recommend this schedule because it provides a balanced approach to running, with a mix of rest days and active recovery days."
+
+You: "That sounds great. Can you also suggest some tips for running?"
+
+Agent: "Here are some tips for running:
+
+- Stay hydrated
+- Fuel your body with healthy foods
+- Get enough sleep
+- Listen to your body and rest when you need to
+
+I also recommend wearing comfortable shoes and using proper form."
+
+You: "Thanks for the tips. Can you also suggest some tips for running?"
+
+Agent: "Here are some tips for running:
+
+- Stay hydrated
+- Fuel your body with healthy foods
+- Get enough sleep
+- Listen to your body and rest when you need to
+
+I also recommend wearing comfortable shoes and using proper form."
+```
+
+## Tasks
+
+- **Automated Workout Scheduling**

agents/connections.mdx

@@ -0,0 +1,172 @@
+---
+title: "Connections"
+sidebarTitle: "Connect Your Agent"
+description:
+  "Build AI agents that act, not just chat—from natural conversation to
+  production-ready code"
+---
+
+**Connections** enable Hypermode Agents to securely access and interact with
+external tools, APIs, and services. With over 2,000+ available integrations,
+agents can execute tasks across your entire technology stack.
+
+- **Built-in integrations** like GitHub, Linear, Slack, Vercel, and Notion
+- **Model Context Protocol** support for secure, structured tool integration
+- **2,000+ integrations** through our partnership with leading automation
+  platforms
+- **Your custom APIs** with encrypted credentials and scoped access
+- **Major large language models** including OpenAI, Anthropic, Google, and open
+  source models
+
+## Overview
+
+Hypermode Agents are built for execution, not just conversation. Connections
+provide the bridge between your agents and the tools they need to complete
+tasks, from internal APIs to third-party applications and public resources.
+
+## Key features
+
+<CardGroup cols={2}>
+  <Card title="2,000+ Integrations" icon="plug">
+    Access to popular tools, APIs, and services including GitHub, Stripe,
+    Snowflake, and custom internal systems.
+  </Card>
+
+<Card title="Role-Based Access" icon="shield-check">
+  Agents only access tools relevant to their specific role and responsibilities.
+</Card>
+
+<Card title="Secure Authentication" icon="lock">
+  Industry-standard security protocols protect your credentials and data.
+</Card>
+
+  <Card title="Model Context Protocol" icon="code">
+    Tools are structured, typed, and traceable for sophisticated agent
+    reasoning.
+  </Card>
+</CardGroup>
+
+## How connections work
+
+### Domain-specific tool assignment
+
+Rather than providing agents with access to all available tools, Hypermode
+Agents uses a curated approach based on the agent's role and domain. Examples of
+connections relevant for domain specific agents include:
+
+#### Frontend development agent
+
+- GitHub (code repository management)
+- Linear (issue tracking)
+- Vercel (deployment and hosting)
+
+#### Revenue operations agent
+
+- Snowflake (data warehousing)
+- Stripe (payment processing)
+- Internal ticketing API (customer support)
+
+#### Marketing agent
+
+- HubSpot (CRM and automation)
+- Google Analytics (website analytics)
+- Mailchimp (email marketing)
+
+### Role-based access control
+
+<Info>
+  Agents are granted access only to tools that align with their designated role,
+  improving both security and decision-making clarity.
+</Info>
+
+1. **Define agent role** and primary responsibilities
+2. **Select relevant tools** from the curated toolkit
+3. **Configure permissions** for each integration
+4. **Monitor usage** and adjust access as needed
+
+## MCP
+
+Connections leverage the Model Context Protocol (MCP) to provide agents with
+enhanced tool interaction capabilities:
+
+### Benefits of MCP Integration
+
+<CardGroup cols={1}>
+  <Card title="Enhanced Reasoning" icon="brain">
+    Agents understand tool capabilities and parameters as clearly as they
+    understand text, enabling better planning and execution.
+  </Card>
+
+<Card title="Sophisticated Planning" icon="route">
+  Multi-step workflows can be planned and executed with tools working together
+  seamlessly.
+</Card>
+
+<Card title="Improved Debugging" icon="bug">
+  Structured tool calls provide clear audit trails and error diagnosis
+  capabilities.
+</Card>
+
+  <Card title="Tool Reusability" icon="recycle">
+    Consistent tool definitions enable agents to reuse and combine tools
+    effectively.
+  </Card>
+</CardGroup>
+
+## Security and compliance
+
+<Warning>
+  All connections use secure authentication methods including OAuth 2.0, API
+  keys, and service account credentials. Credentials are encrypted and never
+  exposed to the agent's reasoning process.
+</Warning>
+
+### Security features
+
+- **Encrypted credential storage** with enterprise-grade security
+- **Audit logging** for all tool interactions
+- **Permission scoping** to limit access to necessary resources only
+- **Regular security updates** and compliance monitoring
+
+## Getting started
+
+### Add a new connection
+
+Select a connection from the "add connections"ption from the left navigation bar
+or search from more than 2000 connection options. You'll be prompted to complete
+the OAuth flow if you haven't enabled the connection yet for your workspace.
+
+<img
+  src="/images/agents/connections-sidebar.png"
+  alt="Add a new connection"
+  style={{ width: "100%", maxWidth: "400px" }}
+/>
+
+### Manage connections
+
+Existing connections can be viewed and managed from the "Connections" tab in the
+Workspace settings page. Connections can also be added to your workspace from
+this page.
+
+![Manage connections](/images/agents/connections-manage.png)
+
+<Tip>
+  Start with a small set of essential tools for your agent's role, then expand
+  as you identify additional needs through usage patterns.
+</Tip>
+
+## Available Integrations
+
+Popular integration categories include:
+
+- **Development Tools**: GitHub, GitLab, Jira, Linear
+- **Data & Analytics**: Snowflake, BigQuery, Tableau, Looker
+- **Customer Success**: Salesforce, HubSpot, Zendesk, Intercom
+- **Finance**: Stripe, QuickBooks, Xero, PayPal
+- **Marketing**: Mailchimp, Constant Contact, Google Ads, Facebook Ads
+- **Productivity**: Slack, Microsoft Teams, Google Workspace, Notion
+
+<Info>
+  Custom integrations can be built for internal APIs and proprietary systems.
+  Contact us for assistance with custom connection development.
+</Info>