@bobfrankston/mailx-settings 0.1.7 → 0.1.10

package/docs/accounts.md

@@ -21,7 +21,11 @@
       "enabled": true,              // false skips this account at startup
       "identityDomains": ["alias.com"]  // extra domains for Reply-From auto-detect
     }
-  ]
+  ],
+  "keys": {                         // AI provider API keys (optional)
+    "anthropic": "",                // sk-ant-api03-...
+    "openai": ""                    // sk-...
+  }
 }
 ```
 
@@ -33,6 +37,7 @@
 - **auth** — `"password"` for traditional IMAP/SMTP, `"oauth2"` for Gmail/Google Workspace/Outlook.
 - **enabled** — set `false` to keep the account record but skip sync at startup.
 - **identityDomains** — addresses you receive at on alternative domains. When you Reply, rmfmail picks the matching identity address as From instead of the account's primary.
+- **keys.anthropic / keys.openai** — API keys for the AI features (translate / proofread / summarize / autocomplete). Lives at the file's top level alongside `accounts:` so you set it once across all your devices. Generated at console.anthropic.com or platform.openai.com. Provider selection is in `preferences.jsonc`; the key here is read based on which provider is active. Empty string means "not configured" — the AI feature silently no-ops. Local Ollama provider needs no key.
 
 ## Notes
 

package/docs/config.md

@@ -17,7 +17,7 @@ Lives at `~/.rmfmail/config.jsonc` on the local filesystem.
     "path": ".rmfmail",                            // folder name in My Drive (currently My Drive/home/.rmfmail)
     "folderId": "1AbCdEf...XYZ"                    // resolved Drive folderId, cached after first lookup
   },
-  "storePath": "C:/Users/Bob/.rmfmail/mailxstore", // local directory for .eml message bodies
+  "storePath": "~/.rmfmail/mailxstore",            // local directory for .eml message bodies
   "historyDays": 30                                // how far back to sync; overrides the shared default
 }
 ```

package/index.d.ts

@@ -15,7 +15,7 @@
  *
  * The old settings.jsonc is still supported for backward compatibility.
  */
