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

package/dist/ai-service/agent/{subagents → tools}/apis/api-executor.js

@@ -42,6 +42,7 @@ import { Api as ProtoApi } from "@superblocksteam/types";
 import { getLogger, getErrorMeta } from "../../../../util/logger.js";
 import llmobs from "../../../llmobs/index.js";
 import { safeJsonStringify } from "../../../util/safe-stringify.js";
+import { validateBlockFieldNames } from "./build-api-artifact.js";
 let ApiExecutor = (() => {
     let _instanceExtraInitializers = [];
     let _execute_decorators;
@@ -68,72 +69,48 @@ let ApiExecutor = (() => {
         async execute(api, inputs = {}) {
             const logger = getLogger();
             const startTime = Date.now();
+            const apiName = api.type === "fetch" ? api.apiName : api.definition.metadata.name;
+            logger.info(`Executing API ${apiName}`, api.type === "inline" ? safeJsonStringify(api.definition, 2) : "");
             try {
                 // Validate proto compatibility before execution
-                this.validateProtoCompatibility(api);
-                logger.info(`Executing API ${api.metadata.name}:\n${safeJsonStringify(api, 2)}`);
+                if (api.type === "inline") {
+                    this.validateProtoCompatibility(api.definition);
+                }
                 // Step 3: Execute via aiExecuteV2Api
                 const result = await this.editorClient.call.aiExecuteV2Api({
                     api,
                     inputs,
                 });
-                // Step 4: Handle execution result
-                if (result.error) {
-                    // Parse error for helpful details
-                    const errorDetails = this.parseExecutionError(result.error);
-                    return {
-                        success: false,
-                        error: result.error,
-                        errorDetails,
-                        executionTime: Date.now() - startTime,
-                    };
+                let errors = result.errors?.map((err) => ({
+                    ...this.parseExecutionError(err.message),
+                    handled: err.handled,
+                }));
+                const topLevelError = result.systemError;
+                if (!errors?.length && typeof topLevelError === "string") {
+                    errors = [this.parseExecutionError(topLevelError)];
                 }
+                const success = !result.systemError &&
+                    (!errors || errors.length === 0 || errors.every((err) => err.handled));
                 return {
-                    success: true,
-                    outputs: result.outputs || {},
+                    success,
+                    outputs: result.outputs,
                     executionTime: Date.now() - startTime,
+                    systemError: result.systemError,
+                    errors,
                 };
             }
             catch (error) {
-                logger.error(`API execution failed for ${api.metadata.name}:`, getErrorMeta(error));
-                // Handle different error types
-                if (error instanceof Error) {
-                    if (error.message.includes("Proto")) {
-                        return {
-                            success: false,
-                            error: error.message,
-                            errorDetails: {
-                                type: "proto",
-                                message: error.message,
-                                suggestion: this.getProtoErrorSuggestion(error.message),
-                                originalError: error,
-                            },
-                            executionTime: Date.now() - startTime,
-                        };
-                    }
-                    if (error.message.includes("ValidationError")) {
-                        return {
-                            success: false,
-                            error: error.message,
-                            errorDetails: {
-                                type: "validation",
-                                message: error.message,
-                                suggestion: this.getValidationErrorSuggestion(error.message),
-                                originalError: error,
-                            },
-                            executionTime: Date.now() - startTime,
-                        };
-                    }
-                }
-                // Generic error
+                logger.error(`API execution failed for ${apiName}:`, getErrorMeta(error));
+                const parsedError = this.parseExecutionError(error instanceof Error ? error.message : String(error));
                 return {
                     success: false,
-                    error: error instanceof Error ? error.message : String(error),
-                    errorDetails: {
-                        type: "unknown",
-                        message: error instanceof Error ? error.message : String(error),
-                        originalError: error,
-                    },
+                    errors: [
+                        {
+                            ...parsedError,
+                            handled: false,
+                            originalError: error,
+                        },
+                    ],
                     executionTime: Date.now() - startTime,
                 };
             }
@@ -145,7 +122,7 @@ let ApiExecutor = (() => {
         validateProtoCompatibility(api) {
             const logger = getLogger();
             // Check for incorrect generic field names
-            this.validateBlockFieldNames(api);
+            validateBlockFieldNames(api, this.integrationStore);
             try {
                 // Convert to proto and back
                 const proto = ProtoApi.fromJson(api);
@@ -168,89 +145,197 @@ let ApiExecutor = (() => {
             }
         }
         /**
-         * Validate that blocks use the correct plugin field name matching the integration's plugin.id.
+         * Parse error messages to extract the message and body (JSON) separately.
+         *
+         * @param errorMessage - The raw error message that may contain JSON with escaped newlines
+         * @returns Object with message and body if body exists, undefined otherwise
          */
-        validateBlockFieldNames(api) {
-            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;
+        parseErrorMessage(errorMessage) {
+            // Check if the message contains a Body section with JSON
+            // Look for Body: followed by JSON, handling escaped newlines
+            const bodyIndex = errorMessage.indexOf("Body:");
+            if (bodyIndex !== -1) {
+                // Find the JSON part after Body:
+                const afterBody = errorMessage.substring(bodyIndex + 5); // Skip "Body:"
+                const jsonMatch = afterBody.match(/(\{[\s\S]*\})/);
+                if (jsonMatch && jsonMatch[1]) {
+                    try {
+                        // Extract and clean the JSON string
+                        const jsonString = jsonMatch[1]
+                            .replace(/^\\n/, "") // Remove leading \n if present
+                            .replace(/\\n/g, "\n")
+                            .replace(/\\"/g, '"')
+                            .replace(/\\\\/g, "\\");
+                        // Parse and re-stringify with proper formatting
+                        const parsed = JSON.parse(jsonString);
+                        const prettyJson = JSON.stringify(parsed, null, 2);
+                        // Get the part before Body: and remove trailing \n
+                        let messageText = errorMessage.substring(0, bodyIndex);
+                        if (messageText.endsWith("\\n")) {
+                            messageText = messageText.slice(0, -2);
+                        }
+                        return {
+                            message: messageText,
+                            body: prettyJson,
+                        };
+                    }
+                    catch {
+                        // If parsing fails, return undefined to indicate no parseable body
+                        return undefined;
+                    }
                 }
-                // Get the integration header to find the actual plugin type
-                const integrationHeader = this.integrationStore.getHeader(integrationId);
-                if (!integrationHeader) {
-                    logger.warn(`Integration "${integrationId}" not found in store for block "${block.name}"`);
-                    continue;
+            }
+            // If no Body section found, try to detect standalone JSON
+            const jsonMatch = errorMessage.match(/^(.*?)(\{[\s\S]*\})$/);
+            if (jsonMatch && jsonMatch[1] !== undefined && jsonMatch[2]) {
+                try {
+                    const jsonString = jsonMatch[2]
+                        .replace(/\\n/g, "\n")
+                        .replace(/\\"/g, '"')
+                        .replace(/\\\\/g, "\\");
+                    const parsed = JSON.parse(jsonString);
+                    const prettyJson = JSON.stringify(parsed, null, 2);
+                    // Get the non-JSON part as message
+                    const messageText = jsonMatch[1].trim().replace(/\\n/g, "\n");
+                    return {
+                        message: messageText || "Error",
+                        body: prettyJson,
+                    };
                 }
-                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.`);
+                catch {
+                    // If parsing fails, return undefined
+                    return undefined;
                 }
             }
+            // No parseable body found
+            return undefined;
         }
         /**
          * Parse execution errors to provide helpful details.
          */
         parseExecutionError(errorMessage) {
+            // Parse the error message to extract message and body
+            const parsedError = this.parseErrorMessage(errorMessage);
+            // Build messages for different purposes
+            const fullMessage = parsedError
+                ? `${parsedError.message}\n\nBody:\n\n${parsedError.body}`
+                : errorMessage.replace(/\\n/g, "\n");
+            const displayMessage = parsedError
+                ? parsedError.message
+                : errorMessage.replace(/\\n/g, "\n");
+            const bodyDetails = parsedError?.body;
             // Check for common error patterns
+            if (errorMessage.includes("Proto")) {
+                return {
+                    type: "proto",
+                    message: fullMessage,
+                    displayMessage,
+                    bodyDetails,
+                    suggestion: this.getProtoErrorSuggestion(errorMessage),
+                };
+            }
+            if (errorMessage.includes("ValidationError")) {
+                return {
+                    type: "validation",
+                    message: fullMessage,
+                    displayMessage,
+                    bodyDetails,
+                    suggestion: this.getValidationErrorSuggestion(errorMessage),
+                };
+            }
             if (errorMessage.includes("ReferenceError")) {
                 const match = errorMessage.match(/ReferenceError: (\w+) is not defined/);
                 const variable = match?.[1];
                 return {
-                    type: "execution",
-                    message: errorMessage,
-                    suggestion: variable
-                        ? `Variable "${variable}" is not defined. If this is in a Variables block, remember that values are JavaScript expressions - strings must be quoted like '"${variable}"'`
-                        : "Check that all variables are properly defined and string values in Variables blocks are quoted",
+                    type: "binding",
+                    message: fullMessage,
+                    displayMessage,
+                    bodyDetails,
+                    suggestion: (variable ? `Variable "${variable}" is not defined. '` : "") +
+                        "Check that all inputs are supplied and string values in Variables blocks are quoted",
                 };
             }
             if (errorMessage.includes("Integration") &&
                 errorMessage.includes("not found")) {
                 return {
                     type: "validation",
-                    message: errorMessage,
+                    message: fullMessage,
+                    displayMessage,
+                    bodyDetails,
                     suggestion: "Check that the integration ID exists and is accessible. Use listIntegrations to see available integrations.",
                 };
             }
             if (errorMessage.includes("UUID")) {
                 return {
                     type: "validation",
-                    message: errorMessage,
+                    message: fullMessage,
+                    displayMessage,
+                    bodyDetails,
                     suggestion: 'Organization ID must be a valid UUID. Use "00000000-0000-0000-0000-000000000000" for testing.',
                 };
             }
             if (errorMessage.includes("type must not be in list [0]")) {
                 return {
                     type: "validation",
-                    message: errorMessage,
+                    message: fullMessage,
+                    displayMessage,
+                    bodyDetails,
                     suggestion: "Variables block 'type' field must be a non-zero value. Use 1 for TYPE_SIMPLE.",
                 };
             }
+            if (this.isAuthError(errorMessage)) {
+                return {
+                    type: "auth",
+                    message: fullMessage,
+                    displayMessage,
+                    bodyDetails,
+                    suggestion: "There may be an issue with the integration configuration. Verify the integration is set up correctly and the credentials are valid.",
+                };
+            }
+            if (this.isRateLimitError(errorMessage)) {
+                return {
+                    type: "rate_limit",
+                    message: fullMessage,
+                    displayMessage,
+                    bodyDetails,
+                    suggestion: "The integration reported a rate limit. Wait a moment and retry or reduce the frequency of requests.",
+                };
+            }
+            if (this.isBindingError(errorMessage)) {
+                return {
+                    type: "binding",
+                    message: fullMessage,
+                    displayMessage,
+                    bodyDetails,
+                    suggestion: "Review component and state bindings referenced by the API to ensure they exist and are spelled correctly.",
+                };
+            }
             // Generic execution error
             return {
                 type: "execution",
-                message: errorMessage,
+                message: fullMessage,
+                displayMessage,
+                bodyDetails,
             };
         }
+        /**
+         * Determine whether an error message indicates an authentication or authorization failure.
+         */
+        isAuthError(message) {
+            return /(unauthorized|forbidden|permission denied|401|403|oauth|no token|authentication|credential|token.*expired|invalid.*token)/i.test(message);
+        }
+        /**
+         * Determine whether an error message indicates a rate limit condition.
+         */
+        isRateLimitError(message) {
+            return /(429|rate limit|throttled)/i.test(message);
+        }
+        /**
+         * Determine whether an error message indicates missing or incorrect bindings.
+         */
+        isBindingError(message) {
+            return /ReferenceError|is not defined|Cannot read properties/i.test(message);
+        }
         /**
          * Get suggestion for proto errors.
          */

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

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

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

@@ -0,0 +1,19 @@
+import type { ClarkStateHandlerParams } from "../../../state-machine/clark-fsm.js";
+import type { FileArtifact } from "../../../types.js";
+/**
+ * Read the TypeScript source of an API
+ */
+export declare const readApiSource: (services: Pick<ClarkStateHandlerParams, "appShell" | "templateRenderer">, apiName: string, entityNames?: string[]) => Promise<FileArtifact | undefined>;
+/**
+ * Write the TypeScript source of an API to the temporary directory
+ *
+ * This function writes the API source code to a temporary location where it can be
+ * compiled and validated before being persisted to the actual API location.
+ *
+ * @param apiName - The name of the API
+ * @param apiSource - The TypeScript source code of the API
+ * @param services - Service dependencies including app shell for file operations
+ * @returns The path where the API source was written
+ */
+export declare function writeApiSource(apiName: string, apiSource: string, services: ClarkStateHandlerParams): Promise<string>;
+//# sourceMappingURL=api-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-source.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/api-source.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD;;GAEG;AACH,eAAO,MAAM,aAAa,GACxB,UAAU,IAAI,CAAC,uBAAuB,EAAE,UAAU,GAAG,kBAAkB,CAAC,EACxE,SAAS,MAAM,EACf,cAAc,MAAM,EAAE,sCA8CvB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

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

@@ -0,0 +1,73 @@
+import { writeFile, mkdir, readFile } from "fs/promises";
+import path from "path";
+import { Paths } from "../../../const.js";
+import { YamlToApiBuilderTransformer } from "../../../transform/api-builder/to-sdk-transformer.js";
+import { applyFileTransformations, renderPath, } from "../../../transform/shared.js";
+// import { getPageEntitiesFiltered } from "../../utils.js";
+/**
+ * Read the TypeScript source of an API
+ */
+export const readApiSource = async (services, apiName, entityNames) => {
+    const apiTsPath = renderPath(Paths.GeneratedApis, {
+        apiName,
+    }) + ".ts";
+    const tmpPath = renderPath(Paths.Scratch, { path: apiTsPath });
+    if (await services.appShell.pathExists(tmpPath)) {
+        const content = await readFile(tmpPath);
+        const artifact = {
+            type: "file",
+            filePath: apiTsPath,
+            content: content.toString(),
+        };
+        return artifact;
+    }
+    const yamlPath = renderPath(Paths.ApiYamls, {
+        apiName,
+    });
+    const pathExists = await services.appShell.pathExists(yamlPath);
+    if (!pathExists) {
+        return undefined;
+    }
+    const yamlArtifact = {
+        type: "file",
+        filePath: yamlPath,
+        content: "", // xform just needs path params
+    };
+    const [sdkArtifact] = await applyFileTransformations([yamlArtifact], [
+        new YamlToApiBuilderTransformer({
+            appRootDirPath: services.appShell.appRootDirPath,
+            entityNames: entityNames || [],
+            skipCleanup: true,
+            templateRenderer: services.templateRenderer,
+        }),
+    ]);
+    return sdkArtifact;
+};
+/**
+ * Write the TypeScript source of an API to the temporary directory
+ *
+ * This function writes the API source code to a temporary location where it can be
+ * compiled and validated before being persisted to the actual API location.
+ *
+ * @param apiName - The name of the API
+ * @param apiSource - The TypeScript source code of the API
+ * @param services - Service dependencies including app shell for file operations
+ * @returns The path where the API source was written
+ */
+export async function writeApiSource(apiName, apiSource, services) {
+    const apiTsFilePath = renderPath(Paths.GeneratedApis, {
+        apiName,
+    }) + ".ts";
+    const filePath = renderPath(Paths.Scratch, {
+        path: apiTsFilePath,
+    });
+    const fullPath = path.join(services.appShell.appRootDirPath, filePath);
+    const dirPath = path.dirname(fullPath);
+    // Ensure all intermediate directories exist
+    await mkdir(dirPath, { recursive: true });
+    await writeFile(fullPath, apiSource, {
+        encoding: "utf-8",
+    });
+    return apiTsFilePath;
+}
+//# sourceMappingURL=api-source.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-source.js","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/api-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,sDAAsD,CAAC;AACnG,OAAO,EACL,wBAAwB,EACxB,UAAU,GACX,MAAM,8BAA8B,CAAC;AAGtC,4DAA4D;AAE5D;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,QAAwE,EACxE,OAAe,EACf,WAAsB,EACtB,EAAE;IACF,MAAM,SAAS,GACb,UAAU,CAAC,KAAK,CAAC,aAAa,EAAE;QAC9B,OAAO;KACR,CAAC,GAAG,KAAK,CAAC;IACb,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAE/D,IAAI,MAAM,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAiB;YAC7B,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE;SAC5B,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE;QAC1C,OAAO;KACR,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAChE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAG;QACnB,IAAI,EAAE,MAAe;QACrB,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,EAAE,EAAE,+BAA+B;KAC7C,CAAC;IAEF,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,wBAAwB,CAClD,CAAC,YAAY,CAAC,EACd;QACE,IAAI,2BAA2B,CAAC;YAC9B,cAAc,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc;YAChD,WAAW,EAAE,WAAW,IAAI,EAAE;YAC9B,WAAW,EAAE,IAAI;YACjB,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;SAC5C,CAAC;KACH,CACF,CAAC;IAEF,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAe,EACf,SAAiB,EACjB,QAAiC;IAEjC,MAAM,aAAa,GACjB,UAAU,CAAC,KAAK,CAAC,aAAa,EAAE;QAC9B,OAAO;KACR,CAAC,GAAG,KAAK,CAAC;IAEb,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE;QACzC,IAAI,EAAE,aAAa;KACpB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvC,4CAA4C;IAC5C,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,MAAM,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE;QACnC,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAC;IAEH,OAAO,aAAa,CAAC;AACvB,CAAC"}

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

@@ -0,0 +1,51 @@
+import { getPrefixedLogger } from "../../../../util/logger.js";
+import { type Clark, type ClarkStateHandlerParams } from "../../../state-machine/clark-fsm.js";
+import type { ApiExecutionResult, ApiExecutionInputs } from "./api-executor.js";
+import type { ApiIdentifier } from "../../subagents/apis/types.js";
+export declare enum ApiValidationStage {
+    REGISTRATION = "registration",
+    EXECUTE = "execute",
+    AUTH = "auth",
+    RESULTS = "results",
+    METADATA = "metadata"
+}
+export interface ApiValidationIssue {
+    stage: ApiValidationStage;
+    reason: string;
+    recoverable: boolean;
+    attempt: number;
+    error?: string;
+    suggestion?: string;
+}
+export interface ApiValidationPipelineOptions {
+    maxRegistrationAttempts: number;
+    maxExecutionAttempts: number;
+    validateMetadata?: boolean;
+}
+export interface ApiValidationPipelineResult {
+    success: boolean;
+    summary: string;
+    issues: ApiValidationIssue[];
+    attempts: Record<ApiValidationStage, number>;
+    executionResult?: ApiExecutionResult;
+    escalated: boolean;
+}
+export declare class ApiValidationEscalatedError extends Error {
+    readonly issues: ApiValidationIssue[];
+    readonly summary: string;
+    constructor(summary: string, issues: ApiValidationIssue[]);
+}
+export interface RunApiValidationPipelineParams {
+    clark: Clark;
+    services: ClarkStateHandlerParams;
+    identifier: ApiIdentifier;
+    inputs?: ApiExecutionInputs;
+    options?: Partial<ApiValidationPipelineOptions>;
+    logger?: ReturnType<typeof getPrefixedLogger>;
+}
+/**
+ * Execute the automated API validation pipeline, progressing through execution,
+ * authentication, parameter, metadata, and result validation stages.
+ */
+export declare const runApiValidationPipeline: (params: RunApiValidationPipelineParams) => Promise<ApiValidationPipelineResult>;
+//# sourceMappingURL=api-validation-orchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-validation-orchestrator.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/api-validation-orchestrator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EAGL,KAAK,KAAK,EACV,KAAK,uBAAuB,EAC7B,MAAM,qCAAqC,CAAC;AAI7C,OAAO,KAAK,EACV,kBAAkB,EAElB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGnE,oBAAY,kBAAkB;IAC5B,YAAY,iBAAiB;IAC7B,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC3C,uBAAuB,EAAE,MAAM,CAAC;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;IAC7C,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE;CAQ1D;AAED,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,uBAAuB,CAAC;IAClC,UAAU,EAAE,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;CAC/C;AAgBD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,8BAA8B,KACrC,OAAO,CAAC,2BAA2B,CAmTrC,CAAC"}