donobu 1.0.0

package/dist/managers/FlowsPersistenceGoogleCloudStorage.js.map

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

package/dist/managers/FlowsPersistenceSupabase.d.ts

@@ -0,0 +1,33 @@
+import { FlowMetadata } from '../models/FlowMetadata';
+import { ToolCall } from '../models/ToolCall';
+import { VideoSegment } from '../models/VideoSegment';
+import { FlowsPersistence } from './FlowsPersistence';
+import { SupabaseClient } from '../clients/SupabaseClient';
+import { BrowserStorageState } from '../models/BrowserState';
+/**
+ * A persistence implementation that uses Supabase for storage via
+ * its PostgREST endpoints. This implementation assumes that row-Level Security (RLS) is enabled and
+ * enforced by Supabase.
+ */
+export declare class FlowsPersistenceSupabase implements FlowsPersistence {
+    private readonly supabaseHttpClient;
+    private static readonly FLOW_METADATA_TABLE;
+    private static readonly BROWSER_STATE_FILENAME;
+    private static readonly TOOL_CALLS_TABLE;
+    private static readonly FLOW_FILES_TABLE;
+    constructor(supabaseHttpClient: SupabaseClient);
+    saveMetadata(flowMetadata: FlowMetadata): Promise<void>;
+    getMetadataByFlowId(flowId: string): Promise<FlowMetadata>;
+    getMetadataByFlowName(flowName: string): Promise<FlowMetadata>;
+    savePngScreenShot(flowId: string, bytes: Buffer): Promise<string>;
+    saveToolCall(flowId: string, toolCall: ToolCall): Promise<void>;
+    getToolCalls(flowId: string): Promise<ToolCall[]>;
+    getFlows(): Promise<FlowMetadata[]>;
+    setVideo(flowId: string, bytes: Buffer): Promise<void>;
+    getVideoSegment(flowId: string, startOffset: number, length: number): Promise<VideoSegment | null>;
+    getFlowFile(flowId: string, fileId: string): Promise<Buffer | null>;
+    setFlowFile(flowId: string, fileId: string, fileBytes: Buffer): Promise<void>;
+    setBrowserState(flowId: string, browserState: BrowserStorageState): Promise<void>;
+    getBrowserState(flowId: string): Promise<BrowserStorageState | null>;
+    deleteFlow(flowId: string): Promise<void>;
+}

