@polpo-ai/connectors 0.15.4

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2026-present Lumea Labs
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,14 @@
+# @polpo-ai/connectors
+
+Curated connector provider definitions for Polpo Connect.
+
+The initial catalog includes:
+
+- API Key
+- GitHub
+- Slack
+- Google Drive
+- MCP Server URL
+- a factory for custom OAuth2 connectors
+
+These definitions describe auth mode, scopes, agent-facing actions, and triggers. They do not execute provider API calls by themselves; execution belongs to connector tools/runtime integrations.

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import type { ConnectorProviderDefinition } from "@polpo-ai/connect";
+export declare const apiKeyConnector: ConnectorProviderDefinition;
+export declare const githubConnector: ConnectorProviderDefinition;
+export declare const slackConnector: ConnectorProviderDefinition;
+export declare const googleDriveConnector: ConnectorProviderDefinition;
+export declare const mcpUrlConnector: ConnectorProviderDefinition;
+export declare function createGenericOAuthConnector(input: {
+    id: string;
+    name: string;
+    authorizationUrl: string;
+    tokenUrl: string;
+    revokeUrl?: string;
+    defaultScopes?: string[];
+    description?: string;
+}): ConnectorProviderDefinition;
+export declare const defaultConnectors: ConnectorProviderDefinition[];
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAErE,eAAO,MAAM,eAAe,EAAE,2BAkB7B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,2BAyC7B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,2BAkC5B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,2BAkClC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,2BA6B7B,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,2BAA2B,CAc9B;AAED,eAAO,MAAM,iBAAiB,EAAE,2BAA2B,EAM1D,CAAC"}

package/dist/index.js

