@sendora/mcp 1.3.1 → 1.4.0

package/README.md

@@ -78,7 +78,8 @@ The documents are resources under `sendora://docs/…`, `sendora://reference/…
 
 The only official Sendora MCP server is this package, `@sendora/mcp`, and the
 address Sendora names at [sendora.se/docs/mcp](https://sendora.se/docs/mcp).
-A server under another name is not Sendora's.
+The MCP Registry lists it as `se.sendora/mcp`, a name that only sendora.se can
+publish. A server under another name is not Sendora's.
 
 ## License
 

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,
@@ -68,22 +73,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: [
             {