@fidacy/mcp 0.1.15 → 0.1.17

package/CHANGELOG.md

@@ -3,6 +3,26 @@
 All notable changes to `@fidacy/mcp` are documented here. This project follows
 semantic versioning.
 
+## 0.1.17 — 2026-07-03
+
+- Config HOT-RELOAD: editing `~/.fidacy/config.json` (payees, caps) takes effect
+  on the next call, no host restart. Spend and invoice-dedup state is rebuilt
+  from the audit log on reload, so a reload never weakens the firewall.
+- The `payee_not_in_allowlist` DENY now tells the agent exactly how to allow a
+  trusted payee (friction fix from a clean-room install test).
+
+## 0.1.16 — 2026-07-03
+
+- `anchor_artifact`/`check_artifact`: new kind `conversation` — anchor chatbot
+  session digests produced by `@fidacy/session` (conversation receipts).
+
+## 0.1.15 — 2026-07-03
+
+- New tools: `anchor_artifact` and `check_artifact` — Bitcoin-anchored integrity
+  proof for any artifact (contracts, invoices, prescriptions, claims, images,
+  audio, video). The file is hashed locally and never uploaded; only the SHA-256
+  joins the tamper-evident audit chain. Signed JWS receipt verifies offline.
+
 ## 0.1.4
 
 ### Fixed

package/dist/core.js

@@ -1,3 +1,6 @@
+// src/core.ts
+import { statSync } from "node:fs";
+
 // ../firewall/dist/util.js
 function stableStringify(obj) {
   if (obj === null || typeof obj !== "object")
@@ -189,6 +192,19 @@ var DevFidacyCore = class {
       this.spent += r.amount;
     }
   }
+  /**
+   * Swap the active mandate (shell config hot-reload: edit config.json, the next
+   * call picks it up, no host restart). Decision state is REBUILT from the audit
+   * log under the new window/currency, so a reload can never reset the BEC
+   * invoice dedup or undercount spend: a paid invoice stays paid, spent is
+   * recomputed.
+   */
+  setMandate(m) {
+    this.mandate = m;
+    this.spent = 0;
+    this.claimedInvoices.clear();
+    this.rehydrate();
+  }
   async getMandate() {
     return this.mandate;
   }
@@ -423,7 +439,7 @@ function resolveMandateRules(cfg) {
 }
 
 // src/telemetry.ts
