@tangle-network/agent-integrations 0.75.4 → 0.76.2

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 (96) hide show
  1. package/README.md +10 -14
  2. package/data/bundled-adapter-manifests.json +1 -1
  3. package/dist/{adapters-CrN3lR4d.js → adapters-Bx-UTWRg.js} +55 -8
  4. package/dist/{adapters-CrN3lR4d.js.map → adapters-Bx-UTWRg.js.map} +1 -1
  5. package/dist/{bundled-manifest-data-C7dav10o.js → bundled-manifest-data-BgTJ7dmp.js} +33 -1
  6. package/dist/{bundled-manifest-data-C7dav10o.js.map → bundled-manifest-data-BgTJ7dmp.js.map} +1 -1
  7. package/dist/{bundled-manifest-runtime-G6p2i9W-.d.ts → bundled-manifest-runtime-EpjLQKA9.d.ts} +7 -3
  8. package/dist/bundled-manifest-runtime-EpjLQKA9.d.ts.map +1 -0
  9. package/dist/{catalog-DmAjfp4i.d.ts → catalog-z4zNeXVL.d.ts} +3 -3
  10. package/dist/{catalog-DmAjfp4i.d.ts.map → catalog-z4zNeXVL.d.ts.map} +1 -1
  11. package/dist/catalog.d.ts +1 -1
  12. package/dist/{cloudbeds-BL5EF3xl.js → cloudbeds-CGSoT275.js} +17 -2
  13. package/dist/cloudbeds-CGSoT275.js.map +1 -0
  14. package/dist/connect/index.d.ts +1 -1
  15. package/dist/connect/index.js +1 -1
  16. package/dist/connectors/adapters/index.d.ts +2 -2
  17. package/dist/connectors/adapters/index.js +3 -3
  18. package/dist/connectors/index.d.ts +7 -7
  19. package/dist/connectors/index.js +8 -7
  20. package/dist/connectors/oauth.d.ts +2 -2
  21. package/dist/connectors/oauth.js +7 -205
  22. package/dist/connectors/oauth.js.map +1 -1
  23. package/dist/{consumer-BafUQUla.d.ts → consumer-YE5ibTlI.d.ts} +18 -9
  24. package/dist/consumer-YE5ibTlI.d.ts.map +1 -0
  25. package/dist/consumer.d.ts +1 -1
  26. package/dist/consumer.js +1 -1
  27. package/dist/{core-types-DfCMwTYt.d.ts → core-types-0BenSoZJ.d.ts} +17 -3
  28. package/dist/core-types-0BenSoZJ.d.ts.map +1 -0
  29. package/dist/{coverage-catalog-oQiZ8yot.d.ts → coverage-catalog-5LheuThC.d.ts} +2 -2
  30. package/dist/{coverage-catalog-oQiZ8yot.d.ts.map → coverage-catalog-5LheuThC.d.ts.map} +1 -1
  31. package/dist/coverage-catalog.d.ts +1 -1
  32. package/dist/{hub-D13zPQGr.js → hub-BjCYNJWr.js} +316 -149
  33. package/dist/hub-BjCYNJWr.js.map +1 -0
  34. package/dist/{hub-fmmnwC2s.d.ts → hub-DkiKVWJX.d.ts} +5 -3
  35. package/dist/hub-DkiKVWJX.d.ts.map +1 -0
  36. package/dist/hub.d.ts +1 -1
  37. package/dist/hub.js +1 -1
  38. package/dist/{index-DbwNiedC.d.ts → index-BFK-G6g1.d.ts} +2 -2
  39. package/dist/{index-DbwNiedC.d.ts.map → index-BFK-G6g1.d.ts.map} +1 -1
  40. package/dist/{index-CHD_8Gn2.d.ts → index-BNzWrQM0.d.ts} +3 -3
  41. package/dist/{index-CHD_8Gn2.d.ts.map → index-BNzWrQM0.d.ts.map} +1 -1
  42. package/dist/{index-B-VH5b3E.d.ts → index-CkCYzn8f.d.ts} +2 -2
  43. package/dist/{index-B-VH5b3E.d.ts.map → index-CkCYzn8f.d.ts.map} +1 -1
  44. package/dist/{index-BKTHRkGz.d.ts → index-WwSnaq5E.d.ts} +11 -2
  45. package/dist/{index-BKTHRkGz.d.ts.map → index-WwSnaq5E.d.ts.map} +1 -1
  46. package/dist/{index-CW1fmxQi.d.ts → index-poLalSQ6.d.ts} +3 -3
  47. package/dist/{index-CW1fmxQi.d.ts.map → index-poLalSQ6.d.ts.map} +1 -1
  48. package/dist/index.d.ts +18 -18
  49. package/dist/index.js +11 -10
  50. package/dist/internal/bundled-manifest-runtime.d.ts +1 -1
  51. package/dist/internal/bundled-manifest-runtime.js +30 -2
  52. package/dist/internal/bundled-manifest-runtime.js.map +1 -1
  53. package/dist/mcp.d.ts +2 -2
  54. package/dist/mcp.js +2 -2
  55. package/dist/middleware/index.d.ts +1 -1
  56. package/dist/middleware/index.js +1 -1
  57. package/dist/{oauth-tzsnaJIb.d.ts → oauth-DoUCpYU_.d.ts} +85 -64
  58. package/dist/oauth-DoUCpYU_.d.ts.map +1 -0
  59. package/dist/oauth-protocol-CFrGJlSz.js +195 -0
  60. package/dist/oauth-protocol-CFrGJlSz.js.map +1 -0
  61. package/dist/{policy-C9frNJFH.d.ts → policy-C8jynxf9.d.ts} +2 -2
  62. package/dist/{policy-C9frNJFH.d.ts.map → policy-C8jynxf9.d.ts.map} +1 -1
  63. package/dist/{registry-CE1iu5zX.d.ts → registry-0xWMSBUu.d.ts} +3 -3
  64. package/dist/{registry-CE1iu5zX.d.ts.map → registry-0xWMSBUu.d.ts.map} +1 -1
  65. package/dist/{registry-core-DtFI-9kF.d.ts → registry-core-B1ApiG47.d.ts} +2 -2
  66. package/dist/{registry-core-DtFI-9kF.d.ts.map → registry-core-B1ApiG47.d.ts.map} +1 -1
  67. package/dist/registry.d.ts +2 -2
  68. package/dist/registry.js +1 -1
  69. package/dist/runtime.d.ts +1 -1
  70. package/dist/sandbox.d.ts +1 -1
  71. package/dist/{specs-Dp7I8aL5.js → specs-02Un982U.js} +2 -2
  72. package/dist/{specs-Dp7I8aL5.js.map → specs-02Un982U.js.map} +1 -1
  73. package/dist/specs.d.ts +1 -1
  74. package/dist/specs.js +1 -1
  75. package/dist/{src-CJBv3wD1.js → src-DM3qkMTB.js} +5 -5
  76. package/dist/{src-CJBv3wD1.js.map → src-DM3qkMTB.js.map} +1 -1
  77. package/dist/{tangle-id-Bq7jkKmE.d.ts → tangle-id-BW5dTiGi.d.ts} +2 -2
  78. package/dist/{tangle-id-Bq7jkKmE.d.ts.map → tangle-id-BW5dTiGi.d.ts.map} +1 -1
  79. package/dist/{tangle-id-81ShqJ7k.js → tangle-id-DUsy7I9_.js} +2 -2
  80. package/dist/{tangle-id-81ShqJ7k.js.map → tangle-id-DUsy7I9_.js.map} +1 -1
  81. package/dist/{types-W418mSuf.d.ts → types-Bq85dJDW.d.ts} +13 -1
  82. package/dist/types-Bq85dJDW.d.ts.map +1 -0
  83. package/dist/{types-BSDXGSi5.js → types-CjrugGcd.js} +13 -7
  84. package/dist/types-CjrugGcd.js.map +1 -0
  85. package/dist/webhooks/index.js +1 -1
  86. package/dist/worker.d.ts +3 -3
  87. package/package.json +1 -1
  88. package/dist/bundled-manifest-runtime-G6p2i9W-.d.ts.map +0 -1
  89. package/dist/cloudbeds-BL5EF3xl.js.map +0 -1
  90. package/dist/consumer-BafUQUla.d.ts.map +0 -1
  91. package/dist/core-types-DfCMwTYt.d.ts.map +0 -1
  92. package/dist/hub-D13zPQGr.js.map +0 -1
  93. package/dist/hub-fmmnwC2s.d.ts.map +0 -1
  94. package/dist/oauth-tzsnaJIb.d.ts.map +0 -1
  95. package/dist/types-BSDXGSi5.js.map +0 -1
  96. package/dist/types-W418mSuf.d.ts.map +0 -1
