@apteva/integrations 0.1.0

package/src/apps/github.json

@@ -0,0 +1,96 @@
+{
+  "slug": "github",
+  "name": "GitHub",
+  "description": "Code hosting, issues, pull requests, and repository management",
+  "logo": null,
+  "categories": ["developer-tools", "version-control"],
+  "base_url": "https://api.github.com",
+  "auth": {
+    "types": ["bearer", "oauth2"],
+    "headers": { "Authorization": "Bearer {{token}}", "Accept": "application/vnd.github+json" },
+    "oauth2": {
+      "authorize_url": "https://github.com/login/oauth/authorize",
+      "token_url": "https://github.com/login/oauth/access_token",
+      "scopes": ["repo", "read:user", "read:org"],
+      "client_id_required": true,
+      "pkce": false
+    }
+  },
+  "tools": [
+    {
+      "name": "list_repos",
+      "description": "List repositories for the authenticated user",
+      "method": "GET",
+      "path": "/user/repos",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "sort": { "type": "string", "enum": ["created", "updated", "pushed", "full_name"], "description": "Sort field" },
+          "per_page": { "type": "number", "description": "Results per page (max 100)", "default": 30 }
+        }
+      }
+    },
+    {
+      "name": "get_repo",
+      "description": "Get a repository by owner and name",
+      "method": "GET",
+      "path": "/repos/{owner}/{repo}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": { "type": "string", "description": "Repository owner" },
+          "repo": { "type": "string", "description": "Repository name" }
+        },
+        "required": ["owner", "repo"]
+      }
+    },
+    {
+      "name": "list_issues",
+      "description": "List issues for a repository",
+      "method": "GET",
+      "path": "/repos/{owner}/{repo}/issues",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": { "type": "string", "description": "Repository owner" },
+          "repo": { "type": "string", "description": "Repository name" },
+          "state": { "type": "string", "enum": ["open", "closed", "all"], "default": "open" },
+          "per_page": { "type": "number", "default": 30 }
+        },
+        "required": ["owner", "repo"]
+      }
+    },
+    {
+      "name": "create_issue",
+      "description": "Create an issue in a repository",
+      "method": "POST",
+      "path": "/repos/{owner}/{repo}/issues",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": { "type": "string", "description": "Repository owner" },
+          "repo": { "type": "string", "description": "Repository name" },
+          "title": { "type": "string", "description": "Issue title" },
+          "body": { "type": "string", "description": "Issue body (markdown)" },
+          "labels": { "type": "array", "items": { "type": "string" }, "description": "Label names" }
+        },
+        "required": ["owner", "repo", "title"]
+      }
+    },
+    {
+      "name": "list_pull_requests",
+      "description": "List pull requests for a repository",
+      "method": "GET",
+      "path": "/repos/{owner}/{repo}/pulls",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": { "type": "string", "description": "Repository owner" },
+          "repo": { "type": "string", "description": "Repository name" },
+          "state": { "type": "string", "enum": ["open", "closed", "all"], "default": "open" }
+        },
+        "required": ["owner", "repo"]
+      }
+    }
+  ]
+}

package/src/apps/gmail.json

@@ -0,0 +1,62 @@
+{
+  "slug": "gmail",
+  "name": "Gmail",
+  "description": "Email sending, reading, and management via Gmail API",
+  "logo": null,
+  "categories": ["communication", "email"],
+  "base_url": "https://gmail.googleapis.com/gmail/v1",
+  "auth": {
+    "types": ["oauth2"],
+    "headers": { "Authorization": "Bearer {{token}}", "Content-Type": "application/json" },
+    "oauth2": {
+      "authorize_url": "https://accounts.google.com/o/oauth2/v2/auth",
+      "token_url": "https://oauth2.googleapis.com/token",
+      "scopes": ["https://www.googleapis.com/auth/gmail.readonly", "https://www.googleapis.com/auth/gmail.send"],
+      "client_id_required": true,
+      "pkce": false
+    }
+  },
+  "tools": [
+    {
+      "name": "list_messages",
+      "description": "List messages in the mailbox",
+      "method": "GET",
+      "path": "/users/me/messages",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "q": { "type": "string", "description": "Gmail search query (e.g. 'from:user@example.com')" },
+          "maxResults": { "type": "number", "default": 10 },
+          "labelIds": { "type": "array", "items": { "type": "string" }, "description": "Filter by label" }
+        }
+      }
+    },
+    {
+      "name": "get_message",
+      "description": "Get a specific email message",
+      "method": "GET",
+      "path": "/users/me/messages/{id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "id": { "type": "string", "description": "Message ID" },
+          "format": { "type": "string", "enum": ["full", "metadata", "minimal"], "default": "full" }
+        },
+        "required": ["id"]
+      }
+    },
+    {
+      "name": "send_message",
+      "description": "Send an email message",
+      "method": "POST",
+      "path": "/users/me/messages/send",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "raw": { "type": "string", "description": "Base64url-encoded RFC 2822 email message" }
+        },
+        "required": ["raw"]
+      }
+    }
+  ]
+}