-var CLIENT_VERSION = true ? "0.1.15" : "dev";
+var CLIENT_VERSION = true ? "0.1.17" : "dev";
 var currentShell = "mcp";
 function telemetryEnabled() {
   const v = (process.env.FIDACY_DISABLE_TELEMETRY ?? "").trim().toLowerCase();
@@ -525,11 +541,32 @@ function makeCore() {
     if (!url || !key) throw new Error("FIDACY_MODE=http requires FIDACY_API_URL and FIDACY_API_KEY");
     return new HttpFidacyCore(url, key, process.env.FIDACY_PUBLIC_KEY_PEM ?? "");
   }
-  return new DevFidacyCore({
+  const dev = new DevFidacyCore({
     mandate: buildMandate(),
     auditLogPath: auditLogPath(),
     onDecision: (d) => recordDecision(d.status, d.violatedRule)
   });
+  const mtimeOf = () => statSync(configPath(), { throwIfNoEntry: false })?.mtimeMs ?? 0;
+  let seenMtime = mtimeOf();
+  const maybeReload = () => {
+    const m = mtimeOf();
+    if (m !== seenMtime) {
+      seenMtime = m;
+      dev.setMandate(buildMandate());
+    }
+  };
+  return {
+    getMandate: () => {
+      maybeReload();
+      return dev.getMandate();
+    },
+    decide: (req, subject) => {
+      maybeReload();
+      return dev.decide(req, subject);
+    },
+    getProof: (decisionId) => dev.getProof(decisionId),
+    publicKey: () => dev.publicKey()
+  };
 }
 export {
   makeCore

package/dist/index.js

@@ -5,6 +5,9 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 
+// src/core.ts
+import { statSync } from "node:fs";
+
 // ../firewall/dist/util.js
 function stableStringify(obj) {
   if (obj === null || typeof obj !== "object")
@@ -196,6 +199,19 @@ var DevFidacyCore = class {
       this.spent += r.amount;
     }
   }
+  /**
+   * Swap the active mandate (shell config hot-reload: edit config.json, the next
+   * call picks it up, no host restart). Decision state is REBUILT from the audit
+   * log under the new window/currency, so a reload can never reset the BEC
+   * invoice dedup or undercount spend: a paid invoice stays paid, spent is
+   * recomputed.
+   */
+  setMandate(m) {
+    this.mandate = m;
+    this.spent = 0;
+    this.claimedInvoices.clear();
+    this.rehydrate();
+  }
   async getMandate() {
     return this.mandate;
   }
@@ -452,7 +468,7 @@ function resolveMandateRules(cfg) {
 }
 
 // src/telemetry.ts
-var CLIENT_VERSION = true ? "0.1.15" : "dev";
+var CLIENT_VERSION = true ? "0.1.17" : "dev";
 var currentShell = "mcp";
 function telemetryEnabled() {
   const v = (process.env.FIDACY_DISABLE_TELEMETRY ?? "").trim().toLowerCase();
@@ -557,11 +573,32 @@ function makeCore() {
     if (!url || !key) throw new Error("FIDACY_MODE=http requires FIDACY_API_URL and FIDACY_API_KEY");
     return new HttpFidacyCore(url, key, process.env.FIDACY_PUBLIC_KEY_PEM ?? "");
   }
-  return new DevFidacyCore({
+  const dev = new DevFidacyCore({
     mandate: buildMandate(),
     auditLogPath: auditLogPath(),
     onDecision: (d) => recordDecision(d.status, d.violatedRule)
   });
+  const mtimeOf = () => statSync(configPath(), { throwIfNoEntry: false })?.mtimeMs ?? 0;
+  let seenMtime = mtimeOf();
+  const maybeReload = () => {
+    const m = mtimeOf();
+    if (m !== seenMtime) {
+      seenMtime = m;
+      dev.setMandate(buildMandate());
+    }
+  };
+  return {
+    getMandate: () => {
+      maybeReload();
+      return dev.getMandate();
+    },
+    decide: (req, subject2) => {
+      maybeReload();
+      return dev.decide(req, subject2);
+    },
+    getProof: (decisionId) => dev.getProof(decisionId),
+    publicKey: () => dev.publicKey()
+  };
 }
 
 // src/assess.ts
@@ -693,6 +730,7 @@ var ARTIFACT_KINDS = [
   "image",
   "audio",
   "video",
+  "conversation",
   "custom"
 ];
 async function hashFile(path) {
@@ -745,7 +783,7 @@ async function findArtifacts(sha2562, cfg) {
 }
 
 // src/provision.ts
-var CLIENT_VERSION2 = true ? "0.1.15" : "dev";
+var CLIENT_VERSION2 = true ? "0.1.17" : "dev";
 function provisionEnabled() {
   const v = (process.env.FIDACY_DISABLE_PROVISION ?? "").trim().toLowerCase();
   return !(v === "1" || v === "true" || v === "yes");
@@ -845,7 +883,7 @@ function weekOneBootNudge(upgradeToolName) {
 var state = ensureState();
 var core = makeCore();
 var subject = process.env.FIDACY_SUBJECT ?? "agent:demo";
-var SERVER_VERSION = true ? "0.1.15" : "dev";
+var SERVER_VERSION = true ? "0.1.17" : "dev";
 var server = new McpServer({ name: "fidacy", version: SERVER_VERSION });
 server.registerTool(
   "request_payment",
@@ -876,7 +914,7 @@ server.registerTool(
     const d = await core.decide(req, subject);
     const out = { status: d.status, decisionId: d.decisionId, grant: d.grant, violatedRule: d.violatedRule };
     const base = d.status === "ALLOW" ? `ALLOW (decision ${d.decisionId})${req.invoiceRef ? ` for invoice ${req.invoiceRef}` : ""}. To settle, call execute_payment with the SAME payee, amount, currency, and idempotencyKey, and set "grant" to EXACTLY this signed value:
-${d.grant}` : `DENY (decision ${d.decisionId}). Rule violated: ${d.violatedRule}. No grant issued, this payment cannot proceed. The denial itself is recorded in the tamper-evident, hash-chained audit: call get_audit_proof with decisionId ${d.decisionId} for the proof of what was blocked.`;
+${d.grant}` : `DENY (decision ${d.decisionId}). Rule violated: ${d.violatedRule}. No grant issued, this payment cannot proceed. The denial itself is recorded in the tamper-evident, hash-chained audit: call get_audit_proof with decisionId ${d.decisionId} for the proof of what was blocked.${d.violatedRule?.startsWith("payee_not_in_allowlist") ? ` If the user trusts this payee, add "${req.payee}" to mandate.payees in ~/.fidacy/config.json and retry: the firewall picks the change up on the next call, no restart needed.` : ""}`;
     const nudge = decisionNudge(d.status, d.violatedRule, "upgrade");
     const human = nudge ? `${base} ${nudge}` : base;
     return { content: [{ type: "text", text: human }], structuredContent: out };

package/dist/lib.js

@@ -230,6 +230,19 @@ var DevFidacyCore = class {
       this.spent += r.amount;
     }
   }
+  /**
+   * Swap the active mandate (shell config hot-reload: edit config.json, the next
+   * call picks it up, no host restart). Decision state is REBUILT from the audit
+   * log under the new window/currency, so a reload can never reset the BEC
+   * invoice dedup or undercount spend: a paid invoice stays paid, spent is
+   * recomputed.
+   */
+  setMandate(m) {
+    this.mandate = m;
+    this.spent = 0;
+    this.claimedInvoices.clear();
+    this.rehydrate();
+  }
   async getMandate() {
     return this.mandate;
   }
@@ -490,6 +503,9 @@ var GrantEnforcingExecutor = class {
   }
 };
 
+// src/core.ts
+import { statSync } from "node:fs";
+
 // src/config.ts
 import { randomUUID as randomUUID3 } from "node:crypto";
 import { homedir } from "node:os";
@@ -571,7 +587,7 @@ function resolveMandateRules(cfg) {
 }
 
 // src/telemetry.ts
-var CLIENT_VERSION = true ? "0.1.15" : "dev";
+var CLIENT_VERSION = true ? "0.1.17" : "dev";
 var currentShell = "mcp";
 function setTelemetryShell(shell) {
   currentShell = shell;
@@ -679,11 +695,32 @@ function makeCore() {
     if (!url || !key) throw new Error("FIDACY_MODE=http requires FIDACY_API_URL and FIDACY_API_KEY");
     return new HttpFidacyCore(url, key, process.env.FIDACY_PUBLIC_KEY_PEM ?? "");
   }
-  return new DevFidacyCore({
+  const dev = new DevFidacyCore({
     mandate: buildMandate(),
     auditLogPath: auditLogPath(),
     onDecision: (d) => recordDecision(d.status, d.violatedRule)
   });
+  const mtimeOf = () => statSync(configPath(), { throwIfNoEntry: false })?.mtimeMs ?? 0;
+  let seenMtime = mtimeOf();
+  const maybeReload = () => {
+    const m = mtimeOf();
+    if (m !== seenMtime) {
+      seenMtime = m;
+      dev.setMandate(buildMandate());
+    }
+  };
+  return {
+    getMandate: () => {
+      maybeReload();
+      return dev.getMandate();
+    },
+    decide: (req, subject) => {
+      maybeReload();
+      return dev.decide(req, subject);
+    },
+    getProof: (decisionId) => dev.getProof(decisionId),
+    publicKey: () => dev.publicKey()
+  };
 }
 
 // src/upgrade.ts
@@ -699,7 +736,7 @@ function requestUpgrade() {
 }
 
 // src/provision.ts
-var CLIENT_VERSION2 = true ? "0.1.15" : "dev";
+var CLIENT_VERSION2 = true ? "0.1.17" : "dev";
 function provisionEnabled() {
   const v = (process.env.FIDACY_DISABLE_PROVISION ?? "").trim().toLowerCase();
   return !(v === "1" || v === "true" || v === "yes");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fidacy/mcp",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Fidacy action firewall for AI agents. Mandate-gated payment authorization as an MCP server.",
   "license": "Apache-2.0",
   "homepage": "https://fidacy.com",