@compilr-dev/sdk 0.10.33 → 0.10.35

package/dist/meta-tools/registry.js

@@ -489,6 +489,8 @@ function buildCompactSchema(tool) {
  * Handles common LLM mistakes when calling tools without guided decoding:
  * - Single object where array expected → wraps in array
  * - JSON string where array expected → parses it
+ * - JSON string where object expected → parses it (covers e.g. Gemini Flash
+ *   stringifying complex nested objects like build_interactive_flow.flow)
  */
 function coerceArgs(schema, args) {
     const properties = schema.properties;
@@ -497,27 +499,43 @@ function coerceArgs(schema, args) {
     let changed = false;
     const coerced = { ...args };
     for (const [name, prop] of Object.entries(properties)) {
-        if (prop.type === 'array' && name in coerced && !Array.isArray(coerced[name])) {
-            const value = coerced[name];
-            if (value !== null && value !== undefined) {
-                if (typeof value === 'object') {
-                    // Single object → wrap in array
-                    coerced[name] = [value];
-                    changed = true;
-                }
-                else if (typeof value === 'string') {
-                    // JSON string → try parsing
-                    try {
-                        const parsed = JSON.parse(value);
-                        if (Array.isArray(parsed)) {
-                            coerced[name] = parsed;
-                            changed = true;
-                        }
-                    }
-                    catch {
-                        // Leave as-is, will fail validation
+        if (!(name in coerced))
+            continue;
+        const value = coerced[name];
+        if (value === null || value === undefined)
+            continue;
+        if (prop.type === 'array' && !Array.isArray(value)) {
+            if (typeof value === 'object') {
+                // Single object → wrap in array
+                coerced[name] = [value];
+                changed = true;
+            }
+            else if (typeof value === 'string') {
+                // JSON string → try parsing
+                try {
+                    const parsed = JSON.parse(value);
+                    if (Array.isArray(parsed)) {
+                        coerced[name] = parsed;
+                        changed = true;
                     }
                 }
+                catch {
+                    // Leave as-is, will fail validation
+                }
+            }
+        }
+        else if (prop.type === 'object' && typeof value === 'string') {
+            // JSON-stringified object → try parsing. Some providers (Gemini Flash
+            // via OpenAI compat, etc.) ship deeply-nested object args as strings.
+            try {
+                const parsed = JSON.parse(value);
+                if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                    coerced[name] = parsed;
+                    changed = true;
+                }
+            }
+            catch {
+                // Leave as-is, will fail validation
             }
         }
     }

package/dist/tools/ask-user-tools.js

@@ -86,13 +86,35 @@ export function createAskUserTool(handler) {
         },
         execute: async (input) => {
             try {
-                if (input.questions.length === 0) {
+                // Defensive — some providers (Gemini Flash via OpenAI compat, etc.)
+                // ship nested object arguments as JSON-stringified strings. Parse
+                // before the length check so hosts always see a real array.
+                let questions = input.questions;
+                if (typeof questions === 'string') {
+                    try {
+                        questions = JSON.parse(questions);
+                    }
+                    catch {
+                        return {
+                            success: false,
+                            error: 'questions must be an array (received a non-JSON string)',
+                        };
+                    }
+                }
+                if (!Array.isArray(questions)) {
+                    return { success: false, error: 'questions must be an array' };
+                }
+                if (questions.length === 0) {
                     return { success: false, error: 'At least one question is required' };
                 }
-                if (input.questions.length > 5) {
+                if (questions.length > 5) {
                     return { success: false, error: 'Maximum 5 questions allowed' };
                 }
-                const result = await handler(input);
+                const normalised = {
+                    ...input,
+                    questions: questions,
+                };
+                const result = await handler(normalised);
                 return { success: true, result };
             }
             catch (err) {

package/dist/tools/propose-alternatives-tool.js

@@ -88,13 +88,35 @@ export function createProposeAlternativesTool(handler) {
         },
         execute: async (input) => {
             try {
-                if (input.alternatives.length < 2) {
+                // Defensive — some providers (Gemini Flash via OpenAI compat, etc.)
+                // ship nested object arguments as JSON-stringified strings. Parse
+                // before validation so hosts always see a real array.
+                let alternatives = input.alternatives;
+                if (typeof alternatives === 'string') {
+                    try {
+                        alternatives = JSON.parse(alternatives);
+                    }
+                    catch {
+                        return {
+                            success: false,
+                            error: 'alternatives must be an array (received a non-JSON string)',
+                        };
+                    }
+                }
+                if (!Array.isArray(alternatives)) {
+                    return { success: false, error: 'alternatives must be an array' };
+                }
+                if (alternatives.length < 2) {
                     return { success: false, error: 'At least 2 alternatives are required' };
                 }
-                if (input.alternatives.length > 3) {
+                if (alternatives.length > 3) {
                     return { success: false, error: 'Maximum 3 alternatives allowed' };
                 }
-                const result = await handler(input);
+                const normalised = {
+                    ...input,
+                    alternatives: alternatives,
+                };
+                const result = await handler(normalised);
                 if (result.rejected) {
                     return {
                         success: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.10.33",
+  "version": "0.10.35",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",