import type { Integrations } from "@cargo-ai/workflow-sdk";
import { type Token } from "../core.js";
import type { ConnectorActionRef } from "../refs.js";
export type RateLimitSpec = {
    unit: "day" | "hour" | "minute" | "second";
    max: number;
    strategy: "spread" | "burst";
};
export interface ConnectorConfigs {
}
type ConnectorConfigFor<S extends string> = S extends keyof ConnectorConfigs ? ConnectorConfigs[S] : Record<string, unknown>;
export type ConnectorSpec<S extends string = string> = {
    integration: S;
    name?: string;
    config?: ConnectorConfigFor<S>;
    rateLimit?: RateLimitSpec;
    cacheTtlMilliseconds?: number;
    /**
     * Bind the integration's DEFAULT connector instead of creating one — the
     * escape hatch for OAuth integrations whose tokens can't live in a repo.
     * Falls back to a slug match when the integration has no default.
     *
     * Leave it off to bind by slug: a connector authored without `config` resolves
     * to the existing connector with this slug, and an undeclared `config` is
     * never cleared, so the credentials it already holds survive.
     */
    default?: boolean;
    /** @deprecated Renamed to `default`, which is what it actually resolves. */
    adopt?: boolean;
};
type ConnectorActions<S extends string> = S extends keyof Integrations ? {
    readonly [A in keyof Integrations[S] & string]: ConnectorActionRef<S, A>;
} : {
    readonly [actionSlug: string]: ConnectorActionRef<S>;
};
export type ConnectorHandle<S extends string = string> = {
    readonly slug: string;
    readonly integrationSlug: S;
    readonly uuid: Token;
    readonly datasetUuid: Token;
    /** Discriminator so a connector handle can be passed where a connector (or its
     *  dataset, via `defineModel`) is referenced. Carries the integration slug `S`
     *  so `defineModel({ dataset })` can type extractor config. */
    readonly resource: "connector";
    /** This connector's actions — `connector.actions.<actionSlug>` — for an
     *  agent's / MCP server's `uses`. */
    readonly actions: ConnectorActions<S>;
};
export declare function defineConnector<S extends string>(slug: string, spec: ConnectorSpec<S>): ConnectorHandle<S>;
export {};
//# sourceMappingURL=connector.d.ts.map