package/README.md CHANGED
@@ -160,6 +160,12 @@ Generated code calls your product integration endpoint with the scoped
160
160
  capability bundle. It never receives provider refresh tokens, API keys, or raw
161
161
  OAuth credentials.
162
162
 
163
+ Connector hosts keep browser/session proof, tenancy, account identity and encrypted
164
+ storage in the product. `IntegrationHub.startAuth` pins normalized provider metadata;
165
+ `completeAuth` uses its single-use state. Adapter-owned exchanges take precedence.
166
+ `listBundledConnectorAdapters({ envSource, includeUnconfigured: true })` supplies
167
+ configured factories plus catalog-only declarations that cannot execute.
168
+
163
169
  ## Core Primitives
164
170
 
165
171
  | Primitive | Purpose |
@@ -201,7 +207,7 @@ OAuth credentials.
201
207
  | `buildIntegrationInvocationEnvelope` | Sandbox-safe action envelope. |
202
208
  | `validateIntegrationInvocationEnvelope` | Runtime validation for tool/action consistency and input limits. |
203
209
  | `createHttpIntegrationProvider` | Adapter for hosted integration gateways. |
204
- | `createConnectorAdapterProvider` | Runs first-party `ConnectorAdapter`s through the same provider contract. |
210
+ | `createConnectorAdapterProvider` | Connector execution, bounded OAuth exchange, API-key connect and credential probes. Supply `persistConnection` to encrypt initial credentials and return the canonical connection with its secret reference; completion fails closed without it. |
205
211
  | `declarativeRestConnector` | Builds REST-backed first-party adapters from compact specs. |