package/src/apps/google-calendar.json

@@ -0,0 +1,68 @@
+{
+  "slug": "google-calendar",
+  "name": "Google Calendar",
+  "description": "Calendar events, scheduling, and availability management",
+  "logo": null,
+  "categories": ["productivity", "calendar"],
+  "base_url": "https://www.googleapis.com/calendar/v3",
+  "auth": {
+    "types": ["oauth2"],
+    "headers": { "Authorization": "Bearer {{token}}", "Content-Type": "application/json" },
+    "oauth2": {
+      "authorize_url": "https://accounts.google.com/o/oauth2/v2/auth",
+      "token_url": "https://oauth2.googleapis.com/token",
+      "scopes": ["https://www.googleapis.com/auth/calendar", "https://www.googleapis.com/auth/calendar.events"],
+      "client_id_required": true,
+      "pkce": false
+    }
+  },
+  "tools": [
+    {
+      "name": "list_calendars",
+      "description": "List all calendars for the user",
+      "method": "GET",
+      "path": "/users/me/calendarList",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "maxResults": { "type": "number", "default": 50 }
+        }
+      }
+    },
+    {
+      "name": "list_events",
+      "description": "List upcoming events from a calendar",
+      "method": "GET",
+      "path": "/calendars/{calendarId}/events",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "calendarId": { "type": "string", "description": "Calendar ID", "default": "primary" },
+          "maxResults": { "type": "number", "default": 10 },
+          "timeMin": { "type": "string", "description": "Start time (RFC3339)" },
+          "timeMax": { "type": "string", "description": "End time (RFC3339)" },
+          "orderBy": { "type": "string", "default": "startTime" },
+          "singleEvents": { "type": "boolean", "default": true }
+        }
+      }
+    },
+    {
+      "name": "create_event",
+      "description": "Create a new calendar event",
+      "method": "POST",
+      "path": "/calendars/{calendarId}/events",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "calendarId": { "type": "string", "default": "primary" },
+          "summary": { "type": "string", "description": "Event title" },
+          "description": { "type": "string", "description": "Event description" },
+          "start": { "type": "object", "description": "Start time { dateTime, timeZone }" },
+          "end": { "type": "object", "description": "End time { dateTime, timeZone }" },
+          "attendees": { "type": "array", "items": { "type": "object" }, "description": "Attendee list" }
+        },
+        "required": ["summary", "start", "end"]
+      }
+    }
+  ]
+}

package/src/apps/linear.json

@@ -0,0 +1,85 @@
+{
+  "slug": "linear",
+  "name": "Linear",
+  "description": "Issue tracking and project management for software teams",
+  "logo": null,
+  "categories": ["project-management", "developer-tools"],
+  "base_url": "https://api.linear.app",
+  "auth": {
+    "types": ["bearer", "oauth2"],
+    "headers": { "Authorization": "Bearer {{token}}", "Content-Type": "application/json" },
+    "oauth2": {
+      "authorize_url": "https://linear.app/oauth/authorize",
+      "token_url": "https://api.linear.app/oauth/token",
+      "scopes": ["read", "write", "issues:create"],
+      "client_id_required": true,
+      "pkce": false
+    }
+  },
+  "tools": [
+    {
+      "name": "list_issues",
+      "description": "List issues (GraphQL query)",
+      "method": "POST",
+      "path": "/graphql",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "default": "{ issues(first: 20) { nodes { id title state { name } assignee { name } priority createdAt } } }",
+            "description": "GraphQL query"
+          }
+        }
+      }
+    },
+    {
+      "name": "create_issue",
+      "description": "Create a new issue",
+      "method": "POST",
+      "path": "/graphql",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "default": "mutation($input: IssueCreateInput!) { issueCreate(input: $input) { success issue { id title url } } }",
+            "description": "GraphQL mutation"
+          },
+          "variables": {
+            "type": "object",
+            "description": "Variables: { input: { title, description, teamId, priority } }",
+            "properties": {
+              "input": {
+                "type": "object",
+                "properties": {
+                  "title": { "type": "string" },
+                  "description": { "type": "string" },
+                  "teamId": { "type": "string" },
+                  "priority": { "type": "number" }
+                },
+                "required": ["title", "teamId"]
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "name": "list_teams",
+      "description": "List teams",
+      "method": "POST",
+      "path": "/graphql",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "default": "{ teams { nodes { id name key } } }",
+            "description": "GraphQL query"
+          }
+        }
+      }
+    }
+  ]
+}