package/dist/managers/FlowsPersistenceSupabase.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowsPersistenceSupabase = void 0;
+const FlowNotFoundException_1 = require("../exceptions/FlowNotFoundException");
+const JsonUtils_1 = require("../utils/JsonUtils");
+/**
+ * A persistence implementation that uses Supabase for storage via
+ * its PostgREST endpoints. This implementation assumes that row-Level Security (RLS) is enabled and
+ * enforced by Supabase.
+ */
+class FlowsPersistenceSupabase {
+    supabaseHttpClient;
+    static FLOW_METADATA_TABLE = 'flowmetadatav1';
+    static BROWSER_STATE_FILENAME = 'browserstate.json';
+    static TOOL_CALLS_TABLE = 'toolcallsv1';
+    static FLOW_FILES_TABLE = 'flowfilesv1';
+    constructor(supabaseHttpClient) {
+        this.supabaseHttpClient = supabaseHttpClient;
+    }
+    async saveMetadata(flowMetadata) {
+        const startedAtEpochMs = flowMetadata.startedAt
+            ? new Date(flowMetadata.startedAt).getTime()
+            : new Date().getTime();
+        const root = {
+            id: flowMetadata.id,
+            startedat: startedAtEpochMs,
+            jsonrecord: flowMetadata,
+        };
+        await this.supabaseHttpClient.executeMethod(`rest/v1/${FlowsPersistenceSupabase.FLOW_METADATA_TABLE}?on_conflict=id`, 'POST', JSON.stringify(root));
+    }
+    async getMetadataByFlowId(flowId) {
+        const response = await this.supabaseHttpClient.executeGet(`rest/v1/${FlowsPersistenceSupabase.FLOW_METADATA_TABLE}?id=eq.${flowId}`);
+        if (!response) {
+            throw FlowNotFoundException_1.FlowNotFoundException.forId(flowId);
+        }
+        const records = JSON.parse(response);
+        if (records.length === 0) {
+            throw FlowNotFoundException_1.FlowNotFoundException.forId(flowId);
+        }
+        return records[0].jsonrecord;
+    }
+    async getMetadataByFlowName(flowName) {
+        const flows = (await this.getFlows()).filter((flow) => flow.name === flowName);
+        if (flows.length > 0) {
+            return flows[0];
+        }
+        else {
+            throw FlowNotFoundException_1.FlowNotFoundException.forName(flowName);
+        }
+    }
+    async savePngScreenShot(flowId, bytes) {
+        const fileId = `${new Date().toISOString()}.screenshot.png`;
+        await this.setFlowFile(flowId, fileId, bytes);
+        return fileId;
+    }
+    async saveToolCall(flowId, toolCall) {
+        const startedAtEpochMs = new Date(toolCall.startedAt).getTime();
+        const root = {
+            id: toolCall.id,
+            flowid: flowId,
+            startedat: startedAtEpochMs,
+            jsonrecord: toolCall,
+        };
+        await this.supabaseHttpClient.executeMethod(`rest/v1/${FlowsPersistenceSupabase.TOOL_CALLS_TABLE}`, 'POST', JSON.stringify(root));
+    }
+    async getToolCalls(flowId) {
+        const response = await this.supabaseHttpClient.executeGet(`rest/v1/${FlowsPersistenceSupabase.TOOL_CALLS_TABLE}?flowid=eq.${flowId}`);
+        if (!response) {
+            await this.getMetadataByFlowId(flowId); // Verify flow exists
+            return [];
+        }
+        const records = JSON.parse(response);
+        const toolCalls = records
+            .map((record) => record.jsonrecord)
+            .sort((a, b) => new Date(a.startedAt).getTime() - new Date(b.startedAt).getTime());
+        return toolCalls;
+    }
+    async getFlows() {
+        const response = await this.supabaseHttpClient.executeGet(`rest/v1/${FlowsPersistenceSupabase.FLOW_METADATA_TABLE}`);
+        if (!response) {
+            return [];
+        }
+        const records = JSON.parse(response);
+        return records.map((record) => record.jsonrecord);
+    }
+    async setVideo(flowId, bytes) {
+        await this.setFlowFile(flowId, 'video.webm', bytes);
+    }
+    async getVideoSegment(flowId, startOffset, length) {
+        const video = await this.getFlowFile(flowId, 'video.webm');
+        if (!video) {
+            return null;
+        }
+        const totalLength = video.length;
+        const adjustedLength = Math.min(length, totalLength - startOffset);
+        if (adjustedLength <= 0) {
+            return null;
+        }
+        const segment = video.subarray(startOffset, startOffset + adjustedLength);
+        return {
+            bytes: segment,
+            totalLength: totalLength,
+            startOffset: startOffset,
+        };
+    }
+    async getFlowFile(flowId, fileId) {
+        const response = await this.supabaseHttpClient.executeGet(`rest/v1/${FlowsPersistenceSupabase.FLOW_FILES_TABLE}?flowid=eq.${flowId}&id=eq.${encodeURIComponent(fileId)}&select=data`);
+        if (!response) {
+            await this.getMetadataByFlowId(flowId); // Verify flow exists
+            return null;
+        }
+        const records = JSON.parse(response);
+        if (records.length === 0) {
+            return null;
+        }
+        return Buffer.from(records[0].data, 'base64');
+    }
+    async setFlowFile(flowId, fileId, fileBytes) {
+        const root = {
+            id: fileId,
+            flowid: flowId,
+            data: fileBytes.toString('base64'),
+        };
+        await this.supabaseHttpClient.executeMethod(`rest/v1/${FlowsPersistenceSupabase.FLOW_FILES_TABLE}?on_conflict=id`, 'POST', JSON.stringify(root));
+    }
+    async setBrowserState(flowId, browserState) {
+        const serializedBrowserState = Buffer.from(JSON.stringify(browserState), 'utf-8');
+        await this.setFlowFile(flowId, FlowsPersistenceSupabase.BROWSER_STATE_FILENAME, serializedBrowserState);
+    }
+    async getBrowserState(flowId) {
+        const browserStateRaw = await this.getFlowFile(flowId, FlowsPersistenceSupabase.BROWSER_STATE_FILENAME);
+        if (browserStateRaw) {
+            const browserState = JsonUtils_1.JsonUtils.jsonStringToJsonObject(browserStateRaw.toString('utf-8'));
+            if (browserState) {
+                return browserState;
+            }
+            else {
+                throw new Error(`Cannot load malformed browser state from flow ${flowId}`);
+            }
+        }
+        else {
+            return null;
+        }
+    }
+    async deleteFlow(flowId) {
+        await this.supabaseHttpClient.executeMethod(`rest/v1/${FlowsPersistenceSupabase.TOOL_CALLS_TABLE}?flowid=eq.${flowId}`, 'DELETE');
+        await this.supabaseHttpClient.executeMethod(`rest/v1/${FlowsPersistenceSupabase.FLOW_FILES_TABLE}?flowid=eq.${flowId}`, 'DELETE');
+        await this.supabaseHttpClient.executeMethod(`rest/v1/${FlowsPersistenceSupabase.FLOW_METADATA_TABLE}?id=eq.${flowId}`, 'DELETE');
+    }
+}
+exports.FlowsPersistenceSupabase = FlowsPersistenceSupabase;
+//# sourceMappingURL=FlowsPersistenceSupabase.js.map

