@superblocksteam/vite-plugin-file-sync 1.99.99-next.3 → 2.0.0-SNAPSHOT.2143e2e95d0107ab

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

@@ -0,0 +1,378 @@
+import { readFile as fsReadFile, stat as fsStat, utimes, } from "node:fs/promises";
+import path from "node:path";
+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 { apiStaticAnalysis } from "../../subagents/apis/static-analysis.js";
+import { ToolExecutionError } from "../../tools2/types.js";
+/**
+ * Integration output type definitions.
+ * Source of truth for what each integration returns.
+ */
+export 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[]",
+    cockroachdb: "any[]",
+    oracledb: "any[]",
+    // NoSQL Databases
+    mongodb: "any[]",
+    dynamodb: "{ Items?: any[]; Count?: number; ScannedCount?: number }",
+    cosmosdb: "{ resources: any[]; headers: Record<string, string> }",
+    // REST APIs
+    restapi: "{ data: any; status: number; headers: Record<string, string> }",
+    restapiintegration: "{ data: any; status: number; headers: Record<string, string> }",
+    snowflakecortex: "{ data: any; status: number; headers: Record<string, string> }",
+    openapi: "{ data: any; status: number; headers: Record<string, string> }",
+    salesforce: "{ data: any; status: number; headers: Record<string, string> }",
+    // GraphQL
+    graphql: "{ data: any; errors?: any[] }",
+    graphqlintegration: "{ data: any; errors?: any[] }",
+    // JavaScript/Python
+    javascript: "any",
+    python: "any",
+    // Messaging
+    kafka: "{ success: boolean; partition?: number; offset?: string }",
+    email: "{ success: boolean; messageId?: string }",
+    smtp: "{ success: boolean; messageId?: string }",
+    // Other
+    redis: "any",
+    slack: "any",
+    s3: "{ ETag?: string; Location?: string; Key?: string; Bucket?: string }",
+    gcs: "any", // Returns vary by action: objects list, file content, upload result, presigned URL, etc.
+};
+/**
+ * Get the output type for a specific block.
+ * Control flow blocks return their last child's output.
+ * @internal Exported for testing only
+ */
+export function getBlockOutputType(block) {
+    // Handle control flow blocks
+    if (block.conditional) {
+        // Conditional returns the output of whichever branch executes
+        // For type purposes, we need to handle all possible branches
+        const types = [];
+        if (block.conditional.if?.blocks?.length > 0) {
+            const lastIfBlock = block.conditional.if.blocks[block.conditional.if.blocks.length - 1];
+            types.push(getBlockOutputType(lastIfBlock));
+        }
+        block.conditional.elseIf?.forEach((elseIfBranch) => {
+            if (elseIfBranch.blocks?.length > 0) {
+                const lastElseIfBlock = elseIfBranch.blocks[elseIfBranch.blocks.length - 1];
+                types.push(getBlockOutputType(lastElseIfBlock));
+            }
+        });
+        if (block.conditional.else?.blocks?.length > 0) {
+            const lastElseBlock = block.conditional.else.blocks[block.conditional.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 INTEGRATION_OUTPUT_TYPES[integration.toLowerCase()] || "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.
+ * @internal Exported for testing only
+ */
+export 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 apiTsPath = `apis/${apiName}.ts`;
+    let apiSourceContent;
+    try {
+        apiSourceContent = await services.appShell.readFile(apiTsPath);
+    }
+    catch {
+        throw new ToolExecutionError(`API source for ${apiName} not found. Ensure the API has been created and source code is available.`, { toolName: "", input: {}, context: {}, severity: "warn" });
+    }
+    const apiSource = {
+        type: "file",
+        filePath: apiTsPath,
+        content: apiSourceContent,
+    };
+    const yamlPath = renderPath(Paths.ApiYamls, { apiName });
+    const isNewApi = !(await services.appShell.pathExists(yamlPath));
+    let previousYamlContent;
+    if (!isNewApi) {
+        try {
+            const absoluteYamlPath = path.join(services.appShell.appRootDirPath, yamlPath);
+            previousYamlContent = await fsReadFile(absoluteYamlPath, "utf-8");
+        }
+        catch (error) {
+            logger.warn(`Could not read previous YAML for ${apiName}, treating as changed`, getErrorMeta(error));
+        }
+    }
+    let apiYaml;
+    try {
+        [apiYaml] = await applyFileTransformations([apiSource], [
+            new ApiBuilderToYamlTransformer({
+                templateRenderer: services.templateRenderer,
+                skipCleanup: true,
+                pluginExecutionVersions: services.integrationStore.pluginExecutionVersions,
+            }),
+        ]);
+    }
+    catch (error) {
+        if (error instanceof ApiBuilderTypeScriptError) {
+            logger.info(`TypeScript compilation failed: ${error.message} (source preview: ${apiSource.content.slice(0, 200)}...)`);
+            throw new ToolExecutionError(`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}`, {
+                toolName: "buildApi",
+                input: { apiName },
+                context: {},
+                severity: "info",
+            });
+        }
+        throw error;
+    }
+    const analysisWarnings = apiStaticAnalysis(apiSource.content);
+    if (analysisWarnings.length > 0) {
+        logger.info("Static analysis warnings", {
+            warnings: analysisWarnings,
+            apiSource: apiSource.content.slice(0, 300),
+        });
+        throw new ToolExecutionError(`The API code has semantic issues that need to be fixed:\n\n${analysisWarnings.join("\n\n")}`, {
+            toolName: "buildApi",
+            input: { apiName },
+            context: {},
+            severity: "info",
+        });
+    }
+    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);
+            // Touch the scratch file to keep it "fresh" relative to the newly written YAML.
+            // This prevents the timestamp-based freshness check from incorrectly marking
+            // the scratch as stale (since the YAML was just generated from this scratch content).
+            const scratchPath = renderPath(Paths.Scratch, {
+                path: `apis/${apiName}.ts`,
+            });
+            const fullScratchPath = path.join(services.appShell.appRootDirPath, scratchPath);
+            try {
+                const yamlStat = await fsStat(path.join(services.appShell.appRootDirPath, apiYaml.filePath));
+                const freshAfterYaml = new Date(yamlStat.mtimeMs + 1);
+                await utimes(fullScratchPath, freshAfterYaml, freshAfterYaml);
+            }
+            catch {
+                // Scratch file may not exist (e.g., if API was created from YAML directly)
+                // This is fine - the freshness check will regenerate from YAML as needed
+            }
+        });
+    }
+    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)}`);
+    }
+    const contentChanged = isNewApi ||
+        previousYamlContent === undefined ||
+        apiYaml.content.trim() !== previousYamlContent.trim();
+    return {
+        apiYaml,
+        isNewApi,
+        contentChanged,
+        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 ToolExecutionError(`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.`, {
+                toolName: "buildApi",
+                input: {},
+                context: {},
+                severity: "warn",
+            });
+        }
+    }
+}
+//# 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":"AAAA,OAAO,EACL,QAAQ,IAAI,UAAU,EACtB,IAAI,IAAI,MAAM,EACd,MAAM,GACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAKxB,OAAO,EACL,6BAA6B,GAE9B,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,SAAS,EACT,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG1C,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,2BAA2B,EAAE,MAAM,uDAAuD,CAAC;AACpG,OAAO,EACL,wBAAwB,EACxB,UAAU,GACX,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAE5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA2B;IAC9D,iDAAiD;IACjD,QAAQ,EAAE,OAAO;IACjB,UAAU,EAAE,OAAO;IACnB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,OAAO;IAClB,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE,OAAO;IACjB,UAAU,EAAE,OAAO;IACnB,MAAM,EAAE,OAAO;IACf,WAAW,EAAE,OAAO;IACpB,QAAQ,EAAE,OAAO;IAEjB,kBAAkB;IAClB,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,0DAA0D;IACpE,QAAQ,EAAE,uDAAuD;IAEjE,YAAY;IACZ,OAAO,EAAE,gEAAgE;IACzE,kBAAkB,EAChB,gEAAgE;IAClE,eAAe,EACb,gEAAgE;IAClE,OAAO,EAAE,gEAAgE;IACzE,UAAU,EAAE,gEAAgE;IAE5E,UAAU;IACV,OAAO,EAAE,+BAA+B;IACxC,kBAAkB,EAAE,+BAA+B;IAEnD,oBAAoB;IACpB,UAAU,EAAE,KAAK;IACjB,MAAM,EAAE,KAAK;IAEb,YAAY;IACZ,KAAK,EAAE,2DAA2D;IAClE,KAAK,EAAE,0CAA0C;IACjD,IAAI,EAAE,0CAA0C;IAEhD,QAAQ;IACR,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,KAAK;IACZ,EAAE,EAAE,qEAAqE;IACzE,GAAG,EAAE,KAAK,EAAE,yFAAyF;CACtG,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAU;IAC3C,6BAA6B;IAC7B,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,8DAA8D;QAC9D,6DAA6D;QAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,WAAW,GACf,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACtE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC;QAC9C,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,YAAiB,EAAE,EAAE;YACtD,IAAI,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,MAAM,eAAe,GACnB,YAAY,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACtD,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC;YAClD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,aAAa,GACjB,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC1E,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,gEAAgE;QAChE,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QAC5C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;QAC9D,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,6DAA6D;QAC7D,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACtE,MAAM,QAAQ,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;YACnD,OAAO,SAAS,QAAQ,GAAG,CAAC;QAC9B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,+DAA+D;QAC/D,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,MAAM,YAAY,GAChB,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAClE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,cAAc,GAClB,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACtE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QAC5C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;QAC9D,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,oCAAoC;IACpC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;QAE3C,6BAA6B;QAC7B,IAAI,WAAW,KAAK,YAAY,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;YAC7D,kEAAkE;YAClE,0BAA0B;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,wDAAwD;QACxD,IAAI,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACzC,wCAAwC;YACxC,yDAAyD;YACzD,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACjD,OAAO,wBAAwB,CAAC,UAAU,IAAI,OAAO,CAAC;YACxD,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACrB,OAAO,wBAAwB,CAAC,KAAK,IAAI,OAAO,CAAC;YACnD,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACzB,OAAO,wBAAwB,CAAC,SAAS,IAAI,OAAO,CAAC;YACvD,CAAC;YACD,uDAAuD;YACvD,OAAO,wBAAwB,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,OAAO,CAAC;QACxE,CAAC;QAED,0BAA0B;QAC1B,OAAO,wBAAwB,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,KAAK,CAAC;IACtE,CAAC;IAED,2BAA2B;IAC3B,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC,CAAC,kDAAkD;IAClE,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,OAAO,CAAC,CAAC,qCAAqC;IACvD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAY;IACjD,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,qBAAqB;IACrB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC5D,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAC7B,OAAe,EACf,MAA4B;IAE5B,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE3E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,oBAAoB,eAAe,UAAU,CAAC;IACvD,CAAC;IAED,MAAM,UAAU,GAAG,MAAM;SACtB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,cAAc,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,OAAO,KAAK,KAAK,CAAC,IAAI,GAAG,cAAc,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC;IAC5D,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,oBAAoB,eAAe,YAAY,UAAU,KAAK,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,OAAe,EAAE,UAAkB;IAC/D,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3E,OAAO,eAAe,eAAe,cAAc,UAAU,GAAG,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,OAAe,EACf,MAA4B,EAC5B,UAAkB;IAElB,OAAO;4BACmB,OAAO;;EAEjC,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC;;EAEvC,oBAAoB,CAAC,OAAO,EAAE,UAAU,CAAC;CAC1C,CAAC;AACF,CAAC;AAiBD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EACnC,MAA8B,EACG,EAAE;IACnC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAAC;IACvD,MAAM,MAAM,GACV,MAAM,CAAC,MAAM,IAAI,iBAAiB,CAAC,qBAAqB,OAAO,GAAG,CAAC,CAAC;IAEtE,MAAM,SAAS,GAAG,QAAQ,OAAO,KAAK,CAAC;IACvC,IAAI,gBAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,gBAAgB,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,kBAAkB,CAC1B,kBAAkB,OAAO,2EAA2E,EACpG,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAC3D,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAiB;QAC9B,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,gBAAgB;KAC1B,CAAC;IAEF,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEjE,IAAI,mBAAuC,CAAC;IAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAChC,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAChC,QAAQ,CACT,CAAC;YACF,mBAAmB,GAAG,MAAM,UAAU,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CACT,oCAAoC,OAAO,uBAAuB,EAClE,YAAY,CAAC,KAAK,CAAC,CACpB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,OAAiC,CAAC;IAEtC,IAAI,CAAC;QACH,CAAC,OAAO,CAAC,GAAG,MAAM,wBAAwB,CACxC,CAAC,SAAS,CAAC,EACX;YACE,IAAI,2BAA2B,CAAC;gBAC9B,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;gBAC3C,WAAW,EAAE,IAAI;gBACjB,uBAAuB,EACrB,QAAQ,CAAC,gBAAgB,CAAC,uBAAuB;aACpD,CAAC;SACH,CACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,yBAAyB,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CACT,kCAAkC,KAAK,CAAC,OAAO,qBAAqB,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAC1G,CAAC;YAEF,MAAM,IAAI,kBAAkB,CAC1B,+SAA+S,KAAK,CAAC,OAAO,EAAE,EAC9T;gBACE,QAAQ,EAAE,UAAU;gBACpB,KAAK,EAAE,EAAE,OAAO,EAAE;gBAClB,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,MAAM;aACjB,CACF,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;YACtC,QAAQ,EAAE,gBAAgB;YAC1B,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SAC3C,CAAC,CAAC;QAEH,MAAM,IAAI,kBAAkB,CAC1B,8DAA8D,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAC7F;YACE,QAAQ,EAAE,UAAU;YACpB,KAAK,EAAE,EAAE,OAAO,EAAE;YAClB,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,MAAM;SACjB,CACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,sDAAsD;IACtD,IAAI,cAAsB,CAAC;IAC3B,IAAI,YAAoB,CAAC;IAEzB,IAAI,CAAC;QACH,yBAAyB;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAQ,CAAC;QAEnD,qEAAqE;QACrE,uBAAuB,CAAC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QAE5D,8DAA8D;QAC9D,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,OAAO,EAAwB,CAAC;QAEvD,2EAA2E;QAC3E,yEAAyE;QACzE,MAAM,MAAM,GAAG,MAAM,6BAA6B,CAChD,KAAK,EACL,SAAS,CAAC,OAAO,CAClB,CAAC;QAEF,wBAAwB;QACxB,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAEnD,wCAAwC;QACxC,cAAc,GAAG,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACzD,YAAY,GAAG,oBAAoB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAEzD,uCAAuC;QACvC,MAAM,YAAY,GAAG,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QAEpE,aAAa;QACb,MAAM,gBAAgB,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;YACxC,oBAAoB;YACpB,MAAM,QAAQ,CAAC,cAAc,CAAC,eAAe,CAC3C,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,OAAO,CAChB,CAAC;YAEF,8EAA8E;YAC9E,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAC/D,UAAU,EACV,YAAY,CACb,CAAC;YACF,MAAM,QAAQ,CAAC,cAAc,CAAC,eAAe,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;YAEvE,gFAAgF;YAChF,6EAA6E;YAC7E,sFAAsF;YACtF,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE;gBAC5C,IAAI,EAAE,QAAQ,OAAO,KAAK;aAC3B,CAAC,CAAC;YACH,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAC/B,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAChC,WAAW,CACZ,CAAC;YACF,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,CAC9D,CAAC;gBACF,MAAM,cAAc,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;gBACtD,MAAM,MAAM,CAAC,eAAe,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;YAChE,CAAC;YAAC,MAAM,CAAC;gBACP,2EAA2E;gBAC3E,yEAAyE;YAC3E,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3E,MAAM,IAAI,KAAK,CACb,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACjF,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAClB,QAAQ;QACR,mBAAmB,KAAK,SAAS;QACjC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,mBAAmB,CAAC,IAAI,EAAE,CAAC;IAExD,OAAO;QACL,OAAO;QACP,QAAQ;QACR,cAAc;QACd,cAAc;QACd,YAAY;KACb,CAAC;AACJ,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,GAAQ,EACR,gBAAkC;IAElC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,SAAS;QAE1B,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;QAC7C,IAAI,CAAC,aAAa;YAAE,SAAS;QAE7B,kEAAkE;QAClE,IAAI,aAAa,KAAK,YAAY,IAAI,aAAa,KAAK,QAAQ,EAAE,CAAC;YACjE,SAAS;QACX,CAAC;QAED,4DAA4D;QAC5D,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACpE,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CACT,gBAAgB,aAAa,mCAAmC,KAAK,CAAC,IAAI,GAAG,CAC9E,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAErD,0CAA0C;QAC1C,IAAI,CAAC,CAAC,gBAAgB,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,yCAAyC;YACzC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAC/C,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,KAAK,aAAa,IAAI,OAAQ,KAAK,CAAC,IAAY,CAAC,GAAG,CAAC,KAAK,QAAQ,CACxE,CAAC;YAEF,MAAM,IAAI,kBAAkB,CAC1B,UAAU,KAAK,CAAC,IAAI,+BAA+B;gBACjD,4DAA4D;gBAC5D,yBAAyB,gBAAgB,KAAK;gBAC9C,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;oBACpB,CAAC,CAAC,qBAAqB,UAAU,CAAC,CAAC,CAAC,OAAO;oBAC3C,CAAC,CAAC,yCAAyC,CAAC;gBAC9C,oBAAoB,aAAa,iBAAiB,gBAAgB,KAAK;gBACvE,wCAAwC;gBACxC,GAAG,gBAAgB,eAAe;gBAClC,+DAA+D,EACjE;gBACE,QAAQ,EAAE,UAAU;gBACpB,KAAK,EAAE,EAAE;gBACT,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,MAAM;aACjB,CACF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { OperationQueue } from "../../../../util/operation-queue.js";
+import type { Clark, ClarkStateHandlerParams } from "../../../state-machine/clark-fsm.js";
+export { extractIntegrationIdsFromSource } from "./analysis.js";
+export declare const buildApiToolFactory: import("../../tools2/types.js").ToolFactory<{
+    clark: Clark;
+    services: ClarkStateHandlerParams;
+    scopeUpdateQueue: OperationQueue;
+}, import("../../tools2/types.js").Tool<{
+    apiName: 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

@@ -0,0 +1 @@
+{"version":3,"file":"build-api.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/build-api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,EACV,KAAK,EACL,uBAAuB,EACxB,MAAM,qCAAqC,CAAC;AAI7C,OAAO,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAC;AAEhE,eAAO,MAAM,mBAAmB;WAOrB,KAAK;cACF,uBAAuB;sBACf,cAAc;;;;;;;GAkFnC,CAAC"}

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

@@ -0,0 +1,82 @@
+import { z } from "zod";
+import { getPrefixedLogger } from "../../../../util/logger.js";
+import { createToolFactory, ToolCategory } from "../../tools2/types.js";
+import { buildApiArtifact } from "./build-api-artifact.js";
+export { extractIntegrationIdsFromSource } from "./analysis.js";
+export const buildApiToolFactory = createToolFactory("buildApi", ({ clark, services, scopeUpdateQueue, }) => {
+    return {
+        category: ToolCategory.API,
+        description: `
+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 ANY integration, you MUST call grepMetadata to explore its metadata:
+
+**Database integrations**: Get table/column names and types. Do NOT make up column names.
+
+**OpenAPI integrations** (REST APIs, AI providers like Gemini/OpenAI/Anthropic):
+- Search for available endpoints: \`\\.paths\\[.*\\]\`
+- Search for parameter values: \`\\.info\\.description\` (often contains setup info, available models)
+- Search for examples: \`\\.example\` (shows valid parameter values)
+- Do NOT assume parameter values from training data - always verify against the spec
+`,
+        inputSchema: z.object({
+            apiName: z.string().describe("The name of the API"),
+        }),
+        execute: async ({ apiName }) => {
+            const logger = getPrefixedLogger(`[buildApi-${apiName}]`);
+            try {
+                const { isNewApi, contentChanged, inputInterface, responseType } = await buildApiArtifact({
+                    apiName,
+                    services,
+                    scopeUpdateQueue,
+                    logger,
+                });
+                // Build succeeded - clear any previous failure for this API
+                clark.context.failedApiBuilds?.delete(apiName);
+                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`;
+                if (contentChanged) {
+                    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`;
+                    // Mark API as needing testing - rebuild resets test status.
+                    // Also clear denied: a rebuild produces new code, so a previous
+                    // denial of the old version shouldn't suppress testing the new one.
+                    clark.context.apiTestingState ??= {
+                        untested: new Set(),
+                        failed: new Set(),
+                        passed: new Set(),
+                        denied: new Set(),
+                    };
+                    clark.context.apiTestingState.untested.add(apiName);
+                    clark.context.apiTestingState.failed.delete(apiName);
+                    clark.context.apiTestingState.passed.delete(apiName);
+                    clark.context.apiTestingState.denied.delete(apiName);
+                }
+                return {
+                    message,
+                    apiName,
+                    isNewApi,
+                };
+            }
+            catch (error) {
+                // Track the failed build so finalize will be blocked
+                clark.context.failedApiBuilds ??= new Set();
+                clark.context.failedApiBuilds.add(apiName);
+                throw error;
+            }
+        },
+        getSummary: (_input, output) => {
+            const status = output.isNewApi ? "Created" : "Updated";
+            return {
+                output: `${status} successfully`,
+            };
+        },
+    };
+});
+//# sourceMappingURL=build-api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-api.js","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/build-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAM/D,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAC;AAEhE,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAClD,UAAU,EACV,CAAC,EACC,KAAK,EACL,QAAQ,EACR,gBAAgB,GAKjB,EAAE,EAAE;IACH,OAAO;QACL,QAAQ,EAAE,YAAY,CAAC,GAAG;QAC1B,WAAW,EAAE;;;;;;;;;;;;;;;;CAgBlB;QACK,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;SACpD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC7B,MAAM,MAAM,GAAG,iBAAiB,CAAC,aAAa,OAAO,GAAG,CAAC,CAAC;YAE1D,IAAI,CAAC;gBACH,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,GAC9D,MAAM,gBAAgB,CAAC;oBACrB,OAAO;oBACP,QAAQ;oBACR,gBAAgB;oBAChB,MAAM;iBACP,CAAC,CAAC;gBAEL,4DAA4D;gBAC5D,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBAE/C,IAAI,OAAO,GAAG,OAAO,OAAO,wDAAwD,CAAC;gBACrF,OAAO,IAAI,iCAAiC,CAAC;gBAC7C,OAAO,IAAI,KAAK,cAAc,EAAE,CAAC;gBACjC,OAAO,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC/B,OAAO,IAAI,2BAA2B,OAAO,OAAO,CAAC;gBACrD,IAAI,cAAc,EAAE,CAAC;oBACnB,OAAO,IAAI,8IAA8I,CAAC;oBAE1J,4DAA4D;oBAC5D,gEAAgE;oBAChE,oEAAoE;oBACpE,KAAK,CAAC,OAAO,CAAC,eAAe,KAAK;wBAChC,QAAQ,EAAE,IAAI,GAAG,EAAU;wBAC3B,MAAM,EAAE,IAAI,GAAG,EAAU;wBACzB,MAAM,EAAE,IAAI,GAAG,EAAU;wBACzB,MAAM,EAAE,IAAI,GAAG,EAAU;qBAC1B,CAAC;oBACF,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBACpD,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;oBACrD,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;oBACrD,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACvD,CAAC;gBAED,OAAO;oBACL,OAAO;oBACP,OAAO;oBACP,QAAQ;iBACT,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,qDAAqD;gBACrD,KAAK,CAAC,OAAO,CAAC,eAAe,KAAK,IAAI,GAAG,EAAU,CAAC;gBACpD,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC3C,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;YAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YACvD,OAAO;gBACL,MAAM,EAAE,GAAG,MAAM,eAAe;aACjC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC,CACF,CAAC"}

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

