@tangle-network/agent-integrations 0.53.16 → 0.53.17

package/dist/registry.js

@@ -5,18 +5,18 @@ import {
   composeIntegrationRegistry,
   inferIntegrationSupportTier,
   summarizeIntegrationRegistry
-} from "./chunk-SDDHYJK6.js";
-import "./chunk-5NLIZJOI.js";
-import "./chunk-PNHETWE4.js";
+} from "./chunk-V6XGWRK2.js";
+import "./chunk-XGL345YX.js";
+import "./chunk-ANWNXGVV.js";
 import "./chunk-H4XYLS7T.js";
-import "./chunk-6ZHVV537.js";
-import "./chunk-HXSZKRMO.js";
-import "./chunk-3NFISG2G.js";
+import "./chunk-FK4ENHCP.js";
+import "./chunk-U5ODNPOX.js";
+import "./chunk-2Q4JR5VV.js";
 import "./chunk-P4FFI752.js";
-import "./chunk-EP66ZCMG.js";
-import "./chunk-4CQ7WC6R.js";
+import "./chunk-MENQVO6O.js";
+import "./chunk-3K5N3SQI.js";
 import "./chunk-XC54EOUQ.js";
-import "./chunk-PDV6QQTH.js";
+import "./chunk-JXFPIZ3O.js";
 import "./chunk-PZ5AY32C.js";
 export {
   buildDefaultIntegrationRegistry,

package/dist/runtime.d.ts

@@ -1,7 +1,7 @@
 import { IntegrationToolDefinition } from './catalog.js';
 import { IntegrationRegistryEntry, IntegrationRegistry } from './registry.js';
-import { I as IntegrationActor, a as IssuedIntegrationCapability, b as IntegrationConnector, c as IntegrationConnection } from './core-types-CdAHF1wy.js';
-import './types-DkIrJgM-.js';
+import { I as IntegrationActor, a as IssuedIntegrationCapability, b as IntegrationConnector, c as IntegrationConnection } from './core-types-qkW_zZDB.js';
+import './types-C1rgdXiP.js';
 
 type IntegrationRequirementMode = 'read' | 'write' | 'trigger';
 type IntegrationRequirementStatus = 'ready' | 'missing_connection' | 'not_executable' | 'unknown_connector';

package/dist/runtime.js

@@ -2,18 +2,18 @@ import {
   InMemoryIntegrationGrantStore,
   IntegrationRuntime,
   createIntegrationRuntime
-} from "./chunk-SDDHYJK6.js";
-import "./chunk-5NLIZJOI.js";
-import "./chunk-PNHETWE4.js";
+} from "./chunk-V6XGWRK2.js";
+import "./chunk-XGL345YX.js";
+import "./chunk-ANWNXGVV.js";
 import "./chunk-H4XYLS7T.js";
-import "./chunk-6ZHVV537.js";
-import "./chunk-HXSZKRMO.js";
-import "./chunk-3NFISG2G.js";
+import "./chunk-FK4ENHCP.js";
+import "./chunk-U5ODNPOX.js";
+import "./chunk-2Q4JR5VV.js";
 import "./chunk-P4FFI752.js";
-import "./chunk-EP66ZCMG.js";
-import "./chunk-4CQ7WC6R.js";
+import "./chunk-MENQVO6O.js";
+import "./chunk-3K5N3SQI.js";
 import "./chunk-XC54EOUQ.js";
