ofw-mcp 2.4.0 → 2.4.1

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "OurFamilyWizard tools for Claude Code",
-    "version": "2.4.0"
+    "version": "2.4.1"
   },
   "plugins": [
     {
@@ -14,7 +14,7 @@
       "displayName": "OurFamilyWizard",
       "source": "./",
       "description": "OurFamilyWizard co-parenting tools for Claude — messages, calendar, expenses, and journal via MCP",
-      "version": "2.4.0",
+      "version": "2.4.1",
       "author": {
         "name": "Chris Chall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ofw",
   "displayName": "OurFamilyWizard",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "OurFamilyWizard co-parenting tools for Claude — messages, calendar, expenses, and journal via MCP",
   "author": {
     "name": "Chris Chall"
@@ -17,5 +17,40 @@
     "family"
   ],
   "skills": "./skills/",
-  "mcp": "./.mcp.json"
+  "mcp": "./.mcp.json",
+  "userConfig": {
+    "ofw_username": {
+      "type": "string",
+      "title": "OFW Email",
+      "description": "Your OurFamilyWizard login email address. Optional — if omitted, the server falls back to the fetchproxy browser extension (requires being signed in to ourfamilywizard.com in your browser).",
+      "required": false
+    },
+    "ofw_password": {
+      "type": "string",
+      "title": "OFW Password",
+      "description": "Your OurFamilyWizard password. Optional — see ofw_username.",
+      "required": false,
+      "sensitive": true
+    },
+    "ofw_inline_attachments": {
+      "type": "boolean",
+      "title": "Return attachments inline",
+      "description": "When on, ofw_download_attachment returns bytes inline as MCP content (images render directly; other files come back as embedded resources) instead of writing to disk. Recommended for sandboxed hosts like Claude Desktop where the model cannot read files written to ~/Downloads. Callers can still override per-call via the tool's `inline` argument.",
+      "required": false,
+      "default": false
+    },
+    "ofw_attachments_dir": {
+      "type": "directory",
+      "title": "Attachments download directory",
+      "description": "Directory where ofw_download_attachment writes files when not returning inline. Defaults to ~/Downloads/ofw-mcp/. Pick a directory that is readable by your MCP host.",
+      "required": false
+    },
+    "ofw_write_mode": {
+      "type": "string",
+      "title": "Write mode",
+      "description": "Structural write gate. \"none\" = no write tools registered (read/sync/search only); \"drafts\" = draft-level writes only (save/delete drafts, upload attachments — never send or calendar/expense/journal writes); \"all\" = everything (default). Unrecognized values fail closed to \"none\".",
+      "required": false,
+      "default": "all"
+    }
+  }
 }

package/.mcp.json

@@ -4,8 +4,11 @@
       "command": "npx",
       "args": ["-y", "ofw-mcp"],
       "env": {
-        "OFW_USERNAME": "${OFW_USERNAME}",
-        "OFW_PASSWORD": "${OFW_PASSWORD}"
+        "OFW_USERNAME": "${user_config.ofw_username}",
+        "OFW_PASSWORD": "${user_config.ofw_password}",
+        "OFW_INLINE_ATTACHMENTS": "${user_config.ofw_inline_attachments}",
+        "OFW_ATTACHMENTS_DIR": "${user_config.ofw_attachments_dir}",
+        "OFW_WRITE_MODE": "${user_config.ofw_write_mode}"
       }
     }
   }

package/dist/bundle.js

