@superblocksteam/vite-plugin-file-sync 2.0.59-next.1 → 2.0.59-next.3

package/dist/ai-service/agent/tools/apis/build-api-artifact.js

@@ -0,0 +1,313 @@
+import yaml from "yaml";
+import { extractInputsWithTypesFromApi, } from "../../../../binding-extraction/extract-identifiers.js";
+import { getErrorMeta, getLogger, getPrefixedLogger, } from "../../../../util/logger.js";
+import { Paths } from "../../../const.js";
+import { ApiBuilderTypeScriptError } from "../../../transform/api-builder/shared.js";
+import { ApiBuilderToYamlTransformer } from "../../../transform/api-builder/to-yaml-transformer.js";
+import { applyFileTransformations, renderPath, } from "../../../transform/shared.js";
+import { safeJsonStringify } from "../../../util/safe-stringify.js";
+import { apiStaticAnalysis } from "../../subagents/apis/static-analysis.js";
+import { readApiSource } from "./api-source.js";
+/**
+ * Integration output type definitions.
+ * Source of truth for what each integration returns.
+ */
+const INTEGRATION_OUTPUT_TYPES = {
+    // SQL Databases - return arrays of rows directly
+    postgres: "any[]",
+    postgresql: "any[]",
+    mysql: "any[]",
+    mariadb: "any[]",
+    mssql: "any[]",
+    snowflake: "any[]",
+    redshift: "any[]",
+    bigquery: "any[]",
+    databricks: "any[]",
+    athena: "any[]",
+    // NoSQL Databases
+    mongodb: "any[]",
+    dynamodb: "{ Items?: any[]; Count?: number; ScannedCount?: number }",
+    cosmosdb: "{ resources: any[]; headers: Record<string, string> }",
+    // REST APIs
+    restapiintegration: "{ data: any; status: number; headers: Record<string, string> }",
+    openapi: "{ data: any; status: number; headers: Record<string, string> }",
+    // GraphQL
+    graphql: "{ data: any; errors?: any[] }",
+    // JavaScript/Python
+    javascript: "any",
+    python: "any",
+    // Messaging
+    kafka: "{ success: boolean; partition?: number; offset?: string }",
+    email: "{ success: boolean; messageId?: string }",
+    // Other
+    redis: "any",
+    s3: "{ ETag?: string; Location?: string; Key?: string; Bucket?: string }",
+};
+/**
+ * Get the output type for a specific block.
+ * Control flow blocks return their last child's output.
+ */
+function getBlockOutputType(block) {
+    // Handle control flow blocks
+    if (block.condition) {
+        // Conditional returns the output of whichever branch executes
+        // For type purposes, we need to handle all possible branches
+        const types = [];
+        if (block.condition.if?.blocks?.length > 0) {
+            const lastIfBlock = block.condition.if.blocks[block.condition.if.blocks.length - 1];
+            types.push(getBlockOutputType(lastIfBlock));
+        }
+        block.condition.elif?.forEach((elif) => {
+            if (elif.blocks?.length > 0) {
+                const lastElifBlock = elif.blocks[elif.blocks.length - 1];
+                types.push(getBlockOutputType(lastElifBlock));
+            }
+        });
+        if (block.condition.else?.blocks?.length > 0) {
+            const lastElseBlock = block.condition.else.blocks[block.condition.else.blocks.length - 1];
+            types.push(getBlockOutputType(lastElseBlock));
+        }
+        // If all branches have the same type, use that; otherwise union
+        const uniqueTypes = [...new Set(types)];
+        if (uniqueTypes.length === 0)
+            return "void";
+        if (uniqueTypes.length === 1)
+            return uniqueTypes[0] || "void";
+        return uniqueTypes.join(" | ");
+    }
+    if (block.loop) {
+        // Loop returns array of outputs from last block in loop body
+        if (block.loop.blocks?.length > 0) {
+            const lastLoopBlock = block.loop.blocks[block.loop.blocks.length - 1];
+            const itemType = getBlockOutputType(lastLoopBlock);
+            return `Array<${itemType}>`;
+        }
+        return "any[]";
+    }
+    if (block.trycatch) {
+        // TryCatch returns output of try block (or catch if try fails)
+        const types = [];
+        if (block.trycatch.try?.blocks?.length > 0) {
+            const lastTryBlock = block.trycatch.try.blocks[block.trycatch.try.blocks.length - 1];
+            types.push(getBlockOutputType(lastTryBlock));
+        }
+        if (block.trycatch.catch?.blocks?.length > 0) {
+            const lastCatchBlock = block.trycatch.catch.blocks[block.trycatch.catch.blocks.length - 1];
+            types.push(getBlockOutputType(lastCatchBlock));
+        }
+        const uniqueTypes = [...new Set(types)];
+        if (uniqueTypes.length === 0)
+            return "void";
+        if (uniqueTypes.length === 1)
+            return uniqueTypes[0] || "void";
+        return uniqueTypes.join(" | ");
+    }
+    // Handle step blocks (integrations)
+    if (block.step) {
+        const integration = block.step.integration;
+        // Map integration ID to type
+        if (integration === "javascript" || integration === "python") {
+            // For code blocks, try to infer from return statement if possible
+            // For now, default to any
+            return "any";
+        }
+        // Check if it's a database integration ID (UUID format)
+        if (/^[0-9a-f-]{36}$/i.test(integration)) {
+            // This is likely a database integration
+            // We need to check what type it is from the block config
+            if (block.step.postgres || block.step.postgresql) {
+                return INTEGRATION_OUTPUT_TYPES.postgresql || "any[]";
+            }
+            if (block.step.mysql) {
+                return INTEGRATION_OUTPUT_TYPES.mysql || "any[]";
+            }
+            if (block.step.snowflake) {
+                return INTEGRATION_OUTPUT_TYPES.snowflake || "any[]";
+            }
+            // Default for unknown database - returns array of rows
+            return "any[]";
+        }
+        // Look up in our type map
+        return INTEGRATION_OUTPUT_TYPES[integration.toLowerCase()] || "any";
+    }
+    // Handle other block types
+    if (block.return) {
+        return "any"; // Return block output is whatever data it returns
+    }
+    if (block.throw) {
+        return "never"; // Throw block never returns normally
+    }
+    return "void";
+}
+/**
+ * Determine the output type of an API based on its last block.
+ * The API response is always the output of the last block executed.
+ */
+function determineApiOutputType(apiJson) {
+    if (!apiJson.blocks || apiJson.blocks.length === 0) {
+        return "void";
+    }
+    // Get the last block
+    const lastBlock = apiJson.blocks[apiJson.blocks.length - 1];
+    return getBlockOutputType(lastBlock);
+}
+/**
+ * Generate TypeScript interface for API inputs with proper types.
+ */
+function generateInputInterface(apiName, inputs) {
+    const capitalizedName = apiName.charAt(0).toUpperCase() + apiName.slice(1);
+    if (inputs.length === 0) {
+        return `export interface ${capitalizedName}Input {}`;
+    }
+    const properties = inputs
+        .map((input) => {
+        const optionalMarker = input.optional ? "?" : "";
+        return `  ${input.name}${optionalMarker}: ${input.type};`;
+    })
+        .join("\n");
+    return `export interface ${capitalizedName}Input {\n${properties}\n}`;
+}
+/**
+ * Generate TypeScript type for API response.
+ */
+function generateResponseType(apiName, outputType) {
+    const capitalizedName = apiName.charAt(0).toUpperCase() + apiName.slice(1);
+    return `export type ${capitalizedName}Response = ${outputType};`;
+}
+/**
+ * Generate complete types.d.ts file content.
+ */
+function generateTypesFile(apiName, inputs, outputType) {
+    return `// Auto-generated by Superblocks
+// Input/output types for ${apiName}
+
+${generateInputInterface(apiName, inputs)}
+
+${generateResponseType(apiName, outputType)}
+`;
+}
+/**
+ * Compile an API source file, validate it, and persist the generated YAML artifact.
+ *
+ * @param params - Build parameters including identifiers and shared services.
+ * @returns The generated API YAML artifact and whether the API is newly created.
+ * @throws Error when the API source is missing, compilation fails, or persistence is not possible.
+ */
+export const buildApiArtifact = async (params) => {
+    const { apiName, services, scopeUpdateQueue } = params;
+    const logger = params.logger ?? getPrefixedLogger(`[buildApiArtifact-${apiName}]`);
+    const apiSource = await readApiSource(services, apiName);
+    if (apiSource === undefined) {
+        throw new Error(`API source for ${apiName} not found. Ensure the API has been created and source code is available.`);
+    }
+    const isNewApi = !(await services.appShell.pathExists(renderPath(Paths.ApiYamls, { apiName })));
+    let apiYaml;
+    try {
+        [apiYaml] = await applyFileTransformations([apiSource], [
+            new ApiBuilderToYamlTransformer({
+                templateRenderer: services.templateRenderer,
+                skipCleanup: true,
+            }),
+        ]);
+    }
+    catch (error) {
+        if (error instanceof ApiBuilderTypeScriptError) {
+            logger.error(`TypeScript compilation failed: `, safeJsonStringify({
+                error: error.message,
+                apiSource: apiSource.content.slice(0, 500),
+            }));
+            throw new Error(`Unable to generate valid API code. This usually means there are syntax errors or issues with integration types. Review the API structure and ensure correct usage of integration methods. Consider checking integration metadata if you haven't already. Error: TypeScript compilation failed with message: ${error.message}`);
+        }
+        throw error;
+    }
+    const analysisWarnings = apiStaticAnalysis(apiSource.content);
+    if (analysisWarnings.length > 0) {
+        logger.warn("Static analysis warnings", {
+            warnings: analysisWarnings,
+            apiSource: apiSource.content.slice(0, 300),
+        });
+        throw new Error(`The API code has semantic issues that need to be fixed:\n\n${analysisWarnings.join("\n\n")}`);
+    }
+    if (apiYaml === undefined) {
+        throw new Error("Failed to generate API YAML. Try again.");
+    }
+    // Parse the YAML to extract inputs and generate types
+    let inputInterface;
+    let responseType;
+    try {
+        // Parse the YAML content
+        const apiData = yaml.parse(apiYaml.content);
+        // Validate that step blocks use the right plugin for the integration
+        validateBlockFieldNames(apiData, services.integrationStore);
+        // Convert to format expected by extractInputsWithTypesFromApi
+        const apiPb = { apiPb: apiData };
+        // Extract inputs with type information using the robust AST-based function
+        // Pass the original TypeScript source so it can extract type annotations
+        const inputs = await extractInputsWithTypesFromApi(apiPb, apiSource.content);
+        // Determine output type
+        const outputType = determineApiOutputType(apiData);
+        // Generate TypeScript interface strings
+        inputInterface = generateInputInterface(apiName, inputs);
+        responseType = generateResponseType(apiName, outputType);
+        // Generate complete types.d.ts content
+        const typesContent = generateTypesFile(apiName, inputs, outputType);
+        // Save files
+        await scopeUpdateQueue.enqueue(async () => {
+            // Save the API YAML
+            await services.draftInterface.createDraftFile(apiYaml.filePath, apiYaml.content);
+            // Save the types.d.ts file in the location expected by vite-plugin-yaml-types
+            const typesPath = renderPath(Paths.ApiYamls, { apiName }).replace("api.yaml", "types.d.ts");
+            await services.draftInterface.createDraftFile(typesPath, typesContent);
+        });
+    }
+    catch (error) {
+        logger.error("Failed to build API or generate types", getErrorMeta(error));
+        throw new Error(`Failed to build API: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return {
+        apiYaml,
+        isNewApi,
+        inputInterface,
+        responseType,
+    };
+};
+/**
+ * Validate that blocks use the correct plugin field name matching the integration's plugin.id.
+ */
+export function validateBlockFieldNames(api, integrationStore) {
+    const logger = getLogger();
+    for (const block of api.blocks || []) {
+        if (!block.step)
+            continue;
+        const integrationId = block.step.integration;
+        if (!integrationId)
+            continue;
+        // Skip built-in plugins that don't have integrations in the store
+        if (integrationId === "javascript" || integrationId === "python") {
+            continue;
+        }
+        // Get the integration header to find the actual plugin type
+        const integrationHeader = integrationStore.getHeader(integrationId);
+        if (!integrationHeader) {
+            logger.warn(`Integration "${integrationId}" not found in store for block "${block.name}"`);
+            continue;
+        }
+        const expectedPluginId = integrationHeader.plugin.id;
+        // Check if the correct field name is used
+        if (!(expectedPluginId in block.step)) {
+            // Find what field they're actually using
+            const usedFields = Object.keys(block.step).filter((key) => key !== "integration" && typeof block.step[key] === "object");
+            throw new Error(`Block "${block.name}" uses incorrect field name. ` +
+                `The field name must match the integration's plugin ID.\n\n` +
+                `Expected field name: "${expectedPluginId}"\n` +
+                (usedFields.length > 0
+                    ? `Used field name: "${usedFields[0]}"\n\n`
+                    : `No plugin configuration field found\n\n`) +
+                `The integration "${integrationId}" is of type "${expectedPluginId}", ` +
+                `so your step configuration must use:\n` +
+                `${expectedPluginId}: { ... }\n\n` +
+                `This ensures proper routing and validation of your API calls.`);
+        }
+    }
+}
+//# sourceMappingURL=build-api-artifact.js.map