package/dist/managers/FlowsPersistenceSupabase.js.map

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

package/dist/managers/FlowsPersistenceVolatile.d.ts

@@ -0,0 +1,30 @@
+import { FlowMetadata } from '../models/FlowMetadata';
+import { ToolCall } from '../models/ToolCall';
+import { VideoSegment } from '../models/VideoSegment';
+import { FlowsPersistence } from './FlowsPersistence';
+import { BrowserStorageState } from '../models/BrowserState';
+/**
+ * A volatile (in-memory) implementation of FlowsPersistence.
+ */
+export declare class FlowsPersistenceVolatile implements FlowsPersistence {
+    private readonly flows;
+    private readonly screenshots;
+    private readonly toolCalls;
+    private readonly videos;
+    private readonly files;
+    private readonly browserStates;
+    saveMetadata(flowMetadata: FlowMetadata): Promise<void>;
+    getMetadataByFlowId(flowId: string): Promise<FlowMetadata>;
+    getMetadataByFlowName(flowName: string): Promise<FlowMetadata>;
+    savePngScreenShot(flowId: string, bytes: Buffer): Promise<string>;
+    saveToolCall(flowId: string, toolCall: ToolCall): Promise<void>;
+    getToolCalls(flowId: string): Promise<ToolCall[]>;
+    getFlows(): Promise<FlowMetadata[]>;
+    setVideo(flowId: string, bytes: Buffer): Promise<void>;
+    getVideoSegment(flowId: string, startOffset: number, length: number): Promise<VideoSegment | null>;
+    getFlowFile(flowId: string, fileId: string): Promise<Buffer | null>;
+    setFlowFile(flowId: string, fileId: string, fileBytes: Buffer): Promise<void>;
+    setBrowserState(flowId: string, browserState: BrowserStorageState): Promise<void>;
+    getBrowserState(flowId: string): Promise<BrowserStorageState | null>;
+    deleteFlow(flowId: string): Promise<void>;
+}