-import type { MailxSettings, AccountConfig, AutocompleteSettings } from "@bobfrankston/mailx-types";
+import type { MailxSettings, AccountConfig, AutocompleteSettings, AiKeys } from "@bobfrankston/mailx-types";
 declare const LOCAL_DIR: string;
 /** Subscribers notified whenever lastCloudError changes (push to UI immediately). */
 type CloudErrorListener = (error: string | null, context?: {
@@ -107,8 +107,32 @@ export declare function denormalizeAccount(acct: AccountConfig, globalName?: str
 /** Save account configs */
 /** Save accounts — merges with cloud copy by email (multi-client safe).
  *  Writes the lean form via denormalizeAccount so accounts.jsonc stays
- *  compact and human-editable. */
+ *  compact and human-editable. Preserves the top-level `keys` field
+ *  (AI API keys) if present in the existing cloud or local file. */
 export declare function saveAccounts(accounts: AccountConfig[]): Promise<void>;
+/** Load top-level AI keys from accounts.jsonc. Returns empty placeholders
+ *  ({ anthropic: "", openai: "" }) when the file lacks a `keys` section,
+ *  so callers can call this unconditionally without missing-section guards.
+ *  Reads from the same shared/local path resolution as loadAccounts. */
+export declare function loadKeys(): AiKeys;
+/** Save AI keys back to accounts.jsonc, preserving the rest of the file
+ *  (accounts list, file-level name). Used by Settings → AI to persist a
+ *  key the user just entered. Cloud-synced via saveFile. */
+export declare function saveKeys(keys: AiKeys): Promise<void>;
+/** First-run helper: ensure `keys: { anthropic: "", openai: "" }` is
+ *  materialized in accounts.jsonc so the user sees placeholders for every
+ *  supported provider when they open the config editor. Adds missing
+ *  fields without disturbing existing values, so `keys: {}` becomes
+ *  `keys: { anthropic: "", openai: "" }` and `keys: { anthropic: "sk-..." }`
+ *  becomes `keys: { anthropic: "sk-...", openai: "" }`. Idempotent. */
+export declare function ensureKeysSectionExists(): Promise<void>;
+/** First-run helper: materialize the `autocomplete` block in
+ *  preferences.jsonc with explicit defaults. loadPreferences() merges
+ *  defaults at read time, but the file on disk often has no
+ *  `autocomplete` key, so a user opening Settings → Edit config files
+ *  doesn't see the AI provider knobs. This writes the defaults out so
+ *  the user can edit them. Idempotent. */
+export declare function ensureAutocompletePrefsExist(): Promise<void>;
 /** Load preferences (shared + local overrides, with legacy fallback) */
 export declare function loadPreferences(): typeof DEFAULT_PREFERENCES;
 /** Save preferences */

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}

package/index.js

@@ -572,7 +572,7 @@ const DEFAULT_PREFERENCES = {
         ollamaUrl: "http://localhost:11434",
         ollamaModel: "qwen2.5-coder:1.5b",
         cloudApiKey: "",
-        cloudModel: "claude-sonnet-4-20250514",
+        cloudModel: "claude-sonnet-4-5",
         debounceMs: 600,
         maxTokens: 60,
     },
@@ -583,7 +583,7 @@ const DEFAULT_AUTOCOMPLETE = {
     ollamaUrl: "http://localhost:11434",
     ollamaModel: "qwen2.5-coder:1.5b",
     cloudApiKey: "",
-    cloudModel: "claude-sonnet-4-20250514",
+    cloudModel: "claude-sonnet-4-5",
     debounceMs: 600,
     maxTokens: 60,
 };
@@ -800,28 +800,44 @@ export function denormalizeAccount(acct, globalName) {
 /** Save account configs */
 /** Save accounts — merges with cloud copy by email (multi-client safe).
  *  Writes the lean form via denormalizeAccount so accounts.jsonc stays
- *  compact and human-editable. */
+ *  compact and human-editable. Preserves the top-level `keys` field
+ *  (AI API keys) if present in the existing cloud or local file. */
 export async function saveAccounts(accounts) {
-    // Merge with cloud: keep all accounts, deduplicate by normalized email
+    // Read existing top-level fields we need to preserve (keys, etc.) before
+    // we rewrite. Prefer cloud over local.
+    let preservedKeys;
+    let cloudCopy;
     try {
         const cloudContent = await cloudRead("accounts.jsonc");
-        if (cloudContent) {
-            const cloud = parseJsonc(cloudContent);
-            const cloudAccts = cloud?.accounts || (Array.isArray(cloud) ? cloud : []);
-            if (cloudAccts.length > 0) {
-                const seen = new Set(accounts.map(a => normalizeEmail(a.email)));
-                for (const ca of cloudAccts) {
-                    if (ca.email && !seen.has(normalizeEmail(ca.email))) {
-                        // Cloud entries are already lean — feed through
-                        // normalizeAccount to coerce to AccountConfig shape.
-                        accounts.push(normalizeAccount(ca));
-                        seen.add(normalizeEmail(ca.email));
-                    }
+        if (cloudContent)
+            cloudCopy = parseJsonc(cloudContent);
+    }
+    catch { /* ignore */ }
+    if (!cloudCopy) {
+        try {
+            const localPath = path.join(LOCAL_DIR, "accounts.jsonc");
+            if (fs.existsSync(localPath))
+                cloudCopy = readJsonc(localPath);
+        }
+        catch { /* ignore */ }
+    }
+    if (cloudCopy?.keys && typeof cloudCopy.keys === "object")
+        preservedKeys = cloudCopy.keys;
+    // Merge with cloud: keep all accounts, deduplicate by normalized email
+    if (cloudCopy) {
+        const cloudAccts = cloudCopy.accounts || (Array.isArray(cloudCopy) ? cloudCopy : []);
+        if (cloudAccts.length > 0) {
+            const seen = new Set(accounts.map(a => normalizeEmail(a.email)));
+            for (const ca of cloudAccts) {
+                if (ca.email && !seen.has(normalizeEmail(ca.email))) {
+                    // Cloud entries are already lean — feed through
+                    // normalizeAccount to coerce to AccountConfig shape.
+                    accounts.push(normalizeAccount(ca));
+                    seen.add(normalizeEmail(ca.email));
                 }
             }
         }
     }
-    catch { /* cloud read failed — save local version */ }
     // Promote a shared "name" to file level when every account has the same
     // name — keeps the JSONC tidy ({ "name": "Bob Frankston", "accounts": [...] }
     // instead of repeating "name" on each entry).
@@ -829,8 +845,106 @@ export async function saveAccounts(accounts) {
     const globalName = names.size === 1 ? [...names][0] : undefined;
     const lean = accounts.map(a => denormalizeAccount(a, globalName));
     const payload = globalName ? { name: globalName, accounts: lean } : { accounts: lean };
+    if (preservedKeys)
+        payload.keys = preservedKeys;
     saveFile("accounts.jsonc", payload);
 }
+/** Load top-level AI keys from accounts.jsonc. Returns empty placeholders
+ *  ({ anthropic: "", openai: "" }) when the file lacks a `keys` section,
+ *  so callers can call this unconditionally without missing-section guards.
+ *  Reads from the same shared/local path resolution as loadAccounts. */
+export function loadKeys() {
+    const sharedDir = getSharedDir();
+    const sharedPath = path.join(sharedDir, "accounts.jsonc");
+    const localPath = path.join(LOCAL_DIR, "accounts.jsonc");
+    let raw = readJsonc(sharedPath);
+    if (!raw)
+        raw = readJsonc(localPath);
+    const keys = raw?.keys;
+    return {
+        anthropic: typeof keys?.anthropic === "string" ? keys.anthropic : "",
+        openai: typeof keys?.openai === "string" ? keys.openai : "",
+    };
+}
+/** Save AI keys back to accounts.jsonc, preserving the rest of the file
+ *  (accounts list, file-level name). Used by Settings → AI to persist a
+ *  key the user just entered. Cloud-synced via saveFile. */
+export async function saveKeys(keys) {
+    let existing = {};
+    try {
+        const cloudContent = await cloudRead("accounts.jsonc");
+        if (cloudContent)
+            existing = parseJsonc(cloudContent) || {};
+    }
+    catch { /* ignore */ }
+    if (!existing.accounts) {
+        try {
+            const localPath = path.join(LOCAL_DIR, "accounts.jsonc");
+            if (fs.existsSync(localPath))
+                existing = readJsonc(localPath) || existing;
+        }
+        catch { /* ignore */ }
+    }
+    const merged = { ...existing.keys, ...keys };
+    // Drop empty-string fields so the on-disk file stays tidy when the user
+    // clears a key (writes `""` from the UI) — keep only meaningful values.
+    const cleaned = {};
+    if (merged.anthropic)
+        cleaned.anthropic = merged.anthropic;
+    if (merged.openai)
+        cleaned.openai = merged.openai;
+    existing.keys = cleaned;
+    saveFile("accounts.jsonc", existing);
+}
+/** First-run helper: ensure `keys: { anthropic: "", openai: "" }` is
+ *  materialized in accounts.jsonc so the user sees placeholders for every
+ *  supported provider when they open the config editor. Adds missing
+ *  fields without disturbing existing values, so `keys: {}` becomes
+ *  `keys: { anthropic: "", openai: "" }` and `keys: { anthropic: "sk-..." }`
+ *  becomes `keys: { anthropic: "sk-...", openai: "" }`. Idempotent. */
+export async function ensureKeysSectionExists() {
+    const sharedDir = getSharedDir();
+    const sharedPath = path.join(sharedDir, "accounts.jsonc");
+    const raw = readJsonc(sharedPath);
+    if (!raw)
+        return; // no accounts file yet — first-time setup will handle it
+    const existing = (raw.keys && typeof raw.keys === "object") ? raw.keys : {};
+    const merged = {
+        anthropic: typeof existing.anthropic === "string" ? existing.anthropic : "",
+        openai: typeof existing.openai === "string" ? existing.openai : "",
+    };
+    // Skip the write if the on-disk shape already matches — avoids touching
+    // accounts.jsonc on every startup and the spurious "config changed" banner.
+    if (raw.keys
+        && typeof raw.keys === "object"
+        && raw.keys.anthropic === merged.anthropic
+        && raw.keys.openai === merged.openai
+        && Object.keys(raw.keys).length === 2)
+        return;
+    raw.keys = merged;
+    saveFile("accounts.jsonc", raw);
+}
+/** First-run helper: materialize the `autocomplete` block in
+ *  preferences.jsonc with explicit defaults. loadPreferences() merges
+ *  defaults at read time, but the file on disk often has no
+ *  `autocomplete` key, so a user opening Settings → Edit config files
+ *  doesn't see the AI provider knobs. This writes the defaults out so
+ *  the user can edit them. Idempotent. */
+export async function ensureAutocompletePrefsExist() {
+    const sharedDir = getSharedDir();
+    const sharedPath = path.join(sharedDir, "preferences.jsonc");
+    let raw = readJsonc(sharedPath);
+    if (!raw)
+        raw = {};
+    if (raw.autocomplete && typeof raw.autocomplete === "object")
+        return; // already present
+    raw.autocomplete = { ...DEFAULT_AUTOCOMPLETE };
+    // Strip the cloudApiKey field — the API key now lives in
+    // accounts.jsonc.keys, not here. Writing "" would mislead users into
+    // editing the wrong file.
+    delete raw.autocomplete.cloudApiKey;
+    saveFile("preferences.jsonc", raw);
+}
 /** Load preferences (shared + local overrides, with legacy fallback) */
 export function loadPreferences() {
     let shared = loadFile("preferences.jsonc", DEFAULT_PREFERENCES);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-settings",
-  "version": "0.1.7",
+  "version": "0.1.10",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",
@@ -17,7 +17,7 @@
   },
   "license": "ISC",
   "dependencies": {
-    "@bobfrankston/mailx-types": "^0.1.6",
+    "@bobfrankston/mailx-types": "^0.1.8",
     "jsonc-parser": "^3.3.1"
   },
   "repository": {
@@ -33,7 +33,7 @@
   },
   ".transformedSnapshot": {
     "dependencies": {
-      "@bobfrankston/mailx-types": "^0.1.6",
+      "@bobfrankston/mailx-types": "^0.1.8",
       "jsonc-parser": "^3.3.1"
     }
   }