@jskit-ai/assistant-core 0.1.143 → 0.1.145

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/assistant-core",
-  "version": "0.1.143",
+  "version": "0.1.145",
   "type": "module",
   "scripts": {
     "test": "node --test"
@@ -11,16 +11,16 @@
     "./shared": "./src/shared/index.js"
   },
   "dependencies": {
-    "@jskit-ai/http-runtime": "0.1.165",
-    "@jskit-ai/kernel": "0.1.167",
-    "@jskit-ai/resource-core": "0.1.109",
-    "@jskit-ai/resource-crud-core": "0.1.109",
+    "@jskit-ai/resource-core": "0.1.111",
+    "@jskit-ai/resource-crud-core": "0.1.111",
     "dompurify": "^3.4.13",
     "json-rest-schema": "^1.0.17",
     "marked": "^17.0.4",
     "openai": "^6.22.0"
   },
   "peerDependencies": {
+    "@jskit-ai/http-runtime": "0.1.167",
+    "@jskit-ai/kernel": "0.1.169",
     "vue": "^3.5.13",
     "vuetify": "^4.0.0"
   },

package/src/server/lib/serviceToolCatalog.js

@@ -384,6 +384,26 @@ function truncateDescription(value, maxLength = 240) {
   return `${description.slice(0, Math.max(1, maxLength - 1))}…`;
 }
 
+function resolveValidationFailureMessage(error) {
+  const baseMessage = normalizeText(error?.message, { fallback: "Validation failed." });
+  if (normalizeText(error?.code).toUpperCase() !== "ACTION_VALIDATION_FAILED") {
+    return baseMessage;
+  }
+
+  const fieldErrors = error?.details?.fieldErrors;
+  if (!fieldErrors || typeof fieldErrors !== "object" || Array.isArray(fieldErrors)) {
+    return baseMessage;
+  }
+
+  const details = Object.entries(fieldErrors)
+    .map(([field, message]) => [normalizeText(field), truncateDescription(message, 300)])
+    .filter(([field, message]) => field && message)
+    .sort(([left], [right]) => left.localeCompare(right))
+    .slice(0, 8)
+    .map(([field, message]) => `${field}: ${message}`);
+  return details.length > 0 ? `${baseMessage} ${details.join(" ")}` : baseMessage;
+}
+
 function canInvokeMethod(permission, context) {
   const permissionSpec = normalizePermissionSpec(permission);
 
@@ -832,7 +852,7 @@ function createServiceToolCatalog(
       ok: false,
       error: {
         code: String(error?.code || "assistant_tool_failed").trim() || "assistant_tool_failed",
-        message: status >= 500 ? "Tool call failed." : String(error?.message || "Tool call failed."),
+        message: status >= 500 ? "Tool call failed." : resolveValidationFailureMessage(error),
         status: Number.isInteger(status) ? status : 500
       }
     };

package/test/serviceToolCatalog.test.js

@@ -216,6 +216,37 @@ test("assistant tools hide workspaceSlug and overwrite model values with trusted
   assert.equal(executed.context.channel, "automation");
 });
 
+test("assistant tools expose safe field-level input guidance to the model", async () => {
+  const actions = createActions([action({
+    input: schema({
+      include: {
+        type: "string",
+        required: false,
+        messages: {
+          default: "include expects a comma-separated string such as \"pet,service\"."
+        }
+      }
+    })
+  })]);
+  const catalog = createServiceToolCatalog(actions);
+  const context = { actor: { id: "7" }, surface: "admin" };
+  const toolSet = catalog.resolveToolSet(context);
+
+  assert.deepEqual(await catalog.executeToolCall({
+    toolName: toolSet.tools[0].name,
+    argumentsText: JSON.stringify({ include: ["pet"] }),
+    context,
+    toolSet
+  }), {
+    ok: false,
+    error: {
+      code: "ACTION_VALIDATION_FAILED",
+      message: "Validation failed. include: include expects a comma-separated string such as \"pet,service\".",
+      status: 400
+    }
+  });
+});
+
 test("large authorized catalogs use compact paged discovery, exact contracts, and gated execution", async () => {
   const executions = [];
   const workspaceInput = schema({