@amboras-dev/capability-kit 0.1.0 → 0.2.0

package/README.md

@@ -5,7 +5,8 @@ and the orchestrator (which exposes them as AI tools). One definition per
 merchant action: id, zod input/output, policy and agent text. The kit checks it
 once, converts money at one boundary, answers errors in one shape and emits a
 hashed manifest the other repo re-checks on load. CommonJS + ESM + types; Node >= 20 and
-browsers. No runtime dependencies besides the `zod` peer (`^3.25.76 || ^4.0.0`,
+browsers. One runtime dependency, `@amboras-dev/money` (the storage rule, conversion
+and money view; the kit pins its exact version), and the `zod` peer (`^3.25.76 || ^4.0.0`,
 imported only as `zod/v4`; zod 3.25.0 ships without `dist/` and cannot load `zod/v4`).
 
 ```ts
@@ -83,18 +84,27 @@ count, or a count that is not a non-negative integer.
 - **Major units at every boundary.** `money()` is the only money field type; its
   description is the one unit sentence. Storage is Medusa's: ×1000 for KWD, BHD,
   OMR, TND, JOD, IQD, LYD and ×100 for everything else, zero-decimal codes
-  included. The currency sets are copied from Medusa `src/common/utils/money.ts`;
-  a Medusa parity spec pins `storageScale` to `divisorFor`.
+  included. The rule has one owner, `@amboras-dev/money`: `storageScale`,
+  `fractionDigits`, `toStorageAmount`, `fromStorageAmount` and `moneyView` are thin
+  wrappers over its `storageScale`, `storageDigits`, `fromMajor`, `toMajorNumber` and
+  `/ai` `moneyView`. Codes are validated by the package's `currencyCode`: an unknown
+  code (`ZZZ`) throws `currency_invalid`; retired codes (BGN) still read. A stored
+  amount must be a safe integer.
 - **Excess decimals throw, float noise rounds.** `19.99 × 100 = 1998.999…` stores
   1999 and `0.1 + 0.2` stores 30; `19.999 USD` and `5.5 JPY` throw. The digit
   check reads the number's decimal text, so it holds at any magnitude; amounts
   above 2^46 units of the currency's precision (USD 703 billion) refuse as too large.
 - **`MoneyError` is an `invalid_input` `CapabilityError`** (rules `money_precision`,
-  `money_invalid`, `currency_invalid`). `toStorageAmount(major, currency, field)`
+  `money_invalid`, `currency_invalid`), mapped from the package's `MoneyError` codes
+  (`precision` → `money_precision`; `amount_invalid`, `overflow` → `money_invalid`;
+  `currency_invalid` → `currency_invalid`). `toStorageAmount(major, currency, field)`
   names the field, so an adapter answers 400 with it. A bad `money()` option is
   a `CapabilityDefinitionError` (boot).
 - **Display digits are pinned**, not read from the runtime's ICU data (HUF/IDR
-  differ between Node images).
+  differ between Node images). `moneyView` shows the currency's display digits from
+  the package registry, widened to keep a finer stored value: HUF 435000 is
+  `HUF 4,350` (was `HUF 4,350.00`), HUF 435050 `HUF 4,350.5`, IQD 1500 `IQD 1.5`
+  (was `IQD 1.500`); `amount` is always exact.
 - **Chaining on `money()` is safe; `.describe()` is not.** `money()` adds a
   no-op refinement as a brand. zod copies checks into every clone, so the brand
   survives `.positive()`, `.max()`, `.int()`, `.optional()`, `.nullish()`, even

package/dist/index.cjs

@@ -1,5 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let zod_v4 = require("zod/v4");
+let _amboras_dev_money = require("@amboras-dev/money");
+let _amboras_dev_money_ai = require("@amboras-dev/money/ai");
 //#region src/canonical-json.ts
 function serialize(value, seen) {
 	if (value !== null && typeof value === "object" && typeof value.toJSON === "function") value = value.toJSON();
@@ -197,38 +199,6 @@ function isRole(value) {
 }
 //#endregion
 //#region src/money.ts
-const ZERO_DECIMAL = /* @__PURE__ */ new Set([
-	"JPY",
-	"KRW",
-	"VND",
-	"CLP",
-	"PYG",
-	"XAF",
-	"XOF",
-	"BIF",
-	"DJF",
-	"GNF",
-	"ISK",
-	"KMF",
-	"MGA",
-	"RWF",
-	"UGX",
-	"VUV",
-	"XPF"
-]);
-const THREE_DECIMAL = /* @__PURE__ */ new Set([
-	"KWD",
-	"BHD",
-	"OMR",
-	"TND",
-	"JOD",
-	"IQD",
-	"LYD"
-]);
-/** The one unit sentence every money field carries, for the model and for people. */
-const MONEY_UNIT_SENTENCE = "Amount in normal currency units as the merchant says it (99 means 99.00; 1.5 means 1.50). Never cents or minor units.";
-/** JSON Schema keyword marking a money field. */
-const MONEY_META_KEY = "x-amboras-money";
 /**
 * A bad amount or currency code. It is an `invalid_input` CapabilityError, so an
 * adapter that maps CapabilityError answers 400 with the rule (and the field,
@@ -276,7 +246,7 @@ function money(opts) {
 	const { exclusiveMinimum, max } = opts;
 	if (exclusiveMinimum !== void 0 && !isBound(exclusiveMinimum)) throw new CapabilityDefinitionError("money(): exclusiveMinimum must be a finite number ≥ 0");
 	if (max !== void 0 && (!isBound(max) || max <= (exclusiveMinimum ?? -1))) throw new CapabilityDefinitionError("money(): max must be a finite number ≥ 0 and above exclusiveMinimum");
-	const description = opts.describe ? `${opts.describe.trim()} ${MONEY_UNIT_SENTENCE}` : MONEY_UNIT_SENTENCE;
+	const description = opts.describe ? `${opts.describe.trim()} ${_amboras_dev_money_ai.MONEY_UNIT_SENTENCE}` : _amboras_dev_money_ai.MONEY_UNIT_SENTENCE;
 	let schema = exclusiveMinimum === void 0 ? zod_v4.z.number().min(0) : zod_v4.z.number().gt(exclusiveMinimum);
 	if (max !== void 0) schema = schema.max(max);
 	schema = schema.refine(alwaysValid);
@@ -287,64 +257,82 @@ function money(opts) {
 	});
 	return schema.meta({
 		description,
-		[MONEY_META_KEY]: marker
+		[_amboras_dev_money_ai.MONEY_META_KEY]: marker
 	});
 }
-function normalizeCode(currency) {
-	if (typeof currency !== "string" || !/^[A-Za-z]{3}$/.test(currency)) throw new MoneyError(`Invalid currency code: ${JSON.stringify(currency)}`, "currency_invalid");
-	return currency.toUpperCase();
+const RULE_FOR_CODE = new Map(Object.entries({
+	precision: "money_precision",
+	amount_invalid: "money_invalid",
+	overflow: "money_invalid",
+	parse: "money_invalid",
+	rate_invalid: "money_invalid",
+	wire_refused: "money_invalid",
+	currency_invalid: "currency_invalid",
+	currency_missing: "currency_invalid",
+	currency_mismatch: "currency_invalid",
+	wire_unsupported: "currency_invalid"
+}));
+/** The caller's code as a known currency (`currencyCode` from @amboras-dev/money), or a kit `currency_invalid`. */
+function kitCurrency(currency) {
+	try {
+		return (0, _amboras_dev_money.currencyCode)(currency);
+	} catch (error) {
+		throw toCapabilityMoneyError(error);
+	}
 }
-/** ISO 4217 minor-unit digits: 0 for JPY/KRW/VND…, 3 for KWD/BHD/OMR/TND/JOD/IQD/LYD, else 2 (also for unknown codes). */
+/**
+* Internal: an error from @amboras-dev/money as the kit's MoneyError, keyed by its `code`
+* (not `instanceof`, so a second copy of the package still maps). Anything else (never
+* expected) is `money_invalid`.
+*/
+function toCapabilityMoneyError(error, field) {
+	const code = error?.code;
+	const rule = RULE_FOR_CODE.get(code) ?? "money_invalid";
+	return new MoneyError(error instanceof Error ? error.message : String(error), rule, field);
+}
+/**
+* Storage digits (`storageDigits` in @amboras-dev/money): 0 for JPY/KRW/VND…, 3 for
+* KWD/BHD/OMR/TND/JOD/IQD/LYD, else 2. An unknown code throws `currency_invalid`.
+*/
 function fractionDigits(currency) {
-	const code = normalizeCode(currency);
-	if (ZERO_DECIMAL.has(code)) return 0;
-	if (THREE_DECIMAL.has(code)) return 3;
-	return 2;
+	return (0, _amboras_dev_money.storageDigits)(kitCurrency(currency));
 }
 /**
-* Amboras storage rule: ×1000 for the seven three-decimal codes, ×100 for every
-* other code INCLUDING zero-decimal ones (¥5 is stored as 500). By design; see
-* Medusa `divisorFor`.
+* Amboras storage rule (`storageScale` in @amboras-dev/money): ×1000 for the seven
+* three-decimal codes, ×100 for every other code INCLUDING zero-decimal ones (¥5 is
+* stored as 500). An unknown code throws `currency_invalid`.
 */
 function storageScale(currency) {
-	return THREE_DECIMAL.has(normalizeCode(currency)) ? 1e3 : 100;
-}
-const MAX_UNITS = 2 ** 46;
-/** Decimal places in the shortest text form of `n` (what JSON carries): 19.99 → 2, 1e-7 → 7, 1.5e+21 → 0. */
-function decimalPlaces(n) {
-	const [mantissa, exponent = "0"] = String(Math.abs(n)).split("e");
-	const fraction = mantissa.split(".")[1] ?? "";
-	return Math.max(0, fraction.length - Number(exponent));
+	return (0, _amboras_dev_money.storageScale)(kitCurrency(currency));
 }
 /**
-* Major → stored minor integer. Throws MoneyError (`invalid_input`) when the
-* amount has more fraction digits than the currency allows (19.999 USD, 5.5 JPY),
-* is not finite, or does not fit a safe integer. Pass `field` to name the input
-* field in the error.
-*
-* An amount is accepted when its decimal text has at most the allowed digits
-* (exact at any magnitude), or when it is within float noise of such an amount
-* (0.1 + 0.2 → 0.30). Noise is bounded absolutely, so a real extra digit is never
-* rounded away, however large the amount.
+* Major → stored minor integer: `fromMajor(major, currency).amount` from
+* @amboras-dev/money. Throws MoneyError (`invalid_input`) when the amount has more
+* fraction digits than the currency allows (19.999 USD, 5.5 JPY), is not a finite
+* number, or does not fit (2^46 units of the currency's digits). Float noise is
+* accepted (0.1 + 0.2 → 0.30); a real extra digit never is. Pass `field` to name the
+* input field in the error.
 */
 function toStorageAmount(major, currency, field) {
-	const digits = fractionDigits(currency);
-	const scale = storageScale(currency);
-	const code = currency.toUpperCase();
-	if (typeof major !== "number" || !Number.isFinite(major)) throw new MoneyError(`Amount must be a finite number, got ${String(major)}`, "money_invalid", field);
-	const inDigits = major * 10 ** digits;
-	const whole = Math.round(inDigits);
-	const noise = Math.abs(inDigits - whole);
-	if (!(decimalPlaces(major) <= digits) && noise > Math.min(8 * Number.EPSILON * Math.max(1, Math.abs(inDigits)), 1e-6)) throw new MoneyError(`${major} has more than ${digits} decimal places, the most ${code} allows`, "money_precision", field);
-	const stored = whole * (scale / 10 ** digits);
-	if (Math.abs(whole) > MAX_UNITS || !Number.isSafeInteger(stored)) throw new MoneyError(`${major} ${code} is too large to store`, "money_invalid", field);
-	return stored === 0 ? 0 : stored;
+	const code = kitCurrency(currency);
+	if (typeof major !== "number") throw new MoneyError(`Amount must be a finite number, got ${String(major)}`, "money_invalid", field);
+	try {
+		return (0, _amboras_dev_money.fromMajor)(major, code).amount;
+	} catch (error) {
+		throw toCapabilityMoneyError(error, field);
+	}
 }
-/** Stored minor amount → major units. */
+/**
+* Stored minor amount → major units: `toMajorNumber(money(minor, currency))` from
+* @amboras-dev/money. The stored amount must be a safe integer.
+*/
 function fromStorageAmount(minor, currency) {
-	const scale = storageScale(currency);
-	if (typeof minor !== "number" || !Number.isFinite(minor)) throw new MoneyError(`Stored amount must be a finite number, got ${String(minor)}`, "money_invalid");
-	return minor / scale;
+	const code = kitCurrency(currency);
+	try {
+		return (0, _amboras_dev_money.toMajorNumber)((0, _amboras_dev_money.money)(minor, code));
+	} catch (error) {
+		throw toCapabilityMoneyError(error);
+	}
 }
 /** Output schema for a MoneyView (what `moneyView` returns), for capability outputs. */
 const moneyViewSchema = zod_v4.z.object({
@@ -353,25 +341,18 @@ const moneyViewSchema = zod_v4.z.object({
 	display: zod_v4.z.string().describe("Formatted for people, e.g. \"$19.99\".")
 });
 /**
-* A stored amount as the merchant reads it. Fraction digits are pinned (not left
-* to the runtime's ICU data): ISO digits, widened only to show a stored value
-* that is not a whole minor unit (¥5.5 stays visible).
+* A stored amount as the merchant reads it: `moneyView` from @amboras-dev/money/ai.
+* `amount` is exact; `display` shows the currency's display digits, widened to keep a
+* stored value finer than them (¥5.5 stays visible, HUF 435000 is `HUF 4,350`). An
+* unknown code throws `currency_invalid`.
 */
 function moneyView(minor, currency) {
-	const code = normalizeCode(currency);
-	const amount = fromStorageAmount(minor, code);
-	const digits = fractionDigits(code);
-	const scaleDigits = storageScale(code) === 1e3 ? 3 : 2;
-	return {
-		amount,
-		currency: code,
-		display: new Intl.NumberFormat("en", {
-			style: "currency",
-			currency: code,
-			minimumFractionDigits: digits,
-			maximumFractionDigits: Math.max(digits, scaleDigits)
-		}).format(amount)
-	};
+	const code = kitCurrency(currency);
+	try {
+		return (0, _amboras_dev_money_ai.moneyView)((0, _amboras_dev_money.money)(minor, code));
+	} catch (error) {
+		throw toCapabilityMoneyError(error);
+	}
 }
 //#endregion
 //#region src/json-schema.ts
@@ -389,7 +370,7 @@ function toJsonSchema(schema, io) {
 			const brand = moneyBrandOf(ctx.zodSchema);
 			if (!brand) return;
 			const node = ctx.jsonSchema;
-			node[MONEY_META_KEY] = { ...brand.marker };
+			node[_amboras_dev_money_ai.MONEY_META_KEY] = { ...brand.marker };
 			if (typeof node.description !== "string") node.description = brand.description;
 		}
 	});
@@ -552,11 +533,11 @@ function checkFieldName(id, name, schema) {
 }
 function checkMoneyNode(id, input, node) {
 	const description = node.description;
-	if (typeof description !== "string" || !description.includes("Amount in normal currency units as the merchant says it (99 means 99.00; 1.5 means 1.50). Never cents or minor units.")) fail(id, "a money() field lost its unit sentence; pass money({ ..., describe }) instead of .describe()/.meta()");
-	const marker = node[MONEY_META_KEY];
+	if (typeof description !== "string" || !description.includes(_amboras_dev_money_ai.MONEY_UNIT_SENTENCE)) fail(id, "a money() field lost its unit sentence; pass money({ ..., describe }) instead of .describe()/.meta()");
+	const marker = node[_amboras_dev_money_ai.MONEY_META_KEY];
 	const field = isRecord(marker) ? marker.currencyField : void 0;
 	if (isRecord(marker) && marker.currency === "store" && field === void 0) return;
-	if (typeof field !== "string") fail(id, `a money() field has a malformed ${MONEY_META_KEY} marker`);
+	if (typeof field !== "string") fail(id, `a money() field has a malformed ${_amboras_dev_money_ai.MONEY_META_KEY} marker`);
 	const found = resolveField(input, field);
 	if (found.length === 0) fail(id, `money() currencyField "${field}" is not a field at the input root`);
 	for (const { parent, name } of found) {
@@ -578,7 +559,7 @@ function checkInputSchema(id, input) {
 		const keys = finiteKeys(node);
 		if (keys) for (const name of keys) checkFieldName(id, name, node.additionalProperties);
 		if (node.additionalProperties !== void 0 && node.additionalProperties !== false && !keys || "patternProperties" in node || "propertyNames" in node && !keys) fail(id, "input objects must declare their keys (no z.record with open keys, z.looseObject or .passthrough())");
-		if ("x-amboras-money" in node) checkMoneyNode(id, input, node);
+		if (_amboras_dev_money_ai.MONEY_META_KEY in node) checkMoneyNode(id, input, node);
 	});
 }
 function checkHideFields(id, input, hideFields) {
@@ -1039,8 +1020,8 @@ exports.CapabilityDefinitionError = CapabilityDefinitionError;
 exports.CapabilityError = CapabilityError;
 exports.CapabilityManifestError = CapabilityManifestError;
 exports.IDEMPOTENCY_KEY_PATTERN = IDEMPOTENCY_KEY_PATTERN;
-exports.MONEY_META_KEY = MONEY_META_KEY;
-exports.MONEY_UNIT_SENTENCE = MONEY_UNIT_SENTENCE;
+exports.MONEY_META_KEY = _amboras_dev_money_ai.MONEY_META_KEY;
+exports.MONEY_UNIT_SENTENCE = _amboras_dev_money_ai.MONEY_UNIT_SENTENCE;
 exports.MoneyError = MoneyError;
 exports.ROLE_RANK = ROLE_RANK;
 exports.areaOf = areaOf;

package/dist/index.d.cts

@@ -1,4 +1,5 @@
 import { z } from "zod/v4";
+import { MONEY_META_KEY, MONEY_UNIT_SENTENCE } from "@amboras-dev/money/ai";
 //#region src/canonical-json.d.ts
 /** Sorted keys, no whitespace. Throws on BigInt and circular values; `undefined` at the top serializes as `null`. */
 export declare function canonicalJson(v: unknown): string;
@@ -210,10 +211,6 @@ export declare function emitManifest(defs: readonly AnyCapabilityDefinition[], s
 export declare function parseManifest(json: unknown): CapabilityManifest;
 //#endregion
 //#region src/money.d.ts
-/** The one unit sentence every money field carries, for the model and for people. */
-export declare const MONEY_UNIT_SENTENCE = "Amount in normal currency units as the merchant says it (99 means 99.00; 1.5 means 1.50). Never cents or minor units.";
-/** JSON Schema keyword marking a money field. */
-export declare const MONEY_META_KEY = "x-amboras-money";
 /**
  * A bad amount or currency code. It is an `invalid_input` CapabilityError, so an
  * adapter that maps CapabilityError answers 400 with the rule (and the field,
@@ -250,27 +247,30 @@ type MoneyOptions = MoneyCurrency & {
  * rejects: pass `describe` here instead.
  */
 export declare function money(opts: MoneyOptions): z.ZodNumber;
-/** ISO 4217 minor-unit digits: 0 for JPY/KRW/VND…, 3 for KWD/BHD/OMR/TND/JOD/IQD/LYD, else 2 (also for unknown codes). */
+/**
+ * Storage digits (`storageDigits` in @amboras-dev/money): 0 for JPY/KRW/VND…, 3 for
+ * KWD/BHD/OMR/TND/JOD/IQD/LYD, else 2. An unknown code throws `currency_invalid`.
+ */
 export declare function fractionDigits(currency: string): 0 | 2 | 3;
 /**
- * Amboras storage rule: ×1000 for the seven three-decimal codes, ×100 for every
- * other code INCLUDING zero-decimal ones (¥5 is stored as 500). By design; see
- * Medusa `divisorFor`.
+ * Amboras storage rule (`storageScale` in @amboras-dev/money): ×1000 for the seven
+ * three-decimal codes, ×100 for every other code INCLUDING zero-decimal ones (¥5 is
+ * stored as 500). An unknown code throws `currency_invalid`.
  */
 export declare function storageScale(currency: string): 100 | 1000;
 /**
- * Major → stored minor integer. Throws MoneyError (`invalid_input`) when the
- * amount has more fraction digits than the currency allows (19.999 USD, 5.5 JPY),
- * is not finite, or does not fit a safe integer. Pass `field` to name the input
- * field in the error.
- *
- * An amount is accepted when its decimal text has at most the allowed digits
- * (exact at any magnitude), or when it is within float noise of such an amount
- * (0.1 + 0.2 → 0.30). Noise is bounded absolutely, so a real extra digit is never
- * rounded away, however large the amount.
+ * Major → stored minor integer: `fromMajor(major, currency).amount` from
+ * @amboras-dev/money. Throws MoneyError (`invalid_input`) when the amount has more
+ * fraction digits than the currency allows (19.999 USD, 5.5 JPY), is not a finite
+ * number, or does not fit (2^46 units of the currency's digits). Float noise is
+ * accepted (0.1 + 0.2 → 0.30); a real extra digit never is. Pass `field` to name the
+ * input field in the error.
  */
 export declare function toStorageAmount(major: number, currency: string, field?: string): number;
-/** Stored minor amount → major units. */
+/**
+ * Stored minor amount → major units: `toMajorNumber(money(minor, currency))` from
+ * @amboras-dev/money. The stored amount must be a safe integer.
+ */
 export declare function fromStorageAmount(minor: number, currency: string): number;
 interface MoneyView {
   amount: number;
@@ -280,9 +280,10 @@ interface MoneyView {
 /** Output schema for a MoneyView (what `moneyView` returns), for capability outputs. */
 export declare const moneyViewSchema: z.ZodType<MoneyView>;
 /**
- * A stored amount as the merchant reads it. Fraction digits are pinned (not left
- * to the runtime's ICU data): ISO digits, widened only to show a stored value
- * that is not a whole minor unit (¥5.5 stays visible).
+ * A stored amount as the merchant reads it: `moneyView` from @amboras-dev/money/ai.
+ * `amount` is exact; `display` shows the currency's display digits, widened to keep a
+ * stored value finer than them (¥5.5 stays visible, HUF 435000 is `HUF 4,350`). An
+ * unknown code throws `currency_invalid`.
  */
 export declare function moneyView(minor: number, currency: string): MoneyView;
 //#endregion
@@ -310,4 +311,4 @@ export declare function evaluatePolicy(policy: CapabilityPolicy, ctx: Capability
  */
 export declare function confirmationRequired(policy: Pick<CapabilityPolicy, 'confirm'>, records?: number): boolean;
 //#endregion
-export type { Actor, AnyCapabilityDefinition, Area, CapabilityAgentSpec, CapabilityCallContext, CapabilityDefinition, CapabilityErrorBody, CapabilityErrorCode, CapabilityErrorInit, CapabilityId, CapabilityManifest, CapabilityPolicy, FromZodErrorOptions, JsonSchema, ManifestEntry, MoneyCurrency, MoneyOptions, MoneyView, PolicyDecision, PolicyEnforcement, Role, Surface };
+export { type Actor, type AnyCapabilityDefinition, type Area, type CapabilityAgentSpec, type CapabilityCallContext, type CapabilityDefinition, type CapabilityErrorBody, type CapabilityErrorCode, type CapabilityErrorInit, type CapabilityId, type CapabilityManifest, type CapabilityPolicy, type FromZodErrorOptions, type JsonSchema, MONEY_META_KEY, MONEY_UNIT_SENTENCE, type ManifestEntry, type MoneyCurrency, type MoneyOptions, type MoneyView, type PolicyDecision, type PolicyEnforcement, type Role, type Surface };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod/v4";
+import { MONEY_META_KEY, MONEY_UNIT_SENTENCE } from "@amboras-dev/money/ai";
 //#region src/canonical-json.d.ts
 /** Sorted keys, no whitespace. Throws on BigInt and circular values; `undefined` at the top serializes as `null`. */
 export declare function canonicalJson(v: unknown): string;
@@ -210,10 +211,6 @@ export declare function emitManifest(defs: readonly AnyCapabilityDefinition[], s
 export declare function parseManifest(json: unknown): CapabilityManifest;
 //#endregion
 //#region src/money.d.ts
-/** The one unit sentence every money field carries, for the model and for people. */
-export declare const MONEY_UNIT_SENTENCE = "Amount in normal currency units as the merchant says it (99 means 99.00; 1.5 means 1.50). Never cents or minor units.";
-/** JSON Schema keyword marking a money field. */
-export declare const MONEY_META_KEY = "x-amboras-money";
 /**
  * A bad amount or currency code. It is an `invalid_input` CapabilityError, so an
  * adapter that maps CapabilityError answers 400 with the rule (and the field,
@@ -250,27 +247,30 @@ type MoneyOptions = MoneyCurrency & {
  * rejects: pass `describe` here instead.
  */
 export declare function money(opts: MoneyOptions): z.ZodNumber;
-/** ISO 4217 minor-unit digits: 0 for JPY/KRW/VND…, 3 for KWD/BHD/OMR/TND/JOD/IQD/LYD, else 2 (also for unknown codes). */
+/**
+ * Storage digits (`storageDigits` in @amboras-dev/money): 0 for JPY/KRW/VND…, 3 for
+ * KWD/BHD/OMR/TND/JOD/IQD/LYD, else 2. An unknown code throws `currency_invalid`.
+ */
 export declare function fractionDigits(currency: string): 0 | 2 | 3;
 /**
- * Amboras storage rule: ×1000 for the seven three-decimal codes, ×100 for every
- * other code INCLUDING zero-decimal ones (¥5 is stored as 500). By design; see
- * Medusa `divisorFor`.
+ * Amboras storage rule (`storageScale` in @amboras-dev/money): ×1000 for the seven
+ * three-decimal codes, ×100 for every other code INCLUDING zero-decimal ones (¥5 is
+ * stored as 500). An unknown code throws `currency_invalid`.
  */
 export declare function storageScale(currency: string): 100 | 1000;
 /**
- * Major → stored minor integer. Throws MoneyError (`invalid_input`) when the
- * amount has more fraction digits than the currency allows (19.999 USD, 5.5 JPY),
- * is not finite, or does not fit a safe integer. Pass `field` to name the input
- * field in the error.
- *
- * An amount is accepted when its decimal text has at most the allowed digits
- * (exact at any magnitude), or when it is within float noise of such an amount
- * (0.1 + 0.2 → 0.30). Noise is bounded absolutely, so a real extra digit is never
- * rounded away, however large the amount.
+ * Major → stored minor integer: `fromMajor(major, currency).amount` from
+ * @amboras-dev/money. Throws MoneyError (`invalid_input`) when the amount has more
+ * fraction digits than the currency allows (19.999 USD, 5.5 JPY), is not a finite
+ * number, or does not fit (2^46 units of the currency's digits). Float noise is
+ * accepted (0.1 + 0.2 → 0.30); a real extra digit never is. Pass `field` to name the
+ * input field in the error.
  */
 export declare function toStorageAmount(major: number, currency: string, field?: string): number;
-/** Stored minor amount → major units. */
+/**
+ * Stored minor amount → major units: `toMajorNumber(money(minor, currency))` from
+ * @amboras-dev/money. The stored amount must be a safe integer.
+ */
 export declare function fromStorageAmount(minor: number, currency: string): number;
 interface MoneyView {
   amount: number;
@@ -280,9 +280,10 @@ interface MoneyView {
 /** Output schema for a MoneyView (what `moneyView` returns), for capability outputs. */
 export declare const moneyViewSchema: z.ZodType<MoneyView>;
 /**
- * A stored amount as the merchant reads it. Fraction digits are pinned (not left
- * to the runtime's ICU data): ISO digits, widened only to show a stored value
- * that is not a whole minor unit (¥5.5 stays visible).
+ * A stored amount as the merchant reads it: `moneyView` from @amboras-dev/money/ai.
+ * `amount` is exact; `display` shows the currency's display digits, widened to keep a
+ * stored value finer than them (¥5.5 stays visible, HUF 435000 is `HUF 4,350`). An
+ * unknown code throws `currency_invalid`.
  */
 export declare function moneyView(minor: number, currency: string): MoneyView;
 //#endregion
@@ -310,4 +311,4 @@ export declare function evaluatePolicy(policy: CapabilityPolicy, ctx: Capability
  */
 export declare function confirmationRequired(policy: Pick<CapabilityPolicy, 'confirm'>, records?: number): boolean;
 //#endregion
-export type { Actor, AnyCapabilityDefinition, Area, CapabilityAgentSpec, CapabilityCallContext, CapabilityDefinition, CapabilityErrorBody, CapabilityErrorCode, CapabilityErrorInit, CapabilityId, CapabilityManifest, CapabilityPolicy, FromZodErrorOptions, JsonSchema, ManifestEntry, MoneyCurrency, MoneyOptions, MoneyView, PolicyDecision, PolicyEnforcement, Role, Surface };
+export { type Actor, type AnyCapabilityDefinition, type Area, type CapabilityAgentSpec, type CapabilityCallContext, type CapabilityDefinition, type CapabilityErrorBody, type CapabilityErrorCode, type CapabilityErrorInit, type CapabilityId, type CapabilityManifest, type CapabilityPolicy, type FromZodErrorOptions, type JsonSchema, MONEY_META_KEY, MONEY_UNIT_SENTENCE, type ManifestEntry, type MoneyCurrency, type MoneyOptions, type MoneyView, type PolicyDecision, type PolicyEnforcement, type Role, type Surface };

package/dist/index.js

@@ -1,4 +1,6 @@
 import { z } from "zod/v4";
+import { currencyCode, fromMajor, money as money$1, storageDigits, storageScale as storageScale$1, toMajorNumber } from "@amboras-dev/money";
+import { MONEY_META_KEY, MONEY_UNIT_SENTENCE, moneyView as moneyView$1 } from "@amboras-dev/money/ai";
 //#region src/canonical-json.ts
 function serialize(value, seen) {
 	if (value !== null && typeof value === "object" && typeof value.toJSON === "function") value = value.toJSON();
@@ -196,38 +198,6 @@ function isRole(value) {
 }
 //#endregion
 //#region src/money.ts
-const ZERO_DECIMAL = /* @__PURE__ */ new Set([
-	"JPY",
-	"KRW",
-	"VND",
-	"CLP",
-	"PYG",
-	"XAF",
-	"XOF",
-	"BIF",
-	"DJF",
-	"GNF",
-	"ISK",
-	"KMF",
-	"MGA",
-	"RWF",
-	"UGX",
-	"VUV",
-	"XPF"
-]);
-const THREE_DECIMAL = /* @__PURE__ */ new Set([
-	"KWD",
-	"BHD",
-	"OMR",
-	"TND",
-	"JOD",
-	"IQD",
-	"LYD"
-]);
-/** The one unit sentence every money field carries, for the model and for people. */
-const MONEY_UNIT_SENTENCE = "Amount in normal currency units as the merchant says it (99 means 99.00; 1.5 means 1.50). Never cents or minor units.";
-/** JSON Schema keyword marking a money field. */
-const MONEY_META_KEY = "x-amboras-money";
 /**
 * A bad amount or currency code. It is an `invalid_input` CapabilityError, so an
 * adapter that maps CapabilityError answers 400 with the rule (and the field,
@@ -289,61 +259,79 @@ function money(opts) {
 		[MONEY_META_KEY]: marker
 	});
 }
-function normalizeCode(currency) {
-	if (typeof currency !== "string" || !/^[A-Za-z]{3}$/.test(currency)) throw new MoneyError(`Invalid currency code: ${JSON.stringify(currency)}`, "currency_invalid");
-	return currency.toUpperCase();
+const RULE_FOR_CODE = new Map(Object.entries({
+	precision: "money_precision",
+	amount_invalid: "money_invalid",
+	overflow: "money_invalid",
+	parse: "money_invalid",
+	rate_invalid: "money_invalid",
+	wire_refused: "money_invalid",
+	currency_invalid: "currency_invalid",
+	currency_missing: "currency_invalid",
+	currency_mismatch: "currency_invalid",
+	wire_unsupported: "currency_invalid"
+}));
+/** The caller's code as a known currency (`currencyCode` from @amboras-dev/money), or a kit `currency_invalid`. */
+function kitCurrency(currency) {
+	try {
+		return currencyCode(currency);
+	} catch (error) {
+		throw toCapabilityMoneyError(error);
+	}
 }
-/** ISO 4217 minor-unit digits: 0 for JPY/KRW/VND…, 3 for KWD/BHD/OMR/TND/JOD/IQD/LYD, else 2 (also for unknown codes). */
+/**
+* Internal: an error from @amboras-dev/money as the kit's MoneyError, keyed by its `code`
+* (not `instanceof`, so a second copy of the package still maps). Anything else (never
+* expected) is `money_invalid`.
+*/
+function toCapabilityMoneyError(error, field) {
+	const code = error?.code;
+	const rule = RULE_FOR_CODE.get(code) ?? "money_invalid";
+	return new MoneyError(error instanceof Error ? error.message : String(error), rule, field);
+}
+/**
+* Storage digits (`storageDigits` in @amboras-dev/money): 0 for JPY/KRW/VND…, 3 for
+* KWD/BHD/OMR/TND/JOD/IQD/LYD, else 2. An unknown code throws `currency_invalid`.
+*/
 function fractionDigits(currency) {
-	const code = normalizeCode(currency);
-	if (ZERO_DECIMAL.has(code)) return 0;
-	if (THREE_DECIMAL.has(code)) return 3;
-	return 2;
+	return storageDigits(kitCurrency(currency));
 }
 /**
-* Amboras storage rule: ×1000 for the seven three-decimal codes, ×100 for every
-* other code INCLUDING zero-decimal ones (¥5 is stored as 500). By design; see
-* Medusa `divisorFor`.
+* Amboras storage rule (`storageScale` in @amboras-dev/money): ×1000 for the seven
+* three-decimal codes, ×100 for every other code INCLUDING zero-decimal ones (¥5 is
+* stored as 500). An unknown code throws `currency_invalid`.
 */
 function storageScale(currency) {
-	return THREE_DECIMAL.has(normalizeCode(currency)) ? 1e3 : 100;
-}
-const MAX_UNITS = 2 ** 46;
-/** Decimal places in the shortest text form of `n` (what JSON carries): 19.99 → 2, 1e-7 → 7, 1.5e+21 → 0. */
-function decimalPlaces(n) {
-	const [mantissa, exponent = "0"] = String(Math.abs(n)).split("e");
-	const fraction = mantissa.split(".")[1] ?? "";
-	return Math.max(0, fraction.length - Number(exponent));
+	return storageScale$1(kitCurrency(currency));
 }
 /**
-* Major → stored minor integer. Throws MoneyError (`invalid_input`) when the
-* amount has more fraction digits than the currency allows (19.999 USD, 5.5 JPY),
-* is not finite, or does not fit a safe integer. Pass `field` to name the input
-* field in the error.
-*
-* An amount is accepted when its decimal text has at most the allowed digits
-* (exact at any magnitude), or when it is within float noise of such an amount
-* (0.1 + 0.2 → 0.30). Noise is bounded absolutely, so a real extra digit is never
-* rounded away, however large the amount.
+* Major → stored minor integer: `fromMajor(major, currency).amount` from
+* @amboras-dev/money. Throws MoneyError (`invalid_input`) when the amount has more
+* fraction digits than the currency allows (19.999 USD, 5.5 JPY), is not a finite
+* number, or does not fit (2^46 units of the currency's digits). Float noise is
+* accepted (0.1 + 0.2 → 0.30); a real extra digit never is. Pass `field` to name the
+* input field in the error.
 */
 function toStorageAmount(major, currency, field) {
-	const digits = fractionDigits(currency);
-	const scale = storageScale(currency);
-	const code = currency.toUpperCase();
-	if (typeof major !== "number" || !Number.isFinite(major)) throw new MoneyError(`Amount must be a finite number, got ${String(major)}`, "money_invalid", field);
-	const inDigits = major * 10 ** digits;
-	const whole = Math.round(inDigits);
-	const noise = Math.abs(inDigits - whole);
-	if (!(decimalPlaces(major) <= digits) && noise > Math.min(8 * Number.EPSILON * Math.max(1, Math.abs(inDigits)), 1e-6)) throw new MoneyError(`${major} has more than ${digits} decimal places, the most ${code} allows`, "money_precision", field);
-	const stored = whole * (scale / 10 ** digits);
-	if (Math.abs(whole) > MAX_UNITS || !Number.isSafeInteger(stored)) throw new MoneyError(`${major} ${code} is too large to store`, "money_invalid", field);
-	return stored === 0 ? 0 : stored;
+	const code = kitCurrency(currency);
+	if (typeof major !== "number") throw new MoneyError(`Amount must be a finite number, got ${String(major)}`, "money_invalid", field);
+	try {
+		return fromMajor(major, code).amount;
+	} catch (error) {
+		throw toCapabilityMoneyError(error, field);
+	}
 }
-/** Stored minor amount → major units. */
+/**
+* Stored minor amount → major units: `toMajorNumber(money(minor, currency))` from
+* @amboras-dev/money. The stored amount must be a safe integer.
+*/
 function fromStorageAmount(minor, currency) {
-	const scale = storageScale(currency);
-	if (typeof minor !== "number" || !Number.isFinite(minor)) throw new MoneyError(`Stored amount must be a finite number, got ${String(minor)}`, "money_invalid");
-	return minor / scale;
+	const code = kitCurrency(currency);
+	try {
+		return toMajorNumber(money$1(minor, code));
+	} catch (error) {
+		throw toCapabilityMoneyError(error);
+	}
 }
 /** Output schema for a MoneyView (what `moneyView` returns), for capability outputs. */
 const moneyViewSchema = z.object({
@@ -352,25 +340,18 @@ const moneyViewSchema = z.object({
 	display: z.string().describe("Formatted for people, e.g. \"$19.99\".")
 });
 /**
-* A stored amount as the merchant reads it. Fraction digits are pinned (not left
-* to the runtime's ICU data): ISO digits, widened only to show a stored value
-* that is not a whole minor unit (¥5.5 stays visible).
+* A stored amount as the merchant reads it: `moneyView` from @amboras-dev/money/ai.
+* `amount` is exact; `display` shows the currency's display digits, widened to keep a
+* stored value finer than them (¥5.5 stays visible, HUF 435000 is `HUF 4,350`). An
+* unknown code throws `currency_invalid`.
 */
 function moneyView(minor, currency) {
-	const code = normalizeCode(currency);
-	const amount = fromStorageAmount(minor, code);
-	const digits = fractionDigits(code);
-	const scaleDigits = storageScale(code) === 1e3 ? 3 : 2;
-	return {
-		amount,
-		currency: code,
-		display: new Intl.NumberFormat("en", {
-			style: "currency",
-			currency: code,
-			minimumFractionDigits: digits,
-			maximumFractionDigits: Math.max(digits, scaleDigits)
-		}).format(amount)
-	};
+	const code = kitCurrency(currency);
+	try {
+		return moneyView$1(money$1(minor, code));
+	} catch (error) {
+		throw toCapabilityMoneyError(error);
+	}
 }
 //#endregion
 //#region src/json-schema.ts
@@ -551,7 +532,7 @@ function checkFieldName(id, name, schema) {
 }
 function checkMoneyNode(id, input, node) {
 	const description = node.description;
-	if (typeof description !== "string" || !description.includes("Amount in normal currency units as the merchant says it (99 means 99.00; 1.5 means 1.50). Never cents or minor units.")) fail(id, "a money() field lost its unit sentence; pass money({ ..., describe }) instead of .describe()/.meta()");
+	if (typeof description !== "string" || !description.includes(MONEY_UNIT_SENTENCE)) fail(id, "a money() field lost its unit sentence; pass money({ ..., describe }) instead of .describe()/.meta()");
 	const marker = node[MONEY_META_KEY];
 	const field = isRecord(marker) ? marker.currencyField : void 0;
 	if (isRecord(marker) && marker.currency === "store" && field === void 0) return;
@@ -577,7 +558,7 @@ function checkInputSchema(id, input) {
 		const keys = finiteKeys(node);
 		if (keys) for (const name of keys) checkFieldName(id, name, node.additionalProperties);
 		if (node.additionalProperties !== void 0 && node.additionalProperties !== false && !keys || "patternProperties" in node || "propertyNames" in node && !keys) fail(id, "input objects must declare their keys (no z.record with open keys, z.looseObject or .passthrough())");
-		if ("x-amboras-money" in node) checkMoneyNode(id, input, node);
+		if (MONEY_META_KEY in node) checkMoneyNode(id, input, node);
 	});
 }
 function checkHideFields(id, input, hideFields) {

package/package.json

@@ -1,57 +1,60 @@
 {
-    "name": "@amboras-dev/capability-kit",
-    "version": "0.1.0",
-    "description": "Capability contract for Amboras: defineCapability, major-unit money, the shared error contract, pure policy evaluation, idempotency helpers and a deterministic manifest. Peer dependency on zod only.",
-    "license": "UNLICENSED",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/Ecomcoder/amboras-core.git",
-        "directory": "packages/capability-kit"
+  "name": "@amboras-dev/capability-kit",
+  "version": "0.2.0",
+  "description": "Capability contract for Amboras: defineCapability, major-unit money (on @amboras-dev/money), the shared error contract, pure policy evaluation, idempotency helpers and a deterministic manifest. Peer dependency on zod.",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ecomcoder/amboras-core.git",
+    "directory": "packages/capability-kit"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
-    "type": "module",
-    "main": "./dist/index.cjs",
-    "module": "./dist/index.js",
-    "types": "./dist/index.d.cts",
-    "exports": {
-        ".": {
-            "import": {
-                "types": "./dist/index.d.ts",
-                "default": "./dist/index.js"
-            },
-            "require": {
-                "types": "./dist/index.d.cts",
-                "default": "./dist/index.cjs"
-            }
-        },
-        "./package.json": "./package.json"
-    },
-    "files": [
-        "dist"
-    ],
-    "sideEffects": false,
-    "engines": {
-        "node": ">=20"
-    },
-    "publishConfig": {
-        "access": "public"
-    },
-    "scripts": {
-        "build": "tsdown",
-        "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json && tsc --noEmit -p tsconfig.zod3.json && tsc --noEmit -p tsconfig.zod40.json",
-        "test": "vitest run --coverage && vitest run --config vitest.zod3.config.ts && vitest run --config vitest.zod40.config.ts"
-    },
-    "peerDependencies": {
-        "zod": "^3.25.76 || ^4.0.0"
-    },
-    "devDependencies": {
-        "@types/node": "22.20.5",
-        "@vitest/coverage-v8": "3.2.7",
-        "fast-check": "4.3.0",
-        "tsdown": "0.23.0",
-        "typescript": "5.9.3",
-        "vitest": "3.2.7",
-        "zod": "4.3.6",
-        "zod3": "npm:zod@3.25.76",
-        "zod40": "npm:zod@4.0.0"
-    }
-}
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@amboras-dev/money": "0.1.0"
+  },
+  "peerDependencies": {
+    "zod": "^3.25.76 || ^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.20.5",
+    "@vitest/coverage-v8": "3.2.7",
+    "fast-check": "4.3.0",
+    "tsdown": "0.23.0",
+    "typescript": "5.9.3",
+    "vitest": "3.2.7",
+    "zod": "4.3.6",
+    "zod3": "npm:zod@3.25.76",
+    "zod40": "npm:zod@4.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json && tsc --noEmit -p tsconfig.zod3.json && tsc --noEmit -p tsconfig.zod40.json",
+    "test": "vitest run --coverage && vitest run --config vitest.zod3.config.ts && vitest run --config vitest.zod40.config.ts"
+  }
+}