donobu 3.5.4 → 3.6.0

package/dist/esm/managers/DonobuFlowsManager.d.ts

@@ -11,6 +11,7 @@ import type { ControlPanelFactory } from '../models/ControlPanel';
 import type { CreateDonobuFlow } from '../models/CreateDonobuFlow';
 import type { DonobuAgent } from '../models/DonobuAgentType';
 import type { DonobuDeploymentEnvironment } from '../models/DonobuDeploymentEnvironment';
+import type { FlowHandle } from '../models/FlowHandle';
 import type { FlowMetadata } from '../models/FlowMetadata';
 import type { FlowsQuery } from '../models/FlowMetadata';
 import type { PaginatedResult } from '../models/PaginatedResult';
@@ -24,10 +25,7 @@ import type { GptConfigsManager } from './GptConfigsManager';
 /**
  * Response wrapper for `createFlow` calls.
  */
-export interface FlowHandle {
-    donobuFlow: DonobuFlow;
-    job: Promise<Record<string, unknown> | null>;
-}
+export type { FlowHandle };
 export declare class DonobuFlowsManager {
     private readonly deploymentEnvironment;
     private readonly gptClientFactory;
@@ -40,8 +38,10 @@ export declare class DonobuFlowsManager {
     static readonly DEFAULT_MESSAGE_DURATION = 2247;
     static readonly DEFAULT_MAX_TOOL_CALLS = 50;
     static readonly DEFAULT_BROWSER_STATE_FILENAME = "browserstate.json";
-    private readonly activeFlows;
-    constructor(deploymentEnvironment: DonobuDeploymentEnvironment, gptClientFactory: GptClientFactory, gptConfigsManager: GptConfigsManager, agentsManager: AgentsManager, flowsPersistenceFactory: FlowsPersistenceFactory, envDataManager: EnvDataManager, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_BEDROCK_MODEL_NAME' | 'BASE64_GPT_CONFIG' | 'BROWSERBASE_API_KEY' | 'BROWSERBASE_PROJECT_ID' | 'DONOBU_API_KEY' | 'GOOGLE_GENERATIVE_AI_API_KEY' | 'GOOGLE_GENERATIVE_AI_MODEL_NAME' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME'>);
+    private readonly flowRuntime;
+    private readonly flowCatalog;
+    private readonly flowDependencyResolver;
+    constructor(deploymentEnvironment: DonobuDeploymentEnvironment, gptClientFactory: GptClientFactory, gptConfigsManager: GptConfigsManager, agentsManager: AgentsManager, flowsPersistenceFactory: FlowsPersistenceFactory, envDataManager: EnvDataManager, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_ACCESS_KEY_ID' | 'AWS_BEDROCK_MODEL_NAME' | 'AWS_SECRET_ACCESS_KEY' | 'BASE64_GPT_CONFIG' | 'BROWSERBASE_API_KEY' | 'BROWSERBASE_PROJECT_ID' | 'DONOBU_API_KEY' | 'GOOGLE_GENERATIVE_AI_API_KEY' | 'GOOGLE_GENERATIVE_AI_MODEL_NAME' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME'>);
     /**
      * Create a flow with the given parameters and invoke its `DonobuFlow#run`
      * method, adding it to list of active flows.
@@ -110,14 +110,15 @@ export declare class DonobuFlowsManager {
      */
     getFlowsAsPlaywrightProject(flowIds: string[], options: CodeGenerationOptions): Promise<GeneratedProject>;
     /**
-     * Creates a GPT client using the provided GPT configuration by name. If the
-     * configuration name is null, or resolves to a missing configuration, then
-     * the default GPT configuration associated with the 'flow-runner' agent is
-     * used.
+     * Resolves a GPT client using the provided GPT configuration name, falling back
+     * to environment-provided configs (BASE64_GPT_CONFIG, DONOBU_API_KEY,
+     * AWS_BEDROCK_MODEL_NAME, ANTHROPIC_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY,
+     * OPENAI_API_KEY) and finally the config bound to the 'flow-runner' agent.
+     * Returns a null client if no configuration source is available.
      *
-     * This method is public for testing purposes only.
+     * Public for testing only.
      **/
-    createGptClient(gptConfigName: string | null): Promise<{
+    createGptClient(gptConfigName?: string): Promise<{
         gptConfigName: string | null;
         agentName: DonobuAgent | null;
         gptClient: GptClient | null;
@@ -127,34 +128,6 @@ export declare class DonobuFlowsManager {
      * {@link BrowserStateNotFoundException} if it is not found.
      */
     getBrowserStorageState(browserStateRef: BrowserStateReference): Promise<BrowserStorageState>;
-    /**
-     * Creates a dictionary of environment variables from allowed variable names.
-     *
-     * This method retrieves environment variable values for each of the provided names
-     * from the environment data manager. Only environment variables that exist in
-     * the environment data manager will be included in the result.
-     *
-     * @param allowedEnvVarsByName - Array of environment variable names that are allowed to be accessed.
-     * @returns A record mapping environment variable names to their values.
-     *
-     * @example
-     * // Returns { "API_KEY": "abc123", "BASE_URL": "https://example.com" }
-     * await buildEnvData(["API_KEY", "BASE_URL", "MISSING_VAR"]);
-     */
-    buildEnvData(allowedEnvVarsByName: string[]): Promise<Record<string, string>>;
-    /**
-     * Extracts dependencies for a single flow by analyzing its browser.initialState
-     */
-    private extractFlowDependencies;
-    /**
-     * Resolves the complete set of flow IDs including all transitive dependencies.
-     * Uses breadth-first search to discover all dependencies recursively.
-     */
-    private resolveFlowDependencies;
-    /**
-     * Determines if a new flow ID should replace an existing flow ID in the name mapping.
-     */
-    private shouldReplaceFlowMapping;
     private isLocallyRunning;
 }
 /**

package/dist/esm/managers/DonobuFlowsManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DonobuFlowsManager.d.ts","sourceRoot":"","sources":["../../../src/managers/DonobuFlowsManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DonobuFlowsManager.d.ts","sourceRoot":"","sources":["../../../src/managers/DonobuFlowsManager.ts"],"names":[],"mappings":"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"}

package/dist/esm/managers/DonobuFlowsManager.js

@@ -66,7 +66,9 @@ const Logger_1 = require("../utils/Logger");
 const MiscUtils_1 = require("../utils/MiscUtils");
 const TemplateInterpolator_1 = require("../utils/TemplateInterpolator");
 const DonobuFlow_1 = require("./DonobuFlow");
-const FlowDependencyAnalyzer_1 = require("./FlowDependencyAnalyzer");
+const FlowCatalog_1 = require("./FlowCatalog");
+const FlowDependencyResolver_1 = require("./FlowDependencyResolver");
+const FlowRuntime_1 = require("./FlowRuntime");
 const InteractionVisualizer_1 = require("./InteractionVisualizer");
 const ToolManager_1 = require("./ToolManager");
 class DonobuFlowsManager {
@@ -79,7 +81,9 @@ class DonobuFlowsManager {
         this.envDataManager = envDataManager;
         this.controlPanelFactory = controlPanelFactory;
         this.environ = environ;
-        this.activeFlows = new Map();
+        this.flowRuntime = new FlowRuntime_1.FlowRuntime();
+        this.flowCatalog = new FlowCatalog_1.FlowCatalog(this.flowsPersistenceFactory, this.flowRuntime, this.deploymentEnvironment);
+        this.flowDependencyResolver = new FlowDependencyResolver_1.FlowDependencyResolver(this.flowCatalog);
     }
     /**
      * Create a flow with the given parameters and invoke its `DonobuFlow#run`
@@ -101,7 +105,7 @@ class DonobuFlowsManager {
                     agentName: null,
                     gptClient: gptClient,
                 }
-                : await this.createGptClient(flowParams.gptConfigNameOverride ?? null);
+                : await this.createGptClient(flowParams.gptConfigNameOverride ?? undefined);
             const initialRunMode = flowParams.initialRunMode ??
                 (gptClientData.gptClient ? 'AUTONOMOUS' : 'INSTRUCT');
             const browserConfig = flowParams.browser ?? getDefaultBrowserConfig(this.environ);
@@ -162,7 +166,7 @@ class DonobuFlowsManager {
                 : await createTempDirectoryForFlow(flowMetadata.id);
             try {
                 const flowsPersistence = await this.flowsPersistenceFactory.createPersistenceLayer();
-                const envData = await this.buildEnvData(flowMetadata.envVars ?? []);
+                const envData = await this.envDataManager.getByNames(flowMetadata.envVars ?? []);
                 const browserContext = browserContextOverride
                     ? browserContextOverride
                     : await BrowserUtils_1.BrowserUtils.create(browserConfig, tempVideoDir, flowParams.browser?.initialState
@@ -176,17 +180,15 @@ class DonobuFlowsManager {
                         current: null,
                     }, flowMetadata, controlPanel);
                     await flowsPersistence.setFlowMetadata(flowMetadata);
-                    // Add to activeFlows BEFORE starting the job so that if a flow
-                    // immediately completes (perhaps due to an error), it will still be
-                    // cleaned up correctly.
                     const flowHandle = {
                         donobuFlow: donobuFlow,
                         job: Promise.resolve(null), // Temporary placeholder.
                     };
-                    this.activeFlows.set(flowMetadata.id, flowHandle);
+                    // Register BEFORE starting the job so cleanup always runs.
+                    this.flowRuntime.register(flowHandle);
                     flowHandle.job = donobuFlow.run().finally(async () => {
                         try {
-                            this.activeFlows.delete(donobuFlow.metadata.id);
+                            this.flowRuntime.remove(donobuFlow.metadata.id);
                         }
                         catch (error) {
                             Logger_1.appLogger.error('Failed to delete active flow:', error);
@@ -223,7 +225,7 @@ class DonobuFlowsManager {
     async renameFlow(flowId, name) {
         validateFlowName(name);
         const activeFlowHandle = this.isLocallyRunning()
-            ? this.activeFlows.get(flowId)
+            ? this.flowRuntime.get(flowId)
             : null;
         // If the flow is active, we need to rename it at both its in-memory location
         // and its persisted location.
@@ -278,7 +280,7 @@ class DonobuFlowsManager {
     /** Add a proposed tool call the tool call queue for the given flow by ID. */
     async proposeToolCall(flowId, toolName, parameters) {
         const activeFlowHandle = this.isLocallyRunning()
-            ? this.activeFlows.get(flowId)
+            ? this.flowRuntime.get(flowId)
             : null;
         if (!activeFlowHandle) {
             throw new ActiveFlowNotFoundException_1.ActiveFlowNotFoundException(flowId);
@@ -303,7 +305,7 @@ class DonobuFlowsManager {
         if (!this.isLocallyRunning()) {
             throw new ActiveFlowNotFoundException_1.ActiveFlowNotFoundException(flowId);
         }
-        const activeFlowHandle = this.activeFlows.get(flowId);
+        const activeFlowHandle = this.flowRuntime.get(flowId);
         if (!activeFlowHandle) {
             throw new ActiveFlowNotFoundException_1.ActiveFlowNotFoundException(flowId);
         }
@@ -313,70 +315,7 @@ class DonobuFlowsManager {
      * Get flows metadata across multiple persistence layers with pagination and filtering.
      */
     async getFlows(query) {
-        // Parse the composite page token or create initial state.
-        const paginationState = parseCompositePageToken(query.pageToken);
-        const requestedLimit = Math.min(Math.max(1, query.limit || 100), 100);
-        // Results container.
-        const combinedResults = [];
-        // Get all persistence layers.
-        const persistenceLayers = await this.flowsPersistenceFactory.createPersistenceLayers();
-        // Query each persistence layer with its own pagination.
-        for (let i = 0; i < persistenceLayers.length; i++) {
-            // Skip layers we've already exhausted.
-            if (paginationState.exhaustedSources.includes(i)) {
-                continue;
-            }
-            // Calculate per-source limit - we need more than requested to merge
-            // properly.
-            //
-            // Double the limit to ensure we have enough data for sorting/merging.
-            const sourceLimit = Math.min(requestedLimit * 2, 100);
-            // Create a source-specific query, preserving all filter params
-            const sourceQuery = {
-                ...query,
-                limit: sourceLimit,
-                pageToken: paginationState.sourceTokens[i],
-            };
-            const sourceResult = await persistenceLayers[i].getFlowsMetadata(sourceQuery);
-            // Wrap each item with its source index.
-            const itemsWithSource = sourceResult.items.map((flow) => ({
-                flow,
-                sourceIndex: i,
-            }));
-            // Add to combined results.
-            combinedResults.push(...itemsWithSource);
-            // Update pagination state.
-            if (sourceResult.nextPageToken) {
-                paginationState.sourceTokens[i] = sourceResult.nextPageToken;
-            }
-            else {
-                // Mark this source as exhausted.
-                paginationState.exhaustedSources.push(i);
-            }
-        }
-        // Sort all results by creation date (newest first).
-        combinedResults.sort((a, b) => {
-            return (b.flow.startedAt || 0) - (a.flow.startedAt || 0);
-        });
-        // Take only the requested limit.
-        const limitedResults = combinedResults.slice(0, requestedLimit);
-        // Get the last timestamp for cursor-based continuation.
-        const lastTimestamp = limitedResults.length > 0
-            ? limitedResults[limitedResults.length - 1].flow.startedAt
-            : null;
-        // Update the cursor timestamp in pagination state.
-        paginationState.cursorTimestamp = lastTimestamp;
-        // Are there more results?
-        const hasMore = combinedResults.length > requestedLimit ||
-            paginationState.exhaustedSources.length < persistenceLayers.length;
-        // Extract just the flow metadata objects for return.
-        const cleanResults = limitedResults.map((item) => item.flow);
-        return {
-            items: cleanResults,
-            nextPageToken: hasMore
-                ? createCompositePageToken(paginationState)
-                : undefined,
-        };
+        return this.flowCatalog.getFlows(query);
     }
     /**
      * Returns the metadata for the given flow by ID. If the flow is active, the
@@ -385,60 +324,17 @@ class DonobuFlowsManager {
      * not active, a copy of the persisted metadata is returned.
      */
     async getFlowById(flowId) {
-        const activeFlowHandle = this.isLocallyRunning()
-            ? this.activeFlows.get(flowId)
-            : null;
-        if (activeFlowHandle) {
-            return activeFlowHandle.donobuFlow.metadata;
-        }
-        for (const persistence of await this.flowsPersistenceFactory.createPersistenceLayers()) {
-            try {
-                return await persistence.getFlowMetadataById(flowId);
-            }
-            catch (error) {
-                if (!(error instanceof FlowNotFoundException_1.FlowNotFoundException)) {
-                    throw error;
-                }
-            }
-        }
-        throw FlowNotFoundException_1.FlowNotFoundException.forId(flowId);
+        return this.flowCatalog.getFlowById(flowId);
     }
     /**
      * Returns the metadata for the given flow by name.
      */
     async getFlowByName(flowName) {
-        for (const persistence of await this.flowsPersistenceFactory.createPersistenceLayers()) {
-            try {
-                return await persistence.getFlowMetadataByName(flowName);
-            }
-            catch (error) {
-                if (!(error instanceof FlowNotFoundException_1.FlowNotFoundException)) {
-                    throw error;
-                }
-            }
-        }
-        throw FlowNotFoundException_1.FlowNotFoundException.forName(flowName);
+        return this.flowCatalog.getFlowByName(flowName);
     }
     /** Returns all the tool calls made by the given flow by ID. */
     async getToolCalls(flowId) {
-        const activeFlowHandle = this.isLocallyRunning()
-            ? this.activeFlows.get(flowId)
-            : null;
-        if (activeFlowHandle) {
-            return [...activeFlowHandle.donobuFlow.invokedToolCalls].sort((a, b) => new Date(a.startedAt).getTime() - new Date(b.startedAt).getTime());
-        }
-        const persistenceLayers = await this.flowsPersistenceFactory.createPersistenceLayers();
-        for (const persistence of persistenceLayers) {
-            try {
-                return await persistence.getToolCalls(flowId);
-            }
-            catch (error) {
-                if (!(error instanceof FlowNotFoundException_1.FlowNotFoundException)) {
-                    throw error;
-                }
-            }
-        }
-        throw FlowNotFoundException_1.FlowNotFoundException.forId(flowId);
+        return this.flowCatalog.getToolCalls(flowId);
     }
     /**
      * Attempts to delete a flow by ID. If the flow is active, then
@@ -447,14 +343,12 @@ class DonobuFlowsManager {
      */
     async deleteFlowById(flowId) {
         const activeFlow = this.isLocallyRunning()
-            ? this.activeFlows.get(flowId)
+            ? this.flowRuntime.get(flowId)
             : null;
         if (activeFlow) {
             throw new CannotDeleteRunningFlowException_1.CannotDeleteRunningFlowException(flowId);
         }
-        for (const persistence of await this.flowsPersistenceFactory.createPersistenceLayers()) {
-            await persistence.deleteFlow(flowId);
-        }
+        await this.flowCatalog.deleteFlow(flowId);
     }
     /**
      * Attempts to cancel a flow by ID. If the flow is active, the flow is ended
@@ -463,7 +357,7 @@ class DonobuFlowsManager {
      */
     async cancelFlow(flowId) {
         const activeFlowHandle = this.isLocallyRunning()
-            ? this.activeFlows.get(flowId)
+            ? this.flowRuntime.get(flowId)
             : null;
         if (activeFlowHandle) {
             activeFlowHandle.donobuFlow.metadata.nextState = 'FAILED';
@@ -499,7 +393,7 @@ class DonobuFlowsManager {
      */
     async getFlowsAsPlaywrightProject(flowIds, options) {
         // First, resolve the complete set of flows including all dependencies
-        const completeFlowIds = await this.resolveFlowDependencies(flowIds);
+        const completeFlowIds = await this.flowDependencyResolver.resolveFlowDependencies(flowIds);
         // Fetch all flows and their tool calls
         const flowsWithToolCalls = await Promise.all(completeFlowIds.map(async (flowId) => {
             const metadata = await this.getFlowById(flowId);
@@ -525,12 +419,13 @@ class DonobuFlowsManager {
         return await (0, CodeGenerator_1.generateProject)(flowsWithToolCalls, defaultGptConfig, options);
     }
     /**
-     * Creates a GPT client using the provided GPT configuration by name. If the
-     * configuration name is null, or resolves to a missing configuration, then
-     * the default GPT configuration associated with the 'flow-runner' agent is
-     * used.
+     * Resolves a GPT client using the provided GPT configuration name, falling back
+     * to environment-provided configs (BASE64_GPT_CONFIG, DONOBU_API_KEY,
+     * AWS_BEDROCK_MODEL_NAME, ANTHROPIC_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY,
+     * OPENAI_API_KEY) and finally the config bound to the 'flow-runner' agent.
+     * Returns a null client if no configuration source is available.
      *
-     * This method is public for testing purposes only.
+     * Public for testing only.
      **/
     async createGptClient(gptConfigName) {
         if (gptConfigName) {
@@ -544,9 +439,14 @@ class DonobuFlowsManager {
                 };
             }
             catch (_error) {
-                Logger_1.appLogger.warn(`Failed to find GPT configuration: ${gptConfigName}, will default to the 'flow-runner' agent config (if it exists).`);
+                Logger_1.appLogger.warn(`Failed to find GPT configuration: ${gptConfigName}, will default to a GPT configuration set via environment variables, or the 'flow-runner' agent config (if it exists).`);
             }
         }
+        const envModelDefaults = {
+            anthropic: this.environ.data.ANTHROPIC_MODEL_NAME || 'claude-sonnet-4-5',
+            googleGemini: this.environ.data.GOOGLE_GENERATIVE_AI_MODEL_NAME || 'gemini-2.5-flash',
+            openAi: this.environ.data.OPENAI_API_MODEL_NAME || 'gpt-5.1',
+        };
         let gptConfigFromEnv = null;
         if (this.environ.data.BASE64_GPT_CONFIG) {
             let json;
@@ -569,35 +469,28 @@ class DonobuFlowsManager {
             gptConfigFromEnv = {
                 type: 'ANTHROPIC_AWS_BEDROCK',
                 modelName: this.environ.data.AWS_BEDROCK_MODEL_NAME,
+                accessKeyId: this.environ.data.AWS_ACCESS_KEY_ID,
+                secretAccessKey: this.environ.data.AWS_SECRET_ACCESS_KEY,
             };
         }
-        else if (this.environ.data.ANTHROPIC_MODEL_NAME) {
-            if (!this.environ.meta.ANTHROPIC_API_KEY) {
-                throw new InvalidParamValueException_1.InvalidParamValueException(this.environ.keys.ANTHROPIC_API_KEY, undefined, `the ${this.environ.keys.ANTHROPIC_MODEL_NAME} environment variable is set but the ${this.environ.keys.ANTHROPIC_API_KEY} is not`);
-            }
+        else if (this.environ.data.ANTHROPIC_API_KEY) {
             gptConfigFromEnv = {
                 type: 'ANTHROPIC',
-                modelName: this.environ.data.ANTHROPIC_MODEL_NAME,
+                modelName: envModelDefaults.anthropic,
                 apiKey: this.environ.data.ANTHROPIC_API_KEY,
             };
         }
-        else if (this.environ.data.GOOGLE_GENERATIVE_AI_MODEL_NAME) {
-            if (!this.environ.data.GOOGLE_GENERATIVE_AI_API_KEY) {
-                throw new InvalidParamValueException_1.InvalidParamValueException(this.environ.keys.GOOGLE_GENERATIVE_AI_API_KEY, undefined, `the ${this.environ.keys.GOOGLE_GENERATIVE_AI_MODEL_NAME} environment variable is set but the ${this.environ.keys.GOOGLE_GENERATIVE_AI_API_KEY} is not`);
-            }
+        else if (this.environ.data.GOOGLE_GENERATIVE_AI_API_KEY) {
             gptConfigFromEnv = {
                 type: 'GOOGLE_GEMINI',
-                modelName: this.environ.data.GOOGLE_GENERATIVE_AI_MODEL_NAME,
+                modelName: envModelDefaults.googleGemini,
                 apiKey: this.environ.data.GOOGLE_GENERATIVE_AI_API_KEY,
             };
         }
-        else if (this.environ.data.OPENAI_API_MODEL_NAME) {
-            if (!this.environ.data.OPENAI_API_KEY) {
-                throw new InvalidParamValueException_1.InvalidParamValueException(this.environ.keys.OPENAI_API_KEY, undefined, `the ${this.environ.keys.OPENAI_API_MODEL_NAME} environment variable is set but the ${this.environ.keys.OPENAI_API_KEY} is not`);
-            }
+        else if (this.environ.data.OPENAI_API_KEY) {
             gptConfigFromEnv = {
                 type: 'OPENAI',
-                modelName: this.environ.data.OPENAI_API_MODEL_NAME,
+                modelName: envModelDefaults.openAi,
                 apiKey: this.environ.data.OPENAI_API_KEY,
             };
         }
@@ -643,147 +536,12 @@ class DonobuFlowsManager {
             default:
                 throw new InvalidParamValueException_1.InvalidParamValueException('type', browserStateRef.type);
         }
-        for (const persistence of await this.flowsPersistenceFactory.createPersistenceLayers()) {
-            try {
-                const browserState = await persistence.getBrowserState(flowMetadata.id);
-                if (browserState) {
-                    return browserState;
-                }
-                else {
-                    throw new BrowserStateNotFoundException_1.BrowserStateNotFoundException(flowMetadata.id);
-                }
-            }
-            catch (error) {
-                if (!(error instanceof FlowNotFoundException_1.FlowNotFoundException)) {
-                    throw error;
-                }
-            }
+        const browserState = await this.flowCatalog.getBrowserState(flowMetadata.id);
+        if (browserState) {
+            return browserState;
         }
         throw new BrowserStateNotFoundException_1.BrowserStateNotFoundException(flowMetadata.id);
     }
-    /**
-     * Creates a dictionary of environment variables from allowed variable names.
-     *
-     * This method retrieves environment variable values for each of the provided names
-     * from the environment data manager. Only environment variables that exist in
-     * the environment data manager will be included in the result.
-     *
-     * @param allowedEnvVarsByName - Array of environment variable names that are allowed to be accessed.
-     * @returns A record mapping environment variable names to their values.
-     *
-     * @example
-     * // Returns { "API_KEY": "abc123", "BASE_URL": "https://example.com" }
-     * await buildEnvData(["API_KEY", "BASE_URL", "MISSING_VAR"]);
-     */
-    async buildEnvData(allowedEnvVarsByName) {
-        const result = {};
-        for (const envVarName of allowedEnvVarsByName) {
-            const envVarValue = await this.envDataManager.getEnvironmentDatum(envVarName);
-            if (envVarValue) {
-                result[envVarName] = envVarValue;
-            }
-        }
-        return result;
-    }
-    /**
-     * Extracts dependencies for a single flow by analyzing its browser.initialState
-     */
-    async extractFlowDependencies(flow, nameToIdMap) {
-        const initialState = flow.browser?.initialState;
-        if (!initialState) {
-            return [];
-        }
-        switch (initialState.type) {
-            case 'id':
-                // Direct flow ID reference
-                try {
-                    await this.getFlowById(initialState.value);
-                    return [initialState.value];
-                }
-                catch (_error) {
-                    Logger_1.appLogger.warn(`Flow dependency not found: flow with ID "${initialState.value}" does not exist`);
-                    return [];
-                }
-            case 'name':
-                // Flow name reference - resolve to ID
-                const flowId = nameToIdMap.get(initialState.value);
-                if (flowId) {
-                    return [flowId];
-                }
-                // If not in our current map, try to find it by querying all flows
-                try {
-                    const dependentFlow = await this.getFlowByName(initialState.value);
-                    nameToIdMap.set(initialState.value, dependentFlow.id);
-                    return [dependentFlow.id];
-                }
-                catch (_error) {
-                    Logger_1.appLogger.warn(`Flow dependency not found: flow with name "${initialState.value}" does not exist`);
-                    return [];
-                }
-            case 'json':
-                // Direct JSON state - no dependencies
-                return [];
-            default:
-                Logger_1.appLogger.warn(`Unknown browser state reference type: ${initialState.type}`);
-                return [];
-        }
-    }
-    /**
-     * Resolves the complete set of flow IDs including all transitive dependencies.
-     * Uses breadth-first search to discover all dependencies recursively.
-     */
-    async resolveFlowDependencies(initialFlowIds) {
-        const resolvedFlowIds = new Set();
-        const flowsToProcess = [...initialFlowIds];
-        const nameToIdMap = new Map();
-        // Process flows in breadth-first order to discover all dependencies
-        while (flowsToProcess.length > 0) {
-            const currentFlowId = flowsToProcess.shift();
-            // Skip if we've already processed this flow
-            if (resolvedFlowIds.has(currentFlowId)) {
-                continue;
-            }
-            try {
-                const flowMetadata = await this.getFlowById(currentFlowId);
-                resolvedFlowIds.add(currentFlowId);
-                // Update name-to-ID mapping for dependency resolution
-                if (flowMetadata.name) {
-                    const existingFlowId = nameToIdMap.get(flowMetadata.name);
-                    if (!existingFlowId ||
-                        (await this.shouldReplaceFlowMapping(existingFlowId, currentFlowId))) {
-                        nameToIdMap.set(flowMetadata.name, currentFlowId);
-                    }
-                }
-                // Extract dependencies from browser state
-                const dependencies = await this.extractFlowDependencies(flowMetadata, nameToIdMap);
-                // Add discovered dependencies to the processing queue
-                dependencies.forEach((depId) => {
-                    if (!resolvedFlowIds.has(depId)) {
-                        flowsToProcess.push(depId);
-                    }
-                });
-            }
-            catch (_error) {
-                // If a flow doesn't exist, skip it but continue processing
-                Logger_1.appLogger.warn(`Flow ${currentFlowId} not found, skipping dependency resolution for this flow`);
-            }
-        }
-        return Array.from(resolvedFlowIds);
-    }
-    /**
-     * Determines if a new flow ID should replace an existing flow ID in the name mapping.
-     */
-    async shouldReplaceFlowMapping(existingFlowId, newFlowId) {
-        try {
-            const existingFlow = await this.getFlowById(existingFlowId);
-            const newFlow = await this.getFlowById(newFlowId);
-            return FlowDependencyAnalyzer_1.FlowDependencyAnalyzer.shouldReplaceFlow(existingFlow, newFlow);
-        }
-        catch (_error) {
-            // If we can't get one of the flows, prefer the new one
-            return true;
-        }
-    }
     isLocallyRunning() {
         return this.deploymentEnvironment === 'LOCAL';
     }
@@ -879,12 +637,6 @@ function parseUrl(url) {
         return null;
     }
 }
-/**
- * Create a composite page token from pagination state
- */
-function createCompositePageToken(state) {
-    return Buffer.from(JSON.stringify(state)).toString('base64');
-}
 function validateFlowName(flowName) {
     if (flowName && flowName.length > 255) {
         throw new InvalidParamValueException_1.InvalidParamValueException('name', flowName, 'the value cannot be longer than 255 characters');
@@ -1040,29 +792,6 @@ async function throwIfAnyToolsRequireGpt(requestedTools, toolCallsOnStart) {
         throw new ToolRequiresGptException_1.ToolRequiresGptException(toolCallsRequiringGpt[0].name);
     }
 }
-/**
- * Parse a composite page token into pagination state
- */
-function parseCompositePageToken(token) {
-    if (!token) {
-        return {
-            sourceTokens: {},
-            exhaustedSources: [],
-            cursorTimestamp: null,
-        };
-    }
-    try {
-        return JSON.parse(Buffer.from(token, 'base64').toString('utf8'));
-    }
-    catch (_error) {
-        // If token parsing fails, start fresh
-        return {
-            sourceTokens: {},
-            exhaustedSources: [],
-            cursorTimestamp: null,
-        };
-    }
-}
 /**
  * Convert an *executed* list of {@link ToolCall}s into a list of
  * {@link ProposedToolCall}s that can be replayed in a fresh browser