@ethisyscore/core-utils 1.148.0 → 1.149.1

package/dist/chunk-3ZLUSRKU.cjs

@@ -0,0 +1,49 @@
+'use strict';
+
+// src/wire/enum.ts
+var NUMERIC_KEY = /^-?\d+$/;
+var lookups = /* @__PURE__ */ new WeakMap();
+function lookupFor(members) {
+  const cached = lookups.get(members);
+  if (cached) {
+    return cached;
+  }
+  const byOrdinal = /* @__PURE__ */ new Map();
+  const byLowerName = /* @__PURE__ */ new Map();
+  for (const [name, ordinal] of Object.entries(members)) {
+    if (NUMERIC_KEY.test(name) || typeof ordinal !== "number") {
+      continue;
+    }
+    byOrdinal.set(ordinal, name);
+    byLowerName.set(name.toLowerCase(), name);
+  }
+  const lookup = { byOrdinal, byLowerName };
+  lookups.set(members, lookup);
+  return lookup;
+}
+function decodeWireEnumName(members, value) {
+  const lookup = lookupFor(members);
+  if (typeof value === "number") {
+    return lookup.byOrdinal.get(value);
+  }
+  if (typeof value === "string") {
+    return lookup.byLowerName.get(value.toLowerCase());
+  }
+  return void 0;
+}
+function decodeWireEnum(members, value) {
+  const name = decodeWireEnumName(members, value);
+  if (name === void 0) {
+    return void 0;
+  }
+  const ordinal = members[name];
+  return isWireEnumValue(members, ordinal) ? ordinal : void 0;
+}
+function isWireEnumValue(_members, value) {
+  return typeof value === "number";
+}
+
+exports.decodeWireEnum = decodeWireEnum;
+exports.decodeWireEnumName = decodeWireEnumName;
+//# sourceMappingURL=chunk-3ZLUSRKU.cjs.map
+//# sourceMappingURL=chunk-3ZLUSRKU.cjs.map

