@compilr-dev/sdk 0.10.33 → 0.10.34

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/interactive-flow-tool.js

@@ -706,7 +706,29 @@ export function createInteractiveFlowTool(handler) {
         inputSchema: INTERACTIVE_FLOW_INPUT_SCHEMA,
         execute: async (input) => {
             try {
-                const validation = validateFlow(input.flow);
+                // Defensive — some providers (Gemini Flash via OpenAI compat,
+                // etc.) ship complex object arguments as JSON-stringified strings
+                // rather than parsed objects. The agents library does the outer
+                // parse but doesn't recurse into nested values. Parse here so the
+                // validator sees the proper object shape. Same quirk hit by
+                // ask_user.questions and propose_alternatives.alternatives —
+                // fixed at the CLI display layer for those, but here it must
+                // happen pre-validation since the validator rejects strings.
+                let flow = input.flow;
+                if (typeof flow === 'string') {
+                    try {
+                        flow = JSON.parse(flow);
+                    }
+                    catch {
+                        return {
+                            success: false,
+                            error: 'Interactive flow validation failed:\n' +
+                                "[INVALID_NODE_TYPE] Flow must be an object — received a string that wasn't valid JSON. " +
+                                'Pass the flow as a parsed object, not as a JSON-stringified string.',
+                        };
+                    }
+                }
+                const validation = validateFlow(flow);
                 if (!validation.ok) {
                     const summary = validation.errors
                         .map((e) => `[${e.code}]${e.nodeId ? ` (node '${e.nodeId}')` : ''} ${e.message}`)
@@ -716,7 +738,11 @@ export function createInteractiveFlowTool(handler) {
                         error: `Interactive flow validation failed:\n${summary}`,
                     };
                 }
-                const result = await handler(input);
+                // Validation passed → flow is a well-formed Flow. Hand it to the
+                // handler with the (possibly-parsed) value so the host gets an
+                // object too.
+                const normalisedInput = { flow: flow };
+                const result = await handler(normalisedInput);
                 if (validation.warnings.length > 0) {
                     result.warnings = [...(result.warnings ?? []), ...validation.warnings];
                 }

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.34",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",