@@ -0,0 +1,66 @@
+import { type PluginExecutionVersions, type SemVer } from "@superblocksteam/shared";
+import type { ClarkStateHandlerParams } from "../../../state-machine/clark-fsm.js";
+/**
+ * Core type definitions - control flow and base types only
+ * Integration-specific types are provided by getIntegrationTypeDefinition
+ *
+ * @remarks Exported for testing purposes to validate completeness
+ */
+export declare const TYPE_DEFINITIONS = "\n## Core Type Definitions\n\nThese are the core type definitions for control flow blocks and base types in Superblocks APIs:\n\n```typescript\n// @superblocksteam/library\n\nexport type JsonValue = any;\n\nexport type State = { [key: string]: JsonValue };\n\nexport type Binding<T> = T | ((state: State) => T);\n\nexport declare abstract class Block {\n  protected name: string;\n\n  constructor(name: string);\n}\n\nexport declare abstract class Integration extends Block {\n  constructor(name: string, integration: string);\n}\n\n// Control Flow Blocks\n\nexport type Condition = {\n  when: Binding<boolean>;\n  then: Block[];\n};\n\nexport type Conditions = {\n  if: Condition;\n  elif?: Condition[];\n  else?: Block[];\n};\n\nexport declare class Conditional extends Block {\n  public conditions: Conditions;\n\n  constructor(name: string, config: Conditions);\n}\n\nexport declare class Loop extends Block {\n  constructor(\n    name: string,\n    config:\n      | {\n          type?: \"TYPE_FOREACH\"; // Optional - defaults to TYPE_FOREACH\n          over: Binding<JsonValue[]>;\n          variables: { item: string; index: string };\n          blocks: Block[];\n        }\n      | {\n          type: \"TYPE_WHILE\"; // Required for TYPE_WHILE\n          condition: Binding<boolean>;\n          blocks: Block[];\n        }\n  );\n  public static fromJSON(json: any, entities: string[]): Loop;\n}\n\nexport declare class Parallel extends Block {\n  constructor(\n    name: string,\n    config:\n      | {\n          mode: \"dynamic\";\n          over: Binding<JsonValue[]>;\n          // variables defaults to { item: \"item\" } - only specify if you need a different name\n          blocks: Block[];\n        }\n      | {\n          mode: \"static\";\n          paths: Record<string, Block[]>;\n        }\n  );\n  public static fromJSON(json: any, entities: string[]): Parallel;\n}\n\nexport declare class Variables extends Block {\n  constructor(\n    name: string,\n    variables: { key: string; value: Binding<JsonValue> }[],\n  );\n  public static fromJSON(json: any, entities: string[]): Variables;\n}\n\nexport declare class TryCatch extends Block {\n  constructor(\n    name: string,\n    config: {\n      try: Block[];\n      catch: Block[];\n      finally?: Block[];\n      variables: { error: string };\n    },\n  );\n}\n\nexport declare class Throw extends Block {\n  constructor(\n    name: string,\n    config: {\n      error: Binding<JsonValue>;\n    },\n  );\n}\n\nexport declare class Return extends Block {\n  constructor(\n    name: string,\n    config: {\n      data: Binding<JsonValue>;\n    },\n  );\n}\n\nexport declare class Break extends Block {\n  constructor(\n    name: string,\n    config: {\n      condition: Binding<JsonValue>;\n    },\n  );\n}\n\n// API and Authorization\n\nexport type Authorization =\n  | {\n      type: \"AUTHORIZATION_TYPE_APP_USERS\";\n    }\n  | {\n      type: \"AUTHORIZATION_TYPE_JS_EXPRESSION\";\n      expression: Binding<boolean>;\n    };\n\nexport declare class Api {\n  constructor(name: string, blocks?: Block[], authorization?: Authorization);\n}\n```\n\n**Note:** Integration-specific type definitions (PostgreSQL, Snowflake, OpenApi, etc.) are provided when you specify `integrationIds` in the tool call. JavaScript and Python block definitions are included in the \"Built-in Blocks\" section.\n";
+/**
+ * Minimum plugin versions required for parameterized query support.
+ * These versions align with VERSION_SPECIFIC_TYPE_DEFINITIONS in integration-types.ts.
+ *
+ * @remarks Exported for testing purposes to validate consistency with VERSION_SPECIFIC_TYPE_DEFINITIONS
+ */
+export declare const SQL_PLUGIN_MIN_VERSIONS_FOR_PARAMETERS: Record<string, SemVer>;
+/**
+ * Check if any SQL plugin in the organization supports parameterized queries
+ * based on its execution version.
+ *
+ * @param pluginVersions - Map of plugin IDs to their execution versions
+ * @returns true if at least one SQL plugin has a version that supports parameters
+ *
+ * @remarks Exported for testing purposes
+ */
+export declare function anySqlPluginSupportsParameters(pluginVersions?: PluginExecutionVersions): boolean;
+/**
+ * Get SQL best practices section with conditional parameterized queries documentation.
+ * Only includes parameterized queries guidance when:
+ * 1. The feature flag is enabled, AND
+ * 2. At least one SQL plugin has a version that supports parameters
+ *
+ * @param options - Configuration options including feature flags and plugin versions
+ * @returns SQL best practices documentation string
+ *
+ * @remarks Exported for testing purposes
+ */
+export declare function getSqlBestPractices(options?: {
+    parameterizedApisEnabled?: boolean;
+    pluginExecutionVersions?: PluginExecutionVersions;
+}): string;
+/**
+ * API structure requirements
+ *
+ * @remarks Exported for testing purposes to validate completeness
+ */
+export declare const API_STRUCTURE = "\n## \uD83C\uDFD7\uFE0F API Structure Requirements\n\n### File Structure\n```typescript\n// Path: /apis/apiName.ts\n\n// \u2705 ALWAYS import the required types from the library\nimport {\n  Api,\n  JavaScript,\n  Python,\n  Databricks,\n  Snowflake,\n  PostgreSQL,\n  GraphQL,\n  RestApi,\n  S3,\n  Email,\n  Conditional,\n  TryCatch,\n  Loop,\n  Parallel,\n  Throw,\n  Return,\n  Break,\n} from \"@superblocksteam/library\";\n\n// \u274C NEVER define constants here - they won't be serialized!\n\n// \u2705 ALL logic must be inside new Api()\nexport default new Api(\"apiName\", [\n  // Workflow blocks here\n]);\n```\n\n**\uD83D\uDEA8 CRITICAL:** Only code inside `new Api()` is serialized. Constants/helpers defined outside cause `ReferenceError` at runtime.\n\n### Basic Workflow Structure\n```typescript\n// 1. Input validation\n// 2. Data fetching (integrations)\n// 3. Data processing (JavaScript/Python)\n// 4. Error handling (Try/Catch)\n// 5. Return formatted output\n```\n";
+/**
+ * Build documentation for specific integrations including TypeScript types
+ */
+export declare function buildIntegrationDocumentation(integrationIds: string[], services: ClarkStateHandlerParams): string;
+/**
+ * Get relevant examples based on integration types
+ */
+export declare function getRelevantExamples(integrationIds: string[], services: ClarkStateHandlerParams): string;
+export declare const getApiDocsToolFactory: import("../../tools2/types.js").ToolFactory<ClarkStateHandlerParams, import("../../tools2/types.js").Tool<{
+    integrationIds?: string[] | undefined;
+    sections?: ("checklist" | "examples" | "error-handling" | "core" | "types" | "integration-workflow" | "scoping" | "patterns" | "sql-best-practices" | "database-naming" | "response-interface" | "runtime-safety" | "error-recovery" | "loop-control" | "api-structure" | "critical-mistakes" | "built-in-blocks")[] | undefined;
+    verbosity?: "minimal" | "standard" | "comprehensive" | undefined;
+}, {
+    documentation: string;
+    integrationCount: number;
+    sectionsIncluded: string[];
+    verbosity: "minimal" | "standard" | "comprehensive";
+}>>;
+//# sourceMappingURL=get-api-docs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-api-docs.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/get-api-docs.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,MAAM,EACZ,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAenF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,6yGAgJ5B,CAAC;AA06BF;;;;;GAKG;AACH,eAAO,MAAM,sCAAsC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAczE,CAAC;AAUF;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,cAAc,CAAC,EAAE,uBAAuB,GACvC,OAAO,CAeT;AA0CD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE;IAC5C,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;CACnD,GAAG,MAAM,CA+ET;AAqPD;;;;GAIG;AACH,eAAO,MAAM,aAAa,69BA8CzB,CAAC;AAuaF;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,MAAM,EAAE,EACxB,QAAQ,EAAE,uBAAuB,GAChC,MAAM,CA8ER;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EAAE,EACxB,QAAQ,EAAE,uBAAuB,GAChC,MAAM,CAmER;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;GAsLjC,CAAC"}