package/dist/ai-service/agent/tools/apis/build-api-artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-api-artifact.js","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/build-api-artifact.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/agent/tools/apis/build-api.d.ts

@@ -1,18 +1,9 @@
 export declare const extractIntegrationIdsFromSource: (source: string) => string[];
 export declare const buildApiToolFactory: import("../../tools2/types.js").ToolFactory<import("../../tools2/types.js").Tool<{
-    description: string;
     apiName: string;
-    apiSource: string;
-    inputs?: Record<string, any> | undefined;
 }, {
     message: string;
     apiName: string;
-} | {
-    execution: {
-        message: string;
-        outputs: string;
-    };
-    message: string;
-    apiName: string;
+    isNewApi: boolean;
 }>>;
 //# sourceMappingURL=build-api.d.ts.map

package/dist/ai-service/agent/tools/apis/build-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-api.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/build-api.ts"],"names":[],"mappings":"AAgCA,eAAO,MAAM,+BAA+B,GAAI,QAAQ,MAAM,KAAG,MAAM,EAWtE,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;GAyS/B,CAAC"}
+{"version":3,"file":"build-api.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/build-api.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,+BAA+B,GAAI,QAAQ,MAAM,KAAG,MAAM,EAWtE,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;GA+C/B,CAAC"}

package/dist/ai-service/agent/tools/apis/build-api.js

