@sendora/mcp 1.3.3 → 1.4.1

package/dist/errors.js

@@ -17,8 +17,13 @@ const capOwner = {
  */
 const hints = {
     invalid_request: null,
-    unauthorized: () => `The key was revoked or mistyped. A server key is made under its server in the dashboard, ${KEYS_PAGE}, and an account key by an administrator under Account › API keys (Konto › API-nycklar), ${ACCOUNT_KEYS_PAGE}; restart the connection with the new one.`,
+    unauthorized: (_error, connection) => connection.kind === 'grant'
+        ? `This connection has ended, or the person who approved it may no longer open this server. They see their connections under Account › Connected apps (Konto › Anslutna appar), ${DASHBOARD}/account/apps, and can connect the app again.`
+        : `The key was revoked or mistyped. A server key is made under its server in the dashboard, ${KEYS_PAGE}, and an account key by an administrator under Account › API keys (Konto › API-nycklar), ${ACCOUNT_KEYS_PAGE}; restart the connection with the new one.`,
     wrong_token_kind: null,
+    not_for_connections: null,
+    read_only_connection: () => 'The person approved this connection without changes on live servers, and the account is read only through a connection. They can connect again and tick "Tillåt ändringar på liveservrar" on the approval page, or the change can be made on a test server.',
+    test_server_only: () => 'Through a connected app, keys, webhooks and what cannot be undone happen on test servers only. Make the change on a test server, or in the dashboard.',
     payment_required: null,
     account_paused: null,
     account_not_active: null,
@@ -41,7 +46,9 @@ const hints = {
     server_reserved: null,
     server_in_flight: null,
     request_too_large: null,
-    from_domain_not_verified: () => `The from address's domain must be one of the account's sending domains that get_server lists as sendingDomains. To add one, which is the account's and not a server's: with the account key, add_domain adds it and answers the DNS records to publish, and check_domain looks them up; or an administrator adds it under Domains (Domäner) in the dashboard, ${DASHBOARD}/domains.`,
+    from_domain_not_verified: (_error, connection) => connection.kind === 'grant'
+        ? `The from address's domain must be one of the account's sending domains that get_server lists as sendingDomains. An administrator adds one, which is the account's and not a server's, under Domains (Domäner) in the dashboard, ${DASHBOARD}/domains.`
+        : `The from address's domain must be one of the account's sending domains that get_server lists as sendingDomains. To add one, which is the account's and not a server's: with the account key, add_domain adds it and answers the DNS records to publish, and check_domain looks them up; or an administrator adds it under Domains (Domäner) in the dashboard, ${DASHBOARD}/domains.`,
     stream_not_found: null,
     stream_archived: null,
     stream_paused: null,
@@ -54,7 +61,9 @@ const hints = {
     content_expired: null,
     content_unreadable: null,
     recipient_suppressed: (error) => `${error.suppressed.map(({ address, reason }) => `${address} (${reason})`).join(', ')} ${error.suppressed.length === 1 ? 'is' : 'are'} on the stream's suppression list, which list_suppressions reads. A hard bounce or a manual suppression can be lifted with remove_suppression, or under the stream's Suppressions (Spärrlista) in the dashboard; a spam complaint or an unsubscribe cannot, since the recipient asked.`,
-    test_address_on_live_server: () => 'The addresses at simulator.sendora.se act out outcomes on a test server only, and a live server refuses them: send to them with a test server key (sk_test_).',
+    test_address_on_live_server: (_error, connection) => connection.kind === 'grant'
+        ? 'The addresses at simulator.sendora.se act out outcomes on a test server only, and a live server refuses them: send to them from a test server this connection reaches, named in server.'
+        : 'The addresses at simulator.sendora.se act out outcomes on a test server only, and a live server refuses them: send to them with a test server key (sk_test_).',
     mode_immutable: null,
     stream_kind_not_allowed: null,
     idempotency_key_mismatch: null,
@@ -68,22 +77,23 @@ const hints = {
     invalid_signature: null,
     stale_signature: null,
 };
-/** The hint for a refusal, or undefined when the API's message says all there is. */
-export function hintFor(error) {
+/** The hint for a refusal on this connection, or undefined when the API's message says all there is. */
+export function hintFor(error, connection) {
     const hint = hints[error.code];
-    return hint === null ? undefined : hint(error);
+    return hint === null ? undefined : hint(error, connection);
 }
 /**
  * A refusal from the API as a tool's error (docs/design/mcp.md §7), which
  * the model reads and can act on: the code, the API's message and the next
- * step, with the error's fields as the SDK has them. Anything that is not a
- * `SendoraError` is the server's own fault and is thrown.
+ * step on this connection, with the error's fields as the SDK has them.
+ * Anything that is not a `SendoraError` is the server's own fault and is
+ * thrown.
  */
-export function toolError(error) {
+export function toolError(error, connection) {
     if (!(error instanceof SendoraError)) {
         throw error;
     }
-    const hint = hintFor(error);
+    const hint = hintFor(error, connection);
     return {
         content: [
             {