@@ -0,0 +1,184 @@
+export const apiKeyConnector = {
+    id: "api_key",
+    name: "API Key",
+    description: "Store a project or user API key and expose it to approved connector tools without showing it to the model.",
+    auth: {
+        type: "api_key",
+        defaultScopes: ["use"],
+    },
+    scopes: [{ id: "use", label: "Use API key" }],
+    actions: [
+        {
+            id: "api_key_get_token",
+            label: "Get runtime token",
+            description: "Resolve the stored API key for server-side tool execution.",
+            scopes: ["use"],
+            risk: "read",
+        },
+    ],
+};
+export const githubConnector = {
+    id: "github",
+    name: "GitHub",
+    description: "Read repositories, inspect issues and pull requests, and create issues through scoped GitHub OAuth.",
+    auth: {
+        type: "oauth2",
+        authorizationUrl: "https://github.com/login/oauth/authorize",
+        tokenUrl: "https://github.com/login/oauth/access_token",
+        defaultScopes: ["read:user", "repo"],
+    },
+    scopes: [
+        { id: "read:user", label: "Read user profile" },
+        { id: "repo", label: "Repository read/write", dangerous: true },
+    ],
+    actions: [
+        {
+            id: "github_list_repos",
+            label: "List repositories",
+            description: "List repositories visible to the connected account.",
+            scopes: ["repo"],
+            risk: "read",
+        },
+        {
+            id: "github_create_issue",
+            label: "Create issue",
+            description: "Create an issue in an authorized repository.",
+            scopes: ["repo"],
+            risk: "write",
+        },
+        {
+            id: "github_read_file",
+            label: "Read file",
+            description: "Read a file from an authorized repository.",
+            scopes: ["repo"],
+            risk: "read",
+        },
+    ],
+    triggers: [
+        { id: "github_issue_opened", label: "Issue opened", scopes: ["repo"] },
+        { id: "github_pr_opened", label: "Pull request opened", scopes: ["repo"] },
+    ],
+};
+export const slackConnector = {
+    id: "slack",
+    name: "Slack",
+    description: "Read channels and send messages through scoped Slack OAuth.",
+    auth: {
+        type: "oauth2",
+        authorizationUrl: "https://slack.com/oauth/v2/authorize",
+        tokenUrl: "https://slack.com/api/oauth.v2.access",
+        defaultScopes: ["channels:read", "chat:write"],
+    },
+    scopes: [
+        { id: "channels:read", label: "Read channels" },
+        { id: "chat:write", label: "Send messages", dangerous: true },
+        { id: "users:read", label: "Read users" },
+    ],
+    actions: [
+        {
+            id: "slack_list_channels",
+            label: "List channels",
+            description: "List channels available to the connected Slack installation.",
+            scopes: ["channels:read"],
+            risk: "read",
+        },
+        {
+            id: "slack_send_message",
+            label: "Send message",
+            description: "Send a message to an authorized Slack channel.",
+            scopes: ["chat:write"],
+            risk: "write",
+        },
+    ],
+    triggers: [
+        { id: "slack_message_posted", label: "Message posted", scopes: ["channels:read"] },
+    ],
+};
+export const googleDriveConnector = {
+    id: "google_drive",
+    name: "Google Drive",
+    description: "Search and read Drive files through scoped Google OAuth.",
+    auth: {
+        type: "oauth2",
+        authorizationUrl: "https://accounts.google.com/o/oauth2/v2/auth",
+        tokenUrl: "https://oauth2.googleapis.com/token",
+        defaultScopes: ["https://www.googleapis.com/auth/drive.readonly"],
+        extraAuthorizeParams: {
+            access_type: "offline",
+            prompt: "consent",
+        },
+    },
+    scopes: [
+        { id: "https://www.googleapis.com/auth/drive.readonly", label: "Read Drive files" },
+        { id: "https://www.googleapis.com/auth/drive.file", label: "Create and edit selected Drive files", dangerous: true },
+    ],
+    actions: [
+        {
+            id: "drive_search_files",
+            label: "Search files",
+            description: "Search files in the connected Google Drive.",
+            scopes: ["https://www.googleapis.com/auth/drive.readonly"],
+            risk: "read",
+        },
+        {
+            id: "drive_read_file",
+            label: "Read file",
+            description: "Read an authorized file from Google Drive.",
+            scopes: ["https://www.googleapis.com/auth/drive.readonly"],
+            risk: "read",
+        },
+    ],
+};
+export const mcpUrlConnector = {
+    id: "mcp_url",
+    name: "MCP Server URL",
+    description: "Connect a remote MCP server and expose discovered tools through Polpo permissions and traces.",
+    auth: {
+        type: "mcp",
+        auth: "bearer",
+        defaultScopes: ["tools:read", "tools:call"],
+    },
+    scopes: [
+        { id: "tools:read", label: "Discover tools" },
+        { id: "tools:call", label: "Call tools", dangerous: true },
+    ],
+    actions: [
+        {
+            id: "mcp_discover_tools",
+            label: "Discover MCP tools",
+            description: "List tools exposed by the connected MCP server.",
+            scopes: ["tools:read"],
+            risk: "read",
+        },
+        {
+            id: "mcp_call_tool",
+            label: "Call MCP tool",
+            description: "Call an allowlisted tool on the connected MCP server.",
+            scopes: ["tools:call"],
+            risk: "write",
+        },
+    ],
+};
+export function createGenericOAuthConnector(input) {
+    return {
+        id: input.id,
+        name: input.name,
+        description: input.description ?? "Custom OAuth2 connector.",
+        allowCustomScopes: true,
+        auth: {
+            type: "oauth2",
+            authorizationUrl: input.authorizationUrl,
+            tokenUrl: input.tokenUrl,
+            revokeUrl: input.revokeUrl,
+            defaultScopes: input.defaultScopes,
+        },
+    };
+}
+export const defaultConnectors = [
+    apiKeyConnector,
+    githubConnector,
+    slackConnector,
+    googleDriveConnector,
+    mcpUrlConnector,
+];
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@polpo-ai/connectors",
+  "version": "0.15.4",
+  "description": "Curated connector provider definitions for Polpo Connect",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@polpo-ai/connect": "0.15.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.4"
+  },
+  "license": "Apache-2.0",
+  "keywords": [
+    "polpo",
+    "connectors",
+    "oauth",
+    "github",
+    "slack",
+    "google-drive",
+    "mcp"
+  ],
+  "author": "OpenPolpo Contributors",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lumea-labs/polpo.git",
+    "directory": "packages/connectors"
+  },
+  "homepage": "https://github.com/lumea-labs/polpo/tree/main/packages/connectors",
+  "bugs": {
+    "url": "https://github.com/lumea-labs/polpo/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run"
+  }
+}