package/dist/chunk-3ZLUSRKU.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/wire/enum.ts"],"names":[],"mappings":";;;AAqBA,IAAM,WAAA,GAAc,SAAA;AAEpB,IAAM,OAAA,uBAAc,OAAA,EAAyC;AAE7D,SAAS,UAAU,OAAA,EAA0C;AAC3D,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,GAAA,CAAI,OAAO,CAAA;AAClC,EAAA,IAAI,MAAA,EAAQ;AACV,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAoB;AAC1C,EAAA,MAAM,WAAA,uBAAkB,GAAA,EAAoB;AAC5C,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,OAAO,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AAErD,IAAA,IAAI,YAAY,IAAA,CAAK,IAAI,CAAA,IAAK,OAAO,YAAY,QAAA,EAAU;AACzD,MAAA;AAAA,IACF;AAEA,IAAA,SAAA,CAAU,GAAA,CAAI,SAAS,IAAI,CAAA;AAC3B,IAAA,WAAA,CAAY,GAAA,CAAI,IAAA,CAAK,WAAA,EAAY,EAAG,IAAI,CAAA;AAAA,EAC1C;AAEA,EAAA,MAAM,MAAA,GAAS,EAAE,SAAA,EAAW,WAAA,EAAY;AACxC,EAAA,OAAA,CAAQ,GAAA,CAAI,SAAS,MAAM,CAAA;AAC3B,EAAA,OAAO,MAAA;AACT;AAgBO,SAAS,kBAAA,CACd,SACA,KAAA,EAC6B;AAC7B,EAAA,MAAM,MAAA,GAAS,UAAU,OAAO,CAAA;AAChC,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,OAAO,MAAA,CAAO,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA;AAAA,EACnC;AAEA,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,OAAO,MAAA,CAAO,WAAA,CAAY,GAAA,CAAI,KAAA,CAAM,aAAa,CAAA;AAAA,EACnD;AAEA,EAAA,OAAO,MAAA;AACT;AAYO,SAAS,cAAA,CACd,SACA,KAAA,EAC8B;AAC9B,EAAA,MAAM,IAAA,GAAO,kBAAA,CAAmB,OAAA,EAAS,KAAK,CAAA;AAC9C,EAAA,IAAI,SAAS,MAAA,EAAW;AACtB,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,MAAM,OAAA,GAAmB,QAAQ,IAAI,CAAA;AACrC,EAAA,OAAO,eAAA,CAAgB,OAAA,EAAS,OAAO,CAAA,GAAI,OAAA,GAAU,MAAA;AACvD;AAEA,SAAS,eAAA,CAA2C,UAAa,KAAA,EAA2C;AAC1G,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA;AAC1B","file":"chunk-3ZLUSRKU.cjs","sourcesContent":["/**\n * The members of a C# enum as the UI mirrors them: member name to ordinal. A `const` object\n * (`{ Hidden: 0, Shown: 2 } as const`) and a TypeScript numeric `enum` both fit.\n */\nexport type WireEnumMembers = Readonly<Record<string, string | number>>;\n\n/**\n * The ordinal values of `T`. For a TypeScript numeric enum this is the enum type itself.\n */\nexport type WireEnumValue<T extends WireEnumMembers> = Extract<T[keyof T], number>;\n\n/**\n * The member names of `T`.\n */\nexport type WireEnumName<T extends WireEnumMembers> = Extract<keyof T, string>;\n\ninterface WireEnumLookup {\n  readonly byOrdinal: ReadonlyMap<number, string>;\n  readonly byLowerName: ReadonlyMap<string, string>;\n}\n\nconst NUMERIC_KEY = /^-?\\d+$/;\n\nconst lookups = new WeakMap<WireEnumMembers, WireEnumLookup>();\n\nfunction lookupFor(members: WireEnumMembers): WireEnumLookup {\n  const cached = lookups.get(members);\n  if (cached) {\n    return cached;\n  }\n\n  const byOrdinal = new Map<number, string>();\n  const byLowerName = new Map<string, string>();\n  for (const [name, ordinal] of Object.entries(members)) {\n    // A TypeScript numeric enum also maps each ordinal back to its name under a numeric key.\n    if (NUMERIC_KEY.test(name) || typeof ordinal !== \"number\") {\n      continue;\n    }\n\n    byOrdinal.set(ordinal, name);\n    byLowerName.set(name.toLowerCase(), name);\n  }\n\n  const lookup = { byOrdinal, byLowerName };\n  lookups.set(members, lookup);\n  return lookup;\n}\n\n/**\n * Decodes an enum value from an MCP tool response to its canonical member name.\n *\n * @remarks\n * Plugin tool responses carry an enum either as its ordinal (the SDK's current output) or as\n * its C# member name (the platform's target form, ethisyscore-protocol#248). A number matches\n * when it is one of the members' ordinals; a string matches a member name in any casing.\n * Anything else, including a numeric string such as `\"2\"`, returns `undefined`, so the caller\n * chooses the fallback.\n *\n * @param members - The C# enum's members as `{ Name: ordinal }`.\n * @param value - The raw wire value.\n * @returns The canonical member name, or `undefined` when nothing matches.\n */\nexport function decodeWireEnumName<const T extends WireEnumMembers>(\n  members: T,\n  value: unknown,\n): WireEnumName<T> | undefined {\n  const lookup = lookupFor(members);\n  if (typeof value === \"number\") {\n    return lookup.byOrdinal.get(value) as WireEnumName<T> | undefined;\n  }\n\n  if (typeof value === \"string\") {\n    return lookup.byLowerName.get(value.toLowerCase()) as WireEnumName<T> | undefined;\n  }\n\n  return undefined;\n}\n\n/**\n * Decodes an enum value from an MCP tool response to its ordinal.\n *\n * @remarks\n * Accepts the same forms as {@link decodeWireEnumName}.\n *\n * @param members - The C# enum's members as `{ Name: ordinal }`.\n * @param value - The raw wire value.\n * @returns The member's ordinal, or `undefined` when nothing matches.\n */\nexport function decodeWireEnum<const T extends WireEnumMembers>(\n  members: T,\n  value: unknown,\n): WireEnumValue<T> | undefined {\n  const name = decodeWireEnumName(members, value);\n  if (name === undefined) {\n    return undefined;\n  }\n\n  const ordinal: unknown = members[name];\n  return isWireEnumValue(members, ordinal) ? ordinal : undefined;\n}\n\nfunction isWireEnumValue<T extends WireEnumMembers>(_members: T, value: unknown): value is WireEnumValue<T> {\n  return typeof value === \"number\";\n}\n"]}

package/dist/chunk-VJKGDUZ2.js

@@ -0,0 +1,46 @@
+// src/wire/enum.ts
+var NUMERIC_KEY = /^-?\d+$/;
+var lookups = /* @__PURE__ */ new WeakMap();
+function lookupFor(members) {
+  const cached = lookups.get(members);
+  if (cached) {
+    return cached;
+  }
+  const byOrdinal = /* @__PURE__ */ new Map();
+  const byLowerName = /* @__PURE__ */ new Map();
+  for (const [name, ordinal] of Object.entries(members)) {
+    if (NUMERIC_KEY.test(name) || typeof ordinal !== "number") {
+      continue;
+    }
+    byOrdinal.set(ordinal, name);
+    byLowerName.set(name.toLowerCase(), name);
+  }
+  const lookup = { byOrdinal, byLowerName };
+  lookups.set(members, lookup);
+  return lookup;
+}
+function decodeWireEnumName(members, value) {
+  const lookup = lookupFor(members);
+  if (typeof value === "number") {
+    return lookup.byOrdinal.get(value);
+  }
+  if (typeof value === "string") {
+    return lookup.byLowerName.get(value.toLowerCase());
+  }
+  return void 0;
+}
+function decodeWireEnum(members, value) {
+  const name = decodeWireEnumName(members, value);
+  if (name === void 0) {
+    return void 0;
+  }
+  const ordinal = members[name];
+  return isWireEnumValue(members, ordinal) ? ordinal : void 0;
+}
+function isWireEnumValue(_members, value) {
+  return typeof value === "number";
+}
+
+export { decodeWireEnum, decodeWireEnumName };
+//# sourceMappingURL=chunk-VJKGDUZ2.js.map
+//# sourceMappingURL=chunk-VJKGDUZ2.js.map

package/dist/chunk-VJKGDUZ2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/wire/enum.ts"],"names":[],"mappings":";AAqBA,IAAM,WAAA,GAAc,SAAA;AAEpB,IAAM,OAAA,uBAAc,OAAA,EAAyC;AAE7D,SAAS,UAAU,OAAA,EAA0C;AAC3D,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,GAAA,CAAI,OAAO,CAAA;AAClC,EAAA,IAAI,MAAA,EAAQ;AACV,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAoB;AAC1C,EAAA,MAAM,WAAA,uBAAkB,GAAA,EAAoB;AAC5C,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,OAAO,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AAErD,IAAA,IAAI,YAAY,IAAA,CAAK,IAAI,CAAA,IAAK,OAAO,YAAY,QAAA,EAAU;AACzD,MAAA;AAAA,IACF;AAEA,IAAA,SAAA,CAAU,GAAA,CAAI,SAAS,IAAI,CAAA;AAC3B,IAAA,WAAA,CAAY,GAAA,CAAI,IAAA,CAAK,WAAA,EAAY,EAAG,IAAI,CAAA;AAAA,EAC1C;AAEA,EAAA,MAAM,MAAA,GAAS,EAAE,SAAA,EAAW,WAAA,EAAY;AACxC,EAAA,OAAA,CAAQ,GAAA,CAAI,SAAS,MAAM,CAAA;AAC3B,EAAA,OAAO,MAAA;AACT;AAgBO,SAAS,kBAAA,CACd,SACA,KAAA,EAC6B;AAC7B,EAAA,MAAM,MAAA,GAAS,UAAU,OAAO,CAAA;AAChC,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,OAAO,MAAA,CAAO,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA;AAAA,EACnC;AAEA,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,OAAO,MAAA,CAAO,WAAA,CAAY,GAAA,CAAI,KAAA,CAAM,aAAa,CAAA;AAAA,EACnD;AAEA,EAAA,OAAO,MAAA;AACT;AAYO,SAAS,cAAA,CACd,SACA,KAAA,EAC8B;AAC9B,EAAA,MAAM,IAAA,GAAO,kBAAA,CAAmB,OAAA,EAAS,KAAK,CAAA;AAC9C,EAAA,IAAI,SAAS,MAAA,EAAW;AACtB,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,MAAM,OAAA,GAAmB,QAAQ,IAAI,CAAA;AACrC,EAAA,OAAO,eAAA,CAAgB,OAAA,EAAS,OAAO,CAAA,GAAI,OAAA,GAAU,MAAA;AACvD;AAEA,SAAS,eAAA,CAA2C,UAAa,KAAA,EAA2C;AAC1G,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA;AAC1B","file":"chunk-VJKGDUZ2.js","sourcesContent":["/**\n * The members of a C# enum as the UI mirrors them: member name to ordinal. A `const` object\n * (`{ Hidden: 0, Shown: 2 } as const`) and a TypeScript numeric `enum` both fit.\n */\nexport type WireEnumMembers = Readonly<Record<string, string | number>>;\n\n/**\n * The ordinal values of `T`. For a TypeScript numeric enum this is the enum type itself.\n */\nexport type WireEnumValue<T extends WireEnumMembers> = Extract<T[keyof T], number>;\n\n/**\n * The member names of `T`.\n */\nexport type WireEnumName<T extends WireEnumMembers> = Extract<keyof T, string>;\n\ninterface WireEnumLookup {\n  readonly byOrdinal: ReadonlyMap<number, string>;\n  readonly byLowerName: ReadonlyMap<string, string>;\n}\n\nconst NUMERIC_KEY = /^-?\\d+$/;\n\nconst lookups = new WeakMap<WireEnumMembers, WireEnumLookup>();\n\nfunction lookupFor(members: WireEnumMembers): WireEnumLookup {\n  const cached = lookups.get(members);\n  if (cached) {\n    return cached;\n  }\n\n  const byOrdinal = new Map<number, string>();\n  const byLowerName = new Map<string, string>();\n  for (const [name, ordinal] of Object.entries(members)) {\n    // A TypeScript numeric enum also maps each ordinal back to its name under a numeric key.\n    if (NUMERIC_KEY.test(name) || typeof ordinal !== \"number\") {\n      continue;\n    }\n\n    byOrdinal.set(ordinal, name);\n    byLowerName.set(name.toLowerCase(), name);\n  }\n\n  const lookup = { byOrdinal, byLowerName };\n  lookups.set(members, lookup);\n  return lookup;\n}\n\n/**\n * Decodes an enum value from an MCP tool response to its canonical member name.\n *\n * @remarks\n * Plugin tool responses carry an enum either as its ordinal (the SDK's current output) or as\n * its C# member name (the platform's target form, ethisyscore-protocol#248). A number matches\n * when it is one of the members' ordinals; a string matches a member name in any casing.\n * Anything else, including a numeric string such as `\"2\"`, returns `undefined`, so the caller\n * chooses the fallback.\n *\n * @param members - The C# enum's members as `{ Name: ordinal }`.\n * @param value - The raw wire value.\n * @returns The canonical member name, or `undefined` when nothing matches.\n */\nexport function decodeWireEnumName<const T extends WireEnumMembers>(\n  members: T,\n  value: unknown,\n): WireEnumName<T> | undefined {\n  const lookup = lookupFor(members);\n  if (typeof value === \"number\") {\n    return lookup.byOrdinal.get(value) as WireEnumName<T> | undefined;\n  }\n\n  if (typeof value === \"string\") {\n    return lookup.byLowerName.get(value.toLowerCase()) as WireEnumName<T> | undefined;\n  }\n\n  return undefined;\n}\n\n/**\n * Decodes an enum value from an MCP tool response to its ordinal.\n *\n * @remarks\n * Accepts the same forms as {@link decodeWireEnumName}.\n *\n * @param members - The C# enum's members as `{ Name: ordinal }`.\n * @param value - The raw wire value.\n * @returns The member's ordinal, or `undefined` when nothing matches.\n */\nexport function decodeWireEnum<const T extends WireEnumMembers>(\n  members: T,\n  value: unknown,\n): WireEnumValue<T> | undefined {\n  const name = decodeWireEnumName(members, value);\n  if (name === undefined) {\n    return undefined;\n  }\n\n  const ordinal: unknown = members[name];\n  return isWireEnumValue(members, ordinal) ? ordinal : undefined;\n}\n\nfunction isWireEnumValue<T extends WireEnumMembers>(_members: T, value: unknown): value is WireEnumValue<T> {\n  return typeof value === \"number\";\n}\n"]}

package/dist/index.cjs

@@ -1,5 +1,6 @@
 'use strict';
 
+var chunk3ZLUSRKU_cjs = require('./chunk-3ZLUSRKU.cjs');
 var chunkLT7I4JVK_cjs = require('./chunk-LT7I4JVK.cjs');
 var chunkYNBKRMK3_cjs = require('./chunk-YNBKRMK3.cjs');
 var chunkP5FSVRZO_cjs = require('./chunk-P5FSVRZO.cjs');
@@ -9,6 +10,14 @@ var chunkRLPXYKSM_cjs = require('./chunk-RLPXYKSM.cjs');
 
 
 
+Object.defineProperty(exports, "decodeWireEnum", {
+  enumerable: true,
+  get: function () { return chunk3ZLUSRKU_cjs.decodeWireEnum; }
+});
+Object.defineProperty(exports, "decodeWireEnumName", {
+  enumerable: true,
+  get: function () { return chunk3ZLUSRKU_cjs.decodeWireEnumName; }
+});
 Object.defineProperty(exports, "computeDateRange", {
   enumerable: true,
   get: function () { return chunkLT7I4JVK_cjs.computeDateRange; }

package/dist/index.d.cts

@@ -3,3 +3,4 @@ export { JsonPatch, JsonPatchOperation, PatchOperation, applyJsonPatch, deepClon
 export { ListEnvelope, unwrapList } from './list/index.cjs';
 export { FormatCompactMoneyOptions, FormatMoneyOptions, MONEY_FALLBACK_CURRENCY, MONEY_FALLBACK_LOCALE, OrgReportingCurrency, formatCompactMoney, formatMoney, getCurrencySymbol, getOrgReportingCurrency, parseMoney, resolveOrgReportingCurrencyCode, setOrgReportingCurrency } from './money/index.cjs';
 export { NUMBER_FALLBACK_LOCALE, formatNumber, formatPercent } from './number/index.cjs';
+export { WireEnumMembers, WireEnumName, WireEnumValue, decodeWireEnum, decodeWireEnumName } from './wire/index.cjs';

package/dist/index.d.ts

@@ -3,3 +3,4 @@ export { JsonPatch, JsonPatchOperation, PatchOperation, applyJsonPatch, deepClon
 export { ListEnvelope, unwrapList } from './list/index.js';
 export { FormatCompactMoneyOptions, FormatMoneyOptions, MONEY_FALLBACK_CURRENCY, MONEY_FALLBACK_LOCALE, OrgReportingCurrency, formatCompactMoney, formatMoney, getCurrencySymbol, getOrgReportingCurrency, parseMoney, resolveOrgReportingCurrencyCode, setOrgReportingCurrency } from './money/index.js';
 export { NUMBER_FALLBACK_LOCALE, formatNumber, formatPercent } from './number/index.js';
+export { WireEnumMembers, WireEnumName, WireEnumValue, decodeWireEnum, decodeWireEnumName } from './wire/index.js';

package/dist/index.js

@@ -1,3 +1,4 @@
+export { decodeWireEnum, decodeWireEnumName } from './chunk-VJKGDUZ2.js';
 export { computeDateRange, currentMonthRangeUtc, dateOnlyToIsoUtc, ensureUtcIso, formatDuration, getCurrentOffsetMinutes, getDateRange, hoursToMilliseconds, isoUtcToLocalDateTimeInput, localDateTimeInputToIsoUtc, millisecondsToHours, nowLocalDateTimeInputValue, timespanToMilliseconds, toHHmm, toHHmmss } from './chunk-GAZLFZEL.js';
 export { AUDIT_DATE_FORMAT, DATE_FORMAT, DAY_DATE_FORMAT, DAY_MONTH_FORMAT, DAY_MONTH_YEAR_FORMAT, DISPLAY_DATETIME_SLASH_FORMAT, DISPLAY_DATE_FORMAT, DISPLAY_DATE_SLASH_FORMAT, DISPLAY_SHORT_DATE_FORMAT, EM_DASH, MS_PER_DAY, MS_PER_HOUR, MS_PER_MINUTE, SHORT_DATETIME_FORMAT, TIME_FORMAT, addDaysToIsoDate, addYearsToIsoDate, daysBetweenIso, formatCompactDateTime, formatDate, formatDateSafe, formatDateWithOrdinal, formatMonthDay, formatShortDate, formatSlashDate, formatTimeAgo, getMonthEndIso, getMonthStartIso, getTodayIsoDate, isDateOnlyString, parseIsoDateLocal, relativeTimePhrase, startOfMonthOffset, toDateOnlyString, toIsoDate, validateDateFormat, validateTimeFormat } from './chunk-TN6DXBVD.js';
 export { applyJsonPatch, deepClone, generateJsonPatch, hasPatches, isNullOrEmpty } from './chunk-OEDAX6WN.js';

package/dist/wire/index.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+var chunk3ZLUSRKU_cjs = require('../chunk-3ZLUSRKU.cjs');
+
+
+
+Object.defineProperty(exports, "decodeWireEnum", {
+  enumerable: true,
+  get: function () { return chunk3ZLUSRKU_cjs.decodeWireEnum; }
+});
+Object.defineProperty(exports, "decodeWireEnumName", {
+  enumerable: true,
+  get: function () { return chunk3ZLUSRKU_cjs.decodeWireEnumName; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/wire/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/wire/index.d.cts

@@ -0,0 +1,41 @@
+/**
+ * The members of a C# enum as the UI mirrors them: member name to ordinal. A `const` object
+ * (`{ Hidden: 0, Shown: 2 } as const`) and a TypeScript numeric `enum` both fit.
+ */
+type WireEnumMembers = Readonly<Record<string, string | number>>;
+/**
+ * The ordinal values of `T`. For a TypeScript numeric enum this is the enum type itself.
+ */
+type WireEnumValue<T extends WireEnumMembers> = Extract<T[keyof T], number>;
+/**
+ * The member names of `T`.
+ */
+type WireEnumName<T extends WireEnumMembers> = Extract<keyof T, string>;
+/**
+ * Decodes an enum value from an MCP tool response to its canonical member name.
+ *
+ * @remarks
+ * Plugin tool responses carry an enum either as its ordinal (the SDK's current output) or as
+ * its C# member name (the platform's target form, ethisyscore-protocol#248). A number matches
+ * when it is one of the members' ordinals; a string matches a member name in any casing.
+ * Anything else, including a numeric string such as `"2"`, returns `undefined`, so the caller
+ * chooses the fallback.
+ *
+ * @param members - The C# enum's members as `{ Name: ordinal }`.
+ * @param value - The raw wire value.
+ * @returns The canonical member name, or `undefined` when nothing matches.
+ */
+declare function decodeWireEnumName<const T extends WireEnumMembers>(members: T, value: unknown): WireEnumName<T> | undefined;
+/**
+ * Decodes an enum value from an MCP tool response to its ordinal.
+ *
+ * @remarks
+ * Accepts the same forms as {@link decodeWireEnumName}.
+ *
+ * @param members - The C# enum's members as `{ Name: ordinal }`.
+ * @param value - The raw wire value.
+ * @returns The member's ordinal, or `undefined` when nothing matches.
+ */
+declare function decodeWireEnum<const T extends WireEnumMembers>(members: T, value: unknown): WireEnumValue<T> | undefined;
+
+export { type WireEnumMembers, type WireEnumName, type WireEnumValue, decodeWireEnum, decodeWireEnumName };

package/dist/wire/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The members of a C# enum as the UI mirrors them: member name to ordinal. A `const` object
+ * (`{ Hidden: 0, Shown: 2 } as const`) and a TypeScript numeric `enum` both fit.
+ */
+type WireEnumMembers = Readonly<Record<string, string | number>>;
+/**
+ * The ordinal values of `T`. For a TypeScript numeric enum this is the enum type itself.
+ */
+type WireEnumValue<T extends WireEnumMembers> = Extract<T[keyof T], number>;
+/**
+ * The member names of `T`.
+ */
+type WireEnumName<T extends WireEnumMembers> = Extract<keyof T, string>;
+/**
+ * Decodes an enum value from an MCP tool response to its canonical member name.
+ *
+ * @remarks
+ * Plugin tool responses carry an enum either as its ordinal (the SDK's current output) or as
+ * its C# member name (the platform's target form, ethisyscore-protocol#248). A number matches
+ * when it is one of the members' ordinals; a string matches a member name in any casing.
+ * Anything else, including a numeric string such as `"2"`, returns `undefined`, so the caller
+ * chooses the fallback.
+ *
+ * @param members - The C# enum's members as `{ Name: ordinal }`.
+ * @param value - The raw wire value.
+ * @returns The canonical member name, or `undefined` when nothing matches.
+ */
+declare function decodeWireEnumName<const T extends WireEnumMembers>(members: T, value: unknown): WireEnumName<T> | undefined;
+/**
+ * Decodes an enum value from an MCP tool response to its ordinal.
+ *
+ * @remarks
+ * Accepts the same forms as {@link decodeWireEnumName}.
+ *
+ * @param members - The C# enum's members as `{ Name: ordinal }`.
+ * @param value - The raw wire value.
+ * @returns The member's ordinal, or `undefined` when nothing matches.
+ */
+declare function decodeWireEnum<const T extends WireEnumMembers>(members: T, value: unknown): WireEnumValue<T> | undefined;
+
+export { type WireEnumMembers, type WireEnumName, type WireEnumValue, decodeWireEnum, decodeWireEnumName };

package/dist/wire/index.js

@@ -0,0 +1,3 @@
+export { decodeWireEnum, decodeWireEnumName } from '../chunk-VJKGDUZ2.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/wire/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ethisyscore/core-utils",
-  "version": "1.148.0",
+  "version": "1.149.1",
   "description": "Framework-agnostic utilities shared by the EthisysCore monolith and plugins: date/time/duration helpers (over date-fns), RFC 6902 JSON Patch generate/apply (over mutative), and list-response envelope normalisation. Pure TypeScript; no React or MUI. The dayjs-backed picker helper lives behind the ./date/dayjs sub-path so the core entry stays dayjs-free.",
   "type": "module",
   "main": "dist/index.cjs",
@@ -46,6 +46,11 @@
       "types": "./dist/number/index.d.ts",
       "import": "./dist/number/index.js",
       "require": "./dist/number/index.cjs"
+    },
+    "./wire": {
+      "types": "./dist/wire/index.d.ts",
+      "import": "./dist/wire/index.js",
+      "require": "./dist/wire/index.cjs"
     }
   },
   "files": [