@tangle-network/agent-integrations 0.53.16 → 0.53.18

package/docs/integration-execution-audit.md

@@ -22,20 +22,20 @@ This audit separates product contracts from implementation backends:
 | Catalog connectors with auth field metadata | 648 |
 | Custom-auth connectors with auth field metadata | 11 |
 | Runtime package dependencies declared by this package | 0 |
-| Setup specs | 184 |
-| Executable setup specs | 150 |
+| Setup specs | 190 |
+| Executable setup specs | 156 |
 | Catalog/setup-only specs | 34 |
 | Tangle first-class contracts | 669 |
 | Contracts with runtime packages | 669 |
 | Contracts with mapped actions | 669 |
 | Contracts with mapped triggers | 669 |
 | Contracts with mapped auth | 669 |
-| Native adapter backends | 449 |
-| Native adapter surfaces shipped | 548 |
-| Package-runtime backends | 220 |
-| Runtime manifest dependencies for catalog-only connectors | 221 |
-| Catalog-only connectors exposable behind runtime | 220 |
-| Catalog-only actions exposable behind runtime | 950 |
+| Native adapter backends | 453 |
+| Native adapter surfaces shipped | 552 |
+| Package-runtime backends | 216 |
+| Runtime manifest dependencies for catalog-only connectors | 217 |
+| Catalog-only connectors exposable behind runtime | 216 |
+| Catalog-only actions exposable behind runtime | 933 |
 
 Full machine-readable matrix: [integration-execution-matrix.json](./integration-execution-matrix.json).
 
@@ -149,7 +149,7 @@ The full set is in the machine-readable matrix; representative native adapters:
 - `captain-data`
 - `cashfree-payments`
 
-...and 468 more native adapter surfaces.
+...and 472 more native adapter surfaces.
 
 Executable setup specs:
 
@@ -301,7 +301,13 @@ Executable setup specs:
 - `youtube`
 - `zapier`
 - `zendesk`
+- `zoho-bookings`
+- `zoho-books`
+- `zoho-campaigns`
 - `zoho-crm`
+- `zoho-desk`
+- `zoho-invoice`
+- `zoho-mail`
 - `zoom`
 
 ## Flow Readiness
@@ -310,9 +316,9 @@ Executable setup specs:
 | --- | --- | --- |
 | Tangle first-class contracts | Done | 669 connectors have Tangle-owned action/trigger/auth/runtime contracts. |
 | Connector discovery/catalog search | Done | 669 catalog connectors, 3790 actions, 998 triggers normalized into Tangle catalog shapes. |
-| Native adapter execution | Done for listed native backends | 548 reviewed native adapter surfaces ship from this package; 449 overlap the 669 catalog contracts. |
-| OAuth/API-key setup metadata | Partial | 184 setup specs exist; 150 are executable setup specs and 34 are catalog/setup-only. |
-| Direct adapter backlog | Tracked | 220 contracts still need native/direct adapters before they should be product-executable. |
+| Native adapter execution | Done for listed native backends | 552 reviewed native adapter surfaces ship from this package; 453 overlap the 669 catalog contracts. |
+| OAuth/API-key setup metadata | Partial | 190 setup specs exist; 156 are executable setup specs and 34 are catalog/setup-only. |
+| Direct adapter backlog | Tracked | 216 contracts still need native/direct adapters before they should be product-executable. |
 | Legacy runtime dependency manifest | Deprecated | `buildTangleCatalogRuntimePackageManifest()` is retained only as an audit/provenance helper; products should not deploy a package runner for normal execution. |
 | Runtime package coverage audit | Removed from launch path | Package-runner smoke is no longer a product launch gate; port demanded integrations to direct adapters instead. |
 | Long-tail credential mapping | Mostly mapped | 648 connectors have auth field metadata. 0 custom-auth connectors still need exact manual auth fields. |
@@ -324,7 +330,7 @@ Executable setup specs:
 
 | Bucket | Count | What it means |
 | --- | ---: | --- |
-| Contracts needing native/direct adapters | 220 | Connector has a Tangle contract but no reviewed direct adapter yet. |
+| Contracts needing native/direct adapters | 216 | Connector has a Tangle contract but no reviewed direct adapter yet. |
 | Commercial/setup-only provider contracts | 31 | Provider is discoverable with honest setup metadata but cannot execute until a supported API backend and customer credentials exist. |
 | Catalog connectors with zero upstream action names | 0 | These entries need catalog action-name mapping before exact package-runtime invocation can work. |
 | Custom-auth catalog connectors needing manual credential-field mapping | 0 | These are still custom auth and no field names were extracted from source. |
