@mastra/core/dist/storage/domains/tool-provider-connections/base.d.ts

import { MastraBase } from '../../../base.js';
import type { StorageDeleteToolProviderConnectionInput, StorageListToolProviderConnectionsInput, StorageToolProviderConnection, StorageToolProviderConnectionKey, StorageUpsertToolProviderConnectionInput } from '../../types.js';
/**
 * Abstract base class for the tool-provider-connections storage domain.
 *
 * Persists a per-author, provider-agnostic registry of authorized tool
 * provider connections so the UI can surface a stable, user-supplied label
 * (e.g. "Work Gmail") across agents. Rows are keyed by
 * `(authorId, providerId, connectionId)`. The label is the only mutable field.
 *
 * Adapter-native connection state (status, scopes, expiry) still lives with the
 * provider — this domain is purely a name lookup.
 */
export declare abstract class ToolProviderConnectionsStorage extends MastraBase {
    constructor();
    /** Initialize the store (create tables, indexes, etc). */
    abstract init(): Promise<void>;
    /**
     * Fetch a single tool provider connection row. Returns `null` when no row
     * exists for the given `(authorId, providerId, connectionId)`.
     */
    abstract getConnectionById(key: StorageToolProviderConnectionKey): Promise<StorageToolProviderConnection | null>;
    /**
     * Insert or update a tool provider connection row. Idempotent on
     * `(authorId, providerId, connectionId)` — the existing label/toolkit are
     * overwritten. `createdAt` is preserved on update.
     */
    abstract upsertConnection(input: StorageUpsertToolProviderConnectionInput): Promise<StorageToolProviderConnection>;
    /**
     * List tool provider connection rows for the given author. Optionally
     * narrow by `providerId` and/or `toolkit`. Order is not guaranteed.
     */
    abstract listConnectionsByAuthor(input: StorageListToolProviderConnectionsInput): Promise<StorageToolProviderConnection[]>;
    /**
     * Remove a single tool provider connection row. Idempotent — returns
     * silently when the row does not exist.
     */
    abstract deleteConnection(input: StorageDeleteToolProviderConnectionInput): Promise<void>;
    /**
     * Delete every tool provider connection row. Used by tests.
     */
    abstract dangerouslyClearAll(): Promise<void>;
}
//# sourceMappingURL=base.d.ts.map