package/src/apps/notion.json

@@ -0,0 +1,102 @@
+{
+  "slug": "notion",
+  "name": "Notion",
+  "description": "Workspace for notes, docs, databases, and project management",
+  "logo": null,
+  "categories": ["productivity", "project-management"],
+  "base_url": "https://api.notion.com/v1",
+  "auth": {
+    "types": ["bearer", "oauth2"],
+    "headers": { "Authorization": "Bearer {{token}}", "Notion-Version": "2022-06-28", "Content-Type": "application/json" },
+    "oauth2": {
+      "authorize_url": "https://api.notion.com/v1/oauth/authorize",
+      "token_url": "https://api.notion.com/v1/oauth/token",
+      "scopes": [],
+      "client_id_required": true,
+      "pkce": false
+    }
+  },
+  "tools": [
+    {
+      "name": "search",
+      "description": "Search pages and databases in the workspace",
+      "method": "POST",
+      "path": "/search",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "query": { "type": "string", "description": "Search query" },
+          "filter": {
+            "type": "object",
+            "description": "Filter by object type",
+            "properties": {
+              "value": { "type": "string", "enum": ["page", "database"] },
+              "property": { "type": "string", "default": "object" }
+            }
+          },
+          "page_size": { "type": "number", "description": "Max results", "default": 10 }
+        }
+      }
+    },
+    {
+      "name": "get_page",
+      "description": "Get a page by ID",
+      "method": "GET",
+      "path": "/pages/{page_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "page_id": { "type": "string", "description": "Page ID" }
+        },
+        "required": ["page_id"]
+      }
+    },
+    {
+      "name": "create_page",
+      "description": "Create a new page in a database or as a child of another page",
+      "method": "POST",
+      "path": "/pages",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "parent": { "type": "object", "description": "Parent (database_id or page_id)" },
+          "properties": { "type": "object", "description": "Page properties" }
+        },
+        "required": ["parent", "properties"]
+      }
+    },
+    {
+      "name": "query_database",
+      "description": "Query a database with optional filters and sorts",
+      "method": "POST",
+      "path": "/databases/{database_id}/query",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "database_id": { "type": "string", "description": "Database ID" },
+          "filter": { "type": "object", "description": "Filter conditions" },
+          "sorts": { "type": "array", "description": "Sort conditions" },
+          "page_size": { "type": "number", "description": "Max results", "default": 10 }
+        },
+        "required": ["database_id"]
+      }
+    },
+    {
+      "name": "list_databases",
+      "description": "List all databases shared with the integration",
+      "method": "POST",
+      "path": "/search",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "filter": {
+            "type": "object",
+            "description": "Filter to databases only",
+            "default": { "value": "database", "property": "object" }
+          },
+          "page_size": { "type": "number", "default": 50 }
+        }
+      }
+    }
+  ]
+}

package/src/apps/pushover.json

