/**
 * Shared CLI configuration for pull/push commands
 *
 * Handles API URL, authentication tokens, and project resolution.
 * @module cli/shared/config
 */
import type { InferSchema } from "../../src/extensions/schema/index.js";
import { type EnvironmentConfig } from "../../src/config/index.js";
/**
 * Classify failures from an idempotent API read conservatively.
 *
 * A structured HTTP status is authoritative: authentication, validation, and
 * other client failures must not become retryable merely because an attached
 * cause resembles a connection error.
 */
export declare function isRetryableApiReadError(error: unknown): boolean;
export declare const getVeryfrontConfigSchema: () => import("../../src/internal-agents/schema.js").Schema<import("../../src/extensions/schema/schema-validator.js").InferShape<{
    projectSlug: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    /** List of project slugs for multi-project pull */
    projects: import("../../src/internal-agents/schema.js").Schema<string[] | undefined>;
    apiToken: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    apiUrl: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
}>>;
export declare const VeryfrontConfigSchema: import("../../src/internal-agents/schema.js").Schema<import("../../src/extensions/schema/schema-validator.js").InferShape<{
    projectSlug: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    /** List of project slugs for multi-project pull */
    projects: import("../../src/internal-agents/schema.js").Schema<string[] | undefined>;
    apiToken: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    apiUrl: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
}>>;
export type VeryfrontConfig = InferSchema<ReturnType<typeof getVeryfrontConfigSchema>>;
export declare const getResolvedConfigSchema: () => import("../../src/internal-agents/schema.js").Schema<import("../../src/extensions/schema/schema-validator.js").InferShape<{
    apiUrl: import("../../src/internal-agents/schema.js").Schema<string>;
    apiToken: import("../../src/internal-agents/schema.js").Schema<string>;
    apiTokenSource: import("../../src/internal-agents/schema.js").Schema<"env" | "env-file" | "config-file" | "token-store" | undefined>;
    projectSlug: import("../../src/internal-agents/schema.js").Schema<string>;
    projectId: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
}>>;
export declare const ResolvedConfigSchema: import("../../src/internal-agents/schema.js").Schema<import("../../src/extensions/schema/schema-validator.js").InferShape<{
    apiUrl: import("../../src/internal-agents/schema.js").Schema<string>;
    apiToken: import("../../src/internal-agents/schema.js").Schema<string>;
    apiTokenSource: import("../../src/internal-agents/schema.js").Schema<"env" | "env-file" | "config-file" | "token-store" | undefined>;
    projectSlug: import("../../src/internal-agents/schema.js").Schema<string>;
    projectId: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
}>>;
export type ResolvedConfig = InferSchema<ReturnType<typeof getResolvedConfigSchema>>;
export type ApiTokenSource = NonNullable<ResolvedConfig["apiTokenSource"]>;
export interface ApiCredentialCandidate {
    apiToken: string;
    apiTokenSource: ApiTokenSource;
    validationEnv: EnvironmentConfig;
    authoritative: boolean;
}
export type ProjectReferenceSource = {
    kind: "argument";
    name: "--project";
} | {
    kind: "environment";
    name: "environment configuration";
} | {
    kind: "module-config";
    name: string;
} | {
    kind: "json-config";
    name: "veryfront.json";
} | {
    kind: "tenant-environment";
    name: string;
} | {
    kind: "local-link";
    name: ".veryfront/project.json";
} | {
    kind: "inferred";
    name: "project files";
};
export interface ResolvedConfigDetails {
    config: ResolvedConfig;
    projectReferenceSource: ProjectReferenceSource;
}
export declare const ENVIRONMENT_PROJECT_REFERENCE_NAMES: readonly ["VERYFRONT_PROJECT_SLUG", "TENANT_PROJECT_SLUG", "VERYFRONT_PROJECT_ID", "TENANT_PROJECT_ID"];
export type EnvironmentProjectReferenceName = typeof ENVIRONMENT_PROJECT_REFERENCE_NAMES[number];
export declare function readConfigFile(projectDir: string): Promise<VeryfrontConfig | null>;
export declare function readConfigJsonFile(projectDir: string): Promise<VeryfrontConfig | null>;
export declare function writeProjectSlug(projectDir: string, slug: string): Promise<void>;
export declare function resolveEnvironmentProjectReference(): {
    reference: string;
    name: EnvironmentProjectReferenceName;
} | undefined;
export declare function resolveApiCredentialCandidatesForAuth(env?: EnvironmentConfig, projectDir?: string, interactive?: boolean): Promise<ApiCredentialCandidate[]>;
export declare const resolveConfig: (projectDir?: string, env?: EnvironmentConfig) => Promise<ResolvedConfig>;
/**
 * Resolve config with interactive authentication.
 *
 * If no token is available, prompts the user to login interactively.
 * Use this for commands that require authentication (push, pull, deploy).
 */
export declare const resolveConfigWithAuth: (projectDir?: string, env?: EnvironmentConfig) => Promise<ResolvedConfig>;
export declare function resolveConfigWithAuthDetails(projectDir?: string, env?: EnvironmentConfig): Promise<ResolvedConfigDetails>;
export interface ApiReadOptions {
    /** Abort the in-flight HTTP request when this signal fires. */
    signal?: AbortSignal;
    /** Use `none` when a caller owns retry timing or replaying a write would be ambiguous. */
    retryPolicy?: "default" | "none";
}
export interface ApiClient {
    get<T>(path: string, params?: Record<string, string>, options?: ApiReadOptions): Promise<T>;
    post<T>(path: string, body?: unknown): Promise<T>;
    put<T>(path: string, body?: unknown, options?: ApiReadOptions): Promise<T>;
    patch<T>(path: string, body?: unknown): Promise<T>;
    delete<T>(path: string): Promise<T>;
}
export declare const getApiErrorSchema: () => import("../../src/internal-agents/schema.js").Schema<import("../../src/extensions/schema/schema-validator.js").InferShape<{
    error: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    message: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    detail: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    title: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    suggestion: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    code: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    slug: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
}>>;
export declare const ApiErrorSchema: import("../../src/internal-agents/schema.js").Schema<import("../../src/extensions/schema/schema-validator.js").InferShape<{
    error: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    message: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    detail: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    title: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    suggestion: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    code: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
    slug: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
}>>;
export type ApiError = InferSchema<ReturnType<typeof getApiErrorSchema>>;
export declare function formatApiError(data: ApiError, fallback: string): string;
export declare function createApiClient(config: ResolvedConfig): ApiClient;
//# sourceMappingURL=config.d.ts.map