import { type HygieneApiClient } from "../hygiene/api/client.js";
import { type AuthoringApiClient } from "../authoring/index.js";
/**
 * Unified client for ad-hoc TypeScript scripting against a configured
 * scai environment. The intent: replace one-shot imports from `@/`-path
 * internals with a stable, ergonomic entry point that handles env
 * resolution, auth, and client lifecycle in one call.
 *
 * Stability contract: the shape of `ScaiClient` and the `connect`
 * signature are part of the public surface. Internal area clients
 * (`hygiene`, `authoring`) are exposed by reference — their own
 * stability contract lives in `scai/hygiene` and `scai/recipe`
 * respectively. Adding a new area client here is a public-API decision.
 */
export interface ScaiClient {
    envName: string;
    hygiene: HygieneApiClient;
    /**
     * Typed Authoring API client — item reads, `createItem` /
     * `updateItem` / `deleteItem` / `moveItem`. Exposed so scripting
     * helpers can do content-tree surgery (the `subtree` helpers) without
     * re-implementing auth and transport, and so script authors can reach
     * Authoring operations that have no `hygiene` equivalent.
     */
    authoring: AuthoringApiClient;
}
export interface ConnectOptions {
    /** Environment name from `sitecoreai.cli.json`. Defaults to `defaultEnvProfile`. */
    envName?: string;
    /** Override the config file path (directory or full path). Defaults to `process.cwd()`. */
    configPath?: string;
}
export declare const connect: (options?: ConnectOptions) => ScaiClient;