@tangle-network/agent-integrations 0.53.28 → 0.53.30

package/docs/integration-execution-audit.md

@@ -23,15 +23,15 @@ This audit separates product contracts from implementation backends:
 | Custom-auth connectors with auth field metadata | 11 |
 | Runtime package dependencies declared by this package | 0 |
 | Setup specs | 243 |
-| Executable setup specs | 216 |
-| Catalog/setup-only specs | 27 |
+| Executable setup specs | 221 |
+| Catalog/setup-only specs | 22 |
 | 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 | 512 |
-| Native adapter surfaces shipped | 612 |
+| Native adapter surfaces shipped | 617 |
 | Package-runtime backends | 157 |
 | Runtime manifest dependencies for catalog-only connectors | 166 |
 | Catalog-only connectors exposable behind runtime | 157 |
@@ -149,7 +149,7 @@ The full set is in the machine-readable matrix; representative native adapters:
 - `bolna`
 - `bonjoro`
 
-...and 532 more native adapter surfaces.
+...and 537 more native adapter surfaces.
 
 Executable setup specs:
 
@@ -214,6 +214,7 @@ Executable setup specs:
 - `contextual-ai`
 - `contiguity`
 - `couchbase`
+- `csv-files`
 - `customer-io`
 - `dappier`
 - `datadog`
@@ -233,6 +234,7 @@ Executable setup specs:
 - `elevenlabs`
 - `etsy`
 - `everhour`
+- `excel-files`
 - `facebook-pages`
 - `fathom`
 - `feathery`
@@ -280,6 +282,7 @@ Executable setup specs:
 - `ironclad`
 - `jira-cloud`
 - `jotform`
+- `kafka`
 - `klaviyo`
 - `lever`
 - `linear`
@@ -317,6 +320,7 @@ Executable setup specs:
 - `paddle`
 - `pagerduty`
 - `pandadoc`
+- `parquet-files`
 - `phony`
 - `pinecone`
 - `ping-identity`
@@ -338,6 +342,7 @@ Executable setup specs:
 - `segment`
 - `sendgrid`
 - `sentry`
+- `sftp`
 - `sharepoint`
 - `shopify`
 - `slack`
@@ -376,8 +381,8 @@ 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 | 612 reviewed native adapter surfaces ship from this package; 512 overlap the 669 catalog contracts. |
-| OAuth/API-key setup metadata | Partial | 243 setup specs exist; 216 are executable setup specs and 27 are catalog/setup-only. |
+| Native adapter execution | Done for listed native backends | 617 reviewed native adapter surfaces ship from this package; 512 overlap the 669 catalog contracts. |
+| OAuth/API-key setup metadata | Partial | 243 setup specs exist; 221 are executable setup specs and 22 are catalog/setup-only. |
 | Direct adapter backlog | Tracked | 157 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. |
@@ -391,7 +396,7 @@ Executable setup specs:
 | Bucket | Count | What it means |
 | --- | ---: | --- |
 | Contracts needing native/direct adapters | 157 | Connector has a Tangle contract but no reviewed direct adapter yet. |
-| Commercial/setup-only provider contracts | 26 | Provider is discoverable with honest setup metadata but cannot execute until a supported API backend and customer credentials exist. |
+| Commercial/setup-only provider contracts | 21 | 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. |
 | Catalog connectors with triggers needing runtime-service hosting | 288 | Trigger metadata and provider hooks exist; runtime services still need package-specific webhook/polling hosting. |
@@ -456,7 +461,7 @@ 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 612 native adapter surfaces. 512 overlap the 669 catalog contracts; the remaining catalog contracts are not product-executable until ported.
+   This repo ships 617 native adapter surfaces. 512 overlap the 669 catalog contracts; the remaining catalog contracts are not product-executable until ported.
 
 ## Concrete Launch Interpretation
 

package/docs/integration-execution-matrix.json

