@absolutejs/ai 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -6,6 +6,12 @@ This file is generated by `absolute-changelog` from the entries in
 `changelog/`. Edit an entry, not this file — and add new ones under
 `changelog/unreleased/`.
 
+## 0.3.2 — 2026-10-01
+
+### Fixed
+
+- **Give structured-output repair bounded field diagnostics for TypeBox and Zod validation failures; expose StructuredOutputError with attempts, cause and accumulated usage when repair is exhausted.** (`generateObjectAI`, `StructuredOutputError`)
+
 ## 0.3.1 — 2026-09-29
 
 ### Fixed

package/changelog.json

@@ -2,6 +2,20 @@
 	"contract": 1,
 	"name": "@absolutejs/ai",
 	"releases": [
+		{
+			"changes": [
+				{
+					"kind": "fixed",
+					"summary": "Give structured-output repair bounded field diagnostics for TypeBox and Zod validation failures; expose StructuredOutputError with attempts, cause and accumulated usage when repair is exhausted.",
+					"symbols": [
+						"generateObjectAI",
+						"StructuredOutputError"
+					]
+				}
+			],
+			"date": "2026-10-01",
+			"version": "0.3.2"
+		},
 		{
 			"changes": [
 				{

package/dist/ai/index.js

@@ -4124,6 +4124,37 @@ var openrouterMessages = (config2) => {
   return withOpenRouterPolicy(provider, allowedModels, allowedPresets);
 };
 
+// src/ai/structuredOutputError.ts
+var record = (value) => typeof value === "object" && value !== null;
+var structuredOutputDiagnostics = (error) => {
+  const source = record(error) && record(error.cause) ? error.cause : error;
+  const issues = record(source) ? source.errors ?? source.issues : undefined;
+  if (Array.isArray(issues)) {
+    const details = issues.slice(0, 10).filter(record).map((issue) => {
+      const path = typeof issue.instancePath === "string" ? issue.instancePath : Array.isArray(issue.path) ? issue.path.join(".") : "/";
+      const expected = record(issue.params) ? issue.params.type : issue.expected;
+      const message = typeof expected === "string" ? `must be ${expected}` : typeof issue.keyword === "string" ? `failed ${issue.keyword} validation` : typeof issue.code === "string" ? `failed ${issue.code} validation` : "does not satisfy the schema";
+      return `${path.slice(0, 160) || "/"}: ${message.slice(0, 160)}`;
+    });
+    if (details.length)
+      return details.join("; ").slice(0, 1500);
+  }
+  return (error instanceof Error ? error.message : "Output does not satisfy the schema").slice(0, 1500);
+};
+
+class StructuredOutputError extends Error {
+  reason;
+  attempts;
+  usage;
+  code = "AI_STRUCTURED_OUTPUT_INVALID";
+  constructor(reason, attempts, usage, cause) {
+    super(`Structured AI output failed after ${attempts} attempt(s): ${structuredOutputDiagnostics(cause)}`, { cause });
+    this.reason = reason;
+    this.attempts = attempts;
+    this.usage = usage;
+    this.name = "StructuredOutputError";
+  }
+}
 // src/plugins/aiChat.ts
 import { Elysia } from "elysia";
 import { websocket } from "elysia/websocket";
@@ -5901,7 +5932,10 @@ var generateObjectAI = async (options) => {
   const messages = [...options.messages];
   let usage;
   let lastError;
+  let reason = "missing_tool";
+  let attempts = 0;
   for (let attempt = 0;attempt <= maxRepairAttempts; attempt += 1) {
+    attempts += 1;
     const result = await generateAI({
       contextPolicy: options.contextPolicy,
       cacheSystemPrompt: options.cacheSystemPrompt,
@@ -5925,14 +5959,16 @@ var generateObjectAI = async (options) => {
     let failure;
     let object;
     if (!call) {
+      reason = "missing_tool";
       lastError = new Error(`generateObjectAI: model did not call the "${toolName}" tool`);
       failure = `You did not call the "${toolName}" tool. Call it exactly once with the structured result.`;
     } else {
       try {
         object = options.validate ? options.validate(call.input) : call.input;
       } catch (error) {
+        reason = "validation";
         lastError = error;
-        failure = `Your "${toolName}" output failed validation: ${error instanceof Error ? error.message : String(error)}. Call "${toolName}" again with corrected output that satisfies the schema.`;
+        failure = `Your "${toolName}" output failed validation: ${structuredOutputDiagnostics(error)}. Call "${toolName}" again with corrected output that satisfies the schema.`;
       }
     }
     if (failure === undefined)
@@ -5953,7 +5989,7 @@ var generateObjectAI = async (options) => {
     } else
       messages.push({ content: failure, role: "user" });
   }
-  throw lastError instanceof Error ? lastError : new Error(`generateObjectAI: failed to produce valid output`);
+  throw new StructuredOutputError(reason, attempts, usage, lastError);
 };
 
 // src/ai/streamAIWithTools.ts
@@ -8395,7 +8431,7 @@ var AVAILABLE_COMPONENT_STATUSES = new Set([
 ]);
 var AVAILABLE_PAGE_INDICATORS = new Set(["none", "minor"]);
 var isRecord7 = (value) => typeof value === "object" && value !== null;
-var readString = (record, key) => typeof record[key] === "string" ? record[key] : "";
+var readString = (record2, key) => typeof record2[key] === "string" ? record2[key] : "";
 var findComponentStatus = (body, componentName) => {
   if (!isRecord7(body) || !Array.isArray(body.components))
     return null;
@@ -8697,7 +8733,7 @@ var boundary = (text, offset) => {
   const next = text.charCodeAt(offset);
   return code >= 55296 && code <= 56319 && next >= 56320 && next <= 57343 ? offset - 1 : offset;
 };
-var record = (value) => value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
+var record2 = (value) => value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
 var createAITextSource = (messages) => {
   const sources = messages.map((message, index) => {
     if (typeof message.content !== "string")
@@ -8764,7 +8800,7 @@ var createAITextSource = (messages) => {
         additionalProperties: false
       },
       handler: (input) => {
-        const value = record(input);
+        const value = record2(input);
         if (typeof value.query !== "string")
           return "Provide a text query.";
         return JSON.stringify({
@@ -8787,7 +8823,7 @@ var createAITextSource = (messages) => {
         additionalProperties: false
       },
       handler: (input) => {
-        const value = record(input);
+        const value = record2(input);
         if (typeof value.sourceId !== "string" || typeof value.start !== "number")
           return "Provide a source ID and start offset.";
         return JSON.stringify({
@@ -8872,6 +8908,7 @@ export {
   PROVIDER_STATUS_PAGES,
   ProviderError,
   STAT_TILES_MAX,
+  StructuredOutputError,
   TABLE_MAX_COLUMNS,
   TABLE_MAX_ROWS,
   UI_ACTIONS_MAX,
@@ -8960,5 +8997,5 @@ export {
   xai
 };
 
-//# debugId=76B9C09CA62B3EF264756E2164756E21
+//# debugId=420F3EDB38FAC4DB64756E2164756E21
 //# sourceMappingURL=index.js.map