@superblocksteam/vite-plugin-file-sync 2.0.43-next.14 → 2.0.43-next.15

package/dist/ai-service/agent/subagents/apis/api-executor.d.ts

@@ -0,0 +1,57 @@
+/**
+ * API Executor Service - Handles API execution with enhanced error handling.
+ *
+ * This service provides a wrapper around aiExecuteV2Api with proto validation
+ * and comprehensive error reporting for the AI model.
+ */
+import type { IntegrationStore } from "../../../integrations/store.js";
+import type { EditorClient } from "../../../types.js";
+import type { Api } from "@superblocksteam/library-shared/types";
+export interface ApiExecutionResult {
+    success: boolean;
+    outputs?: Record<string, any>;
+    error?: string;
+    errorDetails?: {
+        type: "validation" | "execution" | "proto" | "unknown";
+        message: string;
+        suggestion?: string;
+        originalError?: any;
+    };
+    executionTime?: number;
+}
+export type ApiExecutionInputs = Record<string, any>;
+export declare class ApiExecutor {
+    private editorClient;
+    private integrationStore;
+    constructor(editorClient: EditorClient, integrationStore: IntegrationStore);
+    /**
+     * Execute an API with comprehensive error handling.
+     *
+     * @param api - The API definition to execute
+     * @param inputs - Input variables for the API
+     * @returns Execution result with outputs or detailed error information
+     */
+    execute(api: Api, inputs?: ApiExecutionInputs): Promise<ApiExecutionResult>;
+    /**
+     * Validate that the API can roundtrip through protobuf.
+     * Throws an error if validation fails.
+     */
+    private validateProtoCompatibility;
+    /**
+     * Validate that blocks use the correct plugin field name matching the integration's plugin.id.
+     */
+    private validateBlockFieldNames;
+    /**
+     * Parse execution errors to provide helpful details.
+     */
+    private parseExecutionError;
+    /**
+     * Get suggestion for proto errors.
+     */
+    private getProtoErrorSuggestion;
+    /**
+     * Get suggestion for validation errors.
+     */
+    private getValidationErrorSuggestion;
+}
+//# sourceMappingURL=api-executor.d.ts.map

package/dist/ai-service/agent/subagents/apis/api-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-executor.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/subagents/apis/api-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,uCAAuC,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE;QACb,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;QACvD,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,GAAG,CAAC;KACrB,CAAC;IACF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAErD,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;gBAE/B,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB;IAK1E;;;;;;OAMG;IAEG,OAAO,CACX,GAAG,EAAE,GAAG,EACR,MAAM,GAAE,kBAAuB,GAC9B,OAAO,CAAC,kBAAkB,CAAC;IAuF9B;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAkClC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAkD/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqD3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAa/B;;OAEG;IACH,OAAO,CAAC,4BAA4B;CASrC"}

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