-import "./chunk-PDV6QQTH.js";
+import "./chunk-JXFPIZ3O.js";
 import "./chunk-PZ5AY32C.js";
 export {
   InMemoryIntegrationGrantStore,

package/dist/specs.d.ts

@@ -1,5 +1,5 @@
-import { f as IntegrationActionRisk, g as IntegrationDataClass, d as IntegrationConnectorCategory, e as IntegrationConnectorAction, G as IntegrationConnectorTrigger, b as IntegrationConnector } from './core-types-CdAHF1wy.js';
-import './types-DkIrJgM-.js';
+import { f as IntegrationActionRisk, g as IntegrationDataClass, d as IntegrationConnectorCategory, e as IntegrationConnectorAction, G as IntegrationConnectorTrigger, b as IntegrationConnector } from './core-types-qkW_zZDB.js';
+import './types-C1rgdXiP.js';
 
 type IntegrationAuthMode = 'oauth2' | 'api_key' | 'hmac' | 'none' | 'custom';
 type IntegrationSpecStatus = 'catalog' | 'executable' | 'deprecated';

package/dist/specs.js

@@ -16,12 +16,12 @@ import {
   validateCredentialFormat,
   validateCredentialSet,
   validateIntegrationSpec
-} from "./chunk-HXSZKRMO.js";
-import "./chunk-3NFISG2G.js";
-import "./chunk-EP66ZCMG.js";
-import "./chunk-4CQ7WC6R.js";
+} from "./chunk-U5ODNPOX.js";
+import "./chunk-2Q4JR5VV.js";
+import "./chunk-MENQVO6O.js";
+import "./chunk-3K5N3SQI.js";
 import "./chunk-XC54EOUQ.js";
-import "./chunk-PDV6QQTH.js";
+import "./chunk-JXFPIZ3O.js";
 import "./chunk-PZ5AY32C.js";
 export {
   INTEGRATION_FAMILIES,

package/dist/{tangle-id-DkT2T54x.d.ts → tangle-id-uvHTbgCw.d.ts}

@@ -1,4 +1,4 @@
-import { C as ConnectorAdapter } from './types-DkIrJgM-.js';
+import { C as ConnectorAdapter } from './types-C1rgdXiP.js';
 
 /**
  * @stable Tangle Identity — `id.tangle.tools` connector + verifier.

package/dist/{types-DkIrJgM-.d.ts → types-C1rgdXiP.d.ts}

@@ -355,6 +355,9 @@ type OAuth2AuthSpec = {
     /** Scopes requested in the authorization grant. The user UI shows
      *  these so the customer knows what's being shared. */
     scopes: string[];
+    /** Separator used when serializing multiple scopes into the authorization
+     *  URL. OAuth defaults to spaces; Zoho requires comma-delimited scopes. */
+    scopeSeparator?: ' ' | ',';
     /** Whether the connector supports incremental authorization (Google
      *  does; many don't). */
     incremental?: boolean;

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 | 188 |
+| Executable setup specs | 154 |
 | 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,11 @@ Executable setup specs:
 - `youtube`
 - `zapier`
 - `zendesk`
+- `zoho-books`
+- `zoho-campaigns`
 - `zoho-crm`
+- `zoho-invoice`
+- `zoho-mail`
 - `zoom`
 
 ## Flow Readiness
@@ -310,9 +314,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 | 188 setup specs exist; 154 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 +328,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 +382,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 +394,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

@@ -109052,7 +109052,29 @@
     "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 +109094,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 +109105,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 +109164,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 +109175,10 @@
       "actionNamesMapped": true,
       "triggerNamesMapped": true,
       "runtimePackageMapped": true,
-      "nativeAdapter": false
+      "nativeAdapter": true
     },
     "missing": [
-      "hosted_trigger_runtime",
-      "executable_setup_spec"
+      "hosted_trigger_runtime"
     ]
   },
   {
@@ -109141,8 +109190,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 +109216,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"
     },
@@ -109263,7 +109308,29 @@
     "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 +109350,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 +109361,10 @@
       "actionNamesMapped": true,
       "triggerNamesMapped": true,
       "runtimePackageMapped": true,
-      "nativeAdapter": false
+      "nativeAdapter": true
     },
     "missing": [
-      "hosted_trigger_runtime",
-      "executable_setup_spec"
+      "hosted_trigger_runtime"
     ]
   },
   {
@@ -109306,7 +109372,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 +109438,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 +109449,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.17",
   "description": "Vendor-neutral integration contracts and runtime helpers for sandbox and agent apps.",
   "homepage": "https://github.com/tangle-network/agent-integrations#readme",
   "repository": {