@@ -13,7 +13,11 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
 var __commonJS = (cb, mod) => function __require2() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  try {
+    return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  } catch (e) {
+    throw mod = 0, e;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -38146,7 +38150,7 @@ function getDefaultInlineAttachments() {
 // package.json
 var package_default = {
   name: "ofw-mcp",
-  version: "2.4.0",
+  version: "2.4.1",
   license: "MIT",
   mcpName: "io.github.chrischall/ofw-mcp",
   description: "OurFamilyWizard MCP server for Claude \u2014 developed and maintained by AI (Claude Code)",
@@ -38257,7 +38261,26 @@ async function resolveAuth() {
   );
 }
 
+// src/env-bootstrap.ts
+var USER_CONFIG_KEYS = [
+  "OFW_USERNAME",
+  "OFW_PASSWORD",
+  "OFW_INLINE_ATTACHMENTS",
+  "OFW_ATTACHMENTS_DIR",
+  "OFW_WRITE_MODE"
+];
+function clearBlankInjectedEnv(env = process.env, keys = USER_CONFIG_KEYS) {
+  for (const key of keys) {
+    const value = env[key];
+    if (value === void 0) continue;
+    if (value.trim() === "" || value.includes("${")) {
+      delete env[key];
+    }
+  }
+}
+
 // src/client.ts
+clearBlankInjectedEnv();
 var __dirname = dirname(fileURLToPath(import.meta.url));
 await loadDotenvSafely({ path: join4(__dirname, "..", ".env") });
 function parseContentDispositionFilename(cd) {
@@ -39783,7 +39806,7 @@ process.emit = function(event, ...args) {
 };
 await runMcp({
   name: "ofw",
-  version: "2.4.0",
+  version: "2.4.1",
   // x-release-please-version
   deps: client,
   tools: [

package/dist/client.js

@@ -4,7 +4,13 @@ import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
 import { resolveAuth } from './auth.js';
 import { parseBoolEnv } from './config.js';
+import { clearBlankInjectedEnv } from './env-bootstrap.js';
 import { BASE_URL, OFW_PROTOCOL_HEADERS, OFW_TOKEN_TTL_MS, OFW_TOKEN_EXPIRY_SKEW_MS } from './protocol.js';
+// When the plugin runs via a host that maps creds from optional
+// `${user_config.*}` fields, an unset field can be injected as a blank /
+// placeholder env value. Clear those first so the next step's .env (and the
+// shell env) can still populate them — a filled field keeps its real value.
+clearBlankInjectedEnv();
 // Load .env for local dev; silently skip if dotenv is unavailable (e.g. mcpb
 // bundle). loadDotenvSafely applies override:false + quiet:true and swallows a
 // missing dotenv module, matching the prior inline try/catch exactly.

package/dist/env-bootstrap.js

@@ -0,0 +1,28 @@
+// Credentials + config the plugin's .mcp.json maps from `${user_config.*}`.
+// These are the keys whose host-injected values we sanity-check before
+// loading .env.
+export const USER_CONFIG_KEYS = [
+    'OFW_USERNAME',
+    'OFW_PASSWORD',
+    'OFW_INLINE_ATTACHMENTS',
+    'OFW_ATTACHMENTS_DIR',
+    'OFW_WRITE_MODE',
+];
+// A host that maps an UNSET optional `${user_config.x}` into the server env
+// may inject the key as an empty string or the literal, unexpanded
+// "${user_config.x}". Either one SHADOWS the user's `.env`/shell value,
+// because the server loads .env with dotenv `override:false` (it won't
+// replace a key that's already present). Clearing those blanks first lets the
+// `.env`/shell credential path keep working when the Connectors field is left
+// empty — while a real, user-provided value is left untouched (so the desktop
+// userConfig path still wins when set).
+export function clearBlankInjectedEnv(env = process.env, keys = USER_CONFIG_KEYS) {
+    for (const key of keys) {
+        const value = env[key];
+        if (value === undefined)
+            continue;
+        if (value.trim() === '' || value.includes('${')) {
+            delete env[key];
+        }
+    }
+}

package/dist/index.js

@@ -24,7 +24,7 @@ import { registerJournalTools } from './tools/journal.js';
 // always succeeds before any credential check runs.
 await runMcp({
     name: 'ofw',
-    version: '2.4.0', // x-release-please-version
+    version: '2.4.1', // x-release-please-version
     deps: client,
     tools: [
         registerUserTools,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ofw-mcp",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "license": "MIT",
   "mcpName": "io.github.chrischall/ofw-mcp",
   "description": "OurFamilyWizard MCP server for Claude — developed and maintained by AI (Claude Code)",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/chrischall/ofw-mcp",
     "source": "github"
   },
-  "version": "2.4.0",
+  "version": "2.4.1",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "ofw-mcp",
-      "version": "2.4.0",
+      "version": "2.4.1",
       "transport": {
         "type": "stdio"
       },