@@ -29266,18 +29266,19 @@
   },
   {
     "id": "csv-files",
-    "title": "CSV Files",
-    "category": "database",
+    "title": "csv-files",
+    "category": "internal",
     "catalogAuth": null,
-    "setupAuth": "none",
-    "authFields": [],
+    "setupAuth": {
+      "mode": "none"
+    },
     "runtimePackage": null,
-    "actionCount": 0,
-    "triggerCount": 1,
-    "setupStatus": "catalog",
-    "tangleContractStatus": "contract_ready",
-    "implementationKind": "contract_only",
-    "nativeAdapter": false,
+    "actionCount": null,
+    "triggerCount": null,
+    "setupStatus": "executable",
+    "tangleContractStatus": "native_backed",
+    "implementationKind": "native_adapter",
+    "nativeAdapter": true,
     "catalogActionMappings": null,
     "quality": {
       "tangleContract": true,
@@ -29285,11 +29286,9 @@
       "actionNamesMapped": true,
       "triggerNamesMapped": true,
       "runtimePackageMapped": false,
-      "nativeAdapter": false
+      "nativeAdapter": true
     },
-    "missing": [
-      "native_adapter"
-    ]
+    "missing": []
   },
   {
     "id": "cursor",
@@ -37073,18 +37072,19 @@
   },
   {
     "id": "excel-files",
-    "title": "Excel Files",
-    "category": "database",
+    "title": "excel-files",
+    "category": "internal",
     "catalogAuth": null,
-    "setupAuth": "none",
-    "authFields": [],
+    "setupAuth": {
+      "mode": "none"
+    },
     "runtimePackage": null,
-    "actionCount": 0,
-    "triggerCount": 1,
-    "setupStatus": "catalog",
-    "tangleContractStatus": "contract_ready",
-    "implementationKind": "contract_only",
-    "nativeAdapter": false,
+    "actionCount": null,
+    "triggerCount": null,
+    "setupStatus": "executable",
+    "tangleContractStatus": "native_backed",
+    "implementationKind": "native_adapter",
+    "nativeAdapter": true,
     "catalogActionMappings": null,
     "quality": {
       "tangleContract": true,
@@ -37092,11 +37092,9 @@
       "actionNamesMapped": true,
       "triggerNamesMapped": true,
       "runtimePackageMapped": false,
-      "nativeAdapter": false
+      "nativeAdapter": true
     },
-    "missing": [
-      "native_adapter"
-    ]
+    "missing": []
   },
   {
     "id": "extracta-ai",
@@ -38469,7 +38467,7 @@
         },
         {
           "normalized": "docs.read",
-          "providerScope": "projects:read",
+          "providerScope": "project_metadata:read",
           "title": "FigJam read",
           "reason": "Read FigJam data for user-authorized agent workflows.",
           "risk": "read",
@@ -38575,7 +38573,7 @@
         },
         {
           "normalized": "docs.read",
-          "providerScope": "projects:read",
+          "providerScope": "project_metadata:read",
           "title": "Figma read",
           "reason": "Read Figma data for user-authorized agent workflows.",
           "risk": "read",
@@ -51470,18 +51468,24 @@
   },
   {
     "id": "kafka",
-    "title": "Apache Kafka",
-    "category": "webhook",
+    "title": "kafka",
+    "category": "internal",
     "catalogAuth": null,
-    "setupAuth": "custom",
-    "authFields": [],
+    "setupAuth": {
+      "mode": "api_key",
+      "credential": {
+        "label": "kafka API key",
+        "description": "JSON with brokers and optional SASL or mutual-TLS credentials. TLS is mandatory and broker addresses must resolve publicly.",
+        "secret": true
+      }
+    },
     "runtimePackage": null,
-    "actionCount": 0,
-    "triggerCount": 1,
-    "setupStatus": "catalog",
-    "tangleContractStatus": "contract_ready",
-    "implementationKind": "contract_only",
-    "nativeAdapter": false,
+    "actionCount": null,
+    "triggerCount": null,
+    "setupStatus": "executable",
+    "tangleContractStatus": "native_backed",
+    "implementationKind": "native_adapter",
+    "nativeAdapter": true,
     "catalogActionMappings": null,
     "quality": {
       "tangleContract": true,
@@ -51489,11 +51493,9 @@
       "actionNamesMapped": true,
       "triggerNamesMapped": true,
       "runtimePackageMapped": false,
-      "nativeAdapter": false
+      "nativeAdapter": true
     },
-    "missing": [
-      "native_adapter"
-    ]
+    "missing": []
   },
   {
     "id": "kallabot-ai",
@@ -72496,18 +72498,19 @@
   },
   {
     "id": "parquet-files",
-    "title": "Parquet Files",
-    "category": "database",
+    "title": "parquet-files",
+    "category": "internal",
     "catalogAuth": null,
-    "setupAuth": "none",
-    "authFields": [],
+    "setupAuth": {
+      "mode": "none"
+    },
     "runtimePackage": null,
-    "actionCount": 0,
-    "triggerCount": 1,
-    "setupStatus": "catalog",
-    "tangleContractStatus": "contract_ready",
-    "implementationKind": "contract_only",
-    "nativeAdapter": false,
+    "actionCount": null,
+    "triggerCount": null,
+    "setupStatus": "executable",
+    "tangleContractStatus": "native_backed",
+    "implementationKind": "native_adapter",
+    "nativeAdapter": true,
     "catalogActionMappings": null,
     "quality": {
       "tangleContract": true,
@@ -72515,11 +72518,9 @@
       "actionNamesMapped": true,
       "triggerNamesMapped": true,
       "runtimePackageMapped": false,
-      "nativeAdapter": false
+      "nativeAdapter": true
     },
-    "missing": [
-      "native_adapter"
-    ]
+    "missing": []
   },
   {
     "id": "parser-expert",
@@ -85003,18 +85004,24 @@
   },
   {
     "id": "sftp",
-    "title": "SFTP",
-    "category": "storage",
+    "title": "sftp",
+    "category": "internal",
     "catalogAuth": null,
-    "setupAuth": "custom",
-    "authFields": [],
+    "setupAuth": {
+      "mode": "api_key",
+      "credential": {
+        "label": "sftp API key",
+        "description": "JSON with host, username, SHA-256 hostFingerprint, and password or privateKey; optional port, passphrase, and rootPath.",
+        "secret": true
+      }
+    },
     "runtimePackage": null,
-    "actionCount": 0,
-    "triggerCount": 0,
-    "setupStatus": "catalog",
-    "tangleContractStatus": "contract_ready",
-    "implementationKind": "contract_only",
-    "nativeAdapter": false,
+    "actionCount": null,
+    "triggerCount": null,
+    "setupStatus": "executable",
+    "tangleContractStatus": "native_backed",
+    "implementationKind": "native_adapter",
+    "nativeAdapter": true,
     "catalogActionMappings": null,
     "quality": {
       "tangleContract": true,
@@ -85022,11 +85029,9 @@
       "actionNamesMapped": true,
       "triggerNamesMapped": true,
       "runtimePackageMapped": false,
-      "nativeAdapter": false
+      "nativeAdapter": true
     },
-    "missing": [
-      "native_adapter"
-    ]
+    "missing": []
   },
   {
     "id": "sharepoint",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-integrations",
-  "version": "0.53.28",
+  "version": "0.53.30",
   "description": "Vendor-neutral integration contracts and runtime helpers for sandbox and agent apps.",
   "homepage": "https://github.com/tangle-network/agent-integrations#readme",
   "repository": {
@@ -107,6 +107,7 @@
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
+    "@types/ssh2-sftp-client": "9.0.6",
     "tsup": "^8.0.0",
     "typescript": "^5.9.3",
     "vite": "^8.1.5",
@@ -117,7 +118,16 @@
   },
   "license": "MIT",
   "dependencies": {
-    "jose": "6.2.4"
+    "csv-parse": "7.0.1",
+    "csv-stringify": "6.8.1",
+    "hyparquet": "1.27.1",
+    "hyparquet-writer": "0.16.1",
+    "ipaddr.js": "2.4.0",
+    "jose": "6.2.4",
+    "kafkajs": "2.2.4",
+    "read-excel-file": "9.3.5",
+    "ssh2-sftp-client": "12.1.1",
+    "write-excel-file": "4.1.1"
   },
   "scripts": {
     "build": "tsup",