@frigear-nu/mcp 0.0.3 → 0.0.5

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@frigear-nu/mcp",
   "configKey": "mcpModules",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "builder": {
     "@nuxt/module-builder": "1.0.3",
     "unbuild": "unknown"

package/dist/module.mjs

@@ -1,9 +1,11 @@
 import { defineNuxtModule, createResolver, addServerImportsDir, addServerPlugin } from '@nuxt/kit';
+import { inlineModuleRuntime } from '@frigear-nu/module-kit/utils';
 export { addMcpDefinitions } from '../dist/runtime/utils/build.js';
 
 const DEFAULT_INSTRUCTIONS = [
   "You act as the signed-in user, limited to the scopes of the API token in use. You only see the tools that token and the user are allowed to use.",
   'Personal data of other people (names, emails, form answers) is withheld unless the token carries the matching "*:pii" scope. Responses say when something was withheld; report that to the user instead of looking for another way to get it.',
+  'All monetary values, in tool inputs and outputs, are in whole currency units next to a currency code: 52.2 with "USD" means 52.20 US dollars, never cents. Currencies without decimals (JPY) are whole numbers.',
   "Some settings are deliberately not available here, for example where form submissions are delivered, because changing them could be used to exfiltrate data. When a tool refuses for that reason, tell the user to make the change in the admin UI."
 ].join("\n");
 const module$1 = defineNuxtModule({
@@ -27,6 +29,7 @@ const module$1 = defineNuxtModule({
       instructions: host.mcp?.instructions ?? DEFAULT_INSTRUCTIONS
     };
     addServerImportsDir(resolver.resolve("./runtime/server/utils"));
+    inlineModuleRuntime(nuxt, resolver);
     addServerPlugin(resolver.resolve("./runtime/server/plugins/mcp"));
   }
 });

package/dist/runtime/utils/index.d.ts

@@ -2,3 +2,4 @@ export { addMcpDefinitions } from './build.js';
 export type { McpDefinitionKind } from './build.js';
 export { SCOPED_META_KEY, isPrincipalAllowed, pick, piiNotice, redactPii, scopeTags } from './access.js';
 export type { RedactOptions, ScopedAccess } from './access.js';
+export { MONEY_NOTICE, currencyDigits, fieldsFromCents, fromCents, toCents } from './money.js';

package/dist/runtime/utils/index.js

@@ -1,2 +1,3 @@
 export { addMcpDefinitions } from "./build.js";
 export { SCOPED_META_KEY, isPrincipalAllowed, pick, piiNotice, redactPii, scopeTags } from "./access.js";
+export { MONEY_NOTICE, currencyDigits, fieldsFromCents, fromCents, toCents } from "./money.js";

package/dist/runtime/utils/money.d.ts

@@ -0,0 +1,11 @@
+/** Standing sentence for descriptions and `describe()` texts of money fields. */
+export declare const MONEY_NOTICE = "Whole currency units, not cents: 52.2 means 52.20 of the currency (JPY has no decimals).";
+/** The number of minor-unit digits of a currency (2 for EUR, 0 for JPY, 3 for KWD). */
+export declare function currencyDigits(currency: string): number;
+/** Minor units (cents) to the major-unit number agents see, e.g. `fromCents(5220, 'USD')` -> `52.2`. */
+export declare function fromCents(amount: number, currency: string): number;
+export declare function fromCents(amount: number | null | undefined, currency: string): number | null;
+/** A major-unit number from an agent to whole minor units (cents), e.g. `toCents(52.2, 'USD')` -> `5220`. */
+export declare function toCents(value: number, currency: string): number;
+/** Returns a copy of `row` with its `fields` converted from minor to major units. */
+export declare function fieldsFromCents<T extends Record<string, unknown>>(row: T, fields: Array<keyof T & string>, currency: string): T;

package/dist/runtime/utils/money.js

@@ -0,0 +1,24 @@
+export const MONEY_NOTICE = "Whole currency units, not cents: 52.2 means 52.20 of the currency (JPY has no decimals).";
+export function currencyDigits(currency) {
+  try {
+    return new Intl.NumberFormat("en", { style: "currency", currency: currency.toUpperCase() }).resolvedOptions().maximumFractionDigits ?? 2;
+  } catch {
+    return 2;
+  }
+}
+export function fromCents(amount, currency) {
+  if (amount === null || amount === void 0) return null;
+  return Number((amount / 10 ** currencyDigits(currency)).toFixed(currencyDigits(currency)));
+}
+export function toCents(value, currency) {
+  if (!Number.isFinite(value)) throw new TypeError("Amount must be a finite number.");
+  return Math.round(value * 10 ** currencyDigits(currency));
+}
+export function fieldsFromCents(row, fields, currency) {
+  const out = { ...row };
+  for (const field of fields) {
+    const value = out[field];
+    if (typeof value === "number") out[field] = fromCents(value, currency);
+  }
+  return out;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frigear-nu/mcp",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Scoped, PII-safe MCP tools for the frigear ecosystem: modules contribute tools, resources and prompts that are only listed and callable within the scopes the caller holds.",
   "homepage": "https://docs.frigear.dev/modules/mcp",
   "repository": {
@@ -30,8 +30,8 @@
     "playground"
   ],
   "dependencies": {
-    "@frigear-nu/auth": "0.0.3",
-    "@frigear-nu/module-kit": "0.1.7",
+    "@frigear-nu/auth": "0.0.5",
+    "@frigear-nu/module-kit": "1.0.1",
     "@nuxt/kit": "^4.6.0",
     "@nuxtjs/mcp-toolkit": "^0.24.1",
     "agents": "^0.28.0",