connectors 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (112) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGELOG.md +35 -0
  3. data/CONNECTORS_FRAMEWORK.md +799 -0
  4. data/CONTRIBUTING.md +60 -0
  5. data/MCP_CLIENT.md +168 -0
  6. data/MIT-LICENSE +20 -0
  7. data/README.md +146 -0
  8. data/app/connectors/clickup/connector.rb +13 -0
  9. data/app/connectors/gmail/api.rb +114 -0
  10. data/app/connectors/gmail/connector.rb +921 -0
  11. data/app/connectors/gmail/mime_builder.rb +261 -0
  12. data/app/connectors/gmail/mime_parser.rb +106 -0
  13. data/app/connectors/gmail/polling.rb +154 -0
  14. data/app/connectors/remote_mcp/connector.rb +18 -0
  15. data/app/connectors/resend/connector.rb +218 -0
  16. data/app/controllers/concerns/connectors/grant_access.rb +43 -0
  17. data/app/controllers/connectors/actions_controller.rb +66 -0
  18. data/app/controllers/connectors/application_controller.rb +5 -0
  19. data/app/controllers/connectors/credentials_controller.rb +245 -0
  20. data/app/controllers/connectors/grants_controller.rb +123 -0
  21. data/app/controllers/connectors/mcp_controller.rb +88 -0
  22. data/app/controllers/connectors/oauth_controller.rb +134 -0
  23. data/app/controllers/connectors/types_controller.rb +144 -0
  24. data/app/controllers/connectors/webhooks_controller.rb +105 -0
  25. data/app/jobs/connectors/application_job.rb +4 -0
  26. data/app/jobs/connectors/deliver_webhook_job.rb +27 -0
  27. data/app/jobs/connectors/poll_job.rb +49 -0
  28. data/app/models/connectors/application_record.rb +5 -0
  29. data/app/models/connectors/credential_share.rb +31 -0
  30. data/app/models/connectors/grant.rb +103 -0
  31. data/app/models/connectors/mcp_authorization.rb +6 -0
  32. data/app/models/connectors/mcp_interaction.rb +6 -0
  33. data/app/models/connectors/poll_state.rb +17 -0
  34. data/app/models/connectors/webhook_event.rb +19 -0
  35. data/config/routes.rb +68 -0
  36. data/db/migrate/20260518210324_create_connectors_grants.rb +49 -0
  37. data/db/migrate/20260518214609_create_connectors_webhook_events.rb +35 -0
  38. data/db/migrate/20260521140000_create_connectors_credential_shares.rb +26 -0
  39. data/db/migrate/20260922120000_create_connectors_poll_states.rb +12 -0
  40. data/db/migrate/20260922130000_create_connectors_mcp_transactions.rb +18 -0
  41. data/docs/adding-connectors.md +92 -0
  42. data/docs/architecture.md +71 -0
  43. data/docs/releasing.md +60 -0
  44. data/lib/connectors/action.rb +90 -0
  45. data/lib/connectors/action_builder.rb +125 -0
  46. data/lib/connectors/action_runner.rb +99 -0
  47. data/lib/connectors/auth/scheme/api_key.rb +51 -0
  48. data/lib/connectors/auth/scheme/oauth2.rb +23 -0
  49. data/lib/connectors/auth/scheme.rb +35 -0
  50. data/lib/connectors/auth.rb +4 -0
  51. data/lib/connectors/auth_injection.rb +65 -0
  52. data/lib/connectors/client_builder.rb +87 -0
  53. data/lib/connectors/configuration.rb +138 -0
  54. data/lib/connectors/connector.rb +565 -0
  55. data/lib/connectors/credential_schema.rb +219 -0
  56. data/lib/connectors/credential_tester.rb +85 -0
  57. data/lib/connectors/credential_type_registry.rb +162 -0
  58. data/lib/connectors/credential_types/http_auth.rb +171 -0
  59. data/lib/connectors/engine.rb +123 -0
  60. data/lib/connectors/errors.rb +88 -0
  61. data/lib/connectors/grant_policy.rb +13 -0
  62. data/lib/connectors/mcp/access.rb +50 -0
  63. data/lib/connectors/mcp/authorization.rb +177 -0
  64. data/lib/connectors/mcp/authorization_context.rb +25 -0
  65. data/lib/connectors/mcp/authorization_discovery.rb +42 -0
  66. data/lib/connectors/mcp/cancellation.rb +36 -0
  67. data/lib/connectors/mcp/client.rb +137 -0
  68. data/lib/connectors/mcp/connection_config.rb +48 -0
  69. data/lib/connectors/mcp/http.rb +108 -0
  70. data/lib/connectors/mcp/interaction.rb +82 -0
  71. data/lib/connectors/mcp/pending_transaction.rb +26 -0
  72. data/lib/connectors/mcp/protocol/2026-07-28.json +3963 -0
  73. data/lib/connectors/mcp/protocol/LICENSE +216 -0
  74. data/lib/connectors/mcp/protocol/README.md +8 -0
  75. data/lib/connectors/mcp/protocol_schema.rb +30 -0
  76. data/lib/connectors/mcp/schema.rb +45 -0
  77. data/lib/connectors/mcp/settings.rb +27 -0
  78. data/lib/connectors/mcp/token_endpoint.rb +48 -0
  79. data/lib/connectors/mcp/transport.rb +105 -0
  80. data/lib/connectors/mcp.rb +69 -0
  81. data/lib/connectors/middleware/authenticate_generic.rb +79 -0
  82. data/lib/connectors/middleware/auto_refresh.rb +71 -0
  83. data/lib/connectors/middleware/error_normalization.rb +45 -0
  84. data/lib/connectors/middleware/grant_status.rb +19 -0
  85. data/lib/connectors/middleware/pre_authentication.rb +54 -0
  86. data/lib/connectors/middleware/rate_limit.rb +40 -0
  87. data/lib/connectors/oauth/authorize_url.rb +78 -0
  88. data/lib/connectors/oauth/client_authentication.rb +24 -0
  89. data/lib/connectors/oauth/client_credentials.rb +43 -0
  90. data/lib/connectors/oauth/grant_writer.rb +73 -0
  91. data/lib/connectors/oauth/pkce.rb +32 -0
  92. data/lib/connectors/oauth/revoke.rb +72 -0
  93. data/lib/connectors/oauth/state.rb +41 -0
  94. data/lib/connectors/oauth/token_exchange.rb +69 -0
  95. data/lib/connectors/oauth/token_response.rb +40 -0
  96. data/lib/connectors/oauth.rb +4 -0
  97. data/lib/connectors/oauth1.rb +151 -0
  98. data/lib/connectors/permission_check.rb +33 -0
  99. data/lib/connectors/poll_runner.rb +50 -0
  100. data/lib/connectors/pre_authentication_helpers.rb +76 -0
  101. data/lib/connectors/registry.rb +38 -0
  102. data/lib/connectors/version.rb +3 -0
  103. data/lib/connectors/webhook_context.rb +62 -0
  104. data/lib/connectors/webhook_lifecycle.rb +69 -0
  105. data/lib/connectors/webhook_methods.rb +48 -0
  106. data/lib/connectors/webhooks/verifier.rb +31 -0
  107. data/lib/connectors/webhooks.rb +5 -0
  108. data/lib/connectors.rb +50 -0
  109. data/lib/tasks/connectors_mcp.rake +9 -0
  110. data/lib/tasks/connectors_tasks.rake +4 -0
  111. data/openapi.yaml +1099 -0
  112. metadata +263 -0
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA256:
3
+ metadata.gz: dad1a8edb9dac56e6c94e54f0f926422488dfede45c390c974296cc98bdc7e4a
4
+ data.tar.gz: ee1826f96e2b7b9475f0030404bd307eb1a1b89ccb3b732bc04d5f1172a0c51e
5
+ SHA512:
6
+ metadata.gz: c096165959caa7f1ae30a904054175a37d2ff048025fadf78a57cd9dd11c4b78adbf5e9b610e9678b2b7825726b02e36728b6ffd2cd917ba713b7e62d40a45d5
7
+ data.tar.gz: f6263fcfa7aeee54d01864c10c60c6aa9cc70080f5d4a9f85e66988a4787bf0864bb916b30e12763c9bae994ff030a846a21cf3e1a90206c0ee3330c1ff83437
data/CHANGELOG.md ADDED
@@ -0,0 +1,35 @@
1
+ # Changelog
2
+
3
+ Changes are recorded here before release. Published packages are listed on [RubyGems](https://rubygems.org/gems/connectors).
4
+
5
+ ## Unreleased
6
+
7
+ ## 0.1.0 — 2026-09-22
8
+
9
+ ### Added
10
+
11
+ - Rails engine for encrypted credential grants, role-based sharing, provider OAuth, REST actions, webhook processing and polling.
12
+ - Shipped Gmail and Resend REST connectors, configurable remote MCP connections and the ClickUp MCP profile.
13
+ - MCP 2026-07-28 remote tool discovery/invocation, durable user authorization and elicitation, and cancellable subscriptions. Supported scope is documented in the MCP guide.
14
+ - Per-consumer polling state and regression/interoperability coverage.
15
+ - Installation, architecture, connector authoring, development and release documentation; strict package installation/boot verification.
16
+ - Public RubyGems metadata and a tag-triggered trusted publishing workflow gated by lint, tests and installed-package verification.
17
+
18
+ ### Fixed
19
+
20
+ - Shared viewers/editors cannot retrieve regular provider secrets with `include_data=true`; owner access remains supported. MCP credentials return public configuration only.
21
+ - Revocation is checked before REST action execution and HTTP attempts, including cached clients and retries.
22
+ - Upstream MCP HTTP 429 responses retain their rate-limit classification and valid `Retry-After` guidance without automatic replay.
23
+ - Distributable gem includes its referenced user guides, API contract, changelog and upstream protocol license.
24
+ - Development lockfile includes dependency checksums and Linux platform declarations for CI.
25
+ - Streaming cancellation test accepts the expected TCP reset on Linux; CI reports individual examples and bounds execution time.
26
+ - MCP test DNS stubs preserve real database resolution so concurrency checks work with TCP PostgreSQL connections.
27
+
28
+ ### Compatibility and upgrade notes
29
+
30
+ - Rails dependency is bounded to the 8.1 series, starting at 8.1.3; Ruby minimum remains 3.2. The validated baseline is Ruby 3.4.8, Rails 8.1.3 and PostgreSQL 16.
31
+ - Host owner and sharing-principal IDs must be UUIDs. Shipped migrations target PostgreSQL.
32
+ - Run host `bin/rails db:migrate` to add polling and MCP transaction tables; migrations are loaded directly from the engine.
33
+ - Authorization creates a new grant unless `grant_id` explicitly selects an existing owned connection. Reconnection retains an existing refresh token when omitted by the provider.
34
+ - In-flight authorizations using the older signed state format must restart. Current regular OAuth state is authenticated and encrypted, expires after 15 minutes, and remains stateless.
35
+ - Shared editors must update credentials without first reading their decrypted values. The credential response omits `data` for non-owner roles on regular connectors.