@belonguniverseai/react-sdk 0.6.6 → 0.6.7

package/dist/i18n/messages/surfaces/connectors.d.ts

@@ -0,0 +1,512 @@
+/**
+ * Custom-connector strings: the Connectors rail surface, its add/edit dialogs
+ * and the delete confirmation.
+ *
+ * Copy names the PRODUCT, never the plumbing (§42). The user connects an APP
+ * or a CONNECTOR; there is no "transport", no "discovery", no "snapshot" and
+ * no "alias" as a concept — the one place a derived alias is named at all is
+ * the collision message, where the user genuinely has to know which name is
+ * taken.
+ *
+ * FOUR DELIBERATE EXCEPTIONS, pinned by the product owner against the
+ * industry's own wording (§"When to deviate"): the address field is labelled
+ * "MCP server URL", the two app-credential fields "Client ID" / "Client
+ * Secret", and the service credential's optional address "Token URL". Every one
+ * of the four is COPIED VERBATIM off the provider's own setup page — a user
+ * hunting for the value we are asking for finds a page that says "MCP server
+ * URL", and our own gentler "server address" made them guess which of the three
+ * URLs on it we meant. Plumbing vocabulary is forbidden where it tells the
+ * reader nothing; here it is the label they are matching against.
+ *
+ * `{{product}}` is the dock's brand name (`theme.brand.name` — "Simetrik" on
+ * the tenant preset, "Belong" by default), interpolated the same way
+ * `login.welcome` and `embed.agentWorking` do it. The connector surfaces say
+ * WHOSE agent gets the data, because "connect an app" without a name in it is
+ * the sentence a user cannot decide about.
+ *
+ * Failures here are ORANGE, never red (§42): a server that did not answer, an
+ * app that needs reconnecting and a refresh that came back empty are ordinary
+ * things that happen to a working product. Red is reserved for the one case
+ * that is a form the user just submitted failing — and even that is the
+ * DESTRUCTIVE confirm's button, not a status.
+ *
+ * The `errorDiscovery*` sentences say what happened in the user's terms; the
+ * server's own detail rides underneath in a smaller muted line, because it is
+ * the only thing that can distinguish two "we couldn't reach it" failures from
+ * each other when a user asks their IT team. `errorDiscoveryUnauthorized` is
+ * the one that names an ACTION instead: every other arm is a reason to try
+ * again, and a 401 from the app is the one that never is.
+ *
+ * The SIGN-IN strings hold the same line hardest, because the protocol
+ * vocabulary is most tempting there. The user signs in "through the app", not
+ * with OAuth; what they may have been given is an "app ID" and an "app secret",
+ * not a client id and a client secret; what opens is a "sign-in window", not a
+ * popup carrying an authorization request. None of the real words would tell a
+ * Simetrik user anything except that something they cannot name is involved.
+ */
+export declare const connectorsEn: {
+    readonly connectors: {
+        readonly viewTitle: "Connectors";
+        readonly subtitle: "Connect services so {{product}} can access and act on your data";
+        readonly searchPlaceholder: "Search your connectors";
+        readonly loading: "Loading your connectors…";
+        readonly loadError: "Couldn't load your connectors.";
+        readonly unavailable: "Connecting your own apps isn't turned on here.";
+        readonly noResults: "No connectors match “{{q}}”.";
+        readonly empty: "No connected apps yet.";
+        readonly emptyHint: "Connect your tools so the agent can use them in your tasks.";
+        readonly add: "Add connector";
+        readonly actionsMenu: "Connector actions";
+        readonly edit: "Edit";
+        readonly refresh: "Refresh";
+        readonly refreshing: "Refreshing…";
+        readonly turnOn: "Turn on";
+        readonly turnOff: "Turn off";
+        readonly delete: "Delete";
+        readonly close: "Close";
+        readonly cancel: "Cancel";
+        readonly toolsCount_one: "{{count}} tool";
+        readonly toolsCount_other: "{{count}} tools";
+        readonly statusConnected: "Connected";
+        readonly needsAttention: "Needs attention";
+        readonly statusError: "Couldn't connect";
+        readonly statusOff: "Off";
+        readonly enabledLabel: "Available to the agent";
+        readonly addTitle: "Add custom connector";
+        readonly addDescription: "Connect {{product}} to external apps.";
+        readonly editTitle: "Edit connector";
+        readonly nameLabel: "Name";
+        readonly namePlaceholder: "My App";
+        readonly descriptionLabel: "Description (optional)";
+        readonly descriptionPlaceholder: "A brief description of your connector";
+        readonly emojiLabel: "Icon (optional)";
+        readonly emojiPlaceholder: "🔗";
+        readonly urlLabel: "MCP server URL";
+        readonly urlPlaceholder: "https://example.com/mcp";
+        readonly urlHint: "From the app's own setup page. This can't be changed later.";
+        readonly urlFixed: "The address can't be changed. Add a new connector to point somewhere else.";
+        readonly advanced: "Advanced";
+        readonly authLabel: "Authentication";
+        readonly authNone: "No authentication";
+        readonly authOAuth: "Sign in through the app";
+        readonly authBearer: "Access token";
+        readonly authHeaders: "Custom headers";
+        readonly authClientCredentials: "Service credentials";
+        readonly oauthHint: "You'll sign in on the app's own page. Nothing to type here.";
+        readonly oauthAppCredentials: "I was given app credentials";
+        readonly oauthAppCredentialsHint: "Only if the app asked you to register it and gave you an ID. Most apps don't.";
+        readonly oauthClientId: "Client ID";
+        readonly oauthClientSecret: "Client Secret";
+        readonly oauthScope: "Permissions (optional)";
+        readonly oauthScopePlaceholder: "read write";
+        readonly oauthScopeHint: "Only if the app told you exactly what to ask for. Separate them with spaces.";
+        readonly oauthParams: "Extra settings (optional)";
+        readonly oauthParamsHint: "Only if the app's setup page told you to add them.";
+        readonly oauthParamNamePlaceholder: "Setting";
+        readonly oauthParamValuePlaceholder: "Value";
+        readonly addOAuthParam: "Add setting";
+        readonly removeOAuthParam: "Remove setting";
+        readonly ccHint: "Use the ID and secret the app issued. You won't be asked to sign in.";
+        readonly ccTokenEndpoint: "Token URL (optional)";
+        readonly ccTokenEndpointPlaceholder: "https://example.com/token";
+        readonly ccTokenEndpointHint: "Only if the app gave you one. Otherwise we find it from the address above.";
+        readonly ccNeedsCredentials: "This app stopped accepting the saved credentials. Edit this connector and enter them again.";
+        readonly transportLabel: "Transport";
+        readonly transportStreamableHttp: "Streamable HTTP";
+        readonly transportSse: "SSE";
+        readonly connect: "Connect";
+        readonly connectStarting: "Opening the app…";
+        readonly connectWaiting: "Waiting for you to finish signing in…";
+        readonly connectPopupBlocked: "Your browser blocked the sign-in window.";
+        readonly connectOpenManually: "Open the sign-in page";
+        readonly tokenLabel: "Access token";
+        readonly tokenPlaceholder: "Paste the token from the app";
+        readonly headerNamePlaceholder: "Header";
+        readonly headerValuePlaceholder: "Value";
+        readonly addHeader: "Add header";
+        readonly removeHeader: "Remove header";
+        readonly replaceCredentials: "Replace credentials";
+        readonly replaceCredentialsHint: "Saved credentials are never shown again. Enter them to replace them.";
+        readonly risk: "I understand custom connectors can introduce risks.";
+        readonly riskDetail: "{{product}} can't verify this app or guarantee answer quality, so only use connectors from sources you trust.";
+        readonly submitAdd: "Add";
+        readonly submitAdding: "Adding…";
+        readonly submitSave: "Save changes";
+        readonly submitSaving: "Saving…";
+        readonly toolsTitle: "Tools";
+        readonly toolsEmpty: "This app didn't offer any tools.";
+        /** The per-tool switch's only label — the row's text is the tool itself. */
+        readonly toolToggle: "Use {{tool}}";
+        readonly refusedTitle_one: "One tool was skipped";
+        readonly refusedTitle_other: "{{count}} tools were skipped";
+        readonly errorNameEmpty: "Give this connector a name.";
+        readonly errorNameTooLong: "That name is too long.";
+        readonly errorDescriptionTooLong: "That description is too long.";
+        readonly errorEmojiTooLong: "Use a single emoji.";
+        readonly errorUrlEmpty: "Add the MCP server URL.";
+        readonly errorUrlInvalid: "That doesn't look like a web address — it should start with https://.";
+        readonly errorUrlTooLong: "That address is too long.";
+        readonly errorTokenEmpty: "Paste the access token.";
+        readonly errorHeaderNameEmpty: "Name every header you filled in.";
+        readonly errorHeaderNameInvalid: "“{{name}}” isn't a valid header name — use letters, numbers and dashes.";
+        readonly errorHeaderNameDuplicate: "“{{name}}” is listed twice.";
+        readonly errorHeaderValueNewline: "The value for “{{name}}” can't contain line breaks.";
+        readonly errorHeaderRowsExceeded: "You can add up to {{maxCount}} headers.";
+        readonly errorOAuthClientIdMissing: "Add the Client ID that goes with that secret.";
+        readonly errorOAuthClientIdTooLong: "That Client ID is too long.";
+        readonly errorOAuthClientSecretTooLong: "That Client Secret is too long.";
+        readonly errorOAuthScopeInvalid: "Use single spaces between permissions, and no quotes.";
+        readonly errorOAuthScopeTooLong: "That list of permissions is too long.";
+        readonly errorOAuthParamNameEmpty: "Name every setting you filled in.";
+        readonly errorOAuthParamNameInvalid: "“{{name}}” isn't a valid setting name — use lowercase letters, numbers and underscores.";
+        readonly errorOAuthParamNameReserved: "“{{name}}” is used by the sign-in itself — pick another name.";
+        readonly errorOAuthParamNameDuplicate: "“{{name}}” is listed twice.";
+        readonly errorOAuthParamValueNewline: "The value for “{{name}}” can't contain line breaks.";
+        readonly errorOAuthParamValueTooLong: "The value for “{{name}}” is too long.";
+        readonly errorOAuthParamsExceeded: "You can add up to {{maxCount}} settings.";
+        readonly errorCcClientIdMissing: "Add the Client ID the app gave you.";
+        readonly errorCcClientSecretMissing: "Add the Client Secret the app gave you.";
+        readonly errorCcTokenEndpointInvalid: "That doesn't look like a web address — it should start with https://.";
+        readonly errorCcTokenEndpointTooLong: "That address is too long.";
+        readonly errorOAuthNotReplaceable: "To sign in again, use Connect on the connector itself.";
+        readonly errorNameTaken: "You already have a connector whose tools are named “{{alias}}”. Pick another name.";
+        readonly errorInvalidName: "That name can't be used — include some letters or numbers.";
+        readonly errorLimitReached: "You've reached the limit of {{maxCount}} connectors. Remove one to add another.";
+        readonly errorUrlBlocked: "That address can't be used.";
+        readonly errorToolBudget: "That app offers more tools than there's room for.";
+        readonly errorDiscoveryUnreachable: "We couldn't reach that address.";
+        readonly errorDiscoveryTimeout: "The server took too long to answer.";
+        readonly errorDiscoveryProtocol: "That address doesn't speak the connector protocol.";
+        readonly errorDiscoveryUnauthorized: "The app refused the credentials this connector uses. Update them and try again.";
+        readonly errorDiscoveryDrifted: "That app's tools changed while we were reading them — try again.";
+        readonly errorNeedsAuth: "This connector has to be reconnected before it can refresh.";
+        readonly errorCredentialsUnreadable: "We can't read the saved credentials any more — enter them again.";
+        readonly errorForbidden: "You don't have permission to change connectors here.";
+        readonly errorUnavailable: "Connectors aren't available right now.";
+        readonly errorSaveFailed: "Couldn't save — try again.";
+        readonly errorRefreshFailed: "Couldn't refresh — try again.";
+        readonly errorGone: "That connector is no longer there.";
+        readonly errorWrongAuthMode: "This connector doesn't sign in — it already has its credentials.";
+        readonly errorOAuthDiscovery: "That app doesn't offer a sign-in we can use.";
+        readonly errorOAuthNoApp: "That app needs credentials before it can sign you in. Add them and try again.";
+        readonly errorOAuthUnavailable: "Signing in through an app isn't set up here.";
+        readonly errorOAuthAbandoned: "The sign-in window closed before it finished.";
+        readonly errorOAuthTimedOut: "The sign-in took too long. Try again.";
+        readonly errorOAuthFailed: "Couldn't start the sign-in — try again.";
+        readonly errorOAuthUnsupported: "This app doesn't offer a sign-in service here. Paste the Token URL from the app's setup page.";
+        readonly errorOAuthTokenFailed: "The app refused those credentials.";
+        readonly deleteConfirmTitle: "Delete {{name}}?";
+        readonly deleteConfirmBody: "The agent will lose access to its tools. This can't be undone.";
+        readonly deleteConfirm: "Delete connector";
+    };
+};
+export declare const connectorsEs: {
+    connectors: {
+        viewTitle: string;
+        subtitle: string;
+        searchPlaceholder: string;
+        loading: string;
+        loadError: string;
+        unavailable: string;
+        noResults: string;
+        empty: string;
+        emptyHint: string;
+        add: string;
+        actionsMenu: string;
+        edit: string;
+        refresh: string;
+        refreshing: string;
+        turnOn: string;
+        turnOff: string;
+        delete: string;
+        close: string;
+        cancel: string;
+        toolsCount_one: string;
+        toolsCount_other: string;
+        statusConnected: string;
+        needsAttention: string;
+        statusError: string;
+        statusOff: string;
+        enabledLabel: string;
+        addTitle: string;
+        addDescription: string;
+        editTitle: string;
+        nameLabel: string;
+        namePlaceholder: string;
+        descriptionLabel: string;
+        descriptionPlaceholder: string;
+        emojiLabel: string;
+        emojiPlaceholder: string;
+        urlLabel: string;
+        urlPlaceholder: string;
+        urlHint: string;
+        urlFixed: string;
+        advanced: string;
+        authLabel: string;
+        authNone: string;
+        authOAuth: string;
+        authBearer: string;
+        authHeaders: string;
+        authClientCredentials: string;
+        oauthHint: string;
+        oauthAppCredentials: string;
+        oauthAppCredentialsHint: string;
+        oauthClientId: string;
+        oauthClientSecret: string;
+        oauthScope: string;
+        oauthScopePlaceholder: string;
+        oauthScopeHint: string;
+        oauthParams: string;
+        oauthParamsHint: string;
+        oauthParamNamePlaceholder: string;
+        oauthParamValuePlaceholder: string;
+        addOAuthParam: string;
+        removeOAuthParam: string;
+        ccHint: string;
+        ccTokenEndpoint: string;
+        ccTokenEndpointPlaceholder: string;
+        ccTokenEndpointHint: string;
+        ccNeedsCredentials: string;
+        transportLabel: string;
+        transportStreamableHttp: string;
+        transportSse: string;
+        connect: string;
+        connectStarting: string;
+        connectWaiting: string;
+        connectPopupBlocked: string;
+        connectOpenManually: string;
+        tokenLabel: string;
+        tokenPlaceholder: string;
+        headerNamePlaceholder: string;
+        headerValuePlaceholder: string;
+        addHeader: string;
+        removeHeader: string;
+        replaceCredentials: string;
+        replaceCredentialsHint: string;
+        risk: string;
+        riskDetail: string;
+        submitAdd: string;
+        submitAdding: string;
+        submitSave: string;
+        submitSaving: string;
+        toolsTitle: string;
+        toolsEmpty: string;
+        toolToggle: string;
+        refusedTitle_one: string;
+        refusedTitle_other: string;
+        errorNameEmpty: string;
+        errorNameTooLong: string;
+        errorDescriptionTooLong: string;
+        errorEmojiTooLong: string;
+        errorUrlEmpty: string;
+        errorUrlInvalid: string;
+        errorUrlTooLong: string;
+        errorTokenEmpty: string;
+        errorHeaderNameEmpty: string;
+        errorHeaderNameInvalid: string;
+        errorHeaderNameDuplicate: string;
+        errorHeaderValueNewline: string;
+        errorHeaderRowsExceeded: string;
+        errorOAuthClientIdMissing: string;
+        errorOAuthClientIdTooLong: string;
+        errorOAuthClientSecretTooLong: string;
+        errorOAuthScopeInvalid: string;
+        errorOAuthScopeTooLong: string;
+        errorOAuthParamNameEmpty: string;
+        errorOAuthParamNameInvalid: string;
+        errorOAuthParamNameReserved: string;
+        errorOAuthParamNameDuplicate: string;
+        errorOAuthParamValueNewline: string;
+        errorOAuthParamValueTooLong: string;
+        errorOAuthParamsExceeded: string;
+        errorCcClientIdMissing: string;
+        errorCcClientSecretMissing: string;
+        errorCcTokenEndpointInvalid: string;
+        errorCcTokenEndpointTooLong: string;
+        errorOAuthNotReplaceable: string;
+        errorNameTaken: string;
+        errorInvalidName: string;
+        errorLimitReached: string;
+        errorUrlBlocked: string;
+        errorToolBudget: string;
+        errorDiscoveryUnreachable: string;
+        errorDiscoveryTimeout: string;
+        errorDiscoveryProtocol: string;
+        errorDiscoveryUnauthorized: string;
+        errorDiscoveryDrifted: string;
+        errorNeedsAuth: string;
+        errorCredentialsUnreadable: string;
+        errorForbidden: string;
+        errorUnavailable: string;
+        errorSaveFailed: string;
+        errorRefreshFailed: string;
+        errorGone: string;
+        errorWrongAuthMode: string;
+        errorOAuthDiscovery: string;
+        errorOAuthNoApp: string;
+        errorOAuthUnavailable: string;
+        errorOAuthAbandoned: string;
+        errorOAuthTimedOut: string;
+        errorOAuthFailed: string;
+        errorOAuthUnsupported: string;
+        errorOAuthTokenFailed: string;
+        deleteConfirmTitle: string;
+        deleteConfirmBody: string;
+        deleteConfirm: string;
+    };
+};
+export declare const connectorsPt: {
+    connectors: {
+        viewTitle: string;
+        subtitle: string;
+        searchPlaceholder: string;
+        loading: string;
+        loadError: string;
+        unavailable: string;
+        noResults: string;
+        empty: string;
+        emptyHint: string;
+        add: string;
+        actionsMenu: string;
+        edit: string;
+        refresh: string;
+        refreshing: string;
+        turnOn: string;
+        turnOff: string;
+        delete: string;
+        close: string;
+        cancel: string;
+        toolsCount_one: string;
+        toolsCount_other: string;
+        statusConnected: string;
+        needsAttention: string;
+        statusError: string;
+        statusOff: string;
+        enabledLabel: string;
+        addTitle: string;
+        addDescription: string;
+        editTitle: string;
+        nameLabel: string;
+        namePlaceholder: string;
+        descriptionLabel: string;
+        descriptionPlaceholder: string;
+        emojiLabel: string;
+        emojiPlaceholder: string;
+        urlLabel: string;
+        urlPlaceholder: string;
+        urlHint: string;
+        urlFixed: string;
+        advanced: string;
+        authLabel: string;
+        authNone: string;
+        authOAuth: string;
+        authBearer: string;
+        authHeaders: string;
+        authClientCredentials: string;
+        oauthHint: string;
+        oauthAppCredentials: string;
+        oauthAppCredentialsHint: string;
+        oauthClientId: string;
+        oauthClientSecret: string;
+        oauthScope: string;
+        oauthScopePlaceholder: string;
+        oauthScopeHint: string;
+        oauthParams: string;
+        oauthParamsHint: string;
+        oauthParamNamePlaceholder: string;
+        oauthParamValuePlaceholder: string;
+        addOAuthParam: string;
+        removeOAuthParam: string;
+        ccHint: string;
+        ccTokenEndpoint: string;
+        ccTokenEndpointPlaceholder: string;
+        ccTokenEndpointHint: string;
+        ccNeedsCredentials: string;
+        transportLabel: string;
+        transportStreamableHttp: string;
+        transportSse: string;
+        connect: string;
+        connectStarting: string;
+        connectWaiting: string;
+        connectPopupBlocked: string;
+        connectOpenManually: string;
+        tokenLabel: string;
+        tokenPlaceholder: string;
+        headerNamePlaceholder: string;
+        headerValuePlaceholder: string;
+        addHeader: string;
+        removeHeader: string;
+        replaceCredentials: string;
+        replaceCredentialsHint: string;
+        risk: string;
+        riskDetail: string;
+        submitAdd: string;
+        submitAdding: string;
+        submitSave: string;
+        submitSaving: string;
+        toolsTitle: string;
+        toolsEmpty: string;
+        toolToggle: string;
+        refusedTitle_one: string;
+        refusedTitle_other: string;
+        errorNameEmpty: string;
+        errorNameTooLong: string;
+        errorDescriptionTooLong: string;
+        errorEmojiTooLong: string;
+        errorUrlEmpty: string;
+        errorUrlInvalid: string;
+        errorUrlTooLong: string;
+        errorTokenEmpty: string;
+        errorHeaderNameEmpty: string;
+        errorHeaderNameInvalid: string;
+        errorHeaderNameDuplicate: string;
+        errorHeaderValueNewline: string;
+        errorHeaderRowsExceeded: string;
+        errorOAuthClientIdMissing: string;
+        errorOAuthClientIdTooLong: string;
+        errorOAuthClientSecretTooLong: string;
+        errorOAuthScopeInvalid: string;
+        errorOAuthScopeTooLong: string;
+        errorOAuthParamNameEmpty: string;
+        errorOAuthParamNameInvalid: string;
+        errorOAuthParamNameReserved: string;
+        errorOAuthParamNameDuplicate: string;
+        errorOAuthParamValueNewline: string;
+        errorOAuthParamValueTooLong: string;
+        errorOAuthParamsExceeded: string;
+        errorCcClientIdMissing: string;
+        errorCcClientSecretMissing: string;
+        errorCcTokenEndpointInvalid: string;
+        errorCcTokenEndpointTooLong: string;
+        errorOAuthNotReplaceable: string;
+        errorNameTaken: string;
+        errorInvalidName: string;
+        errorLimitReached: string;
+        errorUrlBlocked: string;
+        errorToolBudget: string;
+        errorDiscoveryUnreachable: string;
+        errorDiscoveryTimeout: string;
+        errorDiscoveryProtocol: string;
+        errorDiscoveryUnauthorized: string;
+        errorDiscoveryDrifted: string;
+        errorNeedsAuth: string;
+        errorCredentialsUnreadable: string;
+        errorForbidden: string;
+        errorUnavailable: string;
+        errorSaveFailed: string;
+        errorRefreshFailed: string;
+        errorGone: string;
+        errorWrongAuthMode: string;
+        errorOAuthDiscovery: string;
+        errorOAuthNoApp: string;
+        errorOAuthUnavailable: string;
+        errorOAuthAbandoned: string;
+        errorOAuthTimedOut: string;
+        errorOAuthFailed: string;
+        errorOAuthUnsupported: string;
+        errorOAuthTokenFailed: string;
+        deleteConfirmTitle: string;
+        deleteConfirmBody: string;
+        deleteConfirm: string;
+    };
+};

