@jskit-ai/connectors-catalog 0.1.64 → 0.1.66
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 +12 -17
- package/docs/ai.md +5 -17
- package/docs/amazon-redshift.md +6 -8
- package/docs/apollo-io.md +0 -8
- package/docs/ashby.md +0 -8
- package/docs/attention.md +0 -8
- package/docs/aws-athena.md +2 -2
- package/docs/aws-credentials.md +1 -1
- package/docs/aws-s3.md +1 -1
- package/docs/bigquery.md +2 -4
- package/docs/calendly.md +4 -14
- package/docs/chargebee.md +0 -9
- package/docs/clickhouse.md +1 -1
- package/docs/confidence-oauth.md +3 -9
- package/docs/contentful.md +4 -13
- package/docs/databricks.md +35 -3
- package/docs/dbt-semantic-layer.md +2 -8
- package/docs/figma.md +5 -5
- package/docs/firebase-cloud-messaging.md +3 -3
- package/docs/firecrawl.md +1 -1
- package/docs/fireflies.md +7 -10
- package/docs/gemini-enterprise.md +33 -3
- package/docs/gong.md +0 -9
- package/docs/google-ads.md +53 -11
- package/docs/google-analytics.md +2 -2
- package/docs/google-maps-platform.md +3 -9
- package/docs/granola.md +1 -1
- package/docs/hubspot.md +25 -0
- package/docs/klipy.md +0 -13
- package/docs/lexware.md +0 -8
- package/docs/lightspeed.md +32 -3
- package/docs/linear.md +24 -7
- package/docs/linkedin.md +16 -16
- package/docs/logo-dev.md +7 -25
- package/docs/mailgun.md +1 -14
- package/docs/mapbox.md +0 -8
- package/docs/microsoft-fabric.md +50 -13
- package/docs/microsoft-oauth.md +33 -0
- package/docs/microsoft-powerpoint.md +2 -13
- package/docs/microsoft-word.md +2 -13
- package/docs/miro.md +2 -2
- package/docs/oura.md +4 -3
- package/docs/polar.md +3 -5
- package/docs/posthog.md +2 -17
- package/docs/prestashop.md +5 -9
- package/docs/salesforce.md +41 -12
- package/docs/sentry.md +1 -12
- package/docs/sevdesk.md +2 -13
- package/docs/shopify.md +35 -2
- package/docs/slack.md +39 -14
- package/docs/snowflake.md +27 -2
- package/docs/telegram.md +0 -10
- package/docs/tiktok.md +19 -1
- package/docs/twilio.md +1 -1
- package/docs/twitch.md +34 -4
- package/docs/wave.md +36 -15
- package/docs/wix.md +4 -17
- package/docs/wiz.md +4 -4
- package/docs/wordpress-com.md +4 -13
- package/docs/workday.md +28 -9
- package/docs/x-twitter.md +0 -9
- package/docs/xero.md +39 -11
- package/docs/zoho-books.md +41 -10
- package/docs/zoho-crm.md +36 -12
- package/package.json +3 -3
- package/patterns/oauth-connection/PATTERN.md +27 -610
- package/patterns/paddle-catalogue/example/create-products.js +2 -1
- package/patterns/redshift-queries/PATTERN.md +1 -1
- package/src/server/attention.js +8 -11
- package/src/server/bigquery.js +7 -11
- package/src/server/brevo.js +7 -10
- package/src/server/calendly.js +7 -9
- package/src/server/chargebee.js +3 -6
- package/src/server/firecrawl.js +3 -3
- package/src/server/gatewayapi.js +4 -4
- package/src/server/github-api.js +1 -1
- package/src/server/gitlab-api.js +1 -1
- package/src/server/gmail.js +6 -11
- package/src/server/gong.js +4 -4
- package/src/server/google-ads-search.js +4 -5
- package/src/server/google-docs.js +10 -22
- package/src/server/google-drive.js +6 -6
- package/src/server/google-maps-platform.js +4 -8
- package/src/server/google-search-console.js +2 -2
- package/src/server/google-sheets.js +12 -18
- package/src/server/google-slides.js +10 -16
- package/src/server/google.js +17 -9
- package/src/server/jsonOperation.js +17 -18
- package/src/server/lexware.js +4 -9
- package/src/server/resend.js +8 -14
- package/src/server/semrush.js +70 -89
- package/src/server/wix.js +152 -222
- package/src/server/x-twitter.js +21 -18
- package/src/shared/ai.js +3 -1
- package/src/shared/definitions.js +2 -34
- package/src/shared/firecrawl.js +17 -0
- package/src/shared/gemini-enterprise.js +1 -1
- package/src/shared/google-ads.js +1 -1
- package/src/shared/google.js +2 -2
- package/src/shared/logo-dev.js +1 -1
- package/src/shared/mapbox.js +2 -2
- package/src/shared/mcp.js +2 -5
- package/src/shared/microsoft-fabric.js +1 -1
- package/src/shared/microsoft.js +12 -24
- package/src/shared/resend.js +20 -0
- package/src/shared/siteUrl.js +1 -1
- package/src/shared/tokens.js +4 -6
- package/src/shared/workday.js +1 -1
- package/test/firecrawl.test.js +1 -1
- package/test/github-api.test.js +2 -1
- package/test/gitlab-api.test.js +2 -1
- package/test/gong.test.js +2 -2
- package/test/google.test.js +20 -10
- package/test/setupGuides.test.js +18 -0
- package/test/tokens.test.js +1 -1
- package/test/wix.test.js +13 -0
package/README.md
CHANGED
|
@@ -50,7 +50,7 @@ Provider request validation remains authoritative.
|
|
|
50
50
|
|
|
51
51
|
| Provider | Export | Initial operations | Authentication |
|
|
52
52
|
|---|---|---|---|
|
|
53
|
-
| [AI](docs/ai.md) | `createAiConnectionResolver` | Static catalogue and authorized SDK parameters; app-owned inference |
|
|
53
|
+
| [AI](docs/ai.md) | `createAiConnectionResolver` | Static catalogue and authorized SDK parameters; app-owned inference | Explicit model choice; free no-setup models, administrator Env key or private individual grant |
|
|
54
54
|
| [Wiz](docs/wiz.md) | `createWizScanner` | Authorised source-directory scan, policy verdict and report; separate CLI runtime | Own Cognito service account; installed Wiz v1 CLI |
|
|
55
55
|
| [Shopify](docs/shopify.md) | `shopifyProvider` | `products.list`, `products.create`, `products.update`, `products.delete`; assistant policies | Organization client credentials or existing Admin API token |
|
|
56
56
|
| [Confidence Flags](docs/confidence-flags.md) | `confidenceFlagsProvider`, `registerConfidenceClient` | `tools.list`, `tools.call`; explicit client setup | Assistant OAuth for flag management |
|
|
@@ -88,13 +88,13 @@ Provider request validation remains authoritative.
|
|
|
88
88
|
| [Notion](docs/notion.md) | `notionProvider` | Search, page/block reads and writes, data-source queries; separate MCP tools | Own internal token, REST OAuth or separate MCP client |
|
|
89
89
|
| [Brevo](docs/brevo.md) | `brevoProvider` | `contacts.list` | Own API key |
|
|
90
90
|
| [ElevenLabs](docs/elevenlabs.md) | `elevenlabsProvider` | `account.read`, `voices.list` | Own API key |
|
|
91
|
-
| [GitHub API](docs/github-api.md) | `githubApiProvider` | `account.read`, `repositories.list` | Own personal access token |
|
|
91
|
+
| [GitHub API](docs/github-api.md) | `githubApiProvider` | `account.read`, `repositories.list` | Own personal access token or OAuth registration |
|
|
92
92
|
| [Apify](docs/apify.md) | `apifyProvider` | `actors.list` | Own API token |
|
|
93
|
-
| [Calendly](docs/calendly.md) | `calendlyProvider` | `profile.read`, `eventTypes.list` | Own personal access token |
|
|
93
|
+
| [Calendly](docs/calendly.md) | `calendlyProvider` | `profile.read`, `eventTypes.list` | Own personal access token or OAuth registration |
|
|
94
94
|
| [HubSpot](docs/hubspot.md) | `hubspotProvider` | Contact/deal list/get/create/update, relationships and pipeline reads | Own private/static token or project OAuth |
|
|
95
|
-
| [Linear](docs/linear.md) | `linearProvider` | `profile.read`, `issues.list` | Own personal API key |
|
|
95
|
+
| [Linear](docs/linear.md) | `linearProvider` | `profile.read`, `issues.list` | Own personal API key or OAuth registration |
|
|
96
96
|
| [Pipedrive](docs/pipedrive.md) | `pipedriveProvider` | Profile; deals, people, organizations, activities, leads and pipeline reads; basic record create/update | Own user/company API token |
|
|
97
|
-
| [GitLab API](docs/gitlab-api.md) | `gitlabApiProvider` | `profile.read`, `projects.list` | Own GitLab.com
|
|
97
|
+
| [GitLab API](docs/gitlab-api.md) | `gitlabApiProvider` | `profile.read`, `projects.list` | Own personal access token or OAuth registration; GitLab.com or own instance URL |
|
|
98
98
|
| [Tally](docs/tally.md) | `tallyProvider` | `forms.list` | Own API key |
|
|
99
99
|
| [Contentful](docs/contentful.md) | `contentfulProvider` | `entries.list` | Own Content Delivery key, space and environment |
|
|
100
100
|
| [Asana](docs/asana.md) | `asanaProvider` | `workspaces.list` | Own personal access token |
|
|
@@ -106,14 +106,12 @@ Provider request validation remains authoritative.
|
|
|
106
106
|
| [Microsoft Word](docs/microsoft-word.md) | `microsoftWordProvider` | `items.list`, `items.get` | Own delegated OAuth registration |
|
|
107
107
|
| [Microsoft PowerPoint](docs/microsoft-powerpoint.md) | `microsoftPowerPointProvider` | `items.list`, `items.get` | Own delegated OAuth registration |
|
|
108
108
|
| [Microsoft SharePoint](docs/microsoft-sharepoint.md) | `microsoftSharePointProvider` | `sites.search` | Own organizational OAuth registration |
|
|
109
|
-
|
|
110
109
|
| [Stripe](docs/stripe.md) | `stripeProvider` | `balance.read` | Own restricted/secret API key |
|
|
111
110
|
| [Replicate](docs/replicate.md) | `replicateProvider` | Account/hardware, model schema, prediction submit/poll/cancel | Own API token |
|
|
112
|
-
| [Sentry](docs/sentry.md) | `sentryProvider` | `
|
|
111
|
+
| [Sentry](docs/sentry.md) | `sentryProvider`, `registerSentryClient` | `tools.list`, `tools.call`; explicit client setup | Assistant OAuth to Sentry's hosted MCP |
|
|
113
112
|
| [incident.io](docs/incident-io.md) | `incidentIoProvider` | Incidents/follow-ups, alert resolution, schedule reads, catalogue entries | Own API key |
|
|
114
113
|
| [Fireflies](docs/fireflies.md) | `firefliesProvider` | `profile.read`, `transcripts.list` | Own API key |
|
|
115
|
-
|
|
116
|
-
| [HeyGen](docs/heygen.md) | `heygenProvider` | `profile.read`, `voices.list` | Own API key |
|
|
114
|
+
| [HeyGen](docs/heygen.md) | `heygenProvider` | `profile.read`, `voices.list` | Own API key or OAuth registration |
|
|
117
115
|
| [Perplexity](docs/perplexity.md) | `perplexityProvider` | `requests.list`, `models.list` | Own project API key |
|
|
118
116
|
| [Supabase](docs/supabase.md) | `supabaseProvider` | `projects.list` | Own Management API personal token |
|
|
119
117
|
| [Google Analytics](docs/google-analytics.md) | `googleAnalyticsDefinition` (shared configuration) | Framework-owned Google tag | Public Measurement ID |
|
|
@@ -180,15 +178,12 @@ The [OAuth file-connection pattern](patterns/oauth-connection/PATTERN.md) covers
|
|
|
180
178
|
consent and callbacks with the same text-based runtime storage.
|
|
181
179
|
The [Microsoft guide](docs/microsoft-oauth.md) adds delegated OAuth wiring,
|
|
182
180
|
registration automation and provider-specific account/permission requirements.
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
tests are simulated; live service use and sample-app generation are outside
|
|
186
|
-
this delivery's test scope. Managed service credentials and sharing grants
|
|
187
|
-
remain host-owned capabilities; an own key is not a managed subscription.
|
|
181
|
+
Managed service credentials and sharing grants remain host-owned
|
|
182
|
+
capabilities; an own key is not a managed subscription.
|
|
188
183
|
|
|
189
184
|
Logo.dev uses the [public-image pattern](patterns/public-image/PATTERN.md) and
|
|
190
|
-
its client library export.
|
|
191
|
-
|
|
192
|
-
|
|
185
|
+
its client library export. It is `configurationOnly`: it has no server adapter
|
|
186
|
+
or account connection. Image delivery is observed in the browser; constructing
|
|
187
|
+
a URL never records Connected.
|
|
193
188
|
|
|
194
189
|
The [AWS pattern](patterns/aws-storage-queries/PATTERN.md) composes the signed S3 and Athena libraries with the same file configuration and host authorization.
|
package/docs/ai.md
CHANGED
|
@@ -159,8 +159,8 @@ as general app-inference credentials.
|
|
|
159
159
|
|
|
160
160
|
## Provider setup and automation
|
|
161
161
|
|
|
162
|
-
There are no
|
|
163
|
-
|
|
162
|
+
There are no shared OAuth registrations or universal callbacks for this AI
|
|
163
|
+
integration. Regular keys belong to the app administrator
|
|
164
164
|
or individual app user and are billed directly by that provider.
|
|
165
165
|
|
|
166
166
|
Choose AI, then choose a provider and model; nothing is preselected. For an
|
|
@@ -193,23 +193,11 @@ automate them. AI can wire environment names, configuration and native SDKs;
|
|
|
193
193
|
it cannot create somebody's account, accept terms or supply their billing
|
|
194
194
|
authorization merely by editing this JSON.
|
|
195
195
|
|
|
196
|
-
##
|
|
196
|
+
## Scope and limitations
|
|
197
197
|
|
|
198
|
-
|
|
199
|
-
selection, authorized environment and individual-key resolution, rotation,
|
|
200
|
-
disconnect, redacted failures and SDK parameter handoff. Browser fixtures cover
|
|
201
|
-
the editor's default, searchable model change, credential ownership, persistence
|
|
202
|
-
and responsive layout. These tests perform no live inference, provider login,
|
|
203
|
-
account creation or generated-application execution.
|
|
204
|
-
|
|
205
|
-
## Existing-scope closeout — 13 September 2026
|
|
206
|
-
|
|
207
|
-
A static, attributed September 10 provider/model catalogue, searchable free/paid model configuration and a backend-only authorized credential/SDK-parameter resolver. No model is preselected and the first authentication method is a provider API key. Administrator keys resolve through Env, and individual keys through an app-supplied user/provider-scoped reference resolver.
|
|
208
|
-
|
|
209
|
-
No inference engine, streaming, tools, conversation storage, provider OAuth/login screens, account/key provisioning, live credential verification, usage metering, billing, token resale or Vibe64 AI gateway. No automatic SDK installation, catalogue updates, model replacement or paid fallback. Only the 13 explicitly supported direct-key routes are configurable; other catalogue entries are framework metadata, not implemented cloud/coding-subscription authentication. Model availability, pricing/free classification and endpoint operation are dated source information, not live proof; even no-setup choices can be unavailable or capacity-limited. Detailed provider-specific personal-key entry, verification, encrypted storage, rotation/disconnect and authorization remain application work; the resolver only consumes those bindings. The app/framework owns SDK installation, protocol selection, requests, errors and UI. Generic key-creation guidance and linked provider documentation are supplied; bespoke audited login/key-creation screens for every catalogue provider are not. To extend: deliberately refresh the static snapshot, improve selected provider-specific instructions, and wire any desired app-native key-entry/inference features. This intentionally differs from Lovable managed AI; coding-agent credentials and runtimes remain separate from direct-provider API authentication.
|
|
210
|
-
|
|
211
|
-
10 source and 10 installed-package tests passed on September 13, proving snapshot/default selection, rejected unsupported modes, no-network public parameters, authorized Env and individual references, rotation/deletion, redaction and SDK handoff. Historical September 10 compact/medium/expanded UI evidence is retained; no fresh browser, live inference, provider account, generated-app execution or release was performed.
|
|
198
|
+
A static, attributed provider/model catalogue, searchable free/paid model configuration and a backend-only authorized credential/SDK-parameter resolver. No model is preselected and the first authentication method is a provider API key. Administrator keys resolve through Env, and individual keys through an app-supplied user/provider-scoped reference resolver.
|
|
212
199
|
|
|
200
|
+
No inference engine, streaming, tools, conversation storage, provider OAuth/login screens, account/key provisioning, live credential verification, usage metering, billing, token resale or AI gateway. No automatic SDK installation, catalogue updates, model replacement or paid fallback. Only the 13 explicitly supported direct-key routes are configurable; other catalogue entries are framework metadata, not implemented cloud/coding-subscription authentication. Model availability, pricing/free classification and endpoint operation are dated source information, not live proof; even no-setup choices can be unavailable or capacity-limited. Detailed provider-specific personal-key entry, verification, encrypted storage, rotation/disconnect and authorization remain application work; the resolver only consumes those bindings. The app/framework owns SDK installation, protocol selection, requests, errors and UI. Generic key-creation guidance and linked provider documentation are supplied; bespoke audited login/key-creation screens for every catalogue provider are not. To extend: deliberately refresh the static snapshot, improve selected provider-specific instructions, and wire any desired app-native key-entry/inference features. Coding-agent credentials and runtimes remain separate from direct-provider API authentication.
|
|
213
201
|
|
|
214
202
|
## Assistant integration
|
|
215
203
|
|
package/docs/amazon-redshift.md
CHANGED
|
@@ -178,12 +178,12 @@ IAM policies, resource creation, database grants, billing choices and credential
|
|
|
178
178
|
renewal require the corresponding administrator authority. This connector runs
|
|
179
179
|
Data API operations; it does not provision accounts or warehouses.
|
|
180
180
|
|
|
181
|
-
There is **no OAuth callback URL** for the implemented credential mode.
|
|
182
|
-
desktop and independent CLI can all use the same JSON and runtime. A
|
|
183
|
-
|
|
181
|
+
There is **no OAuth callback URL** for the implemented credential mode. Hosted
|
|
182
|
+
editors, desktop and independent CLI can all use the same JSON and runtime. A
|
|
183
|
+
customer's server or custom domain does not change the AWS API endpoint or credential binding.
|
|
184
184
|
The application owner supplies AWS credentials through private Env or its
|
|
185
185
|
credential store. Resource names and editable `env:` references do not grant
|
|
186
|
-
AWS permissions. Separate IAM keys alone do not promise isolated service quotas. See [AWS ownership](aws-credentials.md#
|
|
186
|
+
AWS permissions. Separate IAM keys alone do not promise isolated service quotas. See [AWS ownership](aws-credentials.md#editors-and-independent-cli).
|
|
187
187
|
|
|
188
188
|
## Per-user federation still to deliver
|
|
189
189
|
|
|
@@ -220,10 +220,8 @@ both target types, invalid-save rejection, inactive-field removal and reload.
|
|
|
220
220
|
No live AWS registration, warehouse, SQL, generated app or federation flow has
|
|
221
221
|
been exercised.
|
|
222
222
|
|
|
223
|
-
##
|
|
223
|
+
## Scope and limitations
|
|
224
224
|
|
|
225
225
|
Shared project-owned AWS credentials support serverless/provisioned targets, databases/schemas/tables discovery, table description, parameterized SQL submission, status, typed result pages and cancellation.
|
|
226
226
|
|
|
227
|
-
No per-user Identity Center/OIDC federation or trusted identity propagation; no role-exchange/automatic credential renewal, default host credential chain, database password or Secrets Manager ARN mode, noncommercial partitions, custom endpoints, warehouse/IAM provisioning, batch SQL, automatic polling/retries or application job-ownership registry. SQL is not SELECT-only: database grants and application authorization enforce allowed work. The host stores request/statement ownership, handles uncertain submission and explicitly cancels remote jobs; local timeout/disconnect cannot do that. Unsafe JavaScript integer results are rejected; cast exact values to text. To extend: implement the already documented federation inputs/exchanges and tests, optional authentication modes and desired orchestration separately.
|
|
228
|
-
|
|
229
|
-
16 source and 16 installed-package tests passed on September 13 using the actual AWS SDK with controlled HTTP and private files. September 12 compact/expanded form/lifecycle evidence is retained; no new UI run.
|
|
227
|
+
No per-user Identity Center/OIDC federation or trusted identity propagation; no role-exchange/automatic credential renewal, default host credential chain, database password or Secrets Manager ARN mode, noncommercial partitions, custom endpoints, warehouse/IAM provisioning, batch SQL, automatic polling/retries or application job-ownership registry. SQL is not SELECT-only: database grants and application authorization enforce allowed work. The host stores request/statement ownership, handles uncertain submission and explicitly cancels remote jobs; local timeout/disconnect cannot do that. Unsafe JavaScript integer results are rejected; cast exact values to text. To extend: implement the already documented federation inputs/exchanges and tests, optional authentication modes and desired orchestration separately. Assistant tool attachment requires explicit host integration. Other frameworks use the same project configuration and their own native tools; JSKIT is optional.
|
package/docs/apollo-io.md
CHANGED
|
@@ -101,14 +101,6 @@ The application owner must arrange the capacity and usage limits it needs. The r
|
|
|
101
101
|
automatically retry requests.
|
|
102
102
|
[Rate limits](https://docs.apollo.io/reference/rate-limits).
|
|
103
103
|
|
|
104
|
-
## Focused evidence
|
|
105
|
-
|
|
106
|
-
Tests use simulated provider replies and actual temporary encrypted JSON
|
|
107
|
-
storage. They verify headers, POST bodies, empty accounts, page/name boundaries,
|
|
108
|
-
malformed replies, provider failures, restart, rotation, ownership and
|
|
109
|
-
disconnect. The editor case verifies secret references, setup links and reload.
|
|
110
|
-
Live API calls, provider signup and sample-app generation are excluded.
|
|
111
|
-
|
|
112
104
|
## Operations and endpoint permissions
|
|
113
105
|
|
|
114
106
|
API-key permissions are provider settings, not OAuth scopes in `integrations.json`.
|
package/docs/ashby.md
CHANGED
|
@@ -101,14 +101,6 @@ organization capacity or change licensed product access. Application owners
|
|
|
101
101
|
must arrange the capacity needed for their usage. No callback is used, so editor VM and deployed app
|
|
102
102
|
domains do not change this flow. A jobs result does not establish user login.
|
|
103
103
|
|
|
104
|
-
## Focused evidence
|
|
105
|
-
|
|
106
|
-
Simulated provider tests cover Basic headers, POST bodies, explicit paging,
|
|
107
|
-
empty results, invalid envelopes, HTTP-200 failures, input boundaries, real
|
|
108
|
-
temporary file-store restart, rotation, ownership and disconnect. Editor
|
|
109
|
-
automation verifies reference-only configuration and save/reload. Live provider
|
|
110
|
-
use, organization signup and sample-app generation are excluded.
|
|
111
|
-
|
|
112
104
|
## Recruiter workflow operations
|
|
113
105
|
|
|
114
106
|
All calls use the fixed `https://api.ashbyhq.com` origin, Basic key authentication
|
package/docs/attention.md
CHANGED
|
@@ -100,14 +100,6 @@ provider capacity arrangements for its usage. Each
|
|
|
100
100
|
customer organization supplies its own authorized key. No OAuth callback is
|
|
101
101
|
used, so VM subdomains and deployed app domains do not change this flow.
|
|
102
102
|
|
|
103
|
-
## Focused evidence
|
|
104
|
-
|
|
105
|
-
Simulated protocol tests with real temporary JSON state cover the bearer header,
|
|
106
|
-
current endpoint, title encoding, page bounds, detailed-transcript selection,
|
|
107
|
-
partial metadata, empty results, failures, ownership, restart, rotation and
|
|
108
|
-
disconnect. The editor check verifies reference-only saving and reload.
|
|
109
|
-
Live provider requests, key provisioning and sample-app generation are excluded.
|
|
110
|
-
|
|
111
103
|
## Complete app workflows
|
|
112
104
|
|
|
113
105
|
The provider's [OpenAPI contract](https://docs.attention.com/api-reference/openapi.json)
|
package/docs/aws-athena.md
CHANGED
|
@@ -67,8 +67,8 @@ and separately configure IAM, Glue/S3 resources and encryption. It cannot grant
|
|
|
67
67
|
itself account access. Neither provisioning nor credential renewal is part of
|
|
68
68
|
this fragment.
|
|
69
69
|
|
|
70
|
-
For
|
|
71
|
-
mode. See [AWS ownership and quota isolation](aws-credentials.md#
|
|
70
|
+
For hosted and installed editors there is **no OAuth callback URL** in this
|
|
71
|
+
mode. See [AWS ownership and quota isolation](aws-credentials.md#editors-and-independent-cli).
|
|
72
72
|
Separate workgroups do not isolate account service quotas. The application
|
|
73
73
|
operator supplies AWS credentials, chooses resources and controls their budget.
|
|
74
74
|
The same application-owned setup works from CLI or editor without a Vibe64
|
package/docs/aws-credentials.md
CHANGED
|
@@ -36,7 +36,7 @@ Use an IAM identity restricted to the intended resources, not an account root ke
|
|
|
36
36
|
Account enrollment, billing and administrator access are prerequisites; adding
|
|
37
37
|
an integration does not create an AWS account or confer administrator rights.
|
|
38
38
|
|
|
39
|
-
##
|
|
39
|
+
## Editors and independent CLI
|
|
40
40
|
|
|
41
41
|
There is **no OAuth registration, redirect URI or universal callback URL** for
|
|
42
42
|
these credential modes. The app's VPS and custom domain do not change the AWS
|
package/docs/aws-s3.md
CHANGED
|
@@ -87,7 +87,7 @@ An authorized AI can use CreateBucket, IAM policies and
|
|
|
87
87
|
[PutBucketCors](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketCors.html)
|
|
88
88
|
to perform these administrative steps. Provisioning is not an adapter operation.
|
|
89
89
|
For application-owned credentials, quota boundaries and the absence of a callback URL,
|
|
90
|
-
see [AWS ownership](aws-credentials.md#
|
|
90
|
+
see [AWS ownership](aws-credentials.md#editors-and-independent-cli).
|
|
91
91
|
|
|
92
92
|
## Runtime operations
|
|
93
93
|
|
package/docs/bigquery.md
CHANGED
|
@@ -137,10 +137,8 @@ limits. Query submission uses the configured billing/execution project.
|
|
|
137
137
|
Automated tests cover consent, scopes, replay, private-file restart, isolation,
|
|
138
138
|
pagination, empty pages and provider failures without live queries or projects.
|
|
139
139
|
|
|
140
|
-
##
|
|
140
|
+
## Scope and limitations
|
|
141
141
|
|
|
142
142
|
Project-owned delegated Google OAuth supports project/dataset/table discovery, table metadata, named scalar GoogleSQL parameters, query submission, job status, result pagination and cancellation in the configured execution project.
|
|
143
143
|
|
|
144
|
-
No service-account key, ADC, workload-identity federation or deployment identity issuance. No array/struct/null parameters, automatic retry/polling/pagination, dry-run operation, load/extract/copy/streaming jobs, dedicated dataset/table administration or cross-project input override. SQL may incur charges and perform IAM-permitted writes; maximumBytesBilled is optional, not an account budget. Connection checking lists projects and does not prove query/dataset permissions. The app owns SQL authorization, per-user job ownership, result rendering, billing choices and cancellation follow-up; DONE or a cancellation acknowledgement does not prove successful execution/stopping. To extend: implement deployment-owned federation and its renewal/tests, then only required job/parameter modes. No
|
|
145
|
-
|
|
146
|
-
9 source and 9 installed-package BigQuery checks passed on September 13. September 12 compact/expanded configuration, IAM guidance and lifecycle browser evidence is retained; no new UI run.
|
|
144
|
+
No service-account key, ADC, workload-identity federation or deployment identity issuance. No array/struct/null parameters, automatic retry/polling/pagination, dry-run operation, load/extract/copy/streaming jobs, dedicated dataset/table administration or cross-project input override. SQL may incur charges and perform IAM-permitted writes; maximumBytesBilled is optional, not an account budget. Connection checking lists projects and does not prove query/dataset permissions. The app owns SQL authorization, per-user job ownership, result rendering, billing choices and cancellation follow-up; DONE or a cancellation acknowledgement does not prove successful execution/stopping. To extend: implement deployment-owned federation and its renewal/tests, then only required job/parameter modes. No identity gateway is supplied. Assistant tool attachment requires explicit host integration. Other frameworks use the same project configuration and their own native tools; JSKIT is optional.
|
package/docs/calendly.md
CHANGED
|
@@ -55,13 +55,13 @@ do not share one person's token across unrelated applications.
|
|
|
55
55
|
Automated fixtures cover headers, required inputs, pagination, storage restart,
|
|
56
56
|
rotation, isolation and failure handling. No live scheduling data was accessed.
|
|
57
57
|
|
|
58
|
-
## Web OAuth setup
|
|
58
|
+
## Web OAuth setup
|
|
59
59
|
|
|
60
60
|
The captured connection experience uses OAuth scopes. Personal tokens above
|
|
61
61
|
are a separate setup choice. OAuth uses the existing connection service and
|
|
62
|
-
the project-owned registration; it needs no
|
|
62
|
+
the project-owned registration; it needs no authentication gateway.
|
|
63
63
|
|
|
64
|
-
Provider setup
|
|
64
|
+
Provider setup:
|
|
65
65
|
|
|
66
66
|
1. Open the [developer portal](https://developer.calendly.com/docs/authentication/creating-an-oauth-app)
|
|
67
67
|
and sign in or create a developer account. This is separate from the normal
|
|
@@ -84,7 +84,7 @@ Provider setup, checked against the official guide on 12 September 2026:
|
|
|
84
84
|
confused with the OAuth Client Secret.
|
|
85
85
|
6. Configure the registration with `tokenEndpointAuthMethod: client_secret_basic`
|
|
86
86
|
for a web client. Its secret belongs to the generated app's backend, never
|
|
87
|
-
the browser or
|
|
87
|
+
the browser or an editor's platform account. The shared provider metadata selects Basic authentication for web OAuth.
|
|
88
88
|
7. Register a changed custom-domain callback in the provider application before
|
|
89
89
|
reconnecting. The provider application's menu offers **Edit**, including
|
|
90
90
|
Redirect URI, followed by **Save**.
|
|
@@ -97,19 +97,9 @@ these web-application instructions. Persist each replacement refresh token
|
|
|
97
97
|
under the existing grant lock rather than replaying a consumed refresh token.
|
|
98
98
|
The profile and event-type operations retain their current fixed API origin.
|
|
99
99
|
|
|
100
|
-
Required focused proof before marking this provider complete: OAuth configuration
|
|
101
|
-
and captured scope choices, Basic authentication on code exchange and refresh,
|
|
102
|
-
PKCE/state checks, rotated-token persistence, denial/cancel/reconnect/disconnect,
|
|
103
|
-
and the existing personal-token flow. Live consent and scheduling remain outside
|
|
104
|
-
the controlled-test scope.
|
|
105
|
-
|
|
106
100
|
Sources: [OAuth app creation](https://developer.calendly.com/docs/authentication/creating-an-oauth-app),
|
|
107
101
|
[token endpoint](https://developer.calendly.com/api-docs/calendly-o-auth/o-auth/post-oauth-refresh-token).
|
|
108
102
|
|
|
109
|
-
The focused `test/calendly.test.js` fixture passes Basic code exchange, S256
|
|
110
|
-
PKCE, concurrent refresh serialization, replacement refresh persistence across
|
|
111
|
-
a new service instance, personal-token connection and local disconnect. This does not establish live Calendly consent or token issuance.
|
|
112
|
-
|
|
113
103
|
## Scheduling operations and application ownership
|
|
114
104
|
|
|
115
105
|
Both authentication methods use these same operations through `service.invoke`.
|
package/docs/chargebee.md
CHANGED
|
@@ -118,15 +118,6 @@ The application owns its credential selection and usage policy. Separate
|
|
|
118
118
|
provider capacity requires the appropriate site/account arrangement. A test
|
|
119
119
|
site is not additional production capacity.
|
|
120
120
|
|
|
121
|
-
## Focused evidence
|
|
122
|
-
|
|
123
|
-
Six tests use simulated Chargebee replies and real temporary encrypted JSON
|
|
124
|
-
files. They cover Basic authentication, file restart, rotation, ownership,
|
|
125
|
-
disconnect, unsafe site/credential rejection, site changes, cursors, deleted
|
|
126
|
-
records, page-size limits and failures. The editor check covers site validation,
|
|
127
|
-
reference-only storage and persistence after reload. Provider signup, live API
|
|
128
|
-
requests, billing changes and sample-app generation are excluded.
|
|
129
|
-
|
|
130
121
|
## Billing operations and recovery
|
|
131
122
|
|
|
132
123
|
| Operations | Result / boundary |
|
package/docs/clickhouse.md
CHANGED
|
@@ -192,7 +192,7 @@ path segments. It does not resolve DNS or impose network policy. The host must
|
|
|
192
192
|
restrict configuration editing and its backend's network access. Redirects are
|
|
193
193
|
rejected; credentials never go in the URL or browser configuration.
|
|
194
194
|
|
|
195
|
-
## Automation and
|
|
195
|
+
## Automation and hosted ownership
|
|
196
196
|
|
|
197
197
|
An AI can prepare portable JSON and wire the library. With an authorized
|
|
198
198
|
database administrator connection, it can provision users, grants, profiles and
|
package/docs/confidence-oauth.md
CHANGED
|
@@ -125,12 +125,6 @@ entitlements. Registration acceptance and commercial use need provider proof.
|
|
|
125
125
|
The editor exposes explicit automatic or manual client registration and the
|
|
126
126
|
application-owned connection lifecycle. Live provider registration and consent remain unverified.
|
|
127
127
|
|
|
128
|
-
##
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
registration, file ownership and restart, refresh, exact tool policy, malformed
|
|
132
|
-
responses, permission errors, cancellation and no request replay. Provider guide
|
|
133
|
-
JSON and responsive editor persistence are checked separately. No live provider
|
|
134
|
-
account, registration, consent, flag mutation, experiment run, database or
|
|
135
|
-
generated application is used. Metadata discovery alone does not prove live
|
|
136
|
-
registration or token acceptance.
|
|
128
|
+
## Discovery limits
|
|
129
|
+
|
|
130
|
+
Metadata discovery alone does not prove live registration or token acceptance.
|
package/docs/contentful.md
CHANGED
|
@@ -100,18 +100,10 @@ Different key names do not establish independent quota allocations.
|
|
|
100
100
|
For Laravel, use native HTTP/configuration tools and the public application
|
|
101
101
|
setup command contract; this package provides JavaScript code only.
|
|
102
102
|
|
|
103
|
-
##
|
|
104
|
-
|
|
105
|
-
The initial unpublished CMA `spaces.list` fragment has been replaced. Existing
|
|
106
|
-
experimental configurations must supply `settings.spaceId`, a Delivery token,
|
|
107
|
-
and use `entries.list`. There is no compatibility alias or automatic token
|
|
108
|
-
conversion. Environment and region default to `master` and `us` respectively.
|
|
109
|
-
|
|
110
|
-
Focused controlled tests cover delivery headers and paths, EU/environment
|
|
111
|
-
selection, invalid settings before transport, published-entry validation,
|
|
112
|
-
page limits, private file-store restart, token rotation, isolation, disconnect
|
|
113
|
-
and provider failures. No live Contentful account or generated app was used.
|
|
103
|
+
## Configuration and limitations
|
|
114
104
|
|
|
105
|
+
Configurations supply `settings.spaceId`, a Delivery token, and use
|
|
106
|
+
`entries.list`. Environment and region default to `master` and `us` respectively.
|
|
115
107
|
|
|
116
108
|
**LIMITATIONS:** Assistant tool attachment requires explicit host integration: the app can display published
|
|
117
109
|
articles and images, but saving this connection does not let the coding assistant
|
|
@@ -119,5 +111,4 @@ browse the space. This connector does not author/publish content or render a CMS
|
|
|
119
111
|
interface. For example, publish the article and hero asset in Contentful first;
|
|
120
112
|
the app then resolves their IDs and renders them with its native components.
|
|
121
113
|
Cross-space authenticated links, Sync/cursor feeds and asset transformation are
|
|
122
|
-
native extensions, not silently fetched.
|
|
123
|
-
shapes, pagination, resource reads and errors; no live content was accessed.
|
|
114
|
+
native extensions, not silently fetched.
|
package/docs/databricks.md
CHANGED
|
@@ -149,15 +149,15 @@ Tokens remain encrypted; source contains references. Disconnect removes the
|
|
|
149
149
|
local connection and attempts without deleting the principal or revoking the
|
|
150
150
|
provider application globally.
|
|
151
151
|
|
|
152
|
-
##
|
|
152
|
+
## Editors, hosting and automation
|
|
153
153
|
|
|
154
154
|
Register the real callback implemented by the runtime that owns this connection.
|
|
155
155
|
For an application integration, use the application's assigned hosting URL as
|
|
156
156
|
the initial origin and its implemented callback path. Store the exact callback
|
|
157
157
|
in its Env reference and provider registration. A domain change requires updating
|
|
158
158
|
both values if the callback URL changes; retain the application identity and its
|
|
159
|
-
persistent grants when moving hosts.
|
|
160
|
-
|
|
159
|
+
persistent grants when moving hosts. Every editor and CLI supplies its own
|
|
160
|
+
registrations through this same contract.
|
|
161
161
|
See the [callback guide](../../connectors-core/docs/oauth-callbacks.md).
|
|
162
162
|
|
|
163
163
|
Service principals have no callback. Databricks custom applications are created
|
|
@@ -178,3 +178,35 @@ privileges; this fragment does not implement provisioning endpoints.
|
|
|
178
178
|
Live accounts, consent, private networking, account-level operations, SQL/data
|
|
179
179
|
queries, jobs execution and app login are unverified or
|
|
180
180
|
unfinished. Local proof uses controlled HTTP responses and encrypted files.
|
|
181
|
+
|
|
182
|
+
## OAuth pattern composition: Databricks user consent and service accounts
|
|
183
|
+
|
|
184
|
+
Import `databricksProvider` from `@jskit-ai/connectors-catalog/server/databricks`.
|
|
185
|
+
Read this guide for the two portable configurations. A custom OAuth app
|
|
186
|
+
uses `authorization_code`, `client_secret_post`, a callback reference and
|
|
187
|
+
`all-apis offline_access`. A service principal uses `client_credentials`,
|
|
188
|
+
`client_secret_basic` and its Databricks OAuth secret reference; it has no
|
|
189
|
+
callback or user refresh token. Use `jobs` for a suitably scoped service secret.
|
|
190
|
+
Service principals cannot use `per-user` ownership.
|
|
191
|
+
|
|
192
|
+
Compose the ordinary connections service/Feature and file store. Call
|
|
193
|
+
`connectClientCredentials` or the `connectors.verifyClientCredentials` action
|
|
194
|
+
to verify a service principal. User access still uses `beginAuthorization` and
|
|
195
|
+
`completeAuthorization`. The library owns token requests, renewal, secret
|
|
196
|
+
resolution, state, grant checks and persistence; do not generate replacements
|
|
197
|
+
in the application. The app owns routes, binding values and trusted identity.
|
|
198
|
+
|
|
199
|
+
`jobs.list` reads one page with `limit`, `name`, `expand_tasks` and `page_token`.
|
|
200
|
+
`jobs.get` reads one job with a safe numeric `job_id` and optional continuation
|
|
201
|
+
token. Empty lists may omit `jobs`; nested job arrays may need further pages.
|
|
202
|
+
No job execution, SQL query, compute startup or write operation is implemented.
|
|
203
|
+
Source permission changes to a service account require reconnecting. The
|
|
204
|
+
runtime renews only its prior grant and commits renewal even if a later API
|
|
205
|
+
read fails. Never supply an arbitrary request URL or reuse a service grant as
|
|
206
|
+
an app user's connection.
|
|
207
|
+
|
|
208
|
+
Both flows pin requests to the configured per-workspace origin. The application
|
|
209
|
+
implements and registers its own user-consent callback. Its registration belongs
|
|
210
|
+
to its Databricks account; it is not automatically universal across customer
|
|
211
|
+
accounts. Follow the guide for admin provisioning and direct CLI wiring.
|
|
212
|
+
Application login remains separate.
|
|
@@ -116,7 +116,7 @@ Environment ID and backend Env token. They send the documented GraphQL requests
|
|
|
116
116
|
and implement their own result parsing/access policy. No JSKIT dependency or
|
|
117
117
|
Vibe64 service is required for those applications.
|
|
118
118
|
|
|
119
|
-
##
|
|
119
|
+
## Editors and universal URLs
|
|
120
120
|
|
|
121
121
|
This service-token variant has **no OAuth registration or callback URL**.
|
|
122
122
|
There is no universal URL to enter in dbt for it. The customer's VM or custom
|
|
@@ -139,7 +139,7 @@ provision provider accounts or warehouse capacity.
|
|
|
139
139
|
| Provision warehouse identities, dbt credentials and service tokens | Account-admin setup is required. The reviewed setup instructions do not establish a complete provisioning API; do not claim automated creation. An authorized operator can follow the portal steps above. |
|
|
140
140
|
| Choose account capacity or grant access | Requires the owner's account and warehouse decisions. No change is made by saving a form. |
|
|
141
141
|
|
|
142
|
-
## Current limits
|
|
142
|
+
## Current limits
|
|
143
143
|
|
|
144
144
|
Queries accept 1–100 metrics (`name`, optional `alias`), up to 100 dimensions
|
|
145
145
|
(`name`, optional `grain`: DAY/WEEK/MONTH/QUARTER/YEAR), and up to 20 trusted
|
|
@@ -167,9 +167,3 @@ does not build the chart or a continuous warehouse dashboard. Assistant tool att
|
|
|
167
167
|
requires explicit host integration. Personal access
|
|
168
168
|
tokens are another documented provider option; the captured service-token setup
|
|
169
169
|
is the supported initial onboarding journey.
|
|
170
|
-
|
|
171
|
-
Controlled HTTP/file tests cover configuration, host restrictions, precise IDs,
|
|
172
|
-
metadata, empty pages, ownership, restart, rotation, malformed responses,
|
|
173
|
-
permission failures, cancellation and timeout. Live account setup, actual data
|
|
174
|
-
access and generated applications are not exercised. Editor form proof is
|
|
175
|
-
recorded separately when the installed package has passed browser checks.
|
package/docs/figma.md
CHANGED
|
@@ -84,8 +84,8 @@ For an application integration, use the application's assigned hosting URL as
|
|
|
84
84
|
the initial origin and its implemented callback path. Store the exact callback
|
|
85
85
|
in its Env reference and provider registration. A domain change requires updating
|
|
86
86
|
both values if the callback URL changes; retain the application identity and its
|
|
87
|
-
persistent grants when moving hosts.
|
|
88
|
-
|
|
87
|
+
persistent grants when moving hosts. Every editor and CLI supplies its own
|
|
88
|
+
registrations through this same contract.
|
|
89
89
|
See the [callback guide](../../connectors-core/docs/oauth-callbacks.md).
|
|
90
90
|
|
|
91
91
|
The registration and grants belong to the application or explicitly authorized
|
|
@@ -116,10 +116,10 @@ fixed JSKIT design schema; fixtures demonstrate consumption rather than assertin
|
|
|
116
116
|
an immutable live tool signature. The host chooses the target framework and
|
|
117
117
|
performs code generation itself.
|
|
118
118
|
|
|
119
|
-
**LIMITATIONS:** This supplies remote MCP only. Installed
|
|
119
|
+
**LIMITATIONS:** This supplies remote MCP only. Installed and hosted editors can
|
|
120
120
|
both use the remote server with their own approved registration. Desktop MCP is
|
|
121
|
-
local to the machine running Figma Desktop and the consuming client: on
|
|
122
|
-
127.0.0.1 means the
|
|
121
|
+
local to the machine running Figma Desktop and the consuming client: on a hosted
|
|
122
|
+
editor, 127.0.0.1 means the server, not the user's laptop. Native desktop clients may configure
|
|
123
123
|
Figma Desktop independently; no tunnel/proxy is provided here. Government-only
|
|
124
124
|
desktop deployments are outside this remote connector.
|
|
125
125
|
|
|
@@ -156,7 +156,7 @@ The application's policy must authorize the audience and payload before a
|
|
|
156
156
|
`messages.send` action. A shared service credential grants no user permission
|
|
157
157
|
to send to arbitrary installations or topics. No login functionality is implied.
|
|
158
158
|
|
|
159
|
-
##
|
|
159
|
+
## Editors, hosting and custom domains
|
|
160
160
|
|
|
161
161
|
**Universal OAuth callback URL: not applicable.** Service-account authorization
|
|
162
162
|
is a server-to-server exchange, with no browser redirect to register. A VPS
|
|
@@ -167,8 +167,8 @@ installation association. Existing cookies or browser permissions do not move
|
|
|
167
167
|
between unrelated domains.
|
|
168
168
|
|
|
169
169
|
The application owner supplies the Firebase project and sender credentials.
|
|
170
|
-
|
|
171
|
-
|
|
170
|
+
Hosted and installed-editor projects use the same configuration and runtime;
|
|
171
|
+
no editor supplies a shared Firebase project or platform sender key. Two service
|
|
172
172
|
accounts or Web apps inside one project do not split its project quota.
|
|
173
173
|
[FCM quota ownership](https://firebase.google.com/docs/cloud-messaging/throttling-and-quotas)
|
|
174
174
|
|
package/docs/firecrawl.md
CHANGED
|
@@ -89,7 +89,7 @@ None of these partner operations is implemented or exercised by this fragment.
|
|
|
89
89
|
An AI can prepare the JSON/environment reference, validate it, compose the
|
|
90
90
|
library calls and check the key through the documented credit endpoint after
|
|
91
91
|
an operator supplies it. Account/team selection, billing and key issuance are
|
|
92
|
-
operator steps for own-key setup.
|
|
92
|
+
operator steps for own-key setup. A hosting platform can implement partner provisioning
|
|
93
93
|
after approval; a standard API key cannot substitute for the partner key.
|
|
94
94
|
|
|
95
95
|
The application owner supplies its Firecrawl key through private Env. Keys for
|
package/docs/fireflies.md
CHANGED
|
@@ -57,8 +57,7 @@ partial errors, HTTP failures, credential rotation, private persistence and
|
|
|
57
57
|
application isolation. They do not access real meetings.
|
|
58
58
|
|
|
59
59
|
Setup rechecked against the official authorization and quickstart guides on
|
|
60
|
-
12 September 2026.
|
|
61
|
-
parity remains unproven. No signed-in Fireflies console was inspected.
|
|
60
|
+
12 September 2026. No signed-in Fireflies console was inspected.
|
|
62
61
|
|
|
63
62
|
## Transcript content and search
|
|
64
63
|
|
|
@@ -82,14 +81,12 @@ cache, task tracking and CRM writes through their respective APIs.
|
|
|
82
81
|
**LIMITATIONS:** assistant tool attachment requires explicit host integration. Example: a
|
|
83
82
|
published app can show a sales call's action items; an assistant
|
|
84
83
|
does not gain meeting access from this configuration. Recording, transcript
|
|
85
|
-
mutation, incoming webhooks and per-user OAuth are not supplied
|
|
86
|
-
|
|
87
|
-
was not captured; current official instructions establish API-key setup.
|
|
84
|
+
mutation, incoming webhooks and per-user OAuth are not supplied.
|
|
85
|
+
Exact signed-in screen placement was not captured; current official instructions establish API-key setup.
|
|
88
86
|
|
|
89
87
|
Rechecked 13 September 2026 against [transcript detail](https://docs.fireflies.ai/graphql-api/query/transcript),
|
|
90
|
-
[search](https://docs.fireflies.ai/graphql-api/query/transcripts)
|
|
91
|
-
[authorization](https://docs.fireflies.ai/fundamentals/authorization)
|
|
92
|
-
|
|
93
|
-
The
|
|
94
|
-
required inputs for its shared connection. The host stores a private Env reference
|
|
88
|
+
[search](https://docs.fireflies.ai/graphql-api/query/transcripts) and
|
|
89
|
+
[authorization](https://docs.fireflies.ai/fundamentals/authorization).
|
|
90
|
+
The authorization guide establishes the API key as the only provider credential.
|
|
91
|
+
The host stores a private Env reference
|
|
95
92
|
instead of putting the key in the source file. No live meetings were read.
|
|
@@ -100,9 +100,10 @@ caller-selected source identity, impersonation header or Workforce Identity toke
|
|
|
100
100
|
## Application ownership, callbacks and capacity
|
|
101
101
|
|
|
102
102
|
The application owner creates the provider registration and stores its secret
|
|
103
|
-
in the application's private Env.
|
|
104
|
-
|
|
105
|
-
references; the editor does not own the
|
|
103
|
+
in the application's private Env. Every editor and CLI uses this same
|
|
104
|
+
[ownership model](../../connectors-core/docs/online-setup.md): the configuration
|
|
105
|
+
file holds the client ID and Env references; the editor does not own the
|
|
106
|
+
application's grants.
|
|
106
107
|
|
|
107
108
|
Register the exact callback implemented by the application. For a hosted project,
|
|
108
109
|
start with its assigned application URL and append the implemented callback path.
|
|
@@ -222,3 +223,32 @@ internal app can answer leave-policy questions with Google citations, but
|
|
|
222
223
|
configuring it does not import company files or grant every employee access.
|
|
223
224
|
Controlled fixtures prove request/response handling; real ACLs, licensing,
|
|
224
225
|
relevance and summary quality remain untested.
|
|
226
|
+
|
|
227
|
+
## OAuth pattern composition: Gemini Enterprise search
|
|
228
|
+
|
|
229
|
+
Use `geminiEnterpriseProvider` from
|
|
230
|
+
`@jskit-ai/connectors-catalog/server/gemini-enterprise` with the existing core
|
|
231
|
+
connection service. this guide contains the portable file and
|
|
232
|
+
provider setup worksheet. Store `projectId`, `location` (`global`, `us`, `eu`)
|
|
233
|
+
and `engineId` as settings, with a confidential Google OAuth registration and
|
|
234
|
+
the `https://www.googleapis.com/auth/cloud-platform` scope. The settings choose
|
|
235
|
+
the API origin and the engine under `default_collection`; callers cannot change
|
|
236
|
+
the target or supply a source identity in an operation request.
|
|
237
|
+
|
|
238
|
+
`engine.get` checks metadata access. `search` accepts `query`, `pageSize` (1–25,
|
|
239
|
+
default 10) and optional `pageToken`. Reuse the same query/page size while
|
|
240
|
+
paginating. The result is Google's JSON envelope, not a generated answer. Treat
|
|
241
|
+
document snippets and `redirectUri` as untrusted data; do not follow returned URLs
|
|
242
|
+
automatically. Search permission and source access are separate from engine
|
|
243
|
+
metadata permission. Shared and assistant modes act as one connected Google
|
|
244
|
+
account, so authorize every caller before exposing that account's search results.
|
|
245
|
+
This fragment implements no per-user Google identity, Workforce Identity, widget,
|
|
246
|
+
resource ingestion, app login or chat sessions.
|
|
247
|
+
|
|
248
|
+
The application implements and registers its own callback. A callback domain
|
|
249
|
+
change requires updating its provider registration and environment binding.
|
|
250
|
+
Independent Google Cloud registration projects can separate some quotas, but
|
|
251
|
+
engine billing and limits also depend on the project hosting the engine. Don't
|
|
252
|
+
claim two OAuth client IDs isolate all paid/free consumption. An authorized AI
|
|
253
|
+
can help prepare resource/IAM configuration; Google Auth Platform client setup,
|
|
254
|
+
verification, consent and licensing remain explicit operator/provider tasks.
|
package/docs/gong.md
CHANGED
|
@@ -143,15 +143,6 @@ This implemented key flow has no callback registration. A separate OAuth
|
|
|
143
143
|
implementation must use the application's actual registered callback and own
|
|
144
144
|
its grants. It is not implemented by this key adapter.
|
|
145
145
|
|
|
146
|
-
## Focused evidence
|
|
147
|
-
|
|
148
|
-
Seven tests use simulated Gong responses and real temporary encrypted JSON state.
|
|
149
|
-
They cover default/customer origins, Basic credentials, file restart, rotation,
|
|
150
|
-
ownership, disconnect, host/key changes, unsafe URL rejection, cursor encoding,
|
|
151
|
-
avatar selection and failures. The public editor check verifies required keys,
|
|
152
|
-
secret references, company URL validation, reload and default restoration.
|
|
153
|
-
No live Gong access, account creation or example application execution is used.
|
|
154
|
-
|
|
155
146
|
## Call analysis and linked deal context
|
|
156
147
|
|
|
157
148
|
`calls.extensive` returns metadata, participants, available call summaries/topics,
|