@apteva/integrations 0.3.62 → 0.15.3

package/src/apps/gmail.json

@@ -66,6 +66,12 @@
       "input_schema": {
         "type": "object",
         "properties": {}
+      },
+      "mock_response": {
+        "emailAddress": "agent@example.com",
+        "messagesTotal": 1284,
+        "threadsTotal": 967,
+        "historyId": "987654"
       }
     },
     {
@@ -122,6 +128,13 @@
           "subject",
           "body"
         ]
+      },
+      "mock_response": {
+        "id": "18f1a2b3c4d5e6f7",
+        "threadId": "18f1a2b3c4d5e6f7",
+        "labelIds": [
+          "SENT"
+        ]
       }
     },
     {
@@ -159,6 +172,20 @@
             "default": false
           }
         }
+      },
+      "mock_response": {
+        "messages": [
+          {
+            "id": "18f1a2b3c4d5e6f7",
+            "threadId": "18f1a2b3c4d5e6f7"
+          },
+          {
+            "id": "18f1aaaabbbbcccc",
+            "threadId": "18f1aaaabbbbcccc"
+          }
+        ],
+        "nextPageToken": "09876543210987654321",
+        "resultSizeEstimate": 2
       }
     },
     {
@@ -192,6 +219,38 @@
         "required": [
           "messageId"
         ]
+      },
+      "mock_response": {
+        "id": "18f1a2b3c4d5e6f7",
+        "threadId": "18f1a2b3c4d5e6f7",
+        "labelIds": [
+          "INBOX",
+          "UNREAD"
+        ],
+        "snippet": "Hi there, just following up on the proposal we discussed last week...",
+        "payload": {
+          "mimeType": "text/plain",
+          "headers": [
+            {
+              "name": "From",
+              "value": "Alice Martin <alice@example.com>"
+            },
+            {
+              "name": "To",
+              "value": "agent@example.com"
+            },
+            {
+              "name": "Subject",
+              "value": "Following up on the proposal"
+            },
+            {
+              "name": "Date",
+              "value": "Wed, 22 May 2026 10:00:00 +0000"
+            }
+          ]
+        },
+        "sizeEstimate": 4096,
+        "internalDate": "1747908000000"
       }
     },
     {
@@ -224,6 +283,13 @@
         "required": [
           "messageId"
         ]
+      },
+      "mock_response": {
+        "id": "18f1a2b3c4d5e6f7",
+        "threadId": "18f1a2b3c4d5e6f7",
+        "labelIds": [
+          "INBOX"
+        ]
       }
     },
     {
@@ -242,6 +308,13 @@
         "required": [
           "messageId"
         ]
+      },
+      "mock_response": {
+        "id": "18f1a2b3c4d5e6f7",
+        "threadId": "18f1a2b3c4d5e6f7",
+        "labelIds": [
+          "TRASH"
+        ]
       }
     },
     {
@@ -371,6 +444,16 @@
             "default": false
           }
         }
+      },
+      "mock_response": {
+        "threads": [
+          {
+            "id": "18f1a2b3c4d5e6f7",
+            "snippet": "Hi there, just following up on the proposal...",
+            "historyId": "987600"
+          }
+        ],
+        "resultSizeEstimate": 1
       }
     },
     {
@@ -400,6 +483,21 @@
         "required": [
           "threadId"
         ]
+      },
+      "mock_response": {
+        "id": "18f1a2b3c4d5e6f7",
+        "historyId": "987600",
+        "messages": [
+          {
+            "id": "18f1a2b3c4d5e6f7",
+            "threadId": "18f1a2b3c4d5e6f7",
+            "labelIds": [
+              "INBOX",
+              "UNREAD"
+            ],
+            "snippet": "Hi there, just following up on the proposal..."
+          }
+        ]
       }
     },
     {
@@ -496,6 +594,30 @@
       "input_schema": {
         "type": "object",
         "properties": {}
+      },
+      "mock_response": {
+        "labels": [
+          {
+            "id": "INBOX",
+            "name": "INBOX",
+            "type": "system"
+          },
+          {
+            "id": "SENT",
+            "name": "SENT",
+            "type": "system"
+          },
+          {
+            "id": "UNREAD",
+            "name": "UNREAD",
+            "type": "system"
+          },
+          {
+            "id": "Label_42",
+            "name": "Follow-up",
+            "type": "user"
+          }
+        ]
       }
     },
     {
@@ -565,6 +687,13 @@
         "required": [
           "name"
         ]
+      },
+      "mock_response": {
+        "id": "Label_42",
+        "name": "Follow-up",
+        "type": "user",
+        "messageListVisibility": "show",
+        "labelListVisibility": "labelShow"
       }
     },
     {
@@ -733,11 +862,21 @@
           "subject",
           "body"
         ]