package/dist/managers/FlowsPersistenceVolatile.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowsPersistenceVolatile = void 0;
+const FlowNotFoundException_1 = require("../exceptions/FlowNotFoundException");
+/**
+ * A volatile (in-memory) implementation of FlowsPersistence.
+ */
+class FlowsPersistenceVolatile {
+    flows = new Map();
+    screenshots = new Map();
+    toolCalls = new Map();
+    videos = new Map();
+    files = new Map();
+    browserStates = new Map();
+    async saveMetadata(flowMetadata) {
+        this.flows.set(flowMetadata.id, { ...flowMetadata });
+    }
+    async getMetadataByFlowId(flowId) {
+        const metadata = this.flows.get(flowId);
+        if (!metadata) {
+            throw FlowNotFoundException_1.FlowNotFoundException.forId(flowId);
+        }
+        return { ...metadata };
+    }
+    async getMetadataByFlowName(flowName) {
+        const flows = Array.from(this.flows.values()).filter((flow) => flow.name === flowName);
+        if (flows.length > 0) {
+            return { ...flows[0] };
+        }
+        throw FlowNotFoundException_1.FlowNotFoundException.forName(flowName);
+    }
+    async savePngScreenShot(flowId, bytes) {
+        if (!this.screenshots.has(flowId)) {
+            this.screenshots.set(flowId, new Map());
+        }
+        const filename = `${new Date().toISOString()}.screenshot.png`;
+        this.screenshots.get(flowId).set(filename, Buffer.from(bytes));
+        return filename;
+    }
+    async saveToolCall(flowId, toolCall) {
+        if (!this.toolCalls.has(flowId)) {
+            this.toolCalls.set(flowId, []);
+        }
+        this.toolCalls.get(flowId).push({ ...toolCall });
+    }
+    async getToolCalls(flowId) {
+        if (!this.flows.has(flowId)) {
+            throw FlowNotFoundException_1.FlowNotFoundException.forId(flowId);
+        }
+        const calls = this.toolCalls.get(flowId) || [];
+        return [...calls].sort((a, b) => a.startedAt.localeCompare(b.startedAt));
+    }
+    async getFlows() {
+        return Array.from(this.flows.values()).map((flow) => ({ ...flow }));
+    }
+    async setVideo(flowId, bytes) {
+        this.videos.set(flowId, Buffer.from(bytes));
+    }
+    async getVideoSegment(flowId, startOffset, length) {
+        const video = this.videos.get(flowId);
+        if (!video) {
+            return null;
+        }
+        const totalLength = video.length;
+        const adjustedLength = Math.min(length, totalLength - startOffset);
+        return {
+            bytes: video.slice(startOffset, startOffset + adjustedLength),
+            totalLength,
+            startOffset,
+        };
+    }
+    async getFlowFile(flowId, fileId) {
+        const flowFiles = this.files.get(flowId);
+        if (!flowFiles) {
+            return null;
+        }
+        const file = flowFiles.get(fileId);
+        return file ? Buffer.from(file) : null;
+    }
+    async setFlowFile(flowId, fileId, fileBytes) {
+        if (!this.files.has(flowId)) {
+            this.files.set(flowId, new Map());
+        }
+        this.files.get(flowId).set(fileId, Buffer.from(fileBytes));
+    }
+    async setBrowserState(flowId, browserState) {
+        this.browserStates.set(flowId, { ...browserState });
+    }
+    async getBrowserState(flowId) {
+        const state = this.browserStates.get(flowId);
+        return state ? { ...state } : null;
+    }
+    async deleteFlow(flowId) {
+        this.flows.delete(flowId);
+        this.screenshots.delete(flowId);
+        this.toolCalls.delete(flowId);
+        this.videos.delete(flowId);
+        this.files.delete(flowId);
+        this.browserStates.delete(flowId);
+    }
+}
+exports.FlowsPersistenceVolatile = FlowsPersistenceVolatile;
+//# sourceMappingURL=FlowsPersistenceVolatile.js.map

package/dist/managers/FlowsPersistenceVolatile.js.map

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

package/dist/managers/GptConfigsManager.d.ts

@@ -0,0 +1,38 @@
+import { GptConfig } from '../models/GptConfig';
+import { GptConfigsPersistence } from '../persistence/GptConfigsPersistence';
+/**
+ * This class manages GPT configs and is responsible for validation around
+ * that context.
+ */
+export declare class GptConfigsManager {
+    private readonly persistence;
+    private constructor();
+    static create(persistence: GptConfigsPersistence): Promise<GptConfigsManager>;
+    /**
+     * Attempt to save the given GPT config. Where possible, a zero-cost
+     * request is attempted to be made with the GPT config before saving it.
+     * If the zero-cost request is attemted and it fails, this method throws.
+     */
+    set(name: string, config: GptConfig): Promise<void>;
+    /**
+     * Fetch a GPT config by name.
+     */
+    get(name: string): Promise<GptConfig>;
+    /**
+     * Fetch all GPT configs.
+     */
+    getAll(): Promise<Map<string, GptConfig>>;
+    /**
+     * Delete a GPT config by name.
+     */
+    delete(name: string): Promise<void>;
+    /**
+     * Verifies the given GPT config and name or throws if they are invalid.
+     */
+    private verifyGptConfigOrThrow;
+    /**
+     * Inspects environment variables and legacy GPT platform keys files to
+     * initialize default GPT configurations.
+     */
+    private initializeDefaultConfigurations;
+}

package/dist/managers/GptConfigsManager.js