@@ -0,0 +1,56 @@
+{
+  "slug": "pushover",
+  "name": "Pushover",
+  "description": "Real-time push notifications to mobile and desktop devices",
+  "logo": null,
+  "categories": ["communication", "notifications"],
+  "base_url": "https://api.pushover.net/1",
+  "auth": {
+    "types": ["api_key"],
+    "query_params": { "token": "{{api_key}}" }
+  },
+  "tools": [
+    {
+      "name": "send_notification",
+      "description": "Send a push notification to a user or group",
+      "method": "POST",
+      "path": "/messages.json",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "user": { "type": "string", "description": "User or group key to send the notification to" },
+          "message": { "type": "string", "description": "Notification message body" },
+          "title": { "type": "string", "description": "Notification title" },
+          "priority": { "type": "number", "description": "Priority: -2 (lowest) to 2 (emergency)", "default": 0 },
+          "sound": { "type": "string", "description": "Sound name (e.g. pushover, bike, bugle)" },
+          "url": { "type": "string", "description": "Supplementary URL to show with the message" },
+          "url_title": { "type": "string", "description": "Title for the supplementary URL" }
+        },
+        "required": ["user", "message"]
+      }
+    },
+    {
+      "name": "validate_user",
+      "description": "Validate a user or group key",
+      "method": "POST",
+      "path": "/users/validate.json",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "user": { "type": "string", "description": "User or group key to validate" }
+        },
+        "required": ["user"]
+      }
+    },
+    {
+      "name": "list_sounds",
+      "description": "List available notification sounds",
+      "method": "GET",
+      "path": "/sounds.json",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      }
+    }
+  ]
+}

package/src/apps/sendgrid.json

@@ -0,0 +1,63 @@
+{
+  "slug": "sendgrid",
+  "name": "SendGrid",
+  "description": "Email delivery and marketing campaigns",
+  "logo": null,
+  "categories": ["communication", "email"],
+  "base_url": "https://api.sendgrid.com/v3",
+  "auth": {
+    "types": ["bearer"],
+    "headers": { "Authorization": "Bearer {{token}}", "Content-Type": "application/json" }
+  },
+  "tools": [
+    {
+      "name": "send_email",
+      "description": "Send an email",
+      "method": "POST",
+      "path": "/mail/send",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "personalizations": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "to": { "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string" }, "name": { "type": "string" } } } },
+                "subject": { "type": "string" }
+              }
+            },
+            "description": "Recipients and personalization"
+          },
+          "from": {
+            "type": "object",
+            "properties": { "email": { "type": "string" }, "name": { "type": "string" } },
+            "description": "Sender"
+          },
+          "content": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "type": { "type": "string", "default": "text/plain" },
+                "value": { "type": "string" }
+              }
+            },
+            "description": "Email content"
+          }
+        },
+        "required": ["personalizations", "from", "content"]
+      }
+    },
+    {
+      "name": "list_contacts",
+      "description": "List marketing contacts",
+      "method": "GET",
+      "path": "/marketing/contacts",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      }
+    }
+  ]
+}

package/src/apps/slack.json

@@ -0,0 +1,74 @@
+{
+  "slug": "slack",
+  "name": "Slack",
+  "description": "Team messaging, channels, and workspace management",
+  "logo": null,
+  "categories": ["communication", "productivity"],
+  "base_url": "https://slack.com/api",
+  "auth": {
+    "types": ["bearer", "oauth2"],
+    "headers": { "Authorization": "Bearer {{token}}", "Content-Type": "application/json" },
+    "oauth2": {
+      "authorize_url": "https://slack.com/oauth/v2/authorize",
+      "token_url": "https://slack.com/api/oauth.v2.access",
+      "scopes": ["chat:write", "channels:read", "channels:history", "users:read"],
+      "client_id_required": true,
+      "pkce": false
+    }
+  },
+  "tools": [
+    {
+      "name": "send_message",
+      "description": "Send a message to a Slack channel",
+      "method": "POST",
+      "path": "/chat.postMessage",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "channel": { "type": "string", "description": "Channel ID or name" },
+          "text": { "type": "string", "description": "Message text" }
+        },
+        "required": ["channel", "text"]
+      }
+    },
+    {
+      "name": "list_channels",
+      "description": "List public channels in the workspace",
+      "method": "GET",
+      "path": "/conversations.list",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": { "type": "number", "description": "Max channels to return", "default": 100 },
+          "types": { "type": "string", "description": "Channel types", "default": "public_channel" }
+        }
+      }
+    },
+    {
+      "name": "get_channel_history",
+      "description": "Get message history for a channel",
+      "method": "GET",
+      "path": "/conversations.history",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "channel": { "type": "string", "description": "Channel ID" },
+          "limit": { "type": "number", "description": "Max messages", "default": 20 }
+        },
+        "required": ["channel"]
+      }
+    },
+    {
+      "name": "list_users",
+      "description": "List users in the workspace",
+      "method": "GET",
+      "path": "/users.list",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": { "type": "number", "description": "Max users to return", "default": 100 }
+        }
+      }
+    }
+  ]
+}