@sanctuary-framework/mcp-server 0.5.11 → 0.5.12

package/dist/index.d.cts

@@ -2083,8 +2083,15 @@ declare class IdentityManager {
     private primaryIdentityId;
     constructor(storage: StorageBackend, masterKey: Uint8Array);
     private get encryptionKey();
-    /** Load identities from storage on startup */
-    load(): Promise<void>;
+    /** Load identities from storage on startup.
+     *  Returns { total: number of encrypted files found, loaded: number successfully decrypted }.
+     *  A mismatch (total > 0, loaded === 0) indicates a wrong master key / missing passphrase.
+     */
+    load(): Promise<{
+        total: number;
+        loaded: number;
+        failed: number;
+    }>;
     /** Save an identity to storage */
     save(identity: StoredIdentity): Promise<void>;
     get(id: string): StoredIdentity | undefined;

package/dist/index.d.ts

@@ -2083,8 +2083,15 @@ declare class IdentityManager {
     private primaryIdentityId;
     constructor(storage: StorageBackend, masterKey: Uint8Array);
     private get encryptionKey();
-    /** Load identities from storage on startup */
-    load(): Promise<void>;
+    /** Load identities from storage on startup.
+     *  Returns { total: number of encrypted files found, loaded: number successfully decrypted }.
+     *  A mismatch (total > 0, loaded === 0) indicates a wrong master key / missing passphrase.
+     */
+    load(): Promise<{
+        total: number;
+        loaded: number;
+        failed: number;
+    }>;
     /** Save an identity to storage */
     save(identity: StoredIdentity): Promise<void>;
     get(id: string): StoredIdentity | undefined;

package/dist/index.js

@@ -1275,9 +1275,13 @@ var IdentityManager = class {
   get encryptionKey() {
     return derivePurposeKey(this.masterKey, "identity-encryption");
   }
-  /** Load identities from storage on startup */
+  /** Load identities from storage on startup.
+   *  Returns { total: number of encrypted files found, loaded: number successfully decrypted }.
+   *  A mismatch (total > 0, loaded === 0) indicates a wrong master key / missing passphrase.
+   */
   async load() {
     const entries = await this.storage.list("_identities");
+    let failed = 0;
     for (const entry of entries) {
       const raw = await this.storage.read("_identities", entry.key);
       if (!raw) continue;
@@ -1290,8 +1294,10 @@ var IdentityManager = class {
           this.primaryIdentityId = identity.identity_id;
         }
       } catch {
+        failed++;
       }
     }
+    return { total: entries.length, loaded: this.identities.size, failed };
   }
   /** Save an identity to storage */
   async save(identity) {
@@ -12863,7 +12869,29 @@ async function createSanctuaryServer(options) {
     keyProtection,
     auditLog
   );
-  await identityManager.load();
+  const loadResult = await identityManager.load();
+  if (loadResult.total > 0 && loadResult.loaded === 0) {
+    console.error(
+      `
+\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
+\u2551  \u26A0  WARNING: Encrypted identities found but NONE loaded     \u2551
+\u2560\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2563
+\u2551  ${loadResult.total} encrypted identity file(s) found on disk              \u2551
+\u2551  0 could be decrypted with the current master key            \u2551
+\u2551                                                              \u2551
+\u2551  This usually means SANCTUARY_PASSPHRASE is missing or       \u2551
+\u2551  incorrect. The server will start but with NO identity data. \u2551
+\u2551                                                              \u2551
+\u2551  To fix: set SANCTUARY_PASSPHRASE to the passphrase used     \u2551
+\u2551  when this Sanctuary instance was first configured.          \u2551
+\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+`
+    );
+  } else if (loadResult.failed > 0) {
+    console.error(
+      `Warning: ${loadResult.failed} of ${loadResult.total} identity files could not be decrypted (possibly corrupted).`
+    );
+  }
   const l2Tools = [
     {
       name: "sanctuary/exec_attest",