+      },
+      "mock_response": {
+        "id": "r-1234567890123456",
+        "message": {
+          "id": "18f1ccccddddeeee",
+          "threadId": "18f1ccccddddeeee",
+          "labelIds": [
+            "DRAFT"
+          ]
+        }
       }
     },
     {
       "name": "update_draft",
-      "description": "Update an existing draft's content (replaces the entire draft message). Provide plain-text fields — the system handles RFC 2822 encoding automatically.",
+      "description": "Update an existing draft's content (replaces the entire draft message). Provide plain-text fields \u2014 the system handles RFC 2822 encoding automatically.",
       "method": "PUT",
       "path": "/users/me/drafts/{draftId}",
       "input_schema": {
@@ -822,6 +961,13 @@
         "required": [
           "id"
         ]
+      },
+      "mock_response": {
+        "id": "18f1ccccddddeeee",
+        "threadId": "18f1ccccddddeeee",
+        "labelIds": [
+          "SENT"
+        ]
       }
     },
     {
@@ -1371,5 +1517,8 @@
         ]
       }
     }
-  ]
+  ],
+  "health_check": {
+    "tool": "get_profile"
+  }
 }

package/src/apps/gnews.json

@@ -0,0 +1,71 @@
+{
+  "slug": "gnews",
+  "name": "GNews",
+  "description": "Search engine for news articles aggregated from 60,000+ sources globally. Stronger international + non-English coverage than NewsAPI (especially solid for European + Asian sources). Returns title, description, content (truncated), url, image, source, and publishedAt per article. Free tier: 100 requests/day, max 10 articles per request. Sign up at https://gnews.io/register.",
+  "logo": "https://www.google.com/s2/favicons?domain=gnews.io&sz=128",
+  "categories": [
+    "news",
+    "search",
+    "international",
+    "media"
+  ],
+  "base_url": "https://gnews.io/api/v4",
+  "auth": {
+    "types": ["api_key"],
+    "query_params": {
+      "apikey": "{{api_key}}"
+    },
+    "credential_fields": [
+      {
+        "name": "api_key",
+        "label": "API Key",
+        "description": "From https://gnews.io/dashboard. Free tier: 100 req/day."
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "search",
+      "description": "Full-text article search. q supports AND / OR / NOT / quoted phrases. Use for broad news pulls including non-English coverage. Example: q='Fed cut rate', lang='en' returns US Fed coverage; lang='de' for German press takes.",
+      "method": "GET",
+      "path": "/search",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "q":          {"type": "string", "description": "Free-text query."},
+          "lang":       {"type": "string", "description": "ISO 639-1 lang code — en, fr, de, es, it, pt, ja, zh, etc. Default: en."},
+          "country":    {"type": "string", "description": "ISO 3166-1 alpha-2 country code — us, gb, fr, de, jp."},
+          "max":        {"type": "integer", "description": "Articles to return (1-100, free tier max 10)."},
+          "in":         {"type": "string", "description": "Comma-separated fields to match q against: title, description, content. Default: title,description."},
+          "nullable":   {"type": "string", "description": "Comma-separated fields that can be null — image, description, content."},
+          "from":       {"type": "string", "description": "ISO date — articles on/after."},
+          "to":         {"type": "string", "description": "ISO date — articles on/before."},
+          "sortby":     {"type": "string", "enum": ["publishedAt","relevance"], "default": "publishedAt"}
+        },
+        "required": ["q"]
+      }
+    },
+    {
+      "name": "top_headlines",
+      "description": "Top news headlines by country + category. Returns the current top stories. Use for daily macro sentiment scans.",
+      "method": "GET",
+      "path": "/top-headlines",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "category": {"type": "string", "enum": ["general","world","nation","business","technology","entertainment","sports","science","health"]},
+          "lang":     {"type": "string", "default": "en"},
+          "country":  {"type": "string", "description": "ISO country code, default us."},
+          "max":      {"type": "integer", "description": "1-100, free tier max 10."},
+          "q":        {"type": "string", "description": "Optional keyword filter."},
+          "from":     {"type": "string"},
+          "to":       {"type": "string"}
+        }
+      }
+    }
+  ],
+  "health_check": {
+    "tool": "top_headlines",
+    "args": {"category": "business", "lang": "en", "max": 1}
+  }
+}

