@nuxtagentic/integrations 0.0.0-stage → 0.1.1

package/runtime/shared/catalog.ts

@@ -0,0 +1,566 @@
+/** How an integration is connected. Several may apply; OAuth is offered first. */
+export interface IntegrationAuth {
+  /** A CloudConfig Connect OAuth provider, and the scopes this integration asks for. */
+  oauth?: { provider: string; scopes?: string[] }
+  /** Accept a pasted API token and the `fields` below — the path that works before any OAuth app exists. */
+  apiKey?: boolean
+  /** A hosted MCP server: its tools become the actions. No server means the user enters one. */
+  mcp?: { server?: string }
+}
+
+export type IntegrationScope = 'user' | 'workspace'
+
+export interface IntegrationDefinition {
+  id: string
+  name: string
+  category: string
+  logo: string
+  description: string
+  details: string
+  triggers: { id: string; label: string }[]
+  actions: { id: string; label: string }[]
+  auth: IntegrationAuth
+  /** Who a connection belongs to, most natural first: a person, or the whole workspace. */
+  ownership: IntegrationScope[]
+  /**
+   * Extra values. Secret ones are API-key credentials and are sealed by Connect;
+   * the rest are per-connection settings, also asked for with OAuth.
+   */
+  fields: {
+    key: string
+    label: string
+    secret?: boolean
+    placeholder?: string
+    apiKeyOnly?: boolean
+  }[]
+}
+
+export const INTEGRATION_CATALOG: readonly IntegrationDefinition[] = [
+  {
+    id: 'github',
+    name: 'GitHub',
+    category: 'Code',
+    logo: 'github',
+    description: 'Repositories, issues and pull requests.',
+    details:
+      'Let agents review pull requests, triage issues and comment on commits across the repositories you choose.',
+    triggers: [
+      { id: 'github.a_pull_request_is_opened', label: 'A pull request is opened' },
+      { id: 'github.an_issue_is_created', label: 'An issue is created' },
+      { id: 'github.a_branch_is_pushed', label: 'A branch is pushed' },
+    ],
+    actions: [
+      { id: 'read_repositories', label: 'Read repositories' },
+      { id: 'comment_on_pull_requests', label: 'Comment on pull requests' },
+      { id: 'open_and_label_issues', label: 'Open and label issues' },
+    ],
+    auth: { oauth: { provider: 'github' }, apiKey: true },
+    ownership: ['workspace', 'user'],
+    fields: [],
+  },
+  {
+    id: 'ga',
+    name: 'Google Analytics',
+    category: 'Analytics',
+    logo: 'googleanalytics',
+    description: 'Traffic, conversions and audience reports.',
+    details:
+      'Give agents read access to GA4 properties so they can build reports, spot anomalies and answer traffic questions.',
+    triggers: [
+      { id: 'ga.traffic_drops_below_a_threshold', label: 'Traffic drops below a threshold' },
+      { id: 'ga.a_weekly_report_is_ready', label: 'A weekly report is ready' },
+    ],
+    actions: [
+      { id: 'run_reports', label: 'Run reports' },
+      { id: 'compare_date_ranges', label: 'Compare date ranges' },
+      { id: 'create_audiences', label: 'Create audiences' },
+    ],
+    auth: {
+      oauth: {
+        provider: 'google',
+        scopes: [
+          'https://www.googleapis.com/auth/analytics.readonly',
+          'https://www.googleapis.com/auth/analytics.edit',
+        ],
+      },
+    },
+    ownership: ['user', 'workspace'],
+    fields: [],
+  },
+  {
+    id: 'gsc',
+    name: 'Search Console',
+    category: 'Analytics',
+    logo: 'googlesearchconsole',
+    description: 'Search queries, rankings and indexing.',
+    details:
+      'Agents can monitor search performance, inspect URLs and flag indexing problems on your verified sites.',
+    triggers: [
+      { id: 'gsc.an_indexing_error_is_detected', label: 'An indexing error is detected' },
+      { id: 'gsc.a_tracked_query_changes_rank', label: 'A tracked query changes rank' },
+    ],
+    actions: [
+      { id: 'read_search_performance', label: 'Read search performance' },
+      { id: 'inspect_urls', label: 'Inspect URLs' },
+      { id: 'request_indexing', label: 'Request indexing' },
+    ],
+    auth: {
+      oauth: {
+        provider: 'google',
+        scopes: [
+          'https://www.googleapis.com/auth/webmasters',
+          'https://www.googleapis.com/auth/indexing',
+        ],
+      },
+    },
+    ownership: ['user', 'workspace'],
+    fields: [],
+  },
+  {
+    id: 'gads',
+    name: 'Google Ads',
+    category: 'Ads',
+    logo: 'googleads',
+    description: 'Search, display and YouTube campaigns.',
+    details: 'Agents can report on spend, adjust bids and pause keywords that miss your targets.',
+    triggers: [
+      { id: 'gads.daily_budget_is_reached', label: 'Daily budget is reached' },
+      { id: 'gads.cpa_rises_above_target', label: 'CPA rises above target' },
+    ],
+    actions: [
+      { id: 'read_campaign_stats', label: 'Read campaign stats' },
+      { id: 'adjust_bids_and_budgets', label: 'Adjust bids and budgets' },
+      { id: 'pause_keywords', label: 'Pause keywords' },
+    ],
+    auth: { oauth: { provider: 'google', scopes: ['https://www.googleapis.com/auth/adwords'] } },
+    ownership: ['workspace', 'user'],
+    // The developer token is the app's own (NUXT_GOOGLE_ADS_DEVELOPER_TOKEN); the customer is per connection.
+    fields: [{ key: 'customerId', label: 'Customer ID', placeholder: '1234567890' }],
+  },
+  {
+    id: 'meta',
+    name: 'Meta Ads',
+    category: 'Ads',
+    logo: 'meta',
+    description: 'Facebook and Instagram campaigns.',
+    details:
+      'Manage Facebook and Instagram ad accounts: build campaigns, shift budgets and pause underperforming ads.',
+    triggers: [
+      { id: 'meta.spend_limit_is_reached', label: 'Spend limit is reached' },
+      { id: 'meta.an_ad_is_rejected', label: 'An ad is rejected' },
+    ],
+    actions: [
+      { id: 'read_ad_insights', label: 'Read ad insights' },
+      { id: 'create_campaigns', label: 'Create campaigns' },
+      { id: 'adjust_budgets', label: 'Adjust budgets' },
+      { id: 'pause_ads', label: 'Pause ads' },
+    ],
+    auth: { apiKey: true },
+    ownership: ['workspace', 'user'],
+    fields: [],
+  },
+  {
+    id: 'x',
+    name: 'X Ads',
+    category: 'Ads',
+    logo: 'x',
+    description: 'Promoted posts and campaign analytics.',
+    details:
+      'Agents can create promoted posts, tune bids and pull campaign performance from your X Ads account.',
+    triggers: [
+      { id: 'x.a_campaign_ends', label: 'A campaign ends' },
+      { id: 'x.cpc_rises_above_target', label: 'CPC rises above target' },
+    ],
+    actions: [
+      { id: 'read_campaign_stats', label: 'Read campaign stats' },
+      { id: 'create_promoted_posts', label: 'Create promoted posts' },
+      { id: 'adjust_bids', label: 'Adjust bids' },
+    ],
+    auth: { apiKey: true },
+    ownership: ['workspace', 'user'],
+    fields: [
+      { key: 'consumerKey', label: 'API key', secret: true },
+      { key: 'consumerSecret', label: 'API key secret', secret: true },
+      { key: 'tokenSecret', label: 'Access token secret', secret: true },
+    ],
+  },
+  {
+    id: 'tiktok',
+    name: 'TikTok Ads',
+    category: 'Ads',
+    logo: 'tiktok',
+    description: 'In-feed campaigns and creative reports.',
+    details:
+      'Agents can read campaign results, compare creatives and adjust budgets in TikTok Ads Manager.',
+    triggers: [
+      { id: 'tiktok.a_campaign_ends', label: 'A campaign ends' },
+      { id: 'tiktok.creative_fatigue_is_detected', label: 'Creative fatigue is detected' },
+    ],
+    actions: [
+      { id: 'read_campaign_stats', label: 'Read campaign stats' },
+      { id: 'adjust_budgets', label: 'Adjust budgets' },
+      { id: 'pause_ad_groups', label: 'Pause ad groups' },
+    ],
+    auth: { apiKey: true },
+    ownership: ['workspace', 'user'],
+    fields: [{ key: 'advertiserId', label: 'Advertiser ID' }],
+  },
+  {
+    id: 'reddit',
+    name: 'Reddit Ads',
+    category: 'Ads',
+    logo: 'reddit',
+    description: 'Promoted posts across communities.',
+    details: 'Agents can report on Reddit campaigns and adjust targeting and budgets.',
+    triggers: [{ id: 'reddit.a_campaign_ends', label: 'A campaign ends' }],
+    actions: [
+      { id: 'read_campaign_stats', label: 'Read campaign stats' },
+      { id: 'adjust_budgets', label: 'Adjust budgets' },
+    ],
+    auth: { apiKey: true },
+    ownership: ['workspace', 'user'],
+    fields: [],
+  },
+  {
+    id: 'stripe',
+    name: 'Stripe',
+    category: 'Commerce',
+    logo: 'stripe',
+    description: 'Payments, subscriptions and invoices.',
+    details:
+      'Agents can look up customers, summarize revenue and draft invoices. Refunds always ask for approval.',
+    triggers: [
+      { id: 'stripe.a_payment_fails', label: 'A payment fails' },
+      { id: 'stripe.a_subscription_is_cancelled', label: 'A subscription is cancelled' },
+      { id: 'stripe.a_dispute_is_opened', label: 'A dispute is opened' },
+    ],
+    actions: [
+      { id: 'read_payments_and_customers', label: 'Read payments and customers' },
+      { id: 'create_invoices', label: 'Create invoices' },
+      { id: 'issue_refunds', label: 'Issue refunds' },
+    ],
+    auth: { apiKey: true },
+    ownership: ['workspace'],
+    fields: [],
+  },
+  {
+    id: 'shopify',
+    name: 'Shopify',
+    category: 'Commerce',
+    logo: 'shopify',
+    description: 'Orders, products and customers.',
+    details: 'Agents can answer order questions, update inventory and tag customers in your store.',
+    triggers: [
+      { id: 'shopify.an_order_is_placed', label: 'An order is placed' },
+      { id: 'shopify.stock_runs_low', label: 'Stock runs low' },
+    ],
+    actions: [
+      { id: 'read_orders', label: 'Read orders' },
+      { id: 'update_products', label: 'Update products' },
+      { id: 'tag_customers', label: 'Tag customers' },
+    ],
+    auth: { oauth: { provider: 'shopify' }, apiKey: true },
+    ownership: ['workspace'],
+    fields: [
+      { key: 'shop', label: 'Store', placeholder: 'your-store.myshopify.com', apiKeyOnly: true },
+    ],
+  },
+  {
+    id: 'hubspot',
+    name: 'HubSpot',
+    category: 'CRM',
+    logo: 'hubspot',
+    description: 'Contacts, deals and marketing email.',
+    details: 'Agents can enrich contacts, move deals through stages and log activity in HubSpot.',
+    triggers: [
+      { id: 'hubspot.a_deal_changes_stage', label: 'A deal changes stage' },
+      { id: 'hubspot.a_form_is_submitted', label: 'A form is submitted' },
+    ],
+    actions: [
+      { id: 'read_contacts_and_deals', label: 'Read contacts and deals' },
+      { id: 'update_deal_stages', label: 'Update deal stages' },
+      { id: 'log_activity', label: 'Log activity' },
+    ],
+    auth: { oauth: { provider: 'hubspot' }, apiKey: true },
+    ownership: ['workspace', 'user'],
+    fields: [],
+  },
+  {
+    id: 'linear',
+    name: 'Linear',
+    category: 'Code',
+    logo: 'linear',
+    description: 'Issues, projects and cycles.',
+    details: 'Agents can file issues, update status and summarize cycles for your teams.',
+    triggers: [
+      { id: 'linear.an_issue_is_assigned_to_agent', label: 'An issue is assigned to Agent' },
+      { id: 'linear.a_cycle_ends', label: 'A cycle ends' },
+    ],
+    actions: [
+      { id: 'read_issues', label: 'Read issues' },
+      { id: 'create_issues', label: 'Create issues' },
+      { id: 'update_status', label: 'Update status' },
+    ],
+    auth: { oauth: { provider: 'linear' }, apiKey: true },
+    ownership: ['workspace', 'user'],
+    fields: [],
+  },
+  {
+    id: 'vercel',
+    name: 'Vercel',
+    category: 'Code',
+    logo: 'vercel',
+    description: 'Deployments and preview URLs.',
+    details:
+      'Agents can watch deployments, read build logs and comment preview links on pull requests.',
+    triggers: [
+      { id: 'vercel.a_deployment_fails', label: 'A deployment fails' },
+      { id: 'vercel.a_preview_is_ready', label: 'A preview is ready' },
+    ],
+    actions: [
+      { id: 'read_deployments', label: 'Read deployments' },
+      { id: 'read_build_logs', label: 'Read build logs' },
+      { id: 'promote_to_production', label: 'Promote to production' },
+    ],
+    auth: { apiKey: true },
+    ownership: ['workspace', 'user'],
+    fields: [],
+  },
+  {
+    id: 'gmail',
+    name: 'Gmail',
+    category: 'Communication',
+    logo: 'gmail',
+    description: 'Read, draft and send email.',
+    details: 'Agents can sort your inbox, draft replies and send email you approve.',
+    triggers: [
+      { id: 'gmail.an_email_arrives_from_a_label', label: 'An email arrives from a label' },
+      { id: 'gmail.a_thread_gets_no_reply', label: 'A thread gets no reply' },
+    ],
+    actions: [
+      { id: 'read_email', label: 'Read email' },
+      { id: 'draft_replies', label: 'Draft replies' },
+      { id: 'send_email', label: 'Send email' },
+    ],
+    auth: {
+      oauth: { provider: 'google', scopes: ['https://www.googleapis.com/auth/gmail.modify'] },
+    },
+    ownership: ['user'],
+    fields: [],
+  },
+  {
+    id: 'discord',
+    name: 'Discord',
+    category: 'Communication',
+    logo: 'discord',
+    description: 'Channels, threads and messages.',
+    details: 'Agents can answer questions in channels you choose and post summaries.',
+    triggers: [
+      { id: 'discord.agent_is_mentioned', label: 'Agent is mentioned' },
+      { id: 'discord.a_message_is_posted_in_a_channel', label: 'A message is posted in a channel' },
+    ],
+    actions: [
+      { id: 'read_channels', label: 'Read channels' },
+      { id: 'post_messages', label: 'Post messages' },
+    ],
+    auth: { oauth: { provider: 'discord' }, apiKey: true },
+    ownership: ['workspace'],
+    fields: [],
+  },
+  {
+    id: 'intercom',
+    name: 'Intercom',
+    category: 'Communication',
+    logo: 'intercom',
+    description: 'Conversations and help center.',
+    details:
+      'Agents can triage conversations, draft answers from your help center and tag tickets.',
+    triggers: [{ id: 'intercom.a_conversation_is_opened', label: 'A conversation is opened' }],
+    actions: [
+      { id: 'read_conversations', label: 'Read conversations' },
+      { id: 'draft_replies', label: 'Draft replies' },
+      { id: 'tag_conversations', label: 'Tag conversations' },
+    ],
+    auth: { oauth: { provider: 'intercom' }, apiKey: true },
+    ownership: ['workspace'],
+    fields: [],
+  },
+  {
+    id: 'notion',
+    name: 'Notion',
+    category: 'Productivity',
+    logo: 'notion',
+    description: 'Pages and databases.',
+    details: 'Agents can read and write the pages and databases you share with the integration.',
+    triggers: [{ id: 'notion.a_database_row_is_added', label: 'A database row is added' }],
+    actions: [
+      { id: 'read_pages', label: 'Read pages' },
+      { id: 'create_pages', label: 'Create pages' },
+      { id: 'update_databases', label: 'Update databases' },
+    ],
+    auth: { oauth: { provider: 'notion' }, apiKey: true },
+    ownership: ['workspace', 'user'],
+    fields: [],
+  },
+  {
+    id: 'gcal',
+    name: 'Google Calendar',
+    category: 'Productivity',
+    logo: 'googlecalendar',
+    description: 'Events and availability.',
+    details: 'Agents can check availability, schedule meetings and prepare briefs before events.',
+    triggers: [{ id: 'gcal.an_event_is_about_to_start', label: 'An event is about to start' }],
+    actions: [
+      { id: 'read_events', label: 'Read events' },
+      { id: 'create_events', label: 'Create events' },
+    ],
+    auth: {
+      oauth: {
+        provider: 'google',
+        scopes: [
+          'https://www.googleapis.com/auth/calendar.events',
+          'https://www.googleapis.com/auth/calendar.calendarlist.readonly',
+        ],
+      },
+    },
+    ownership: ['user'],
+    fields: [],
+  },
+  {
+    id: 'gdrive',
+    name: 'Google Drive',
+    category: 'Productivity',
+    logo: 'googledrive',
+    description: 'Files, folders and sharing.',
+    details: 'Agents can search, read and organize files in the folders you allow.',
+    triggers: [{ id: 'gdrive.a_file_is_added_to_a_folder', label: 'A file is added to a folder' }],
+    actions: [
+      { id: 'read_files', label: 'Read files' },
+      { id: 'create_files', label: 'Create files' },
+      { id: 'move_files', label: 'Move files' },
+    ],
+    auth: { oauth: { provider: 'google', scopes: ['https://www.googleapis.com/auth/drive.file'] } },
+    ownership: ['user', 'workspace'],
+    fields: [],
+  },
+  {
+    id: 'slack',
+    name: 'Slack',
+    category: 'Communication',
+    logo: 'slack',
+    description: 'Channels, messages and agent notifications.',
+    details: 'Post agent results and failure alerts to the channels you allow.',
+    triggers: [
+      { id: 'slack.an_agent_is_mentioned', label: 'An agent is mentioned' },
+      { id: 'slack.a_message_is_posted', label: 'A message is posted' },
+    ],
+    actions: [
+      { id: 'read_channels', label: 'Read channels' },
+      { id: 'post_messages', label: 'Post messages' },
+    ],
+    auth: { oauth: { provider: 'slack' }, apiKey: true },
+    ownership: ['workspace'],
+    fields: [],
+  },
+  {
+    id: 'mcp-linear',
+    name: 'Linear MCP',
+    category: 'MCP servers',
+    logo: 'linear',
+    description: 'Every tool on Linear’s hosted MCP server.',
+    details:
+      'Sign in to Linear’s MCP server. No app to register: agents get the tools you allow, and changes ask for approval.',
+    triggers: [],
+    actions: [],
+    auth: { mcp: { server: 'https://mcp.linear.app/mcp' } },
+    ownership: ['user', 'workspace'],
+    fields: [],
+  },
+  {
+    id: 'mcp-notion',
+    name: 'Notion MCP',
+    category: 'MCP servers',
+    logo: 'notion',
+    description: 'Every tool on Notion’s hosted MCP server.',
+    details:
+      'Sign in to Notion’s MCP server. Agents search, read and write the pages you share, with the tools you allow.',
+    triggers: [],
+    actions: [],
+    auth: { mcp: { server: 'https://mcp.notion.com/mcp' } },
+    ownership: ['user', 'workspace'],
+    fields: [],
+  },
+  {
+    id: 'mcp-sentry',
+    name: 'Sentry MCP',
+    category: 'MCP servers',
+    logo: 'sentry',
+    description: 'Issues, events and releases from Sentry.',
+    details:
+      'Sign in to Sentry’s MCP server so agents can investigate errors with the tools you allow.',
+    triggers: [],
+    actions: [],
+    auth: { mcp: { server: 'https://mcp.sentry.dev/mcp' } },
+    ownership: ['user', 'workspace'],
+    fields: [],
+  },
+  {
+    id: 'mcp-stripe',
+    name: 'Stripe MCP',
+    category: 'MCP servers',
+    logo: 'stripe',
+    description: 'Stripe’s hosted MCP server.',
+    details:
+      'Sign in to Stripe’s MCP server. Tools that change data, such as refunds, always ask for approval.',
+    triggers: [],
+    actions: [],
+    auth: { mcp: { server: 'https://mcp.stripe.com' } },
+    ownership: ['workspace', 'user'],
+    fields: [],
+  },
+  {
+    id: 'mcp',
+    name: 'Custom MCP server',
+    category: 'MCP servers',
+    logo: 'mcp',
+    description: 'Any hosted MCP server with OAuth.',
+    details:
+      'Paste the server’s URL. Connect discovers how to sign in, registers this app with the server and keeps the token fresh.',
+    triggers: [],
+    actions: [],
+    auth: { mcp: {} },
+    ownership: ['user', 'workspace'],
+    fields: [],
+  },
+]
+
+export const INTEGRATION_CATEGORIES = [
+  'All',
+  'Analytics',
+  'Ads',
+  'Code',
+  'Commerce',
+  'CRM',
+  'Communication',
+  'Productivity',
+  'MCP servers',
+] as const
+
+export function getIntegrationDefinition(id: string) {
+  return INTEGRATION_CATALOG.find((entry) => entry.id === id)
+}
+
+/**
+ * The tool name agents see. The first connection of an integration keeps the
+ * plain `provider_action` name; further accounts add their connection id so
+ * an agent can be pointed at one of them explicitly.
+ */
+export function getIntegrationToolName(provider: string, action: string, binding?: number) {
+  const base = `${provider.replace(/[^a-zA-Z0-9]/g, '_')}${binding ? `_${binding}` : ''}`
+  return `${base}_${action.replace(/[^a-zA-Z0-9_-]/g, '_')}`.slice(0, 64)
+}
+
+/** Whether an MCP tool changes data, by its own annotations: unannotated tools are treated as writes. */
+export function isMcpWrite(annotations?: { readOnlyHint?: boolean; destructiveHint?: boolean }) {
+  return annotations?.readOnlyHint !== true
+}