@@ -0,0 +1,159 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GptConfigsManager = void 0;
+const GptClientFactory_1 = require("../clients/GptClientFactory");
+const InvalidParamValueException_1 = require("../exceptions/InvalidParamValueException");
+const MiscUtils_1 = require("../utils/MiscUtils");
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+/**
+ * This class manages GPT configs and is responsible for validation around
+ * that context.
+ */
+class GptConfigsManager {
+    persistence;
+    constructor(persistence) {
+        this.persistence = persistence;
+    }
+    static async create(persistence) {
+        const instance = new GptConfigsManager(persistence);
+        await instance.initializeDefaultConfigurations();
+        return instance;
+    }
+    /**
+     * Attempt to save the given GPT config. Where possible, a zero-cost
+     * request is attempted to be made with the GPT config before saving it.
+     * If the zero-cost request is attemted and it fails, this method throws.
+     */
+    async set(name, config) {
+        await this.verifyGptConfigOrThrow(name, config);
+        await this.persistence.set(name, config);
+    }
+    /**
+     * Fetch a GPT config by name.
+     */
+    async get(name) {
+        return this.persistence.get(name);
+    }
+    /**
+     * Fetch all GPT configs.
+     */
+    async getAll() {
+        return this.persistence.getAll();
+    }
+    /**
+     * Delete a GPT config by name.
+     */
+    async delete(name) {
+        return this.persistence.delete(name);
+    }
+    /**
+     * Verifies the given GPT config and name or throws if they are invalid.
+     */
+    async verifyGptConfigOrThrow(name, config) {
+        if (!name || name.length > 64) {
+            throw new InvalidParamValueException_1.InvalidParamValueException('name', name, 'the GPT configuration name must be a non-blank string 64 characters or fewer');
+        }
+        // Creating a GPT client performs validation on its own.
+        await GptClientFactory_1.GptClientFactory.createFromGptConfig(config);
+    }
+    /**
+     * Inspects environment variables and legacy GPT platform keys files to
+     * initialize default GPT configurations.
+     */
+    async initializeDefaultConfigurations() {
+        const apiKeysFilepath = path_1.default.join(MiscUtils_1.MiscUtils.baseWorkingDirectory(), '.gptplatforms');
+        let apiKeysData = {
+            ANTHROPIC: null,
+            GOOGLE: null,
+            OPENAI: null,
+        };
+        try {
+            const content = await fs_1.promises.readFile(apiKeysFilepath, 'utf-8');
+            // API key data has the JSON format of...
+            // {
+            //   "ANTHROPIC": <key>,
+            //   ...
+            // }
+            apiKeysData = JSON.parse(content);
+        }
+        catch (_error) {
+            // This likely just means the legacy API keys file has already been migrated.
+        }
+        // Perform overrides if environment variables are present.
+        if (process.env.ANTHROPIC_API_KEY) {
+            apiKeysData.ANTHROPIC = process.env.ANTHROPIC_API_KEY;
+        }
+        if (process.env.GOOGLE_GENERATIVE_AI_API_KEY) {
+            apiKeysData.GOOGLE = process.env.GOOGLE_GENERATIVE_AI_API_KEY;
+        }
+        if (process.env.OPENAI_API_KEY) {
+            apiKeysData.OPENAI = process.env.OPENAI_API_KEY;
+        }
+        // Setup Anthropic GPT configurations.
+        if (apiKeysData.ANTHROPIC) {
+            for (const modelName of [
+                'claude-3-7-sonnet-latest',
+                'claude-3-5-sonnet-latest',
+            ]) {
+                try {
+                    await this.get(modelName);
+                }
+                catch (_error) {
+                    if (apiKeysData.ANTHROPIC) {
+                        // Nothing found, so port it.
+                        await this.set(modelName, {
+                            type: 'ANTHROPIC',
+                            apiKey: apiKeysData.ANTHROPIC,
+                            modelName: modelName,
+                        });
+                    }
+                }
+            }
+        }
+        // Setup Google GPT configurations.
+        if (apiKeysData.GOOGLE) {
+            for (const modelName of ['gemini-2.0-flash', 'gemini-1.5-pro']) {
+                try {
+                    await this.get(modelName);
+                }
+                catch (_error) {
+                    // Nothing found, so port it.
+                    await this.set(modelName, {
+                        type: 'GOOGLE_GEMINI',
+                        apiKey: apiKeysData.GOOGLE,
+                        modelName: modelName,
+                    });
+                }
+            }
+        }
+        // Setup OpenAI GPT configurations.
+        if (apiKeysData.OPENAI) {
+            for (const modelName of ['gpt-4o', 'gpt-4o-mini']) {
+                try {
+                    await this.get(modelName);
+                }
+                catch (_error) {
+                    // Nothing found, so port it.
+                    await this.set(modelName, {
+                        type: 'OPENAI',
+                        apiKey: apiKeysData.OPENAI,
+                        modelName: modelName,
+                    });
+                }
+            }
+        }
+        // Remove the legacy API keys file if it exists.
+        try {
+            await fs_1.promises.rm(apiKeysFilepath);
+        }
+        catch (_error) {
+            // No-op.
+        }
+    }
+}
+exports.GptConfigsManager = GptConfigsManager;
+//# sourceMappingURL=GptConfigsManager.js.map

