@openephemeris/mcp-server 4.3.0 → 4.3.1

package/CHANGELOG.md

@@ -7,6 +7,39 @@ Version numbering follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [4.3.1] — 2026-07-29
+
+Two rendering fixes surfaced by the Phase-0 v4.3 audit, plus a companion
+server-side fix that unblocks the tool this release advertised.
+
+### Fixed
+
+- **`account_usage` no longer tells unlimited-plan customers they have "0 remaining".**
+  A service-tier row reports `included_units = -1` (the sentinel for unlimited);
+  the tool rendered it literally as *"Credits: 993 used of -1 included — 0 remaining
+  (0% used)"* — three mutually contradictory statements about the same quota, and
+  the "0 remaining" reading a paid customer as cut off. Unlimited plans now render
+  as *"Credits: 993 used · unlimited plan"* with no synthesized percentage.
+  NEW-11 from the audit.
+- **Companion:** `ephemeris_house_cusps` accepts the `timezone` companion the
+  4.3.0 schema advertised. The Go server rejected the field at the JSON decode
+  layer with *"unknown field provided in DateTimeInput"*, so an agent following
+  OE's own naive-datetime error message hit a second error. Fixed server-side
+  in [`openephemeris/openephemeris#466`](https://github.com/openephemeris/openephemeris/pull/466)
+  (no MCP change) — the schema, generated struct, and handler were all correct;
+  only the bespoke JSON decoder's allowlist was out of sync. NEW-10 from the
+  audit.
+
+### Added
+
+- **`account_usage` now prints a `Server version` line.** External audits and
+  eval runs could not previously attribute a score to a specific published
+  build — the version is set in `serverInfo.version` on `initialize` but was
+  not surfaced anywhere a human-readable tool response could echo. NEW-9 from
+  the audit.
+
+---
+
 ## [4.3.0] — 2026-07-29
 
 The bodygraph iframes get the same view toggle across every mode (natal, transit,

package/dist/tools/specialized/account.js

@@ -1,4 +1,4 @@
-import { registerTool } from "../index.js";
+import { registerTool, SERVER_VERSION } from "../index.js";
 import { getActiveClient, BackendError, DASHBOARD_ACCOUNT_URL, LOGIN_SIGNUP_URL, UPGRADE_URL, WALLET_TOPUP_URL, } from "../../backend/client.js";
 import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 // Tiers where the primary next step is a wallet top-up rather than a plan change.
@@ -63,6 +63,10 @@ registerTool({
         const period = row.month || args?.month || new Date().toISOString().substring(0, 7);
         const used = row.total_units ?? 0;
         const included = row.included_units ?? 0;
+        // `included_units < 0` is a sentinel for unlimited (service/enterprise plans).
+        // Rendering it literally as "0 remaining (0% used)" tells a paid customer they
+        // are cut off — the exact opposite of the truth. NEW-11 from the audit.
+        const unlimited = included < 0;
         const remaining = Math.max(included - used, 0);
         const percent = row.percent_units_used ?? (included > 0 ? Math.round((used / included) * 1000) / 10 : 0);
         const totalCalls = row.total_calls ?? 0;
@@ -71,7 +75,9 @@ registerTool({
             ``,
             `- **Plan:** ${tier}`,
             `- **Period:** ${period}`,
-            `- **Credits:** ${used.toLocaleString()} used of ${included.toLocaleString()} included — **${remaining.toLocaleString()} remaining** (${percent}% used)`,
+            unlimited
+                ? `- **Credits:** ${used.toLocaleString()} used · unlimited plan`
+                : `- **Credits:** ${used.toLocaleString()} used of ${included.toLocaleString()} included — **${remaining.toLocaleString()} remaining** (${percent}% used)`,
             `- **Total API calls:** ${totalCalls.toLocaleString()}`,
         ];
         if ((row.overage_units ?? 0) > 0) {
@@ -86,6 +92,10 @@ registerTool({
                 lines.push(`- **Renews:** ${renewal.toISOString().substring(0, 10)}`);
             }
         }
+        // Verifiable build identifier so external evals can attribute every score to
+        // a specific published version rather than trusting the tester's word.
+        // NEW-9 from the audit.
+        lines.push(`- **Server version:** ${SERVER_VERSION}`);
         lines.push(``);
         if (WALLET_TIERS.has(tier)) {
             lines.push(`**Need more credits?** Top up your wallet at ${WALLET_TOPUP_URL} (from $5), ` +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openephemeris/mcp-server",
-  "version": "4.3.0",
+  "version": "4.3.1",
   "description": "Model Context Protocol server for the Open Ephemeris astronomical computation API",
   "type": "module",
   "main": "dist/index.js",