@compilr-dev/agents 0.3.20 → 0.3.22

package/dist/providers/claude.js

@@ -352,7 +352,7 @@ export class ClaudeProvider {
             return new ProviderError('Rate limit exceeded', 'claude', 429, error);
         }
         if (error instanceof Anthropic.AuthenticationError) {
-            return new ProviderError('Authentication failed: Invalid API key', 'claude', 401, error);
+            return new ProviderError(`Authentication failed: Invalid API key. (${error.message})`, 'claude', 401, error);
         }
         if (error instanceof Error) {
             return new ProviderError(error.message, 'claude', undefined, error);

package/dist/providers/fireworks.js

@@ -96,9 +96,9 @@ export class FireworksProvider extends OpenAICompatibleProvider {
         }
         switch (status) {
             case 401:
-                return new ProviderError('Invalid Fireworks AI API key. Check your FIREWORKS_API_KEY.', 'fireworks', 401);
+                return new ProviderError(`Invalid Fireworks AI API key. Check your FIREWORKS_API_KEY. (${message})`, 'fireworks', 401);
             case 403:
-                return new ProviderError('Access denied. Check your Fireworks AI API key permissions.', 'fireworks', 403);
+                return new ProviderError(`Access denied. Check your Fireworks AI API key permissions. (${message})`, 'fireworks', 403);
             case 429:
                 return new ProviderError('Fireworks AI rate limit exceeded. Please wait and try again.', 'fireworks', 429);
             case 500:

package/dist/providers/gemini.js

@@ -93,9 +93,9 @@ export class GeminiProvider extends OpenAICompatibleProvider {
             case 400:
                 return new ProviderError(`Invalid request to Gemini API: ${message}`, 'gemini', 400);
             case 401:
-                return new ProviderError('Invalid Gemini API key. Check your GOOGLE_AI_API_KEY or GEMINI_API_KEY.', 'gemini', 401);
+                return new ProviderError(`Invalid Gemini API key. Check your GOOGLE_AI_API_KEY or GEMINI_API_KEY. (${message})`, 'gemini', 401);
             case 403:
-                return new ProviderError('Access denied to Gemini API. Check your API key permissions.', 'gemini', 403);
+                return new ProviderError(`Access denied to Gemini API. Check your API key permissions. (${message})`, 'gemini', 403);
             case 429:
                 return new ProviderError('Gemini rate limit exceeded. Please wait and try again.', 'gemini', 429);
             case 500:

package/dist/providers/groq.js

@@ -81,9 +81,9 @@ export class GroqProvider extends OpenAICompatibleProvider {
         }
         switch (status) {
             case 401:
-                return new ProviderError('Invalid Groq API key. Check your GROQ_API_KEY.', 'groq', 401);
+                return new ProviderError(`Invalid Groq API key. Check your GROQ_API_KEY. (${message})`, 'groq', 401);
             case 403:
-                return new ProviderError('Access denied. Check your Groq API key permissions.', 'groq', 403);
+                return new ProviderError(`Access denied. Check your Groq API key permissions. (${message})`, 'groq', 403);
             case 429:
                 return new ProviderError('Groq rate limit exceeded. Please wait and try again.', 'groq', 429);
             case 500:

package/dist/providers/openai-compatible.d.ts

@@ -169,6 +169,16 @@ export declare abstract class OpenAICompatibleProvider implements LLMProvider {
      * Convert library messages to OpenAI format
      */
     protected convertMessages(messages: Message[]): OpenAIMessage[];
+    /**
+     * Ensure every assistant tool_call has a matching tool response message.
+     *
+     * OpenAI strictly requires that each tool_call_id in an assistant message
+     * is followed by a tool-role response before the next non-tool message.
+     * This can break after ToolLoopError (partial results) or context
+     * compaction (message reordering). We add synthetic error responses
+     * for any orphaned tool_calls.
+     */
+    protected repairOpenAIToolPairing(messages: OpenAIMessage[]): OpenAIMessage[];
     /**
      * Map library role to OpenAI role
      */

package/dist/providers/openai-compatible.js

@@ -271,7 +271,47 @@ export class OpenAICompatibleProvider {
                 }
             }
         }
-        return result;
+        return this.repairOpenAIToolPairing(result);
+    }
+    /**
+     * Ensure every assistant tool_call has a matching tool response message.
+     *
+     * OpenAI strictly requires that each tool_call_id in an assistant message
+     * is followed by a tool-role response before the next non-tool message.
+     * This can break after ToolLoopError (partial results) or context
+     * compaction (message reordering). We add synthetic error responses
+     * for any orphaned tool_calls.
+     */
+    repairOpenAIToolPairing(messages) {
+        const repaired = [];
+        for (let i = 0; i < messages.length; i++) {
+            const msg = messages[i];
+            repaired.push(msg);
+            // Only check assistant messages with tool_calls
+            if (msg.role !== 'assistant' || !msg.tool_calls || msg.tool_calls.length === 0) {
+                continue;
+            }
+            // Collect expected tool_call_ids
+            const expectedIds = new Set(msg.tool_calls.map((tc) => tc.id));
+            // Push all consecutive tool messages first, tracking which IDs are satisfied
+            while (i + 1 < messages.length && messages[i + 1].role === 'tool') {
+                i++;
+                const toolMsg = messages[i];
+                repaired.push(toolMsg);
+                if (toolMsg.tool_call_id) {
+                    expectedIds.delete(toolMsg.tool_call_id);
+                }
+            }
+            // Add synthetic responses for any missing tool_call_ids
+            for (const missingId of expectedIds) {
+                repaired.push({
+                    role: 'tool',
+                    tool_call_id: missingId,
+                    content: '[Error: Tool execution was interrupted]',
+                });
+            }
+        }
+        return repaired;
     }
     /**
      * Map library role to OpenAI role

package/dist/providers/openai.js

@@ -87,9 +87,9 @@ export class OpenAIProvider extends OpenAICompatibleProvider {
         }
         switch (status) {
             case 401:
-                return new ProviderError('Invalid OpenAI API key. Check your OPENAI_API_KEY.', 'openai', 401);
+                return new ProviderError(`Invalid OpenAI API key. Check your OPENAI_API_KEY. (${message})`, 'openai', 401);
             case 403:
-                return new ProviderError('Access denied. Check your OpenAI API key permissions.', 'openai', 403);
+                return new ProviderError(`Access denied. Check your OpenAI API key permissions. (${message})`, 'openai', 403);
             case 429:
                 return new ProviderError('OpenAI rate limit exceeded. Please wait and try again.', 'openai', 429);
             case 500:

package/dist/providers/openrouter.js

@@ -94,9 +94,9 @@ export class OpenRouterProvider extends OpenAICompatibleProvider {
         }
         switch (status) {
             case 401:
-                return new ProviderError('Invalid OpenRouter API key. Check your OPENROUTER_API_KEY.', 'openrouter', 401);
+                return new ProviderError(`Invalid OpenRouter API key. Check your OPENROUTER_API_KEY. (${message})`, 'openrouter', 401);
             case 403:
-                return new ProviderError('Access denied. Check your OpenRouter API key permissions or credits.', 'openrouter', 403);
+                return new ProviderError(`Access denied. Check your OpenRouter API key permissions or credits. (${message})`, 'openrouter', 403);
             case 429:
                 return new ProviderError('OpenRouter rate limit exceeded. Please wait and try again.', 'openrouter', 429);
             case 500:

package/dist/providers/perplexity.js

@@ -81,9 +81,9 @@ export class PerplexityProvider extends OpenAICompatibleProvider {
         }
         switch (status) {
             case 401:
-                return new ProviderError('Invalid Perplexity API key. Check your PERPLEXITY_API_KEY.', 'perplexity', 401);
+                return new ProviderError(`Invalid Perplexity API key. Check your PERPLEXITY_API_KEY. (${message})`, 'perplexity', 401);
             case 403:
-                return new ProviderError('Access denied. Check your Perplexity API key permissions.', 'perplexity', 403);
+                return new ProviderError(`Access denied. Check your Perplexity API key permissions. (${message})`, 'perplexity', 403);
             case 429:
                 return new ProviderError('Perplexity rate limit exceeded. Please wait and try again.', 'perplexity', 429);
             case 500:

package/dist/providers/together.js

@@ -81,9 +81,9 @@ export class TogetherProvider extends OpenAICompatibleProvider {
         }
         switch (status) {
             case 401:
-                return new ProviderError('Invalid Together AI API key. Check your TOGETHER_API_KEY.', 'together', 401);
+                return new ProviderError(`Invalid Together AI API key. Check your TOGETHER_API_KEY. (${message})`, 'together', 401);
             case 403:
-                return new ProviderError('Access denied. Check your Together AI API key permissions.', 'together', 403);
+                return new ProviderError(`Access denied. Check your Together AI API key permissions. (${message})`, 'together', 403);
             case 429:
                 return new ProviderError('Together AI rate limit exceeded. Please wait and try again.', 'together', 429);
             case 500:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/agents",
-  "version": "0.3.20",
+  "version": "0.3.22",
   "description": "Lightweight multi-LLM agent library for building CLI AI assistants",
   "type": "module",
   "main": "dist/index.js",