package/runtime/shared/google-mcp.ts

@@ -0,0 +1,8 @@
+/** Google endpoints allowed to receive a connected Google account's access token. */
+export const GOOGLE_MCP_SERVERS = {
+  gcal: 'https://calendarmcp.googleapis.com/mcp/v1',
+  gmail: 'https://gmailmcp.googleapis.com/mcp/v1',
+  gdrive: 'https://drivemcp.googleapis.com/mcp/v1',
+} as const
+
+export const GOOGLE_MCP_ENDPOINTS = Object.values(GOOGLE_MCP_SERVERS)

package/runtime/workspace.ts

@@ -0,0 +1,15 @@
+import type { WorkspaceContribution } from '@nuxtagentic/workspace/runtime/types'
+import { computed } from 'vue'
+
+export const integrationsContribution = {
+  id: 'integrations',
+  label: 'Integrations',
+  icon: 'i-lucide-plug',
+  matchesRoute: (route) => route.path === '/dashboard/integrations',
+  navigation: { order: 60, group: 'workspace' },
+  navigationShortcuts: [
+    { label: 'Integrations', icon: 'i-lucide-plug', to: '/dashboard/integrations' },
+  ],
+  layout: { navbar: true, hideExpand: true },
+  usePromptPresentation: () => computed(() => ({ hidden: true })),
+} satisfies WorkspaceContribution