@@ -378,7 +384,7 @@ Manual custom auth mapping gap: none.
 ## Completion Claims And Remaining Proof Gates
 
 1. **Tangle first-class connector contracts are complete.**
-   All 669 catalog entries have Tangle-owned contracts. 449 use native adapter backends; 220 are backlog for native ports.
+   All 669 catalog entries have Tangle-owned contracts. 453 use native adapter backends; 216 are backlog for native ports.
 
 2. **Action-name mapping exists for cataloged actions.**
    Done for cataloged actions: the catalog currently has 3790 actions and 3790 upstream action-name mappings in the checked-in catalog. Direct adapters should preserve stable Tangle action ids when porting demanded backlog connectors.
@@ -390,13 +396,13 @@ Manual custom auth mapping gap: none.
    There are 998 catalog triggers and 998 upstream trigger names. The provider flow supports trigger subscribe/unsubscribe/normalize hooks. Runtime services still need live webhook/polling smoke verification.
 
 5. **Native adapter coverage is intentionally smaller than contract breadth.**
-   This repo ships 548 native adapter surfaces. 449 overlap the 669 catalog contracts; the remaining catalog contracts are not product-executable until ported.
+   This repo ships 552 native adapter surfaces. 453 overlap the 669 catalog contracts; the remaining catalog contracts are not product-executable until ported.
 
 ## Concrete Launch Interpretation
 
 - It is accurate to say: **we have 669 first-class Tangle integration contracts.**
 - It is accurate to say: **product execution should use direct/native adapters.**
-- It is accurate to say: **the remaining 220 catalog-only contracts are backlog, not runtime-ready product surface.**
+- It is accurate to say: **the remaining 216 catalog-only contracts are backlog, not runtime-ready product surface.**
 
 ## Native Port Gate
 

package/docs/integration-execution-matrix.json

@@ -109010,7 +109010,37 @@
     "title": "Zoho Bookings",
     "category": "calendar",
     "catalogAuth": "oauth2",
