@tangle-network/agent-integrations 0.9.0 → 0.14.0

package/docs/catalog-registry.md

@@ -0,0 +1,59 @@
+# Catalog Registry
+
+`agent-integrations` can ingest several catalog sources:
+
+- first-party adapters
+- generated setup specs
+- gateway catalogs
+- vendored Activepieces metadata
+- planning coverage stubs
+
+Those sources intentionally overlap. The public product surface should not.
+Use `composeIntegrationRegistry()` or `buildDefaultIntegrationRegistry()` before
+building agent tools, connection pickers, setup flows, or planning context.
+
+## Support Tiers
+
+The registry assigns one tier per canonical connector:
+
+| Tier | Meaning |
+| --- | --- |
+| `catalogOnly` | Known integration metadata. Useful for search/planning, not execution. |
+| `setupReady` | Has setup/auth/spec metadata, but still needs an execution provider. |
+| `gatewayExecutable` | Executable through a gateway provider. |
+| `firstPartyExecutable` | Executable through a first-party adapter. |
+| `sandboxExecutable` | Safe to invoke directly from generated sandbox apps. |
+
+Precedence is explicit:
+
+```txt
+sandboxExecutable
+  > firstPartyExecutable
+  > gatewayExecutable
+  > setupReady
+  > catalogOnly
+```
+
+When multiple catalogs define the same integration, the registry keeps one
+canonical connector, retains source provenance, merges non-conflicting
+actions/triggers, and reports auth/category conflicts.
+
+## Example
+
+```ts
+import {
+  buildDefaultIntegrationRegistry,
+  buildIntegrationToolCatalog,
+  searchIntegrationTools,
+} from '@tangle-network/agent-integrations'
+
+const registry = buildDefaultIntegrationRegistry()
+const tools = buildIntegrationToolCatalog(registry.connectors)
+const matches = searchIntegrationTools(tools, 'send a slack message', {
+  maxRisk: 'write',
+})
+```
+
+Aliases such as `notion -> notion-database`, `stripe -> stripe-pack`,
+`twilio -> twilio-sms`, and `outlook-calendar -> microsoft-calendar` resolve to
+one canonical entry while preserving lookup by either name.

package/docs/integration-coverage-checklist.md

@@ -17,11 +17,13 @@ Goal: cover the integrations that make agents useful for 99% of practical produc
 - [x] Coverage catalog for 100+ high-value integrations.
 - [x] Builder API consumes the coverage catalog for app planning.
 - [x] Declarative REST adapter factory for fast first-party promotion of REST-shaped APIs.
+- [x] Provider gateway catalog adapter can normalize 500+ Nango/Pipedream/Activepieces-style connectors.
+- [x] Canonical registry dedupes overlapping catalogs, aliases, support tiers, and conflict diagnostics.
 - [ ] Generated sandbox apps can request missing connections from the catalog.
 - [ ] Live smoke credentials exist for Tier 0 connectors.
 - [ ] Tier 0 connector failures are classified by auth, scope, rate-limit, provider outage, validation, approval, and conflict.
 - [ ] Tier 0 write actions have idempotency and approval tests.
-- [ ] Provider gateway adapters can import/sync catalog metadata from Nango/Pipedream/Activepieces registries.
+- [x] Provider gateway adapters can import/sync catalog metadata from Nango/Pipedream/Activepieces registries.
 
 ## Tier 0 First-Party Promotion Queue
 

package/docs/third-party/activepieces.md

@@ -0,0 +1,57 @@
+# Activepieces Community Catalog Attribution
+
+`src/activepieces-catalog.generated.ts` is generated from the Activepieces
+Community pieces catalog:
+
+- Source repository: https://github.com/activepieces/activepieces
+- Source path: `packages/pieces/community`
+- License: MIT
+- Imported surface: piece ids, display names, descriptions, package names,
+  versions, high-level action names, trigger names, auth shape hints, and
+  category/domain metadata.
+
+The generated catalog is connector metadata for `agent-integrations`; it does
+not vendor the Activepieces runtime or execute Activepieces piece code directly.
+Consumers can run these connectors through an Activepieces-backed provider,
+promote selected entries to first-party adapters, or use the metadata for
+planning and connection setup.
+
+Regenerate after checking out Activepieces:
+
+```sh
+ACTIVEPIECES_ROOT=/path/to/activepieces node scripts/import-activepieces-catalog.mjs
+```
+
+## Upstream License Notice
+
+Copyright (c) 2020-2024 Activepieces Inc.
+
+Portions of this software are licensed as follows:
+
+- All content that resides under the "packages/ee/" and
+  "packages/server/api/src/app/ee" directory of this repository, if that
+  directory exists, is licensed under the license defined in
+  packages/ee/LICENSE.
+- All third party components incorporated into the Activepieces Inc Software
+  are licensed under the original license provided by the owner of the
+  applicable component.
+- Content outside of the above mentioned directories or restrictions above is
+  available under the "MIT Expat" license as defined below.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-integrations",
-  "version": "0.9.0",
+  "version": "0.14.0",
   "description": "Vendor-neutral integration contracts and runtime helpers for sandbox and agent apps.",
   "homepage": "https://github.com/tangle-network/agent-integrations#readme",
   "repository": {
@@ -21,6 +21,7 @@
     }
   },
   "files": [
+    "data",
     "dist",
     "docs",
     "examples",