@@ -1,18 +1,7 @@
-import { AiEntityType } from "@superblocksteam/library-shared/types";
-import yaml from "yaml";
 import { z } from "zod";
-import { getErrorMeta, getPrefixedLogger } from "../../../../util/logger.js";
-import { Paths } from "../../../const.js";
-import { ApiBuilderTypeScriptError } from "../../../transform/api-builder/shared.js";
-import { ApiBuilderToYamlTransformer } from "../../../transform/api-builder/to-yaml-transformer.js";
-import { applyFileTransformations, renderPath, } from "../../../transform/shared.js";
-import { safeJsonStringify } from "../../../util/safe-stringify.js";
-import { ApiExecutor } from "../../subagents/apis/api-executor.js";
-import { ApiGenerationContext } from "../../subagents/apis/context.js";
-import { apiStaticAnalysis } from "../../subagents/apis/static-analysis.js";
-import { createToolFactory, ToolCategory, } from "../../tools2/types.js";
-const MAX_BUILD_ATTEMPTS = 10;
-const MAX_OUTPUT_SAMPLE_LENGTH = 500;
+import { getPrefixedLogger } from "../../../../util/logger.js";
+import { createToolFactory, ToolCategory } from "../../tools2/types.js";
+import { buildApiArtifact } from "./build-api-artifact.js";
 const integrationConstructorRegex = /new\s+[\w$.]+\s*\(\s*(["'`])(?:\\.|(?!\1).)*?\1\s*,\s*(["'`])((?:\\.|(?!\2).)*?)\2/g;
 export const extractIntegrationIdsFromSource = (source) => {
     integrationConstructorRegex.lastIndex = 0;
@@ -26,241 +15,40 @@ export const extractIntegrationIdsFromSource = (source) => {
     }
     return Array.from(ids);
 };
-export const buildApiToolFactory = createToolFactory("buildApi", (clark, services) => {
+export const buildApiToolFactory = createToolFactory("buildApi", (_clark, services, scopeUpdateQueue) => {
     return {
         category: ToolCategory.API,
         description: `
-Compile the API source code. Provide the inputs of the API required to test the API works after it is built.
+Compile, validate, and save the API. This tool performs the following steps:
+1. Reads the API source from file
+2. Compiles to Superblocks API YAML and validates syntax
+3. Performs static analysis to catch common mistakes
+4. Validates proto compatibility
 
 IMPORTANT Before using an integration, you MUST call the grepMetadata tool to get the correct schema/table structure. Do NOT make up column names or table structures.
 `,
         inputSchema: z.object({
-            apiSource: z.string().describe("The source code of the API"),
             apiName: z.string().describe("The name of the API"),
-            description: z
-                .string()
-                .min(1)
-                .describe(`
-A concise plain-English description of what the API does, framed as a request for permission.
-
-Always include the API name and the names of integrations used. Focus on the domain names for resources.
-
-DO NOT explain why or include context.
-
-Examples: "Create getRecentCommitsApi to retrieve recent commits from GitHub?", "Create getJiraIssuesApi to pull issues from Jira?", "Create updateOrdersApi to update the Orders table in DemoOrders?".`),
-            inputs: z
-                .record(z.string(), z.any())
-                .optional()
-                .describe("Test API inputs. Must be provided if the API uses bindings."),
         }),
-        extractEntities: (input) => {
-            const integrationIds = extractIntegrationIdsFromSource(input.apiSource);
-            return integrationIds.map((integrationId) => ({
-                type: AiEntityType.INTEGRATION,
-                id: integrationId,
-            }));
-        },
-        formatInput: (input) => {
-            const integrationIds = extractIntegrationIdsFromSource(input.apiSource);
-            const targets = integrationIds.map((id) => services.integrationStore.getEntityTag(id) ?? id);
-            return {
-                targets,
-                summary: input.description,
-            };
-        },
-        execute: async ({ apiSource, apiName, inputs }, options) => {
-            const context = ApiGenerationContext.from(options?.experimental_context);
-            let id = apiName;
-            if (context && context.id) {
-                id = context.id;
-            }
+        execute: async ({ apiName }) => {
             const logger = getPrefixedLogger(`[buildApi-${apiName}]`);
-            const stateMap = clark.context.apiGenStateMap;
-            if (!stateMap) {
-                throw new Error("Unexpected state: API generation state map is not initialized.");
-            }
-            let state = stateMap.get(id);
-            if (!state) {
-                throw new Error(`No API generation state found for API ${apiName}.`);
-            }
-            if (state.status === "ready") {
-                state = {
-                    ...state,
-                    status: "building",
-                    attempts: 0,
-                };
-                stateMap.set(id, state);
-            }
-            else if (state.status === "building") {
-                state.attempts++;
-            }
-            else if (state.status === "built") {
-                throw new Error(`API ${apiName} is already built. Must call finalizeApi.`);
-            }
-            else {
-                throw new Error(`API ${apiName} is in unexpected state: ${state.status}.`);
-            }
-            if (state.attempts > MAX_BUILD_ATTEMPTS) {
-                const error = new Error("Unable to build the API after multiple attempts. The API structure may be fundamentally incompatible with the requirements. Consider simplifying the approach or checking if all required integrations are properly configured.");
-                const currentState = stateMap.get(id);
-                state = {
-                    ...state,
-                    status: "failed",
-                    error: state.lastError || error,
-                    errorContext: {
-                        phase: "building",
-                        attemptNumber: state.attempts,
-                        lastToolCalled: currentState?.status === "building"
-                            ? currentState.lastToolCalled
-                            : undefined,
-                        lastToolError: currentState?.status === "building"
-                            ? currentState.lastToolError
-                            : undefined,
-                        suggestion: "Try a simpler API structure or verify integration configurations",
-                    },
-                };
-                stateMap.set(id, state);
-                throw error;
-            }
-            const processApiSource = async () => {
-                const generatedArtifact = {
-                    type: "file",
-                    filePath: renderPath(Paths.GeneratedApis, {
-                        apiName,
-                    }) + ".ts",
-                    content: apiSource,
-                };
-                const success = {
-                    message: "API compiled successfully",
-                    apiName,
-                };
-                let apiYaml;
-                try {
-                    [apiYaml] = await applyFileTransformations([generatedArtifact], [
-                        new ApiBuilderToYamlTransformer({
-                            templateRenderer: services.templateRenderer,
-                            skipCleanup: true,
-                        }),
-                    ]);
-                }
-                catch (error) {
-                    if (error instanceof ApiBuilderTypeScriptError) {
-                        // Log technical details for debugging
-                        logger.error("TypeScript compilation failed", {
-                            error: error.message,
-                            apiSource: apiSource.slice(0, 500),
-                        });
-                        // Return user-friendly error for the subagent LLM
-                        throw new Error(`Unable to generate valid API code. This usually means there are syntax errors or issues with integration types. Review the API structure and ensure correct usage of integration methods. Consider checking integration metadata if you haven't already. Error: Typescript compilation failed with message: ${error.message}`);
-                    }
-                    throw error;
-                }
-                // At this point we know the apiSource is valid TypeScript.
-                // Now do some static analysis to ensure it's semantically valid
-                // We do this against the TS source instead of the YAML because
-                // it's easier to provide better errors to the LLM, which is dealing in TS
-                const analysisWarnings = apiStaticAnalysis(apiSource);
-                if (analysisWarnings.length > 0) {
-                    // Log detailed warnings
-                    logger.warn("Static analysis warnings", {
-                        warnings: analysisWarnings,
-                        apiSource: apiSource.slice(0, 300),
-                    });
-                    throw new Error(`The API code has semantic issues that need to be fixed:\n\n${analysisWarnings.join("\n\n")}`);
-                }
-                if (apiYaml === undefined) {
-                    throw new Error("Failed to generate API YAML. Try again.");
-                }
-                const successState = {
-                    ...state,
-                    status: "built",
-                    apiYaml,
-                };
-                if (!clark.context.llmConfig?.customerDataAccessEnabled) {
-                    logger.info("Customer data access is disabled, skipping API execution validation");
-                    stateMap.set(id, successState);
-                    return success;
-                }
-                const editorClient = clark.context.peer;
-                if (!editorClient) {
-                    logger.warn("No editor client available, skipping API execution validation");
-                    stateMap.set(id, successState);
-                    return success;
-                }
-                let parsedApi;
-                try {
-                    // Parse with a reviver to clean up backticks from all strings
-                    parsedApi = yaml.parse(apiYaml.content, (_key, value) => {
-                        if (typeof value === "string" &&
-                            value.startsWith("`") &&
-                            value.endsWith("`")) {
-                            return value.slice(1, -1);
-                        }
-                        return value;
-                    });
-                }
-                catch (error) {
-                    logger.error("Parsing failed", getErrorMeta(error));
-                    throw new Error(`Failed to parse generated API YAML: ${error instanceof Error ? error.message : String(error)}`);
-                }
-                logger.info("Parsed API", safeJsonStringify(parsedApi, 2));
-                const executor = new ApiExecutor(editorClient, services.integrationStore);
-                const result = await executor.execute(parsedApi, inputs);
-                if (!result.success) {
-                    // Log technical error details
-                    logger.error("API execution failed", {
-                        error: result.error,
-                        errorDetails: result.errorDetails,
-                    });
-                    // Return user-friendly error for the subagent LLM
-                    const { errorDetails } = result;
-                    let friendlyMessage = `The API failed during execution: ${result.error ?? ""} ${safeJsonStringify(result.errorDetails)} `;
-                    if (errorDetails) {
-                        switch (errorDetails.type) {
-                            case "validation":
-                                friendlyMessage += `There's a validation error - check that all required parameters are provided and data types are correct.`;
-                                break;
-                            case "execution":
-                                friendlyMessage += `The integration returned an error. This might be due to incorrect query syntax, missing permissions, or invalid data references.`;
-                                break;
-                            case "proto":
-                                friendlyMessage += `There's an incompatibility with the API structure. Try simplifying the API or checking the integration configuration.`;
-                                break;
-                            default:
-                                friendlyMessage += `${result.error}`;
-                        }
-                        if (errorDetails.suggestion) {
-                            friendlyMessage += `\n\nSuggestion: ${errorDetails.suggestion}`;
-                        }
-                    }
-                    throw new Error(friendlyMessage);
-                }
-                const { outputs } = result;
-                if (!outputs) {
-                    throw new Error(`Execution failed: no outputs in response`);
-                }
-                // take a small sample of outputs, don't want to blow up context
-                const sample = safeJsonStringify(outputs).slice(0, MAX_OUTPUT_SAMPLE_LENGTH) +
-                    "...[TRUNCATED]";
-                stateMap.set(id, successState);
-                return {
-                    ...success,
-                    execution: {
-                        message: "Verify the output sample matches your expectations; if not, there may be a bug",
-                        outputs: sample,
-                    },
-                };
+            const { isNewApi, inputInterface, responseType } = await buildApiArtifact({
+                apiName,
+                services,
+                scopeUpdateQueue,
+                logger,
+            });
+            let message = `API ${apiName} has been successfully compiled, validated, and saved.`;
+            message += `\n\nGenerated TypeScript types:`;
+            message += `\n${inputInterface}`;
+            message += `\n${responseType}`;
+            message += `\n\nTypes saved to apis/${apiName}.d.ts`;
+            message += `\n\nThe API is now available in the application. You MUST call testApi to execute and verify the API behavior before moving on to other work`;
+            return {
+                message,
+                apiName,
+                isNewApi,
             };
-            try {
-                return await processApiSource();
-            }
-            catch (error) {
-                stateMap.set(id, {
-                    ...state,
-                    lastError: error,
-                });
-                throw error;
-            }
         },
     };
 });