@jskit-ai/connectors-catalog 0.1.67 → 0.2.0

package/src/shared/google-ads.js

@@ -5,15 +5,15 @@ const common = {
     validator: (value) => /^[0-9]{10}$/u.test(value) || "Enter the manager's 10-digit customer ID without hyphens." }
 };
 const googleAdsDefinition = Object.freeze({
-  id: "google-ads", name: "Google Ads", description: "Discover advertising accounts, prepare reviewed Search campaigns and read Google Ads reports.",
+  id: "google-ads", name: "Google Ads", description: "jskit.connectors.googleAds.description",
   accountModes: ["shared", "per-user", "assistant"], authenticationMethods: ["oauth2"],
   settingsSchema: createSchema(common),
   settingsFields: [
-    { name: "loginCustomerId", label: "Manager customer ID (optional)", placeholder: "1234567890",
-      hint: "Use the manager through which this app accesses client accounts, without hyphens. Direct account access can leave this blank." }
+    { name: "loginCustomerId", label: "jskit.connectors.googleAds.fields.loginCustomerId.label", placeholder: "1234567890",
+      hint: "jskit.connectors.googleAds.fields.loginCustomerId.hint" }
   ],
-  scopes: [{ value: "https://www.googleapis.com/auth/adwords", label: "Access Google Ads accounts", recommended: true }],
-  permissionsHint: "This Google permission can authorize campaign changes. Search management uses separate reviewed operations; your application must authorize each account and spending decision. This is not application login.",
+  scopes: [{ value: "https://www.googleapis.com/auth/adwords", label: "jskit.connectors.googleAds.scopes.httpsWwwGoogleapisComAuthAdwords.label", recommended: true }],
+  permissionsHint: "jskit.connectors.googleAds.permissionsHint",
   setup: { url: "https://developers.google.com/google-ads/api/docs/get-started/make-first-call", steps: [
     "Select your Google Cloud project, open APIs & Services > Library and enable Google Ads API. Open its Overview page and review API access level. Test access only permits test accounts; use Upgrade access level to apply for production access.",
     "In Google Auth Platform, configure Branding and Audience, adding test users while testing. In Data Access add https://www.googleapis.com/auth/adwords. Complete the applicable consent publishing and verification requirements.",

package/src/shared/google-maps-platform.js

@@ -2,15 +2,15 @@ import { createSchema } from "json-rest-schema";
 import { secretReference } from "@jskit-ai/connectors-core/shared/configuration";
 
 const googleMapsPlatformDefinition = Object.freeze({
-  id: "google-maps-platform", name: "Google Maps Platform", description: "Geocode addresses, find places, compute routes and configure browser maps.",
+  id: "google-maps-platform", name: "Google Maps Platform", description: "jskit.connectors.googleMapsPlatform.description",
   accountModes: ["shared", "assistant"], authenticationMethods: ["api-key"], scopes: [],
-  apiKeyReferenceLabel: "Server API key reference",
-  verificationFields: [{ name: "address", required: true, label: "Verification address",
-    hint: "Enter an address or plus code. Connecting performs one geocoding request and can incur provider usage charges." }],
-  apiKeyReferenceHint: "Reference a server key authorized for Geocoding API. Verification performs one geocoding request using an address you supply and can incur provider usage charges.",
+  apiKeyReferenceLabel: "jskit.connectors.googleMapsPlatform.apiKeyReferenceLabel",
+  verificationFields: [{ name: "address", required: true, label: "jskit.connectors.googleMapsPlatform.verificationFields.address.label",
+    hint: "jskit.connectors.googleMapsPlatform.verificationFields.address.hint" }],
+  apiKeyReferenceHint: "jskit.connectors.googleMapsPlatform.apiKeyReferenceHint",
   settingsSchema: createSchema({ browserKeyRef: { ...secretReference, required: false }, mapId: { type: "string", maxLength: 100, validator: value => /^[A-Za-z0-9_-]+$/.test(value) || "Use the map ID from Google Cloud." } }),
-  settingsFields: [{ name: "mapId", label: "Map ID (optional)", hint: "Public JavaScript map ID for advanced markers. Create it in Google Maps Platform > Map management. DEMO_MAP_ID is only for development." }, { name: "browserKeyRef", label: "Browser API key reference (optional)", placeholder: "env:GOOGLE_MAPS_BROWSER_KEY",
-    hint: "A separate key for browser maps. Restrict it to the actual application websites and APIs. Backend verification does not verify this key." }],
+  settingsFields: [{ name: "mapId", label: "jskit.connectors.googleMapsPlatform.fields.mapId.label", hint: "jskit.connectors.googleMapsPlatform.fields.mapId.hint" }, { name: "browserKeyRef", label: "jskit.connectors.googleMapsPlatform.fields.browserKeyRef.label", placeholder: "env:GOOGLE_MAPS_BROWSER_KEY",
+    hint: "jskit.connectors.googleMapsPlatform.fields.browserKeyRef.hint" }],
   setup: {
     url: "https://developers.google.com/maps/documentation/geocoding/guides-v3/get-api-key",
     steps: [

package/src/shared/google.js

@@ -23,63 +23,63 @@ function definition(id, name, api, description, recommended, permissions, verifi
   });
 }
 
-const gmailDefinition = definition("gmail", "Gmail", "Gmail API", "Read and search mail, manage drafts and labels, and explicitly send messages.", ["gmail.readonly", "gmail.send", "gmail.compose", "gmail.modify"], [
-  ["gmail.readonly", "Read messages", true], ["gmail.send", "Send messages"], ["gmail.compose", "Manage drafts and send messages"],
-  ["gmail.modify", "Read and modify messages"], ["gmail.labels", "Manage labels"], ["gmail.metadata", "Read message headers and labels"],
-  ["gmail.insert", "Insert messages"], ["gmail.settings.basic", "Manage basic mail settings"], ["gmail.settings.sharing", "Manage sharing settings"],
-  ["https://mail.google.com/", "Full mailbox access including permanent deletion"],
-  ["gmail.addons.current.message.readonly", "Read the current add-on message"], ["gmail.addons.current.message.action", "Act on the current add-on message"],
-  ["gmail.addons.current.message.metadata", "Read the current add-on message headers"], ["gmail.addons.current.action.compose", "Compose from an add-on"]
+const gmailDefinition = definition("gmail", "Gmail", "Gmail API", "jskit.connectors.gmail.description", ["gmail.readonly", "gmail.send", "gmail.compose", "gmail.modify"], [
+  ["gmail.readonly", "jskit.connectors.gmail.scopes.gmailReadonly.label", true], ["gmail.send", "jskit.connectors.gmail.scopes.gmailSend.label"], ["gmail.compose", "jskit.connectors.gmail.scopes.gmailCompose.label"],
+  ["gmail.modify", "jskit.connectors.gmail.scopes.gmailModify.label"], ["gmail.labels", "jskit.connectors.gmail.scopes.gmailLabels.label"], ["gmail.metadata", "jskit.connectors.gmail.scopes.gmailMetadata.label"],
+  ["gmail.insert", "jskit.connectors.gmail.scopes.gmailInsert.label"], ["gmail.settings.basic", "jskit.connectors.gmail.scopes.gmailSettingsBasic.label"], ["gmail.settings.sharing", "jskit.connectors.gmail.scopes.gmailSettingsSharing.label"],
+  ["https://mail.google.com/", "jskit.connectors.gmail.scopes.httpsMailGoogleCom.label"],
+  ["gmail.addons.current.message.readonly", "jskit.connectors.gmail.scopes.gmailAddonsCurrentMessageReadonly.label"], ["gmail.addons.current.message.action", "jskit.connectors.gmail.scopes.gmailAddonsCurrentMessageAction.label"],
+  ["gmail.addons.current.message.metadata", "jskit.connectors.gmail.scopes.gmailAddonsCurrentMessageMetadata.label"], ["gmail.addons.current.action.compose", "jskit.connectors.gmail.scopes.gmailAddonsCurrentActionCompose.label"]
 ], [], [
   "For inbox reading, retain Read messages (gmail.readonly) and deselect optional sending or editing permissions your application does not use. Gmail read access is restricted: check Google's restricted-scope review and server-data security assessment requirements before public release.",
   "Read messages gives full bodies, search and attachments. Send messages permits sending; Manage drafts and send messages permits drafts; Read and modify messages permits marking read, archiving and moving mail to trash. Adding permission requires reconnecting. Connect only reads the mailbox profile and never sends or edits mail.",
   "The app builds MIME messages with its framework, renders mail safely and authorizes each mailbox user. A send receipt is not proof of delivery. No automatic retry occurs after an uncertain send; check Sent before retrying. No background sync or permanent-delete operation is supplied.",
   "Leave Manage sharing settings unselected: its operations require a Workspace service account with domain-wide delegation, which this Web application connection does not configure. Add-on permissions apply only to an actual Gmail add-on; they do not replace mailbox permissions."
 ]);
-const googleDriveDefinition = definition("google-drive", "Google Drive", "Google Drive API", "Find files, upload and download content, and manage basic file metadata.", ["drive.file", "drive.appdata", "drive.appfolder", "drive.readonly"], [
-  ["drive.metadata.readonly", "Read file metadata"], ["drive.file", "Manage files selected for this application", true], ["drive.readonly", "Read and download files"],
-  ["drive", "Manage all Drive files"], ["drive.metadata", "Manage file metadata"], ["drive.appdata", "Manage application data"],
-  ["drive.appfolder", "Manage this application’s Drive folder data"],
-  ["drive.apps.readonly", "Read installed Drive apps"], ["drive.meet.readonly", "Read Meet-created files"],
-  ["drive.photos.readonly", "Read photos"], ["drive.scripts", "Manage Apps Script files"],
-  ["drive.activity", "Read and add file activity"], ["drive.activity.readonly", "Read file activity"]
+const googleDriveDefinition = definition("google-drive", "Google Drive", "Google Drive API", "jskit.connectors.googleDrive.description", ["drive.file", "drive.appdata", "drive.appfolder", "drive.readonly"], [
+  ["drive.metadata.readonly", "jskit.connectors.googleDrive.scopes.driveMetadataReadonly.label"], ["drive.file", "jskit.connectors.googleDrive.scopes.driveFile.label", true], ["drive.readonly", "jskit.connectors.googleDrive.scopes.driveReadonly.label"],
+  ["drive", "jskit.connectors.googleDrive.scopes.drive.label"], ["drive.metadata", "jskit.connectors.googleDrive.scopes.driveMetadata.label"], ["drive.appdata", "jskit.connectors.googleDrive.scopes.driveAppdata.label"],
+  ["drive.appfolder", "jskit.connectors.googleDrive.scopes.driveAppfolder.label"],
+  ["drive.apps.readonly", "jskit.connectors.googleDrive.scopes.driveAppsReadonly.label"], ["drive.meet.readonly", "jskit.connectors.googleDrive.scopes.driveMeetReadonly.label"],
+  ["drive.photos.readonly", "jskit.connectors.googleDrive.scopes.drivePhotosReadonly.label"], ["drive.scripts", "jskit.connectors.googleDrive.scopes.driveScripts.label"],
+  ["drive.activity", "jskit.connectors.googleDrive.scopes.driveActivity.label"], ["drive.activity.readonly", "jskit.connectors.googleDrive.scopes.driveActivityReadonly.label"]
 ], [], [
   "Select only the file access your application needs. With drive.file, users must select or open files through your application's file-picker flow, or the application must create them. Pasting an existing file ID alone does not grant access. App-data permissions do not grant access to ordinary Drive files.",
   "The app can upload files up to 5 MB and download/export up to 8 MiB with this adapter. Google Docs/Sheets/Slides require export to a supported MIME type; ordinary stored files use download. Larger or resumable transfers need the framework's native client.",
   "Use file capabilities and sharing access before offering writes. Uploading with an existing file ID replaces its content and name; moving a file to trash is an explicit metadata update. The app owns file selection, safe rendering and ambiguous-transfer reconciliation. No sync service or embedded Google Picker is installed.",
   "Broad Drive read or management permissions are restricted scopes. Review Google's verification and server-data security assessment requirements before public release. An empty file list with drive.file can mean no files have yet been shared with this application."
 ]);
-const drivePermissions = [["drive.file", "Access files selected for this application"], ["drive.readonly", "Read Drive files"], ["drive", "Manage Drive files"]];
-const googleSheetsDefinition = definition("google-sheets", "Google Sheets", "Google Sheets API", "Create spreadsheets, read and write ranges, and apply native batch updates.", "drive.file", [
-  ["spreadsheets.readonly", "Read spreadsheets"], ["spreadsheets", "Manage spreadsheets"],
-  ["drive.metadata.readonly", "Read Drive file metadata (does not grant spreadsheet content access)"], ...drivePermissions
-], [{ name: "spreadsheetId", required: false, label: "Spreadsheet ID (optional)", hint: "Leave blank for create-first access with drive.file and Drive API enabled. Otherwise copy the ID between /spreadsheets/d/ and /edit, not the gid tab number; the account and app must have access." }], [
+const drivePermissions = [["drive.file", "jskit.connectors.google.scopes.driveFile.label"], ["drive.readonly", "jskit.connectors.google.scopes.driveReadonly.label"], ["drive", "jskit.connectors.google.scopes.drive.label"]];
+const googleSheetsDefinition = definition("google-sheets", "Google Sheets", "Google Sheets API", "jskit.connectors.googleSheets.description", "drive.file", [
+  ["spreadsheets.readonly", "jskit.connectors.googleSheets.scopes.spreadsheetsReadonly.label"], ["spreadsheets", "jskit.connectors.googleSheets.scopes.spreadsheets.label"],
+  ["drive.metadata.readonly", "jskit.connectors.googleSheets.scopes.driveMetadataReadonly.label"], ...drivePermissions
+], [{ name: "spreadsheetId", required: false, label: "jskit.connectors.googleSheets.verificationFields.spreadsheetId.label", hint: "jskit.connectors.googleSheets.verificationFields.spreadsheetId.hint" }], [
   "For create-first access, retain Access files selected for this application (drive.file) and also enable Google Drive API in APIs & Services > Library. Leave Spreadsheet ID blank: verification reads accessible Drive metadata and accepts an empty list. It does not create a spreadsheet or prove Sheets API is enabled.",
   "With drive.file, the app can create and edit its own spreadsheets. An existing file needs Google Picker or an app-open grant; pasting an ID alone does not grant access. For spreadsheets.readonly-only or spreadsheets-only access, supply an accessible Spreadsheet ID. Adding write permissions requires reconnecting.",
   "Value writes default to RAW so untrusted strings are not interpreted as formulas. Choose USER_ENTERED explicitly for formulas and locale-dependent parsing. Ranges use A1 notation; quote sheet titles with spaces. Appending finds the next row in the table, not necessarily the requested start cell; uncertain writes are never automatically retried.",
   "The app can create spreadsheets, update or append rows, clear values, and send bounded native batch requests for sheets and formatting. Clear preserves formatting. The app owns conflict handling, file selection and its data UI; this form installs neither a spreadsheet editor nor editor-assistant tools."
 ]);
-const googleDocsDefinition = definition("google-docs", "Google Docs", "Google Docs API", "Create documents, read tabs and edit content with native batch requests.", "drive.file", [
-  ["documents.readonly", "Read documents"], ["documents", "Manage documents"], ...drivePermissions
-], [{ name: "documentId", required: false, label: "Document ID (optional)", hint: "Leave blank for create-first access with drive.file and Drive API enabled. To verify an existing document, copy its ID between /document/d/ and /edit; the account and this app must have access." }], [
+const googleDocsDefinition = definition("google-docs", "Google Docs", "Google Docs API", "jskit.connectors.googleDocs.description", "drive.file", [
+  ["documents.readonly", "jskit.connectors.googleDocs.scopes.documentsReadonly.label"], ["documents", "jskit.connectors.googleDocs.scopes.documents.label"], ...drivePermissions
+], [{ name: "documentId", required: false, label: "jskit.connectors.googleDocs.verificationFields.documentId.label", hint: "jskit.connectors.googleDocs.verificationFields.documentId.hint" }], [
   "For create-first access, retain Access files selected for this application (drive.file) and also enable Google Drive API in APIs & Services > Library. Leave Document ID blank: connection checks accessible Drive metadata and accepts an empty list; it does not create a document or prove Docs API is enabled.",
   "With drive.file the app can create and edit its own documents. For existing files, use Google Picker or an app-open flow to grant this application access; pasting an ID alone does not grant access. Picker wiring belongs to the app.",
   "For documents.readonly-only or documents-only access, supply an accessible Document ID for verification. Manage documents enables writing documents accessible to the account; adding permissions requires reconnecting. Broad Drive permissions can require restricted-scope review.",
   "Create a blank document, then insert content with documents.batchUpdate. The app owns tab IDs, UTF-16 text indices, formatting requests and revision conflict handling. No editor-assistant attachment or visual document editor is installed by this form."
 ]);
-const googleSlidesDefinition = definition("google-slides", "Google Slides", "Google Slides API", "Create and edit presentations, read pages and obtain preview thumbnails.", "drive.file", [
-  ["presentations.readonly", "Read presentations"], ["presentations", "Manage presentations"],
-  ["spreadsheets.readonly", "Read linked spreadsheets"], ["spreadsheets", "Manage linked spreadsheets"], ...drivePermissions
-], [{ name: "presentationId", required: false, label: "Presentation ID (optional)", hint: "Leave blank for create-first access with drive.file and Drive API enabled. Otherwise copy the ID between /presentation/d/ and /edit; this is not a slide object ID. The account and app must have access." }], [
+const googleSlidesDefinition = definition("google-slides", "Google Slides", "Google Slides API", "jskit.connectors.googleSlides.description", "drive.file", [
+  ["presentations.readonly", "jskit.connectors.googleSlides.scopes.presentationsReadonly.label"], ["presentations", "jskit.connectors.googleSlides.scopes.presentations.label"],
+  ["spreadsheets.readonly", "jskit.connectors.googleSlides.scopes.spreadsheetsReadonly.label"], ["spreadsheets", "jskit.connectors.googleSlides.scopes.spreadsheets.label"], ...drivePermissions
+], [{ name: "presentationId", required: false, label: "jskit.connectors.googleSlides.verificationFields.presentationId.label", hint: "jskit.connectors.googleSlides.verificationFields.presentationId.hint" }], [
   "For create-first access, retain Access files selected for this application (drive.file) and enable Google Drive API as well as Google Slides API in APIs & Services > Library. Leave Presentation ID blank: verification reads Drive metadata and accepts an empty list; it neither creates a deck nor proves Slides API is enabled.",
   "The app can create and edit its own decks with drive.file. Existing decks need an app-open or Google Picker grant; a pasted ID alone is insufficient. For presentations.readonly-only or presentations-only access, supply an accessible Presentation ID. Additional permissions require reconnecting; spreadsheet permissions alone do not grant deck access.",
   "Create a blank presentation, then use native batch requests to add slides, text, images or formatting. The app owns object IDs, positions, linked-chart access and revision conflict handling. Images must be reachable by Google; thumbnails return temporary URLs that should not be logged or stored as permanent public assets.",
   "No slide designer, template catalogue, embedded Picker or editor-assistant attachment is installed. Copying, sharing, exporting or deleting the whole deck uses the separate Drive API. An uncertain create or edit is not automatically retried."
 ]);
-const googleSearchConsoleDefinition = definition("google-search-console", "Google Search Console", "Google Search Console API", "Query search performance, inspect indexed URLs and manage sitemaps.", "webmasters.readonly", [
-  ["webmasters.readonly", "Read Search Console properties"], ["webmasters", "Manage Search Console properties"],
-  ["siteverification", "Manage website ownership through Site Verification"],
-  ["siteverification.verify_only", "Verify new website ownership through Site Verification"]
+const googleSearchConsoleDefinition = definition("google-search-console", "Google Search Console", "Google Search Console API", "jskit.connectors.googleSearchConsole.description", "webmasters.readonly", [
+  ["webmasters.readonly", "jskit.connectors.googleSearchConsole.scopes.webmastersReadonly.label"], ["webmasters", "jskit.connectors.googleSearchConsole.scopes.webmasters.label"],
+  ["siteverification", "jskit.connectors.googleSearchConsole.scopes.siteverification.label"],
+  ["siteverification.verify_only", "jskit.connectors.googleSearchConsole.scopes.siteverificationVerifyOnly.label"]
 ], [], [
   "The connecting Google account needs access to the intended Search Console property. A property owner can open that property, choose Settings > Users and permissions > Add user, enter the account email, choose the appropriate role and save.",
   "To add a property, open Search Console > property selector > Add property. Domain properties require your DNS provider's TXT record; URL-prefix properties offer verification methods such as an HTML file or tag. Follow Google's displayed instructions and Verify, or have an existing owner add this account. An OAuth grant does not verify domain ownership.",
@@ -88,17 +88,17 @@ const googleSearchConsoleDefinition = definition("google-search-console", "Googl
   "Keep Read Search Console properties for the initial check, which lists accessible properties. Site Verification permissions alone do not authorize that check or create property access. An empty result can mean this Google account has no properties."
 ]);
 const googleAnalyticsDefinition = Object.freeze({
-  id: "google-analytics", name: "Google Analytics", description: "Configure website tracking with your public GA4 Measurement ID.",
+  id: "google-analytics", name: "Google Analytics", description: "jskit.connectors.googleAnalytics.description",
   configurationOnly: true,
   accountModes: ["shared"], authenticationMethods: ["none"], scopes: [],
-  authenticationLabels: { none: "Public configuration · no credentials" },
-  authenticationHint: "Your application loads the Google tag. This does not grant access to Analytics reports.",
+  authenticationLabels: { none: "jskit.connectors.googleAnalytics.authenticationLabels.none" },
+  authenticationHint: "jskit.connectors.googleAnalytics.authenticationHint",
   settingsSchema: createSchema({ measurementId: {
     type: "string", required: true, minLength: 3, maxLength: 64,
     validator: (value) => /^G-[A-Z0-9]+$/u.test(value) || "Enter the GA4 web stream Measurement ID beginning G-."
   } }),
-  settingsFields: [{ name: "measurementId", label: "Measurement ID", required: true,
-    hint: "Public: this value will be visible in your deployed application. Copy it from your GA4 web stream." }],
+  settingsFields: [{ name: "measurementId", label: "jskit.connectors.googleAnalytics.fields.measurementId.label", required: true,
+    hint: "jskit.connectors.googleAnalytics.fields.measurementId.hint" }],
   setup: {
     url: "https://support.google.com/analytics/answer/9304153",
     steps: [
@@ -113,9 +113,9 @@ const googleAnalyticsDefinition = Object.freeze({
     ]
   }
 });
-const bigqueryDefinition = Object.freeze({ ...definition("bigquery", "BigQuery", "BigQuery API", "Configure the query project, run queries and retrieve results.", "bigquery", [
-  ["bigquery.readonly", "Read BigQuery data and metadata"], ["bigquery", "Manage BigQuery data"],
-  ["cloud-platform.read-only", "Read Google Cloud resources"], ["cloud-platform", "Manage Google Cloud resources"]
+const bigqueryDefinition = Object.freeze({ ...definition("bigquery", "BigQuery", "BigQuery API", "jskit.connectors.bigquery.description", "bigquery", [
+  ["bigquery.readonly", "jskit.connectors.bigquery.scopes.bigqueryReadonly.label"], ["bigquery", "jskit.connectors.bigquery.scopes.bigquery.label"],
+  ["cloud-platform.read-only", "jskit.connectors.bigquery.scopes.cloudPlatformReadOnly.label"], ["cloud-platform", "jskit.connectors.bigquery.scopes.cloudPlatform.label"]
 ], [], [
   "In the project that will run queries, open IAM & Admin > IAM > Grant access. Add the connecting Google account and grant BigQuery Job User when it must create query jobs. OAuth consent alone does not grant project or dataset access.",
   "In BigQuery Studio, select the intended dataset in Explorer, choose Sharing > Permissions > Add principal, and grant only the needed dataset role, such as BigQuery Data Viewer for reading data and metadata. A dataset administrator must make this grant. Repeat for any source dataset the authorized queries use.",
@@ -126,8 +126,8 @@ const bigqueryDefinition = Object.freeze({ ...definition("bigquery", "BigQuery",
     type: "string", required: true, minLength: 6, maxLength: 30,
     validator: (value) => /^[a-z][a-z0-9-]{4,28}[a-z0-9]$/u.test(value) || "Enter the Google Cloud project ID, not its number or URL."
   } }),
-  settingsFields: [{ name: "projectId", label: "Google Cloud project ID", required: true,
-    hint: "The project that runs and is billed for queries. It can differ from the project containing your datasets. The initial connection check only lists accessible projects." }]
+  settingsFields: [{ name: "projectId", label: "jskit.connectors.bigquery.fields.projectId.label", required: true,
+    hint: "jskit.connectors.bigquery.fields.projectId.hint" }]
 });
 const googleDefinitions = Object.freeze([gmailDefinition, googleDriveDefinition, googleSheetsDefinition, googleDocsDefinition, googleSlidesDefinition, googleSearchConsoleDefinition, googleAnalyticsDefinition, bigqueryDefinition]);
 export { gmailDefinition, googleDriveDefinition, googleSheetsDefinition, googleDocsDefinition, googleSlidesDefinition, googleSearchConsoleDefinition, googleAnalyticsDefinition, bigqueryDefinition, googleDefinitions };

package/src/shared/granola.js

@@ -1,10 +1,10 @@
 const granolaDefinition = Object.freeze({
-  id: "granola", name: "Granola", description: "Read meeting notes with an API key or connect the assistant owner through Granola MCP OAuth.",
+  id: "granola", name: "Granola", description: "jskit.connectors.granola.description",
   accountModes: ["shared", "assistant"], authenticationMethods: ["api-key", "oauth2"], scopes: [
-    { value: "openid", label: "Identify the connected Granola account", recommended: true, authenticationMethods: ["oauth2"] },
-    { value: "profile", label: "Read account profile", recommended: true, authenticationMethods: ["oauth2"] },
-    { value: "email", label: "Read account email", recommended: true, authenticationMethods: ["oauth2"] },
-    { value: "offline_access", label: "Refresh access without repeating sign-in", recommended: true, authenticationMethods: ["oauth2"] }
+    { value: "openid", label: "jskit.connectors.granola.scopes.openid.label", recommended: true, authenticationMethods: ["oauth2"] },
+    { value: "profile", label: "jskit.connectors.granola.scopes.profile.label", recommended: true, authenticationMethods: ["oauth2"] },
+    { value: "email", label: "jskit.connectors.granola.scopes.email.label", recommended: true, authenticationMethods: ["oauth2"] },
+    { value: "offline_access", label: "jskit.connectors.granola.scopes.offlineAccess.label", recommended: true, authenticationMethods: ["oauth2"] }
   ],
   setup: { urlByAuthentication: { oauth2: "https://docs.granola.ai/help-center/sharing/integrations/mcp" }, clientRegistrationEndpoint: "https://mcp-auth.granola.ai/oauth2/register", url: "https://docs.granola.ai/help-center/sharing/integrations/granola-api", steps: [
 "API key: In the Granola desktop app, open Settings, Connectors, API keys, then Create new key. Choose the note access scopes and Generate API Key.",

package/src/shared/hex.js

@@ -3,17 +3,17 @@ import { createSchema } from "json-rest-schema";
 const hexHosts = Object.freeze({ standard: "app.hex.tech", eu: "eu.hex.tech", hipaa: "hc.hex.tech" });
 const hexEndpointField = { type: "string", enum: Object.keys(hexHosts), defaultTo: "standard" };
 const hexDefinition = Object.freeze({
-  id: "hex", name: "Hex", description: "Search projects and use Hex Threads through the assistant owner's MCP connection.",
+  id: "hex", name: "Hex", description: "jskit.connectors.hex.description",
   accountModes: ["assistant"], authenticationMethods: ["oauth2"],
   scopes: [
-    { value: "openid", label: "Identify the connected Hex account", recommended: true },
-    { value: "profile", label: "Read account profile", recommended: true },
-    { value: "email", label: "Read account email", recommended: true },
-    { value: "offline_access", label: "Refresh access without repeating sign-in", recommended: true }
+    { value: "openid", label: "jskit.connectors.hex.scopes.openid.label", recommended: true },
+    { value: "profile", label: "jskit.connectors.hex.scopes.profile.label", recommended: true },
+    { value: "email", label: "jskit.connectors.hex.scopes.email.label", recommended: true },
+    { value: "offline_access", label: "jskit.connectors.hex.scopes.offlineAccess.label", recommended: true }
   ],
   settingsSchema: createSchema({ endpoint: hexEndpointField }),
-  settingsFields: [{ name: "endpoint", label: "Hex workspace endpoint", hint: "Use the endpoint where your Hex workspace lives; register the OAuth client at that endpoint.",
-    items: [{ value: "standard", title: "Standard (app.hex.tech)" }, { value: "eu", title: "Europe (eu.hex.tech)" }, { value: "hipaa", title: "HIPAA (hc.hex.tech)" }] }],
+  settingsFields: [{ name: "endpoint", label: "jskit.connectors.hex.fields.endpoint.label", hint: "jskit.connectors.hex.fields.endpoint.hint",
+    items: [{ value: "standard", title: "jskit.connectors.hex.fields.endpoint.items.standard.title" }, { value: "eu", title: "jskit.connectors.hex.fields.endpoint.items.eu.title" }, { value: "hipaa", title: "jskit.connectors.hex.fields.endpoint.items.hipaa.title" }] }],
   setup: { clientRegistrationEndpoint: (settings) => `https://auth.${hexHosts[settings.endpoint || "standard"]}/oauth2/register`, url: "https://learn.hex.tech/docs/api-integrations/mcp-server", steps: [
     "Confirm your Hex workspace has MCP access and your role is Explorer or higher. Hex currently requires a Team or Enterprise plan.",
     "Choose Standard, Europe or HIPAA in Hex workspace endpoint to match where you sign into Hex. Confirm the Suggested callback URL is the exact route your assistant host will serve. Keep the identity, profile, email and refresh permissions selected.",

package/src/shared/inngest.js

@@ -2,21 +2,21 @@ import { createSchema } from "json-rest-schema";
 import { secretReference } from "@jskit-ai/connectors-core/shared/configuration";
 
 const inngestDefinition = Object.freeze({
-  id: "inngest", name: "Inngest", description: "Send events to background workflows and inspect registered apps.",
+  id: "inngest", name: "Inngest", description: "jskit.connectors.inngest.description",
   accountModes: ["shared", "assistant"], authenticationMethods: ["api-key"], scopes: [],
-  apiKeyReferenceLabel: "Signing Key reference",
-  apiKeyReferenceHint: "Reference the Signing Key for the intended Inngest environment. Verification reads app metadata; it does not verify the Event Key or run a workflow.",
+  apiKeyReferenceLabel: "jskit.connectors.inngest.apiKeyReferenceLabel",
+  apiKeyReferenceHint: "jskit.connectors.inngest.apiKeyReferenceHint",
   settingsSchema: createSchema({
     eventKeyRef: { ...secretReference, required: true },
     branchEnvironment: { type: "string", minLength: 1, maxLength: 255,
       validator: (value) => /^[\x21-\x7e]+$/u.test(value) || "Use an ASCII branch environment without spaces or control characters." }
   }),
   settingsFields: [
-    { name: "eventKeyRef", label: "Event Key reference", placeholder: "env:INNGEST_EVENT_KEY",
-      environmentCredential: { label: "Inngest Event Key", public: false },
-      hint: "The Event Key sends events. Keep it separate from the Signing Key, and use keys from the same intended environment." },
-    { name: "branchEnvironment", label: "Branch environment (optional)", placeholder: "feature/my-branch",
-      hint: "Routes event delivery to this branch. App metadata reads follow the Signing Key's environment." }
+    { name: "eventKeyRef", label: "jskit.connectors.inngest.fields.eventKeyRef.label", placeholder: "env:INNGEST_EVENT_KEY",
+      environmentCredential: { label: "jskit.connectors.inngest.fields.eventKeyRef.environmentCredential.label", public: false },
+      hint: "jskit.connectors.inngest.fields.eventKeyRef.hint" },
+    { name: "branchEnvironment", label: "jskit.connectors.inngest.fields.branchEnvironment.label", placeholder: "feature/my-branch",
+      hint: "jskit.connectors.inngest.fields.branchEnvironment.hint" }
   ],
   setup: {
     url: "https://www.inngest.com/docs/events/creating-an-event-key",

package/src/shared/lightspeed.js

@@ -1,65 +1,65 @@
 import { createSchema } from "json-rest-schema";
 
 const lightspeedDefinition = Object.freeze({
-  id: "lightspeed", name: "Lightspeed", description: "Read products, inventory, sales, customers and outlets from a Lightspeed Retail X-Series store.",
+  id: "lightspeed", name: "Lightspeed", description: "jskit.connectors.lightspeed.description",
   accountModes: ["shared", "per-user", "assistant"], authenticationMethods: ["oauth2"],
   oauthClientAuthenticationMethods: ["client_secret_post"],
   settingsSchema: createSchema({
     domainPrefix: { type: "string", required: true, minLength: 1, maxLength: 63,
       validator: (value) => /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/u.test(value) || "Enter the lowercase store prefix without a URL, dots or spaces." }
   }),
-  settingsFields: [{ name: "domainPrefix", label: "Domain prefix", placeholder: "your-store",
-    hint: "The store prefix from https://your-store.retail.lightspeed.app. Use the store you intend to authorize." }],
+  settingsFields: [{ name: "domainPrefix", label: "jskit.connectors.lightspeed.fields.domainPrefix.label", placeholder: "your-store",
+    hint: "jskit.connectors.lightspeed.fields.domainPrefix.hint" }],
   scopes: [
-    { value: "retailer:read", label: "Read retailer settings", recommended: true },
-    { value: "outlets:read", label: "Read outlets", recommended: true },
-    { value: "registers:read", label: "Read registers", recommended: true },
-    { value: "payment_types:read", label: "Read payment types", recommended: true },
-    { value: "products:read", label: "Read products", recommended: true },
-    { value: "products:read:price_books", label: "Read price books", recommended: true },
-    { value: "inventory:read", label: "Read inventory", recommended: true },
-    { value: "customers:read", label: "Read customers", recommended: true },
-    { value: "sales:read", label: "Read sales", recommended: true },
-    { value: "fulfillments:read", label: "Read fulfillments", recommended: true },
-    { value: "promotions:read", label: "Read promotions", recommended: true },
-    { value: "gift_cards:read", label: "Read gift cards", recommended: true },
-    { value: "store_credits:read", label: "Read store credits", recommended: true },
-    { value: "suppliers:read", label: "Read suppliers", recommended: true },
-    { value: "taxes:read", label: "Read taxes", recommended: true },
-    { value: "users:read", label: "Read users", recommended: true },
-    { value: "audit:read", label: "Read audit events" },
-    { value: "business_rules:read", label: "Read business rules" },
-    { value: "business_rules:write", label: "Edit business rules" },
-    { value: "channels:read", label: "Read channels" },
-    { value: "consignments:read", label: "Read consignments" },
-    { value: "consignments:write:inventory_count", label: "Perform inventory counts" },
-    { value: "consignments:write:stock_order", label: "Process stock orders" },
-    { value: "consignments:write:stock_transfer", label: "Transfer stock" },
-    { value: "customers:write", label: "Edit customers" },
-    { value: "custom_fields:read", label: "Read custom fields" },
-    { value: "custom_fields:write", label: "Edit custom fields" },
-    { value: "fulfillments:write", label: "Edit fulfillments" },
-    { value: "gift_cards:write:issue", label: "Issue gift cards" },
-    { value: "gift_cards:write:redeem", label: "Redeem gift cards" },
-    { value: "inventory:write", label: "Edit inventory" },
-    { value: "payments:read", label: "Read payments" },
-    { value: "products:write", label: "Edit products" },
-    { value: "products:write:price_books", label: "Edit price books" },
-    { value: "promotions:write", label: "Edit promotions" },
-    { value: "register:close", label: "Close registers" },
-    { value: "register:open", label: "Open registers" },
-    { value: "remote_rules:read", label: "Read remote rules" },
-    { value: "remote_rules:write", label: "Edit remote rules" },
-    { value: "sales:write", label: "Edit sales" },
-    { value: "serial_numbers:read", label: "Read serial numbers" },
-    { value: "serial_numbers:write", label: "Edit serial numbers" },
-    { value: "services:read", label: "Read services" },
-    { value: "services:write", label: "Edit services" },
-    { value: "store_credits:write:issue", label: "Issue store credits" },
-    { value: "suppliers:write", label: "Edit suppliers" },
-    { value: "taxes:write", label: "Edit taxes" },
-    { value: "users:write", label: "Edit users" },
-    { value: "webhooks", label: "Manage application webhooks" }
+    { value: "retailer:read", label: "jskit.connectors.lightspeed.scopes.retailerRead.label", recommended: true },
+    { value: "outlets:read", label: "jskit.connectors.lightspeed.scopes.outletsRead.label", recommended: true },
+    { value: "registers:read", label: "jskit.connectors.lightspeed.scopes.registersRead.label", recommended: true },
+    { value: "payment_types:read", label: "jskit.connectors.lightspeed.scopes.paymentTypesRead.label", recommended: true },
+    { value: "products:read", label: "jskit.connectors.lightspeed.scopes.productsRead.label", recommended: true },
+    { value: "products:read:price_books", label: "jskit.connectors.lightspeed.scopes.productsReadPriceBooks.label", recommended: true },
+    { value: "inventory:read", label: "jskit.connectors.lightspeed.scopes.inventoryRead.label", recommended: true },
+    { value: "customers:read", label: "jskit.connectors.lightspeed.scopes.customersRead.label", recommended: true },
+    { value: "sales:read", label: "jskit.connectors.lightspeed.scopes.salesRead.label", recommended: true },
+    { value: "fulfillments:read", label: "jskit.connectors.lightspeed.scopes.fulfillmentsRead.label", recommended: true },
+    { value: "promotions:read", label: "jskit.connectors.lightspeed.scopes.promotionsRead.label", recommended: true },
+    { value: "gift_cards:read", label: "jskit.connectors.lightspeed.scopes.giftCardsRead.label", recommended: true },
+    { value: "store_credits:read", label: "jskit.connectors.lightspeed.scopes.storeCreditsRead.label", recommended: true },
+    { value: "suppliers:read", label: "jskit.connectors.lightspeed.scopes.suppliersRead.label", recommended: true },
+    { value: "taxes:read", label: "jskit.connectors.lightspeed.scopes.taxesRead.label", recommended: true },
+    { value: "users:read", label: "jskit.connectors.lightspeed.scopes.usersRead.label", recommended: true },
+    { value: "audit:read", label: "jskit.connectors.lightspeed.scopes.auditRead.label" },
+    { value: "business_rules:read", label: "jskit.connectors.lightspeed.scopes.businessRulesRead.label" },
+    { value: "business_rules:write", label: "jskit.connectors.lightspeed.scopes.businessRulesWrite.label" },
+    { value: "channels:read", label: "jskit.connectors.lightspeed.scopes.channelsRead.label" },
+    { value: "consignments:read", label: "jskit.connectors.lightspeed.scopes.consignmentsRead.label" },
+    { value: "consignments:write:inventory_count", label: "jskit.connectors.lightspeed.scopes.consignmentsWriteInventoryCount.label" },
+    { value: "consignments:write:stock_order", label: "jskit.connectors.lightspeed.scopes.consignmentsWriteStockOrder.label" },
+    { value: "consignments:write:stock_transfer", label: "jskit.connectors.lightspeed.scopes.consignmentsWriteStockTransfer.label" },
+    { value: "customers:write", label: "jskit.connectors.lightspeed.scopes.customersWrite.label" },
+    { value: "custom_fields:read", label: "jskit.connectors.lightspeed.scopes.customFieldsRead.label" },
+    { value: "custom_fields:write", label: "jskit.connectors.lightspeed.scopes.customFieldsWrite.label" },
+    { value: "fulfillments:write", label: "jskit.connectors.lightspeed.scopes.fulfillmentsWrite.label" },
+    { value: "gift_cards:write:issue", label: "jskit.connectors.lightspeed.scopes.giftCardsWriteIssue.label" },
+    { value: "gift_cards:write:redeem", label: "jskit.connectors.lightspeed.scopes.giftCardsWriteRedeem.label" },
+    { value: "inventory:write", label: "jskit.connectors.lightspeed.scopes.inventoryWrite.label" },
+    { value: "payments:read", label: "jskit.connectors.lightspeed.scopes.paymentsRead.label" },
+    { value: "products:write", label: "jskit.connectors.lightspeed.scopes.productsWrite.label" },
+    { value: "products:write:price_books", label: "jskit.connectors.lightspeed.scopes.productsWritePriceBooks.label" },
+    { value: "promotions:write", label: "jskit.connectors.lightspeed.scopes.promotionsWrite.label" },
+    { value: "register:close", label: "jskit.connectors.lightspeed.scopes.registerClose.label" },
+    { value: "register:open", label: "jskit.connectors.lightspeed.scopes.registerOpen.label" },
+    { value: "remote_rules:read", label: "jskit.connectors.lightspeed.scopes.remoteRulesRead.label" },
+    { value: "remote_rules:write", label: "jskit.connectors.lightspeed.scopes.remoteRulesWrite.label" },
+    { value: "sales:write", label: "jskit.connectors.lightspeed.scopes.salesWrite.label" },
+    { value: "serial_numbers:read", label: "jskit.connectors.lightspeed.scopes.serialNumbersRead.label" },
+    { value: "serial_numbers:write", label: "jskit.connectors.lightspeed.scopes.serialNumbersWrite.label" },
+    { value: "services:read", label: "jskit.connectors.lightspeed.scopes.servicesRead.label" },
+    { value: "services:write", label: "jskit.connectors.lightspeed.scopes.servicesWrite.label" },
+    { value: "store_credits:write:issue", label: "jskit.connectors.lightspeed.scopes.storeCreditsWriteIssue.label" },
+    { value: "suppliers:write", label: "jskit.connectors.lightspeed.scopes.suppliersWrite.label" },
+    { value: "taxes:write", label: "jskit.connectors.lightspeed.scopes.taxesWrite.label" },
+    { value: "users:write", label: "jskit.connectors.lightspeed.scopes.usersWrite.label" },
+    { value: "webhooks", label: "jskit.connectors.lightspeed.scopes.webhooks.label" }
   ],
   setup: { url: "https://x-series-api.lightspeedhq.com/docs/authorization", steps: [
     "Open developers.retail.lightspeed.app and register a developer account; your retail-store login is separate. Open Applications > Create and register this application's exact Suggested callback URL as its redirect URI.",

package/src/shared/linkedin.js

@@ -1,13 +1,13 @@
 const linkedinDefinition = Object.freeze({
-  id: "linkedin", name: "LinkedIn", description: "Connect a member's LinkedIn account to read their permitted profile information and publish approved text posts.",
+  id: "linkedin", name: "LinkedIn", description: "jskit.connectors.linkedin.description",
   accountModes: ["shared", "per-user", "assistant"], authenticationMethods: ["oauth2"],
   scopes: [
-    { value: "openid", label: "OpenID (required)", required: true, recommended: true },
-    { value: "profile", label: "Read basic profile (required)", required: true, recommended: true },
-    { value: "email", label: "Read primary email address" },
-    { value: "w_member_social", label: "Publish posts" }
+    { value: "openid", label: "jskit.connectors.linkedin.scopes.openid.label", required: true, recommended: true },
+    { value: "profile", label: "jskit.connectors.linkedin.scopes.profile.label", required: true, recommended: true },
+    { value: "email", label: "jskit.connectors.linkedin.scopes.email.label" },
+    { value: "w_member_social", label: "jskit.connectors.linkedin.scopes.wMemberSocial.label" }
   ],
-  permissionsHint: "OpenID and profile are required for profile verification. Email is optional. Publish posts needs LinkedIn's Share on LinkedIn product; select it and reconnect before publishing text posts.",
+  permissionsHint: "jskit.connectors.linkedin.permissionsHint",
   setup: {
     url: "https://learn.microsoft.com/en-us/linkedin/consumer/integrations/self-serve/sign-in-with-linkedin-v2",
     steps: [

package/src/shared/logo-dev.js

@@ -1,9 +1,9 @@
 const logoDevDefinition = Object.freeze({
-  id: "logo-dev", name: "Logo.dev", description: "Display company logos using a publishable image-service key.",
+  id: "logo-dev", name: "Logo.dev", description: "jskit.connectors.logoDev.description",
   accountModes: ["shared", "assistant"], authenticationMethods: ["api-key"], scopes: [],
   configurationOnly: true,
-  apiKeyReferenceLabel: "Publishable key reference",
-  apiKeyReferenceHint: "Reference a pk_ key. Your application exposes its value in image URLs. A private sk_ key cannot be used for this image flow.",
+  apiKeyReferenceLabel: "jskit.connectors.logoDev.apiKeyReferenceLabel",
+  apiKeyReferenceHint: "jskit.connectors.logoDev.apiKeyReferenceHint",
   setup: {
     url: "https://www.logo.dev/docs/platform/api-keys",
     steps: [

package/src/shared/mapbox.js

@@ -2,19 +2,19 @@ import { createSchema } from "json-rest-schema";
 import { secretReference } from "@jskit-ai/connectors-core/shared/configuration";
 
 const mapboxDefinition = Object.freeze({
-  id: "mapbox", name: "Mapbox", description: "Validate a backend access token and look up places or coordinates.",
+  id: "mapbox", name: "Mapbox", description: "jskit.connectors.mapbox.description",
   accountModes: ["shared", "assistant"], authenticationMethods: ["api-key", "none"], scopes: [],
   authenticationMethodsForSettings: settings => settings?.usage === "browser" ? ["none"] : ["api-key"],
   configurationOnlyForSettings: settings => settings?.usage === "browser",
-  apiKeyReferenceLabel: "Backend access token reference",
-  apiKeyReferenceHint: "Use a reference to a token for backend requests. It may be a public (pk.) or secret (sk.) token; browser URL restrictions can block backend geocoding.",
+  apiKeyReferenceLabel: "jskit.connectors.mapbox.apiKeyReferenceLabel",
+  apiKeyReferenceHint: "jskit.connectors.mapbox.apiKeyReferenceHint",
   settingsSchema: settings => createSchema({
     usage: { type: "string", enum: ["backend", "browser"], defaultTo: "backend" },
     publicTokenRef: { ...secretReference, required: settings?.usage === "browser" }
   }),
-  settingsFields: [{ name: "usage", label: "Mapbox usage", credentialScope: value => value,
-    items: [{ title: "Backend geocoding and optional browser maps", value: "backend" }, { title: "Browser maps only", value: "browser" }] }, { name: "publicTokenRef", environmentCredential: { label: "Public browser token", public: true }, label: "Public browser token reference", placeholder: "env:MAPBOX_PUBLIC_TOKEN",
-    hint: "Required for browser-only mode; optional with backend geocoding. Separate pk. token for Mapbox in your browser. The application may expose this value; backend verification does not verify its restrictions." }],
+  settingsFields: [{ name: "usage", label: "jskit.connectors.mapbox.fields.usage.label", credentialScope: value => value,
+    items: [{ title: "jskit.connectors.mapbox.fields.usage.items.backend.title", value: "backend" }, { title: "jskit.connectors.mapbox.fields.usage.items.browser.title", value: "browser" }] }, { name: "publicTokenRef", environmentCredential: { label: "jskit.connectors.mapbox.fields.publicTokenRef.environmentCredential.label", public: true }, label: "jskit.connectors.mapbox.fields.publicTokenRef.label", placeholder: "env:MAPBOX_PUBLIC_TOKEN",
+    hint: "jskit.connectors.mapbox.fields.publicTokenRef.hint" }],
   setup: {
     url: "https://docs.mapbox.com/accounts/guides/tokens/",
     stepsForSettings: settings => settings?.usage === "browser" ? [

package/src/shared/mcp.js

@@ -24,19 +24,19 @@ function validN8nOAuthDiscovery(value) {
 }
 
 const n8nDefinition = Object.freeze({
-  id: "n8n", name: "n8n", description: "Discover and use your n8n instance's MCP tools from an assistant.",
+  id: "n8n", name: "n8n", description: "jskit.connectors.n8n.description",
   accountModes: ["assistant"], authenticationMethods: ["api-key"], scopes: [],
   authenticationMethodsForSettings: (settings) => settings.oauthDiscovery ? ["oauth2", "api-key"] : ["api-key"],
   scopesForSettings: (settings) => (settings.oauthDiscovery?.scopes || []).map((value) => ({ value, label: value })),
-  apiKeyReferenceLabel: "MCP access token reference",
-  apiKeyReferenceHint: "Use the personal token from Instance-level MCP, not an n8n REST API key. The assistant host must authorize individual tool calls.",
+  apiKeyReferenceLabel: "jskit.connectors.n8n.apiKeyReferenceLabel",
+  apiKeyReferenceHint: "jskit.connectors.n8n.apiKeyReferenceHint",
   settingsSchema: createSchema({ serverUrl: { type: "string", required: true, minLength: 1, maxLength: 2048,
     validator: (value) => validN8nServerUrl(value) || "Use the HTTPS MCP server URL ending /mcp-server/http, without credentials, query or fragment." },
     oauthDiscovery: { type: "object", additionalProperties: true,
       validator: (value) => validN8nOAuthDiscovery(value) || "Discover a supported n8n OAuth authority and permissions before connecting." }
   }),
-  settingsFields: [{ name: "serverUrl", label: "Server URL", placeholder: "https://automation.example.com/mcp-server/http",
-    hint: "Copy the full Server URL from n8n's MCP connection details. Keep any reverse-proxy subdirectory." }],
+  settingsFields: [{ name: "serverUrl", label: "jskit.connectors.n8n.fields.serverUrl.label", placeholder: "https://automation.example.com/mcp-server/http",
+    hint: "jskit.connectors.n8n.fields.serverUrl.hint" }],
   setup: {
     url: "https://docs.n8n.io/connect/connect-to-n8n-mcp-server",
     clientRegistrationEndpoint: (settings) => settings.oauthDiscovery?.resource === settings.serverUrl
@@ -65,11 +65,11 @@ const n8nDefinition = Object.freeze({
 });
 
 const sanityDefinition = Object.freeze({
-  id: "sanity", name: "Sanity", description: "Discover and use Sanity's hosted MCP tools from an assistant.",
+  id: "sanity", name: "Sanity", description: "jskit.connectors.sanity.description",
   accountModes: ["assistant"], authenticationMethods: ["oauth2", "api-key"],
-  scopes: [{ value: "global", label: "Sanity MCP account access", recommended: true }],
-  apiKeyReferenceLabel: "MCP API token reference",
-  apiKeyReferenceHint: "Store a Sanity token in Env. Its role controls tool access at https://mcp.sanity.io; the assistant host must authorize individual calls.",
+  scopes: [{ value: "global", label: "jskit.connectors.sanity.scopes.global.label", recommended: true }],
+  apiKeyReferenceLabel: "jskit.connectors.sanity.apiKeyReferenceLabel",
+  apiKeyReferenceHint: "jskit.connectors.sanity.apiKeyReferenceHint",
   setup: {
     url: "https://www.sanity.io/docs/ai/mcp-server",
     clientRegistrationEndpoint: "https://mcp.sanity.io/register",

package/src/shared/microsoft-fabric.js

@@ -6,18 +6,18 @@ const guid = "[a-fA-F0-9]{8}-(?:[a-fA-F0-9]{4}-){3}[a-fA-F0-9]{12}";
 const guidPattern = new RegExp(`^${guid}$`, "u");
 const endpointPattern = new RegExp(`^https://api\\.fabric\\.microsoft\\.com/v1/workspaces/${guid}/(?:graphqlapis|graphQLApis|GraphQLApis)/${guid}/graphql$`, "u");
 const scopes = [
-  { value: delegatedScope, label: "Execute GraphQL queries and mutations as the user", recommended: true },
-  { value: "offline_access", label: "Keep user access between visits", recommended: true },
-  { value: serviceScope, label: "Use the service account's Fabric permissions", recommended: true }
+  { value: delegatedScope, label: "jskit.connectors.microsoftFabric.scopes.delegatedScope.label", recommended: true },
+  { value: "offline_access", label: "jskit.connectors.microsoftFabric.scopes.offlineAccess.label", recommended: true },
+  { value: serviceScope, label: "jskit.connectors.microsoftFabric.scopes.serviceScope.label", recommended: true }
 ];
 
 const microsoftFabricDefinition = Object.freeze({
   id: "microsoft-fabric", name: "Microsoft Fabric",
-  description: "Access one Fabric GraphQL API using user consent or a service principal.",
+  description: "jskit.connectors.microsoftFabric.description",
   accountModes: ["shared", "per-user", "assistant"], authenticationMethods: ["oauth2"],
   oauthGrantTypes: ["authorization_code", "client_credentials"], oauthClientAuthenticationMethods: ["client_secret_post"],
   validateClientId: (value) => guidPattern.test(value) || "Enter the Application (client) ID as a GUID.",
-  oauthGrantHint: "User consent needs a Web callback and delegated GraphQL permission. Service account needs a service principal with Fabric access, without a callback.",
+  oauthGrantHint: "jskit.connectors.microsoftFabric.oauthGrantHint",
   settingsSchema: createSchema({
     tenantId: { type: "string", required: true, maxLength: 36,
       validator: (value) => guidPattern.test(value) || "Enter the Directory (tenant) ID as a GUID, not common or a client ID." },
@@ -25,12 +25,12 @@ const microsoftFabricDefinition = Object.freeze({
       validator: (value) => endpointPattern.test(value) || "Copy the Fabric GraphQL API endpoint with workspace and API IDs, without a query string or fragment." }
   }),
   settingsFields: [
-    { name: "tenantId", label: "Microsoft Entra Tenant ID", placeholder: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", hint: "The directory containing the Fabric resource and permitted users or service principal." },
-    { name: "graphqlEndpoint", label: "Fabric GraphQL Endpoint", placeholder: "https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/graphqlapis/<api-id>/graphql",
-      hint: "Open your API for GraphQL in Fabric and select Copy endpoint. Custom proxies and sovereign-cloud addresses are not supported by this fragment." }
+    { name: "tenantId", label: "jskit.connectors.microsoftFabric.fields.tenantId.label", placeholder: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", hint: "jskit.connectors.microsoftFabric.fields.tenantId.hint" },
+    { name: "graphqlEndpoint", label: "jskit.connectors.microsoftFabric.fields.graphqlEndpoint.label", placeholder: "https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/graphqlapis/<api-id>/graphql",
+      hint: "jskit.connectors.microsoftFabric.fields.graphqlEndpoint.hint" }
   ],
   scopes, scopesForGrantType: (grantType) => scopes.filter((scope) => grantType === "client_credentials" ? scope.value === serviceScope : scope.value !== serviceScope),
-  permissionsHint: "Fabric Execute access permits queries and mutations. Your application must authorize the documents it executes. Data-source access is separate; this does not sign users into your application.",
+  permissionsHint: "jskit.connectors.microsoftFabric.permissionsHint",
   setup: { url: "https://learn.microsoft.com/en-us/fabric/data-engineering/connect-apps-api-graphql", steps: [
     "You need an existing Fabric API for GraphQL and permission to register an application in its Microsoft Entra directory. In Entra admin center → Entra ID → App registrations → New registration, name the app, choose the intended directory audience and Register. Copy Application (client) ID and Directory (tenant) ID from Overview into their separate fields; use the tenant GUID, not common.",
     "Open Certificates & secrets → Client secrets → New client secret. Add a description and expiry, then Add. Copy Value immediately, not Secret ID. Keep env:MICROSOFT_FABRIC_CLIENT_SECRET as the secret reference; store the secret value in Env after saving.",