@tangle-network/agent-integrations 1.0.2 → 1.0.4
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.
- package/README.md +31 -30
- package/data/bundled-adapter-manifests.json +1 -1
- package/dist/{adapters-DbYKxFVp.js → adapters-x5V_2d6D.js} +447 -678
- package/dist/{adapters-DbYKxFVp.js.map → adapters-x5V_2d6D.js.map} +1 -1
- package/dist/{billing-access-policy-CtvuHvM8.d.ts → billing-access-policy-Ce3WWxG5.d.ts} +2 -3
- package/dist/billing-access-policy-Ce3WWxG5.d.ts.map +1 -0
- package/dist/billing-access-policy-DJ63AxZ5.js.map +1 -1
- package/dist/{bundled-manifest-data-CgUuwak6.js → bundled-manifest-data-DLzwtr7z.js} +89 -1
- package/dist/{bundled-manifest-data-CgUuwak6.js.map → bundled-manifest-data-DLzwtr7z.js.map} +1 -1
- package/dist/{bundled-manifest-runtime-EpjLQKA9.d.ts → bundled-manifest-runtime-nc86Eowo.d.ts} +2 -2
- package/dist/{bundled-manifest-runtime-EpjLQKA9.d.ts.map → bundled-manifest-runtime-nc86Eowo.d.ts.map} +1 -1
- package/dist/{catalog-CFvKzwVj.js → catalog-DEbD4Cn3.js} +6 -10
- package/dist/catalog-DEbD4Cn3.js.map +1 -0
- package/dist/{catalog-z4zNeXVL.d.ts → catalog-VQlC1Ew0.d.ts} +8 -12
- package/dist/{catalog-z4zNeXVL.d.ts.map → catalog-VQlC1Ew0.d.ts.map} +1 -1
- package/dist/catalog.d.ts +1 -1
- package/dist/catalog.js +1 -1
- package/dist/connect/index.d.ts +1 -1
- package/dist/connectors/adapters/index.d.ts +3 -2
- package/dist/connectors/adapters/index.js +1 -1
- package/dist/connectors/index.d.ts +7 -7
- package/dist/connectors/index.js +2 -2
- package/dist/connectors/oauth.d.ts +1 -1
- package/dist/{consumer-PHOoRorX.d.ts → consumer-BMWxApGG.d.ts} +10 -122
- package/dist/consumer-BMWxApGG.d.ts.map +1 -0
- package/dist/consumer.d.ts +1 -1
- package/dist/{types-Bq85dJDW.d.ts → core-types-ZuEjjJAr.d.ts} +546 -14
- package/dist/core-types-ZuEjjJAr.d.ts.map +1 -0
- package/dist/{coverage-catalog-5LheuThC.d.ts → coverage-catalog-CsJmShn5.d.ts} +3 -4
- package/dist/{coverage-catalog-5LheuThC.d.ts.map → coverage-catalog-CsJmShn5.d.ts.map} +1 -1
- package/dist/coverage-catalog.d.ts +2 -2
- package/dist/coverage-catalog.js +1 -22
- package/dist/coverage-catalog.js.map +1 -1
- package/dist/{errors-8ePwEZRM.d.ts → errors-CvjrGB5r.d.ts} +4 -1
- package/dist/errors-CvjrGB5r.d.ts.map +1 -0
- package/dist/{errors-CvO_y8JO.js → errors-DSdeYms8.js} +16 -3
- package/dist/errors-DSdeYms8.js.map +1 -0
- package/dist/{hub-DkiKVWJX.d.ts → hub-CRteFmOR.d.ts} +3 -3
- package/dist/{hub-DkiKVWJX.d.ts.map → hub-CRteFmOR.d.ts.map} +1 -1
- package/dist/{hub-Du6wsA1o.js → hub-DnPkr4xn.js} +2 -1
- package/dist/hub-DnPkr4xn.js.map +1 -0
- package/dist/hub.d.ts +1 -1
- package/dist/hub.js +1 -1
- package/dist/{index-BFK-G6g1.d.ts → index-BAI3O7bc.d.ts} +2 -2
- package/dist/{index-BFK-G6g1.d.ts.map → index-BAI3O7bc.d.ts.map} +1 -1
- package/dist/{index-poLalSQ6.d.ts → index-BbluAb0U.d.ts} +3 -12
- package/dist/index-BbluAb0U.d.ts.map +1 -0
- package/dist/{index-HBXVPkSs.d.ts → index-C5W0VfzQ.d.ts} +19 -194
- package/dist/index-C5W0VfzQ.d.ts.map +1 -0
- package/dist/{index-CkCYzn8f.d.ts → index-CezgaMuD.d.ts} +3 -3
- package/dist/{index-CkCYzn8f.d.ts.map → index-CezgaMuD.d.ts.map} +1 -1
- package/dist/{index-DoJFdW9K.d.ts → index-Dev4r3_u.d.ts} +3 -3
- package/dist/{index-DoJFdW9K.d.ts.map → index-Dev4r3_u.d.ts.map} +1 -1
- package/dist/index.d.ts +19 -20
- package/dist/index.js +11 -11
- package/dist/internal/bundled-manifest-runtime.d.ts +1 -1
- package/dist/internal/bundled-manifest-runtime.js +1 -1
- package/dist/mcp.d.ts +2 -2
- package/dist/mcp.js +2 -2
- package/dist/middleware/index.d.ts +1 -1
- package/dist/{oauth-DoUCpYU_.d.ts → oauth-Br5r5Ms0.d.ts} +2 -2
- package/dist/{oauth-DoUCpYU_.d.ts.map → oauth-Br5r5Ms0.d.ts.map} +1 -1
- package/dist/{policy-C8jynxf9.d.ts → policy-BH4ZAZ4s.d.ts} +3 -14
- package/dist/policy-BH4ZAZ4s.d.ts.map +1 -0
- package/dist/{policy-UOPcZqdE.js → policy-C0XpcajG.js} +5 -30
- package/dist/policy-C0XpcajG.js.map +1 -0
- package/dist/{redaction-B6R-ZeWT.js → redaction-dXj4op-I.js} +16 -2
- package/dist/redaction-dXj4op-I.js.map +1 -0
- package/dist/{registry-0xWMSBUu.d.ts → registry-CJFl46d3.d.ts} +3 -3
- package/dist/{registry-0xWMSBUu.d.ts.map → registry-CJFl46d3.d.ts.map} +1 -1
- package/dist/{registry-core-B1ApiG47.d.ts → registry-core-_BnkpeSe.d.ts} +2 -2
- package/dist/{registry-core-B1ApiG47.d.ts.map → registry-core-_BnkpeSe.d.ts.map} +1 -1
- package/dist/registry.d.ts +2 -2
- package/dist/registry.js +1 -1
- package/dist/runtime.d.ts +1 -1
- package/dist/runtime.js +1 -1
- package/dist/sandbox.d.ts +2 -2
- package/dist/sandbox.js +5 -20
- package/dist/sandbox.js.map +1 -1
- package/dist/{specs-amTqWDjy.js → specs-BQHb_KgP.js} +4 -23
- package/dist/specs-BQHb_KgP.js.map +1 -0
- package/dist/specs.d.ts +2 -2
- package/dist/specs.js +2 -2
- package/dist/{src-DsEhuVEx.js → src-BZmlzQzN.js} +8 -186
- package/dist/src-BZmlzQzN.js.map +1 -0
- package/dist/stripe/index.d.ts +3 -79
- package/dist/stripe/index.d.ts.map +1 -1
- package/dist/stripe/index.js +5 -52
- package/dist/stripe/index.js.map +1 -1
- package/dist/{tangle-id-BW5dTiGi.d.ts → tangle-id-BnzGOA_W.d.ts} +2 -2
- package/dist/{tangle-id-BW5dTiGi.d.ts.map → tangle-id-BnzGOA_W.d.ts.map} +1 -1
- package/dist/types-CjrugGcd.js.map +1 -1
- package/dist/worker.d.ts +3 -3
- package/dist/worker.js +2 -2
- package/docs/external-product-integration.md +14 -5
- package/docs/integration-coverage-checklist.md +1 -12
- package/docs/private-audio-transcription.md +1 -1
- package/package.json +2 -1
- package/dist/billing-access-policy-CtvuHvM8.d.ts.map +0 -1
- package/dist/catalog-CFvKzwVj.js.map +0 -1
- package/dist/consumer-PHOoRorX.d.ts.map +0 -1
- package/dist/core-types-0BenSoZJ.d.ts +0 -365
- package/dist/core-types-0BenSoZJ.d.ts.map +0 -1
- package/dist/errors-8ePwEZRM.d.ts.map +0 -1
- package/dist/errors-CvO_y8JO.js.map +0 -1
- package/dist/hub-Du6wsA1o.js.map +0 -1
- package/dist/index-HBXVPkSs.d.ts.map +0 -1
- package/dist/index-poLalSQ6.d.ts.map +0 -1
- package/dist/policy-C8jynxf9.d.ts.map +0 -1
- package/dist/policy-UOPcZqdE.js.map +0 -1
- package/dist/redaction-B6R-ZeWT.js.map +0 -1
- package/dist/specs-amTqWDjy.js.map +0 -1
- package/dist/src-DsEhuVEx.js.map +0 -1
- package/dist/types-Bq85dJDW.d.ts.map +0 -1
- package/docs/generated-integration-coverage-checklist.md +0 -156
package/README.md
CHANGED
|
@@ -33,35 +33,23 @@ provider SDK.
|
|
|
33
33
|
|
|
34
34
|
## What It Provides
|
|
35
35
|
|
|
36
|
-
- A normalized connector/action/trigger catalog
|
|
37
|
-
|
|
38
|
-
|
|
36
|
+
- A normalized connector/action/trigger catalog with Tangle contracts for
|
|
37
|
+
every connector, and generated `IntegrationSpec`s for setup docs,
|
|
38
|
+
permissions, healthchecks, and tool descriptions.
|
|
39
|
+
- User-owned connection records referencing secrets in vaults, never raw
|
|
39
40
|
credentials in public shapes.
|
|
40
|
-
- Short-lived capability tokens for sandbox-safe access to a subset of
|
|
41
|
-
connection.
|
|
42
|
-
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
- A gateway catalog provider for hosted integration gateways, executor-style
|
|
46
|
-
runtimes, and internal connector registries.
|
|
47
|
-
- A first-party `ConnectorAdapter` boundary for direct provider execution.
|
|
48
|
-
- A declarative REST adapter factory for promoting REST APIs from reviewed specs.
|
|
49
|
-
- A broad catalog for discovering hundreds of integrations while keeping
|
|
50
|
-
executable backend state explicit.
|
|
41
|
+
- Short-lived, scoped capability tokens for sandbox-safe access to a subset of
|
|
42
|
+
a user's connection, with policy checks and invocation-envelope validation.
|
|
43
|
+
- First-party `ConnectorAdapter` and declarative REST factories for direct
|
|
44
|
+
execution; gateway providers for hosted gateways, executor-style runtimes,
|
|
45
|
+
and internal registries.
|
|
51
46
|
- A canonical registry that deduplicates overlapping catalogs, keeps support
|
|
52
|
-
tiers explicit, and
|
|
47
|
+
tiers explicit, and keeps executable backend state distinct from discovery.
|
|
53
48
|
- App/agent manifests, grants, and sandbox bundles so generated apps, domain
|
|
54
|
-
agents, and
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
- Approval persistence, audit events, healthchecks, credential resolution,
|
|
59
|
-
webhook ingestion, idempotency guards, and sandbox/CLI bridge payloads.
|
|
60
|
-
- Generated-app client helpers, manifest inference/validation, consent copy,
|
|
61
|
-
platform policy presets, canonical launch action schemas, and controlled
|
|
62
|
-
provider-native passthrough validation.
|
|
63
|
-
- A generated `IntegrationSpec` registry used for setup docs, admin UI steps,
|
|
64
|
-
normalized permissions, healthcheck plans, and tool descriptions.
|
|
49
|
+
agents, and runtimes reuse user-owned connections safely.
|
|
50
|
+
- Workflow trigger installation, normalized event dispatch, approvals, audit
|
|
51
|
+
events, healthchecks, idempotency guards, webhook ingestion, consent copy,
|
|
52
|
+
and sandbox/CLI bridge payloads.
|
|
65
53
|
|
|
66
54
|
## Architecture
|
|
67
55
|
|
|
@@ -178,8 +166,8 @@ configured factories plus catalog-only declarations that cannot execute.
|
|
|
178
166
|
| `IntegrationGrant` | Persistent grant from a user-owned connection to an app, agent, or sandbox consumer. |
|
|
179
167
|
| `createIntegrationRuntime` | Facade for manifest resolution, grant creation, and sandbox capability bundles. |
|
|
180
168
|
| `createIntegrationWorkflowRuntime` | Installs trigger workflows and dispatches normalized provider events. |
|
|
181
|
-
| `
|
|
182
|
-
| `
|
|
169
|
+
| `ApprovalBackedPolicyEngine` | Persists approval requests and allows approved invocations to resume. |
|
|
170
|
+
| `DefaultIntegrationActionGuard` | Adds idempotency replay, dry-run mutation handling, rate-limit hooks, and audit events. |
|
|
183
171
|
| `createConnectionCredentialResolver` | Resolves secret refs into in-memory connector credentials and refreshes expired OAuth credentials. |
|
|
184
172
|
| `runIntegrationHealthchecks` | Checks connection status, registry executability, scope shape, and optional live provider tests. |
|
|
185
173
|
| `receiveIntegrationWebhook` | Verifies inbound webhooks, dedupes provider events, and dispatches normalized trigger events. |
|
|
@@ -189,7 +177,7 @@ configured factories plus catalog-only declarations that cannot execute.
|
|
|
189
177
|
| `handleDelegatedToolCall` / `handleDelegatedToolRequest` | Transport-agnostic JSON-RPC 2.0 callback handler with fail-closed gates (token fresh, tool allow-listed, integration connected) via product-supplied seams. |
|
|
190
178
|
| `createTangleIntegrationsClient` | Tiny generated-app/sandbox client for platform `/v1/integrations/invoke`. |
|
|
191
179
|
| `inferIntegrationManifestFromTools` / `validateIntegrationManifest` | Deterministic manifest helpers for Builder and platform APIs. |
|
|
192
|
-
| `renderConsentSummary`
|
|
180
|
+
| `renderConsentSummary` | User-facing consent copy from manifests/actions. |
|
|
193
181
|
| `createPlatformIntegrationPolicyPreset` | Secure defaults: reads allowed after grant, writes need approval, destructive denied, passthrough disabled. |
|
|
194
182
|
| `buildCanonicalLaunchConnectors` | Product-ready launch action schemas for Calendar, Gmail, Drive, GitHub, and Slack. |
|
|
195
183
|
| `validateProviderPassthroughRequest` | Policy-gated provider-native HTTP escape hatch validation. |
|
|
@@ -211,7 +199,7 @@ configured factories plus catalog-only declarations that cannot execute.
|
|
|
211
199
|
| `declarativeRestConnector` | Builds REST-backed first-party adapters from compact specs. |
|
|
212
200
|
| `listIntegrationSpecs` | Generates setup/execution specs from the coverage catalog and family defaults. |
|
|
213
201
|
| `renderRunbookMarkdown` / `renderConsoleSteps` | Render operator docs or admin UI steps from the same spec source. |
|
|
214
|
-
| `
|
|
202
|
+
| `validateCredentialFormat` / `buildHealthcheckPlan` | Validate setup input and describe the correct healthcheck path. |
|
|
215
203
|
|
|
216
204
|
## Worker-safe Imports
|
|
217
205
|
|
|
@@ -384,6 +372,19 @@ See [Integration Execution Audit](./docs/integration-execution-audit.md) for
|
|
|
384
372
|
the exact current split between catalog, setup, first-party execution, and
|
|
385
373
|
package-runtime execution.
|
|
386
374
|
|
|
375
|
+
### Readiness States
|
|
376
|
+
|
|
377
|
+
Copy names a connector's state instead of implying execution: **catalogued**
|
|
378
|
+
(discovery only), **configured** (product registered an adapter or gateway
|
|
379
|
+
backend), **connected** (user completed setup and owns a connection record),
|
|
380
|
+
**authorized** (a grant scopes actions to an app or agent), **executed** (a
|
|
381
|
+
provider call ran and returned a result). Catalog breadth is not a promise
|
|
382
|
+
that every action works for every customer: say "Available in the catalog;
|
|
383
|
+
account setup required" rather than a generic "Connected", and surface the
|
|
384
|
+
provider's own result — limits, failures, and revocation intact — for executed
|
|
385
|
+
writes. Tool descriptors carry `supportTier` and `runnable` so discovery
|
|
386
|
+
tools stay distinguishable from runtime tools.
|
|
387
|
+
|
|
387
388
|
## Executable Coverage
|
|
388
389
|
|
|
389
390
|
Current first-party adapters:
|