@vincemakes/kiso-core 0.47.3 → 0.48.0

package/dist/tools/validate.d.ts

@@ -7,5 +7,8 @@
  * hand-rolling a draft-07 subset — is how schemas silently stop meaning
  * what they say. Validators are compiled once per schema and cached.
  */
-/** Returns a human-readable failure reason, or null when the input is valid. */
+/** Returns a human-readable failure reason, or null when the input is valid.
+ *  K15a: a refused undeclared argument is named — the model's own field,
+ *  JSON-quoted and cut at 96 characters — so the call is fixable; no other
+ *  validator detail reaches the model (an enum's values stay unlisted). */
 export declare function validateArgs(schema: Readonly<Record<string, unknown>>, input: unknown): string | null;

package/dist/tools/validate.js

@@ -10,7 +10,10 @@
 import { Ajv } from "ajv";
 const ajv = new Ajv({ strict: false });
 const cache = new WeakMap();
-/** Returns a human-readable failure reason, or null when the input is valid. */
+/** Returns a human-readable failure reason, or null when the input is valid.
+ *  K15a: a refused undeclared argument is named — the model's own field,
+ *  JSON-quoted and cut at 96 characters — so the call is fixable; no other
+ *  validator detail reaches the model (an enum's values stay unlisted). */
 export function validateArgs(schema, input) {
     let validate = cache.get(schema);
     if (!validate) {
@@ -22,7 +25,9 @@ export function validateArgs(schema, input) {
     const first = validate.errors?.[0];
     if (first) {
         const where = first.instancePath || "/";
-        return `${where} ${first.message ?? "is invalid"}`;
+        const extra = first.keyword === "additionalProperties" ? String(first.params.additionalProperty) : undefined;
+        const named = extra === undefined ? "" : `: ${JSON.stringify(extra.length > 96 ? `${extra.slice(0, 96)}…` : extra)}`;
+        return `${where} ${first.message ?? "is invalid"}${named}`;
     }
     return "arguments failed schema validation";
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-core",
-	"version": "0.47.3",
+	"version": "0.48.0",
 	"description": "kiso core \u2014 protocol, event log, loop, hooks, modes, permissions, compaction, delivery truth. The 2,000-line kernel at the bottom of the kiso framework.",
 	"type": "module",
 	"license": "MIT",
@@ -33,7 +33,7 @@
 		"openai"
 	],
 	"devDependencies": {
-		"@vincemakes/kiso-evals": "0.47.3",
+		"@vincemakes/kiso-evals": "0.48.0",
 		"@types/node": "^26.1.2",
 		"typescript": "^5.7.2",
 		"vitest": "^3.0.0"