// Generated by dts-bundle-generator v9.5.1

/**
 * Load a file into process.env without overwriting existing values.
 *
 * Uses `node:fs` rather than `Bun.file` on purpose: `agent-core` is the public
 * surface downstream tools consume, and those tools do not necessarily run on
 * Bun. A Bun-only builtin here makes the whole export unusable for them.
 */
export declare function loadEnvFile(filePath: string): Promise<void>;
export interface AppliedLimitMetadata {
	/** True only when the caller fetched and removed an additional row. */
	truncated: boolean;
	/** User-facing row limit, never the internal lookahead size. */
	limitApplied: number;
}
export interface AppliedLimitResult<T> {
	rows: T[];
	metadata: AppliedLimitMetadata;
}
/** Trim a one-row lookahead without mutating the input. */
export declare function trimAppliedLimit<T>(rows: readonly T[], limit: number): AppliedLimitResult<T>;
export interface ConnectionSelectorInputs {
	root?: string;
	command?: string;
	environment?: string;
}
/** Resolve one invocation-scoped selector without changing persisted state. */
export declare function resolveConnectionSelector(inputs: ConnectionSelectorInputs): string | undefined;
/** Parse a comma-separated selector into ordered, unique names. */
export declare function parseConnectionNames(selector: string): string[];
export interface EnvReference {
	$env: string;
}
/** Resolve a literal or environment reference with a field-specific error. */
export declare function resolveEnvRef(value: string | EnvReference, fieldName: string, env?: Record<string, string | undefined>): string;
/** Configuration error shared by agent-facing command-line tools. */
export declare class ConfigError extends Error {
	constructor(message: string);
}

export {};