@jini-ai/core 0.4.6 → 0.4.7

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @jini-ai/core
 
+## 0.4.7 — 2026-10-16
+
+- `requireString`, `requireNumber` and `requireObject` errors list the keys the call actually received and flag unsupported `items[]` batching (a6ac9d7e, c7557838).
+
 ## 0.4.6 — 2026-10-14
 
 - Express 5 accepted: the optional `express` peer is now `^4.21.0 || ^5.0.0` (1442d875), so an Express 5 host no longer hits ERESOLVE.

package/dist/registration-kit.d.ts

@@ -139,6 +139,11 @@ export declare function indexCatalogById<T extends {
 export declare function requireInputRecord(required: {
     input: unknown;
 }, _optional?: Record<string, never>): Record<string, unknown>;
+/**
+ * Reads a required non-empty string, with received-key hints when the field is missing.
+ * @throws {ToolInputError} If the field is missing, empty, or not a string.
+ * @complexity O(k) for k input keys on a missing-field rejection; otherwise O(1).
+ */
 export declare function requireString(required: {
     input: Record<string, unknown>;
     key: string;

package/dist/registration-kit.js

@@ -110,11 +110,33 @@ export function requireInputRecord(required, _optional = {}) {
         throw new ToolInputError({ message: "input must be an object" });
     return candidate.value;
 }
+/**
+ * Builds received-key and unsupported-batching hints for a missing required field.
+ * @complexity O(k) for k input keys.
+ */
+function missingFieldHint(required, _optional = {}) {
+    const { input } = required;
+    // Show names, never values, so a wrong-key or batch call can be corrected without exposing content.
+    const keys = Object.keys(input);
+    let hint = keys.length > 0 ? `; received: ${keys.join(", ")}` : "";
+    if (Array.isArray(input.items)) {
+        hint += "; this tool takes one input per call — items[] batching is not supported here";
+    }
+    return hint;
+}
+/**
+ * Reads a required non-empty string, with received-key hints when the field is missing.
+ * @throws {ToolInputError} If the field is missing, empty, or not a string.
+ * @complexity O(k) for k input keys on a missing-field rejection; otherwise O(1).
+ */
 export function requireString(required, _optional = {}) {
     const { input, key } = required;
     const value = input[key];
     if (typeof value !== "string" || value.length === 0) {
-        throw new ToolInputError({ message: `'${key}' (non-empty string) is required` });
+        let message = `'${key}' (non-empty string) is required`;
+        if (value === undefined)
+            message += missingFieldHint({ input });
+        throw new ToolInputError({ message });
     }
     return value;
 }
@@ -122,7 +144,10 @@ export function requireNumber(requiredArgs, optionalArgs = {}) {
     const { input, key } = requiredArgs;
     const value = input[key];
     if (typeof value !== "number" || !Number.isFinite(value)) {
-        throw new ToolInputError({ message: `'${key}' (number) is required` });
+        let message = `'${key}' (number) is required`;
+        if (value === undefined)
+            message += missingFieldHint({ input });
+        throw new ToolInputError({ message });
     }
     return value;
 }
@@ -131,7 +156,10 @@ export function requireObject(requiredArgs, optionalArgs = {}) {
     const value = input[key];
     const candidate = { value };
     if (!isRecord(candidate) || Array.isArray(candidate.value)) {
-        throw new ToolInputError({ message: `'${key}' (object) is required` });
+        let message = `'${key}' (object) is required`;
+        if (value === undefined)
+            message += missingFieldHint({ input });
+        throw new ToolInputError({ message });
     }
     return candidate.value;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jini-ai/core",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "description": "The Jini kernel: typed DI tokens, pack composition and lifecycle, the tool registry, redaction, and origin/API-token auth primitives. Zero dependencies.",
   "license": "Apache-2.0",
   "repository": {