@compilr-dev/agents 0.3.21 → 0.3.22

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/package.json

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