-    "setupAuth": null,
+    "setupAuth": {
+      "mode": "oauth2",
+      "authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
+      "tokenUrl": "https://accounts.zoho.com/oauth/v2/token",
+      "clientIdEnv": "ZOHO_OAUTH_CLIENT_ID",
+      "clientSecretEnv": "ZOHO_OAUTH_CLIENT_SECRET",
+      "scopes": [
+        {
+          "normalized": "calendar.write",
+          "providerScope": "zohobookings.data.CREATE",
+          "title": "Zoho Bookings write",
+          "reason": "Create or update Zoho Bookings resources after policy approval.",
+          "risk": "write",
+          "dataClass": "private"
+        },
+        {
+          "normalized": "calendar.read",
+          "providerScope": "zohobookings.data.READ",
+          "title": "Zoho Bookings read",
+          "reason": "Read Zoho Bookings data for user-authorized agent workflows.",
+          "risk": "read",
+          "dataClass": "private"
+        }
+      ],
+      "extraAuthParams": {
+        "access_type": "offline",
+        "prompt": "consent"
+      },
+      "redirectUriTemplate": "https://{host}/api/integrations/oauth/zoho-bookings/callback",
+      "pkce": "unsupported"
+    },
     "authFields": [
       {
         "key": "access_token",
@@ -109030,7 +109060,7 @@
     "runtimePackage": "@activepieces/piece-zoho-bookings",
     "actionCount": 5,
     "triggerCount": 0,
-    "setupStatus": "catalog-only",
+    "setupStatus": "executable",
     "tangleContractStatus": "native_backed",
     "implementationKind": "native_adapter",
     "nativeAdapter": true,
@@ -109043,16 +109073,36 @@
       "runtimePackageMapped": true,
       "nativeAdapter": true
     },
-    "missing": [
-      "executable_setup_spec"
-    ]
+    "missing": []
   },
   {
     "id": "zoho-books",
     "title": "Location",
     "category": "crm",
     "catalogAuth": "oauth2",
-    "setupAuth": null,
+    "setupAuth": {
+      "mode": "oauth2",
+      "authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
+      "tokenUrl": "https://accounts.zoho.com/oauth/v2/token",
+      "clientIdEnv": "ZOHO_OAUTH_CLIENT_ID",
+      "clientSecretEnv": "ZOHO_OAUTH_CLIENT_SECRET",
+      "scopes": [
+        {
+          "normalized": "finance.read",
+          "providerScope": "ZohoBooks.fullaccess.all",
+          "title": "Zoho Books read",
+          "reason": "Read Zoho Books data for user-authorized agent workflows.",
+          "risk": "read",
+          "dataClass": "sensitive"
+        }
+      ],
+      "extraAuthParams": {
+        "access_type": "offline",
+        "prompt": "consent"
+      },
+      "redirectUriTemplate": "https://{host}/api/integrations/oauth/zoho-books/callback",
+      "pkce": "unsupported"
+    },
     "authFields": [
       {
         "key": "access_token",
@@ -109072,10 +109122,10 @@
     "runtimePackage": "@activepieces/piece-zoho-books",
     "actionCount": 0,
     "triggerCount": 0,
-    "setupStatus": "catalog-only",
-    "tangleContractStatus": "runtime_backed",
-    "implementationKind": "package_runtime",
-    "nativeAdapter": false,
+    "setupStatus": "executable",
+    "tangleContractStatus": "native_backed",
+    "implementationKind": "native_adapter",
+    "nativeAdapter": true,
     "catalogActionMappings": 0,
     "quality": {
       "tangleContract": true,
@@ -109083,18 +109133,46 @@
       "actionNamesMapped": true,
       "triggerNamesMapped": true,
       "runtimePackageMapped": true,
-      "nativeAdapter": false
+      "nativeAdapter": true
     },
-    "missing": [
-      "executable_setup_spec"
-    ]
+    "missing": []
   },
   {
     "id": "zoho-campaigns",
     "title": "Zoho Campaigns",
     "category": "email",
     "catalogAuth": "oauth2",
-    "setupAuth": null,
+    "setupAuth": {
+      "mode": "oauth2",
+      "authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
+      "tokenUrl": "https://accounts.zoho.com/oauth/v2/token",
+      "clientIdEnv": "ZOHO_OAUTH_CLIENT_ID",
+      "clientSecretEnv": "ZOHO_OAUTH_CLIENT_SECRET",
+      "scopes": [
+        {
+          "normalized": "marketing.read",
+          "providerScope": "ZohoCampaigns.campaign.ALL",
+          "title": "Zoho Campaigns read",
+          "reason": "Read Zoho Campaigns data for user-authorized agent workflows.",
+          "risk": "read",
+          "dataClass": "private"
+        },
+        {
+          "normalized": "marketing.read",
+          "providerScope": "ZohoCampaigns.contact.ALL",
+          "title": "Zoho Campaigns read",
+          "reason": "Read Zoho Campaigns data for user-authorized agent workflows.",
+          "risk": "read",
+          "dataClass": "private"
+        }
+      ],
+      "extraAuthParams": {
+        "access_type": "offline",
+        "prompt": "consent"
+      },
+      "redirectUriTemplate": "https://{host}/api/integrations/oauth/zoho-campaigns/callback",
+      "pkce": "unsupported"
+    },
     "authFields": [
       {
         "key": "access_token",
@@ -109114,10 +109192,10 @@
     "runtimePackage": "@activepieces/piece-zoho-campaigns",
     "actionCount": 10,
     "triggerCount": 3,
-    "setupStatus": "catalog-only",
-    "tangleContractStatus": "runtime_backed",
-    "implementationKind": "package_runtime",
-    "nativeAdapter": false,
+    "setupStatus": "executable",
+    "tangleContractStatus": "native_backed",
+    "implementationKind": "native_adapter",
+    "nativeAdapter": true,
     "catalogActionMappings": 10,
     "quality": {
       "tangleContract": true,
@@ -109125,11 +109203,10 @@
       "actionNamesMapped": true,
       "triggerNamesMapped": true,
       "runtimePackageMapped": true,
-      "nativeAdapter": false
+      "nativeAdapter": true
     },
     "missing": [
-      "hosted_trigger_runtime",
-      "executable_setup_spec"
+      "hosted_trigger_runtime"
     ]
   },
   {
@@ -109141,8 +109218,8 @@
       "mode": "oauth2",
       "authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
       "tokenUrl": "https://accounts.zoho.com/oauth/v2/token",
-      "clientIdEnv": "ZOHO_CRM_OAUTH_CLIENT_ID",
-      "clientSecretEnv": "ZOHO_CRM_OAUTH_CLIENT_SECRET",
+      "clientIdEnv": "ZOHO_OAUTH_CLIENT_ID",
+      "clientSecretEnv": "ZOHO_OAUTH_CLIENT_SECRET",
       "scopes": [
         {
           "normalized": "crm.read",
@@ -109167,16 +109244,12 @@
           "reason": "Read Zoho CRM data for user-authorized agent workflows.",
           "risk": "read",
           "dataClass": "private"
-        },
-        {
-          "normalized": "crm.read",
-          "providerScope": "offline_access",
-          "title": "Zoho CRM read",
-          "reason": "Read Zoho CRM data for user-authorized agent workflows.",
-          "risk": "read",
-          "dataClass": "private"
         }
       ],
+      "extraAuthParams": {
+        "access_type": "offline",
+        "prompt": "consent"
+      },
       "redirectUriTemplate": "https://{host}/api/integrations/oauth/zoho-crm/callback",
       "pkce": "unsupported"
     },
@@ -109221,7 +109294,53 @@
     "title": "Zoho Desk",
     "category": "crm",
     "catalogAuth": "oauth2",
-    "setupAuth": null,
+    "setupAuth": {
+      "mode": "oauth2",
+      "authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
+      "tokenUrl": "https://accounts.zoho.com/oauth/v2/token",
+      "clientIdEnv": "ZOHO_OAUTH_CLIENT_ID",
+      "clientSecretEnv": "ZOHO_OAUTH_CLIENT_SECRET",
+      "scopes": [
+        {
+          "normalized": "support.read",
+          "providerScope": "Desk.tickets.ALL",
+          "title": "Zoho Desk read",
+          "reason": "Read Zoho Desk data for user-authorized agent workflows.",
+          "risk": "read",
+          "dataClass": "private"
+        },
+        {
+          "normalized": "support.read",
+          "providerScope": "Desk.contacts.READ",
+          "title": "Zoho Desk read",
+          "reason": "Read Zoho Desk data for user-authorized agent workflows.",
+          "risk": "read",
+          "dataClass": "private"
+        },
+        {
+          "normalized": "support.read",
+          "providerScope": "Desk.search.READ",
+          "title": "Zoho Desk read",
+          "reason": "Read Zoho Desk data for user-authorized agent workflows.",
+          "risk": "read",
+          "dataClass": "private"
+        },
+        {
+          "normalized": "support.read",
+          "providerScope": "Desk.basic.READ",
+          "title": "Zoho Desk read",
+          "reason": "Read Zoho Desk data for user-authorized agent workflows.",
+          "risk": "read",
+          "dataClass": "private"
+        }
+      ],
+      "extraAuthParams": {
+        "access_type": "offline",
+        "prompt": "consent"
+      },
+      "redirectUriTemplate": "https://{host}/api/integrations/oauth/zoho-desk/callback",
+      "pkce": "unsupported"
+    },
     "authFields": [
       {
         "key": "access_token",
@@ -109241,7 +109360,7 @@
     "runtimePackage": "@activepieces/piece-zoho-desk",
     "actionCount": 3,
     "triggerCount": 0,
-    "setupStatus": "catalog-only",
+    "setupStatus": "executable",
     "tangleContractStatus": "native_backed",
     "implementationKind": "native_adapter",
     "nativeAdapter": true,
@@ -109254,16 +109373,36 @@
       "runtimePackageMapped": true,
       "nativeAdapter": true
     },
-    "missing": [
-      "executable_setup_spec"
-    ]
+    "missing": []
   },
   {
     "id": "zoho-invoice",
     "title": "Region",
     "category": "crm",
     "catalogAuth": "oauth2",
-    "setupAuth": null,
+    "setupAuth": {
+      "mode": "oauth2",
+      "authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
+      "tokenUrl": "https://accounts.zoho.com/oauth/v2/token",
+      "clientIdEnv": "ZOHO_OAUTH_CLIENT_ID",
+      "clientSecretEnv": "ZOHO_OAUTH_CLIENT_SECRET",
+      "scopes": [
+        {
+          "normalized": "finance.read",
+          "providerScope": "ZohoInvoice.fullaccess.all",
+          "title": "Zoho Invoice read",
+          "reason": "Read Zoho Invoice data for user-authorized agent workflows.",
+          "risk": "read",
+          "dataClass": "sensitive"
+        }
+      ],
+      "extraAuthParams": {
+        "access_type": "offline",
+        "prompt": "consent"
+      },
+      "redirectUriTemplate": "https://{host}/api/integrations/oauth/zoho-invoice/callback",
+      "pkce": "unsupported"
+    },
     "authFields": [
       {
         "key": "access_token",
@@ -109283,10 +109422,10 @@
     "runtimePackage": "@activepieces/piece-zoho-invoice",
     "actionCount": 0,
     "triggerCount": 1,
-    "setupStatus": "catalog-only",
-    "tangleContractStatus": "runtime_backed",
-    "implementationKind": "package_runtime",
-    "nativeAdapter": false,
+    "setupStatus": "executable",
+    "tangleContractStatus": "native_backed",
+    "implementationKind": "native_adapter",
+    "nativeAdapter": true,
     "catalogActionMappings": 0,
     "quality": {
       "tangleContract": true,
@@ -109294,11 +109433,10 @@
       "actionNamesMapped": true,
       "triggerNamesMapped": true,
       "runtimePackageMapped": true,
-      "nativeAdapter": false
+      "nativeAdapter": true
     },
     "missing": [
-      "hosted_trigger_runtime",
-      "executable_setup_spec"
+      "hosted_trigger_runtime"
     ]
   },
   {
@@ -109306,7 +109444,53 @@
     "title": "Zoho Mail",
     "category": "chat",
     "catalogAuth": "oauth2",
-    "setupAuth": null,
+    "setupAuth": {
+      "mode": "oauth2",
+      "authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
+      "tokenUrl": "https://accounts.zoho.com/oauth/v2/token",
+      "clientIdEnv": "ZOHO_OAUTH_CLIENT_ID",
+      "clientSecretEnv": "ZOHO_OAUTH_CLIENT_SECRET",
+      "scopes": [
+        {
+          "normalized": "email.read",
+          "providerScope": "ZohoMail.accounts.READ",
+          "title": "Zoho Mail read",
+          "reason": "Read Zoho Mail data for user-authorized agent workflows.",
+          "risk": "read",
+          "dataClass": "private"
+        },
+        {
+          "normalized": "email.read",
+          "providerScope": "ZohoMail.messages.ALL",
+          "title": "Zoho Mail read",
+          "reason": "Read Zoho Mail data for user-authorized agent workflows.",
+          "risk": "read",
+          "dataClass": "private"
+        },
+        {
+          "normalized": "email.read",
+          "providerScope": "ZohoMail.folders.ALL",
+          "title": "Zoho Mail read",
+          "reason": "Read Zoho Mail data for user-authorized agent workflows.",
+          "risk": "read",
+          "dataClass": "private"
+        },
+        {
+          "normalized": "email.read",
+          "providerScope": "ZohoMail.organization.accounts.READ",
+          "title": "Zoho Mail read",
+          "reason": "Read Zoho Mail data for user-authorized agent workflows.",
+          "risk": "read",
+          "dataClass": "private"
+        }
+      ],
+      "extraAuthParams": {
+        "access_type": "offline",
+        "prompt": "consent"
+      },
+      "redirectUriTemplate": "https://{host}/api/integrations/oauth/zoho-mail/callback",
+      "pkce": "unsupported"
+    },
     "authFields": [
       {
         "key": "access_token",
@@ -109326,10 +109510,10 @@
     "runtimePackage": "@activepieces/piece-zoho-mail",
     "actionCount": 7,
     "triggerCount": 1,
-    "setupStatus": "catalog-only",
-    "tangleContractStatus": "runtime_backed",
-    "implementationKind": "package_runtime",
-    "nativeAdapter": false,
+    "setupStatus": "executable",
+    "tangleContractStatus": "native_backed",
+    "implementationKind": "native_adapter",
+    "nativeAdapter": true,
     "catalogActionMappings": 7,
     "quality": {
       "tangleContract": true,
@@ -109337,11 +109521,10 @@
       "actionNamesMapped": true,
       "triggerNamesMapped": true,
       "runtimePackageMapped": true,
-      "nativeAdapter": false
+      "nativeAdapter": true
     },
     "missing": [
-      "hosted_trigger_runtime",
-      "executable_setup_spec"
+      "hosted_trigger_runtime"
     ]
   },
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-integrations",
-  "version": "0.53.16",
+  "version": "0.53.18",
   "description": "Vendor-neutral integration contracts and runtime helpers for sandbox and agent apps.",
   "homepage": "https://github.com/tangle-network/agent-integrations#readme",
   "repository": {