@bpmsoftwaresolutions/ai-engine-client 1.1.17 → 1.1.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.1.17",
+  "version": "1.1.19",
   "description": "Thin npm client for the AI Engine operator and retrieval APIs",
   "type": "module",
   "main": "./src/index.js",

package/src/index.js

@@ -1,5 +1,5 @@
 const DEFAULT_TIMEOUT_MS = 30000;
-export const AI_ENGINE_CLIENT_VERSION = '1.1.17';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.19';
 export const GOVERNED_MUTATION_REQUIRED_CAPABILITIES = [
   'executeVerifiedMutation',
   'post_mutation_verification',
@@ -2100,8 +2100,14 @@ export class AIEngineClient {
     if (eligibility?.execution_eligible && eligibility?.mutation_allowed) {
       return eligibility;
     }
+    const remediation = cleanText(eligibility?.remediation_command);
+    const verification = cleanText(eligibility?.verification_command);
     throw buildEligibilityError(
-      `Execution eligibility gate blocked mutation${cleanText(body?.requested_mutation_surface) ? ` on ${cleanText(body.requested_mutation_surface)}` : ''}.`,
+      [
+        `Execution eligibility gate blocked mutation${cleanText(body?.requested_mutation_surface) ? ` on ${cleanText(body.requested_mutation_surface)}` : ''}.`,
+        remediation ? `Fix: ${remediation}` : null,
+        verification ? `Then verify: ${verification}` : null,
+      ].filter(Boolean).join(' '),
       {
         required_gate: eligibility?.required_gate || 'execution_eligibility.required_gate',
         execution_eligibility: eligibility ?? null,
@@ -2129,6 +2135,14 @@ export class AIEngineClient {
         throw error;
       }
       return payload;
+    } catch (error) {
+      if (error?.name === 'AbortError') {
+        const timeoutError = new Error(`Request to ${url.pathname} timed out after ${this.timeoutMs}ms.`);
+        timeoutError.code = 'REQUEST_TIMEOUT';
+        timeoutError.status = 0;
+        throw timeoutError;
+      }
+      throw error;
     } finally {
       clearTimeout(timeoutHandle);
     }
@@ -2167,6 +2181,14 @@ export class AIEngineClient {
         fileName: parseContentDispositionFilename(contentDisposition),
         headers: Object.fromEntries(response.headers.entries()),
       };
+    } catch (error) {
+      if (error?.name === 'AbortError') {
+        const timeoutError = new Error(`Request to ${url.pathname} timed out after ${this.timeoutMs}ms.`);
+        timeoutError.code = 'REQUEST_TIMEOUT';
+        timeoutError.status = 0;
+        throw timeoutError;
+      }
+      throw error;
     } finally {
       clearTimeout(timeoutHandle);
     }
@@ -2213,6 +2235,14 @@ export class AIEngineClient {
         contentType,
         fileName: parseContentDispositionFilename(contentDisposition),
       };
+    } catch (error) {
+      if (error?.name === 'AbortError') {
+        const timeoutError = new Error(`Request to ${url.pathname} timed out after ${this.timeoutMs}ms.`);
+        timeoutError.code = 'REQUEST_TIMEOUT';
+        timeoutError.status = 0;
+        throw timeoutError;
+      }
+      throw error;
     } finally {
       clearTimeout(timeoutHandle);
     }