package/dist/i18n/messages/surfaces/header.d.ts

@@ -6,6 +6,7 @@ export declare const headerEn: {
         readonly navFiles: "Files";
         readonly navScheduled: "Scheduled";
         readonly navPrompts: "Prompts";
+        readonly navConnectors: "Connectors";
         readonly chatPlanRunning: "Chat — plan running, {{completed}} of {{total}} steps done";
         readonly devMode: "Dev mode";
         readonly devModeTitle: "Dev mode (belong:dev)";
@@ -31,6 +32,7 @@ export declare const headerEs: {
         navFiles: string;
         navScheduled: string;
         navPrompts: string;
+        navConnectors: string;
         chatPlanRunning: string;
         devMode: string;
         devModeTitle: string;
@@ -56,6 +58,7 @@ export declare const headerPt: {
         navFiles: string;
         navScheduled: string;
         navPrompts: string;
+        navConnectors: string;
         chatPlanRunning: string;
         devMode: string;
         devModeTitle: string;

package/dist/routes/connectors.d.ts

@@ -0,0 +1,2 @@
+/** /connectors — the connected-apps list view (rail tab). */
+export declare const ConnectorsRoute: () => import("react").JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@belonguniverseai/react-sdk",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "description": "Belong — embeddable React AI assistant dock. Mount <BelongWidget> in your app tree with getToken dependency-injection auth.",
   "license": "UNLICENSED",
   "type": "module",