package/dist/managers/GptConfigsManager.js.map

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

package/dist/managers/GptPlatformApiKeysManager.d.ts

@@ -0,0 +1,36 @@
+import { Platform } from '../models/FlowMetadata';
+/**
+ * Interface for setting and getting Platform-specific API keys.
+ */
+export interface GptPlatformApiKeysManager {
+    /**
+     * Sets the given API key with the given GPT platform.
+     *
+     * @param gptPlatform - The GPT platform to set the key for
+     * @param apiKey - The API key to set
+     * @throws {GptPlatformAuthenticationFailedException} If the API key is invalid
+     * @throws {GptPlatformNotReachableException} If the GPT platform cannot be connected to
+     * @throws {GptPlatformInternalErrorException} If there's an internal error with the GPT platform
+     */
+    setKey(gptPlatform: Platform, apiKey: string): Promise<void>;
+    /**
+     * Returns the API key for the given Platform in plaintext.
+     *
+     * @param gptPlatform - The GPT platform to get the key for
+     * @returns The API key in plaintext
+     * @throws {ApiKeyNotSetUpException} If no API key is set up for the platform
+     */
+    getKey(gptPlatform: Platform): Promise<string>;
+    /**
+     * Returns the list of platforms that have API keys available.
+     *
+     * @returns Array of platforms that have API keys set up
+     */
+    getGptPlatformsWithKeys(): Promise<Platform[]>;
+    /**
+     * Deletes the API key for the given platform.
+     *
+     * @param gptPlatform - The GPT platform to delete the key for
+     */
+    deleteKey(gptPlatform: Platform): Promise<void>;
+}

package/dist/managers/GptPlatformApiKeysManager.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=GptPlatformApiKeysManager.js.map

package/dist/managers/GptPlatformApiKeysManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GptPlatformApiKeysManager.js","sourceRoot":"","sources":["../../src/managers/GptPlatformApiKeysManager.ts"],"names":[],"mappings":""}

package/dist/managers/GptPlatformApiKeysManagerFilesystem.d.ts

@@ -0,0 +1,29 @@
+import { Platform } from '../models/FlowMetadata';
+import { GptPlatformApiKeysManager } from './GptPlatformApiKeysManager';
+/**
+ * An implementation of the GptPlatformApiKeysManager that uses the local filesystem for
+ * persistence.
+ */
+export declare class GptPlatformApiKeysManagerFilesystem implements GptPlatformApiKeysManager {
+    private static readonly API_KEYS_FILENAME;
+    private static readonly LEGACY_API_KEY_FILENAME_TEMPLATE;
+    private readonly apiKeysFilepath;
+    /**
+     * Creates a new instance, initializing keys using the following rules:
+     * 1. If there are API keys specified in environment variables, save those.
+     * 2. Use the given directory to persist data.
+     *
+     * @param storageDirectory - The directory to store API keys
+     */
+    static create(storageDirectory: string): Promise<GptPlatformApiKeysManagerFilesystem>;
+    private constructor();
+    private initialize;
+    setKey(gptPlatform: Platform, apiKey: string): Promise<void>;
+    getKey(gptPlatform: Platform): Promise<string>;
+    getGptPlatformsWithKeys(): Promise<Platform[]>;
+    deleteKey(gptPlatform: Platform): Promise<void>;
+    private setKeyWithNoValidation;
+    private getGptModelToValidateKeyWith;
+    private migrateLegacyKeys;
+    private setApiKeysFromEnvironmentVariables;
+}