@@ -0,0 +1,284 @@
+/**
+ * API Executor Service - Handles API execution with enhanced error handling.
+ *
+ * This service provides a wrapper around aiExecuteV2Api with proto validation
+ * and comprehensive error reporting for the AI model.
+ */
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+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";
+let ApiExecutor = (() => {
+    let _instanceExtraInitializers = [];
+    let _execute_decorators;
+    return class ApiExecutor {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _execute_decorators = [llmobs.decorate({ name: "ApiExecutor.execute", kind: "task" })];
+            __esDecorate(this, null, _execute_decorators, { kind: "method", name: "execute", static: false, private: false, access: { has: obj => "execute" in obj, get: obj => obj.execute }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        editorClient = __runInitializers(this, _instanceExtraInitializers);
+        integrationStore;
+        constructor(editorClient, integrationStore) {
+            this.editorClient = editorClient;
+            this.integrationStore = integrationStore;
+        }
+        /**
+         * Execute an API with comprehensive error handling.
+         *
+         * @param api - The API definition to execute
+         * @param inputs - Input variables for the API
+         * @returns Execution result with outputs or detailed error information
+         */
+        async execute(api, inputs = {}) {
+            const logger = getLogger();
+            const startTime = Date.now();
+            try {
+                // Validate proto compatibility before execution
+                this.validateProtoCompatibility(api);
+                logger.info(`Executing API ${api.metadata.name}:\n${safeJsonStringify(api, 2)}`);
+                // 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,
+                    };
+                }
+                return {
+                    success: true,
+                    outputs: result.outputs || {},
+                    executionTime: Date.now() - startTime,
+                };
+            }
+            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
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : String(error),
+                    errorDetails: {
+                        type: "unknown",
+                        message: error instanceof Error ? error.message : String(error),
+                        originalError: error,
+                    },
+                    executionTime: Date.now() - startTime,
+                };
+            }
+        }
+        /**
+         * Validate that the API can roundtrip through protobuf.
+         * Throws an error if validation fails.
+         */
+        validateProtoCompatibility(api) {
+            const logger = getLogger();
+            // Check for incorrect generic field names
+            this.validateBlockFieldNames(api);
+            try {
+                // Convert to proto and back
+                const proto = ProtoApi.fromJson(api);
+                const roundtripped = proto.toJson();
+                // Basic validation that critical fields survived
+                if (!roundtripped.metadata?.name) {
+                    throw new Error("Critical metadata fields lost in proto conversion");
+                }
+                logger.debug(`Proto validation passed for API ${api.metadata.name}`);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                logger.error(`Proto validation failed for API ${api.metadata.name}: ${message}`);
+                throw new Error(`Proto validation failed: ${message}\n` +
+                    `Common issues:\n` +
+                    `- Boolean fields: Omit false values instead of including them\n` +
+                    `- Enum values: Use exact string values from the schema\n` +
+                    `- Required fields: Ensure all required fields are present\n` +
+                    `- Field types: Ensure values match expected types`);
+            }
+        }
+        /**
+         * Validate that blocks use the correct plugin field name matching the integration's plugin.id.
+         */
+        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;
+                }
+                // 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;
+                }
+                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.`);
+                }
+            }
+        }
+        /**
+         * Parse execution errors to provide helpful details.
+         */
+        parseExecutionError(errorMessage) {
+            // Check for common error patterns
+            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",
+                };
+            }
+            if (errorMessage.includes("Integration") &&
+                errorMessage.includes("not found")) {
+                return {
+                    type: "validation",
+                    message: errorMessage,
+                    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,
+                    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,
+                    suggestion: "Variables block 'type' field must be a non-zero value. Use 1 for TYPE_SIMPLE.",
+                };
+            }
+            // Generic execution error
+            return {
+                type: "execution",
+                message: errorMessage,
+            };
+        }
+        /**
+         * Get suggestion for proto errors.
+         */
+        getProtoErrorSuggestion(errorMessage) {
+            if (errorMessage.includes("boolean")) {
+                return "Omit boolean fields that are false. Only include them when true.";
+            }
+            if (errorMessage.includes("enum")) {
+                return "Check that enum values use the exact string constants from the schema.";
+            }
+            if (errorMessage.includes("required")) {
+                return "Ensure all required fields are present: metadata.id, metadata.name, metadata.organization";
+            }
+            return "Review the API structure against the schema. Common issues: false booleans should be omitted, enums need exact values.";
+        }
+        /**
+         * Get suggestion for validation errors.
+         */
+        getValidationErrorSuggestion(errorMessage) {
+            if (errorMessage.includes("integration")) {
+                return "Check that all integration IDs referenced in blocks actually exist";
+            }
+            if (errorMessage.includes("Variables")) {
+                return "Variables block values are JavaScript expressions - strings need quotes";
+            }
+            return "Review the API against the validation requirements";
+        }
+    };
+})();
+export { ApiExecutor };
+//# sourceMappingURL=api-executor.js.map

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

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

package/dist/ai-service/agent/subagents/apis/context.d.ts

@@ -0,0 +1,12 @@
+import type { ApiIdentifier } from "./types.js";
+/**
+ * Context for API generation tasks.
+ *
+ * This context gets passed into tool calls made by the subagent
+ */
+export declare class ApiGenerationContext {
+    id: ApiIdentifier;
+    constructor(id: ApiIdentifier);
+    static from(input: unknown): ApiGenerationContext | null;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/ai-service/agent/subagents/apis/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/subagents/apis/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,EAAE,EAAE,aAAa,CAAC;gBAEN,EAAE,EAAE,aAAa;IAI7B,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI;CAMzD"}

package/dist/ai-service/agent/subagents/apis/context.js

@@ -0,0 +1,18 @@
+/**
+ * Context for API generation tasks.
+ *
+ * This context gets passed into tool calls made by the subagent
+ */
+export class ApiGenerationContext {
+    id;
+    constructor(id) {
+        this.id = id;
+    }
+    static from(input) {
+        if (input instanceof ApiGenerationContext) {
+            return input;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/ai-service/agent/subagents/apis/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../../src/ai-service/agent/subagents/apis/context.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IAC/B,EAAE,CAAgB;IAElB,YAAY,EAAiB;QAC3B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAc;QACxB,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

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

@@ -1,18 +1,10 @@
 import type { OperationQueue } from "../../../../util/operation-queue.js";
 import type { Clark, ClarkStateHandlerParams } from "../../../state-machine/clark-fsm.js";
-import type { FileArtifact } from "../../../types.js";
-import type { PromptContext, PromptContextIntegration } from "@superblocksteam/library-shared/types";
-export declare const buildApiTools: (input: {
-    apiName: string;
-    pageName: string;
-    prompt: string;
-}, isNewApi: boolean, promptContext: PromptContext | undefined, clark: Clark, services: ClarkStateHandlerParams, scopeUpdateQueue: OperationQueue, onFinalized: (message: string) => void) => {
-    readIntegrationMetadata: import("ai").Tool<{
-        integrationId: string;
-    }, Record<string, any>>;
-    fetchIntegration: import("ai").Tool<{
-        integrationId: string;
-    }, PromptContextIntegration | undefined>;
+export declare const buildApiTools: (clark: Clark, services: ClarkStateHandlerParams, scopeUpdateQueue: OperationQueue) => {
+    readIntegrationMetadata: import("./../../tools2/types.js").Tool<{
+        integrationIds: string[];
+        prompt: string;
+    }, string>;
     searchIntegrations: import("./../../tools2/types.js").Tool<{
         type?: import("@superblocksteam/shared").PluginType;
         name?: string;
@@ -40,44 +32,58 @@ export declare const buildApiTools: (input: {
             type: "other";
             body: string;
         };
-    }, string | undefined>;
-    buildApi: import("ai").Tool<{
-        apiName: string;
+    }, string>;
+    buildApi: import("./../../tools2/types.js").Tool<{
+        id: {
+            pageName: string;
+            apiName: string;
+        };
         apiSource: string;
     }, {
         message: string;
         apiName: string;
         pageName: string;
-    }>;
-    finalizeApi: import("ai").Tool<{
+    } | {
+        execution: {
+            message: string;
+            outputs: string;
+        };
+        message: string;
         apiName: string;
+        pageName: string;
+    }>;
+    finalizeApi: import("./../../tools2/types.js").Tool<{
+        id: {
+            pageName: string;
+            apiName: string;
+        };
         summary: string;
         responseInterface: string;
         inputInterface: string;
         givingUpDueToFatalError?: boolean | undefined;
     }, {
-        message: string;
-        apiName: string;
         pageName: string;
+        apiName: string;
+        message: string;
     }>;
 };
-export declare const readApiSource: (pageName: string, apiName: string, pageEntityNames: string[] | undefined, services: ClarkStateHandlerParams) => Promise<FileArtifact | undefined>;
+export declare const readApiSource: (pageName: string, apiName: string, pageEntityNames: string[] | undefined, services: ClarkStateHandlerParams) => Promise<import("../../../types.js").FileArtifact | undefined>;
 export declare const generateApiSourceSubagentToolFactory: import("./../../tools2/types.js").ToolFactory<import("./../../tools2/types.js").Tool<{
+    id: {
+        pageName: string;
+        apiName: string;
+    };
     action: "create" | "edit";
-    pageName: string;
-    apiName: string;
     prompt: string;
     exampleHints?: ("databricks" | "snowflake" | "validation" | "conditional" | "loop" | "trycatch" | "nested-control-flow" | "scope-access" | "variable-access" | "error-handling" | "data-transformation" | "batch-processing" | "global-context" | "multi-integration" | "data-science" | "sql-query" | "aggregation" | "error-scope-violation" | "error-execution-order")[] | undefined;
 }, {
+    isNewApi: boolean;
+} & {
+    status: "finalized";
     message: string;
-    apiName: string;
-    pageName: string;
-    apiData: {
-        apiName: string;
-        summary: string;
-        responseInterface: string;
-        inputInterface: string;
-        givingUpDueToFatalError?: boolean | undefined;
+    interface: {
+        input: string;
+        output: string;
     };
 }>>;
 //# sourceMappingURL=generate-api-source.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"generate-api-source.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/subagents/apis/generate-api-source.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,EACV,KAAK,EACL,uBAAuB,EACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EACV,aAAa,EACb,wBAAwB,EAIzB,MAAM,uCAAuC,CAAC;AAE/C,eAAO,MAAM,aAAa,GACxB,OAAO;IACL,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,EACD,UAAU,OAAO,EACjB,eAAe,aAAa,GAAG,SAAS,EACxC,OAAO,KAAK,EACZ,UAAU,uBAAuB,EACjC,kBAAkB,cAAc,EAEhC,aAAa,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;yBAmDJ,CAAC;uBAErB,CAAC;;;;;;uBAUS,CAAC;2BACyB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;CA6KpD,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,UAAU,MAAM,EAChB,SAAS,MAAM,EACf,iBAAiB,MAAM,EAAE,GAAG,SAAS,EACrC,UAAU,uBAAuB,sCA0ClC,CAAC;AAEF,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;GA6fhD,CAAC"}
+{"version":3,"file":"generate-api-source.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/subagents/apis/generate-api-source.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,EACV,KAAK,EACL,uBAAuB,EACxB,MAAM,qCAAqC,CAAC;AAS7C,eAAO,MAAM,aAAa,GACxB,OAAO,KAAK,EACZ,UAAU,uBAAuB,EACjC,kBAAkB,cAAc;;;;;;;;;;;;;;;;;;yBAiFW,CAAC;uBAGX,CAAC;;;;;;uBAEvB,CAAC;2BAAsD,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAnEnE,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,UAAU,MAAM,EAChB,SAAS,MAAM,EACf,iBAAiB,MAAM,EAAE,GAAG,SAAS,EACrC,UAAU,uBAAuB,kEA0ClC,CAAC;AAEF,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;GAshBhD,CAAC"}