package/src/apps/google-analytics.json

@@ -0,0 +1,311 @@
+{
+  "slug": "google-analytics",
+  "name": "Google Analytics",
+  "description": "Google Analytics 4 (GA4) Data API — run reports, realtime queries, pivot reports, and inspect property metadata. Pull metrics like activeUsers, sessions, conversions, eventCount across any dimension (date, country, source, eventName, etc.).",
+  "logo": "https://www.google.com/s2/favicons?domain=analytics.google.com&sz=128",
+  "categories": [
+    "analytics",
+    "web-analytics",
+    "ga4",
+    "google",
+    "metrics",
+    "reporting",
+    "marketing"
+  ],
+  "base_url": "https://analyticsdata.googleapis.com/v1beta",
+  "auth": {
+    "types": [
+      "oauth2"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "access_token"
+      },
+      {
+        "name": "refresh_token",
+        "label": "refresh_token"
+      }
+    ],
+    "oauth2": {
+      "authorize_url": "https://accounts.google.com/o/oauth2/v2/auth",
+      "token_url": "https://oauth2.googleapis.com/token",
+      "scopes": [
+        "https://www.googleapis.com/auth/analytics.readonly"
+      ],
+      "client_id_required": true,
+      "pkce": false,
+      "extra_authorize_params": {
+        "access_type": "offline",
+        "prompt": "consent select_account",
+        "include_granted_scopes": "true"
+      }
+    }
+  },
+  "tools": [
+    {
+      "name": "run_report",
+      "description": "Run a GA4 report. Specify the property and one or more dimensions + metrics with date ranges. Returns rows of [dimensionValues, metricValues]. Common dimensions: date, country, sessionSource, deviceCategory, eventName, pagePath. Common metrics: activeUsers, sessions, screenPageViews, eventCount, conversions, totalRevenue.",
+      "method": "POST",
+      "path": "/properties/{property_id}:runReport",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "property_id": {
+            "type": "string",
+            "description": "GA4 property ID (numeric, e.g. '123456789'). Find it under Admin → Property Settings."
+          },
+          "dimensions": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            },
+            "description": "Dimension objects, e.g. [{ name: 'date' }, { name: 'country' }]."
+          },
+          "metrics": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            },
+            "description": "Metric objects, e.g. [{ name: 'activeUsers' }, { name: 'sessions' }]."
+          },
+          "dateRanges": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            },
+            "description": "Date ranges, e.g. [{ startDate: '7daysAgo', endDate: 'today' }] or [{ startDate: '2025-01-01', endDate: '2025-01-31', name: 'jan' }]."
+          },
+          "dimensionFilter": {
+            "type": "object",
+            "description": "Filter expression on dimension values. Example: { filter: { fieldName: 'country', stringFilter: { value: 'United States' } } }."
+          },
+          "metricFilter": {
+            "type": "object",
+            "description": "Filter on metric values."
+          },
+          "orderBys": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            },
+            "description": "Sort directives, e.g. [{ metric: { metricName: 'sessions' }, desc: true }]."
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Max rows (default 10000)."
+          },
+          "offset": {
+            "type": "integer"
+          },
+          "keepEmptyRows": {
+            "type": "boolean"
+          },
+          "currencyCode": {
+            "type": "string",
+            "description": "Override property currency (ISO-4217)."
+          }
+        },
+        "required": [
+          "property_id",
+          "metrics",
+          "dateRanges"
+        ]
+      }
+    },
+    {
+      "name": "run_realtime_report",
+      "description": "Run a realtime report over the past 30 minutes of traffic. Same shape as run_report but with a smaller dimension/metric set (no dateRanges — always now).",
+      "method": "POST",
+      "path": "/properties/{property_id}:runRealtimeReport",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "property_id": {
+            "type": "string"
+          },
+          "dimensions": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "metrics": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "dimensionFilter": {
+            "type": "object"
+          },
+          "metricFilter": {
+            "type": "object"
+          },
+          "orderBys": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "limit": {
+            "type": "integer"
+          },
+          "minuteRanges": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            },
+            "description": "[{ startMinutesAgo, endMinutesAgo, name? }]. Default is the last 30 minutes."
+          }
+        },
+        "required": [
+          "property_id",
+          "metrics"
+        ]
+      }
+    },
+    {
+      "name": "run_pivot_report",
+      "description": "Run a pivot report — produces multiple cross-tabulated tables for the same dimensions/metrics in one call.",
+      "method": "POST",
+      "path": "/properties/{property_id}:runPivotReport",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "property_id": {
+            "type": "string"
+          },
+          "dimensions": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "metrics": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "dateRanges": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "pivots": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            },
+            "description": "Pivot specs, each with fieldNames + orderBys + offset + limit."
+          },
+          "dimensionFilter": {
+            "type": "object"
+          },
+          "metricFilter": {
+            "type": "object"
+          },
+          "currencyCode": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "property_id",
+          "metrics",
+          "dateRanges",
+          "pivots"
+        ]
+      }
+    },
+    {
+      "name": "batch_run_reports",
+      "description": "Run multiple GA4 reports against the same property in a single request — saves round-trips when building dashboards.",
+      "method": "POST",
+      "path": "/properties/{property_id}:batchRunReports",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "property_id": {
+            "type": "string"
+          },
+          "requests": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            },
+            "description": "Array of run_report request bodies (max 5 per batch)."
+          }
+        },
+        "required": [
+          "property_id",
+          "requests"
+        ]
+      }
+    },
+    {
+      "name": "get_metadata",
+      "description": "List every dimension and metric available for a property — names, descriptions, categories, deprecation status, custom-event dimensions. Essential for discovering what you can query.",
+      "method": "GET",
+      "path": "/properties/{property_id}/metadata",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "property_id": {
+            "type": "string",
+            "description": "GA4 property ID. Use '0' to fetch the universal (non-property-scoped) metadata schema."
+          }
+        },
+        "required": [
+          "property_id"
+        ]
+      }
+    },
+    {
+      "name": "check_compatibility",
+      "description": "Check whether a set of dimensions/metrics can be used together in a report. GA4 has compatibility constraints; this tells you up front.",
+      "method": "POST",
+      "path": "/properties/{property_id}:checkCompatibility",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "property_id": {
+            "type": "string"
+          },
+          "dimensions": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "metrics": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "dimensionFilter": {
+            "type": "object"
+          },
+          "metricFilter": {
+            "type": "object"
+          },
+          "compatibilityFilter": {
+            "type": "string",
+            "enum": [
+              "COMPATIBLE",
+              "INCOMPATIBLE"
+            ]
+          }
+        },
+        "required": [
+          "property_id"
+        ]
+      }
+    }
+  ]
+}