206
212
  | `listIntegrationSpecs` | Generates setup/execution specs from the coverage catalog and family defaults. |
207
213
  | `renderRunbookMarkdown` / `renderConsoleSteps` | Render operator docs or admin UI steps from the same spec source. |
@@ -448,15 +454,7 @@ without obscuring the package contract.
448
454
 
449
455
  ## Development
450
456
 
451
- ```sh
452
- pnpm install
453
- pnpm typecheck
454
- pnpm test
455
- pnpm build
456
- pnpm run check:bundled-manifest-freshness
457
- pnpm pack
458
- pnpm run release
459
- ```
457
+ For package code changes, merge `origin/main` and run the canonical local gate (the launcher performs the frozen install): `beelink-gate auto https://github.com/tangle-network/agent-integrations.git <full-sha> -- bash -lc 'pnpm typecheck && pnpm run release && pnpm exec vitest run <touched-integration-files>'`. Supply the touched integration test files; the release command builds and verifies the packed artifact before those tests run. Workflow and documentation changes use YAML and content checks.
460
458
 
461
459
  `pnpm run release` builds the package, generates and checks bundled adapter
462
460
  metadata, packs one exact archive, and tests that archive without publishing.
@@ -470,18 +468,16 @@ The test suite packs the npm artifact and bundles `/worker`, `/specs`, and
470
468
  ## Prepare a release
471
469
 
472
470
  Feature PRs must leave the package version and `CHANGELOG.md` unchanged.
473
- Feature checks compare against the common ancestor, so releases merged into `main` do not invalidate unchanged feature metadata.
474
471
  After features merge, run the **Prepare Release** workflow and choose a patch, minor, or major bump.
475
472
  The workflow uses Node and Git to open a `release/v<version>` PR from current `main`.
476
473
  It does not install dependencies or publish a package.
477
474
 
478
- Verification requires the branch version to match the next package version.
475
+ Review that the release branch version matches the next package version.
479
476
  Only the package version and generated changelog entry may change in that PR.
480
477
  Existing changelog history must remain unchanged.
481
478
  The generated notes describe the `main` snapshot used by the preparation workflow.
482
479
  Before merging, compare the notes with the final release commits and update them if `main` advanced.
483
- Approve the generated PR's workflow runs if GitHub requests approval.
484
- Merge the release PR after its checks pass.
480
+ Read all reviews and the local gate receipt before merging the release PR.
485
481
 
486
482
  After publication approval, tag the merged commit with `v<version>` to start the existing **Publish** workflow.
487
483
  Confirm that the published archive installs and its intended consumer flow works before reporting availability.