import { type ResolvedArtifacts, type RootEntry, type AgentSessionConfig, type StartCommand, type LocalArtifacts } from "@pulsemcp/air-core";
export interface StartSessionOptions {
    /** Root to activate by name. */
    root?: string;
    /** Path to air.json. Uses AIR_CONFIG env or ~/.air/air.json if not set. */
    config?: string;
    /** Check whether the agent CLI is installed. Defaults to true. */
    checkAvailability?: boolean;
    /**
     * Git protocol override for git-based catalog providers. Takes precedence
     * over the `gitProtocol` field in air.json.
     */
    gitProtocol?: "ssh" | "https";
    /**
     * Directory to scan for adapter-owned local artifacts (e.g. skills
     * checked into `.claude/skills/`). Defaults to `process.cwd()`. Set to
     * `null` to skip the local scan entirely.
     */
    localScanDir?: string | null;
}
export interface StartSessionResult {
    /** The resolved artifacts. */
    artifacts: ResolvedArtifacts;
    /** The matched root, if any. */
    root?: RootEntry;
    /** The generated session config. */
    sessionConfig: AgentSessionConfig;
    /** Whether the agent CLI is available on PATH. Undefined if checkAvailability was false. */
    agentAvailable: boolean | undefined;
    /** The command to start the agent. */
    startCommand: StartCommand;
    /** The agent adapter display name. */
    adapterDisplayName: string;
    /** Warnings from provider cache freshness checks (e.g., stale GitHub clones). */
    warnings?: string[];
    /**
     * Artifacts discovered in the target directory outside of AIR's
     * management (e.g. skills checked into `.claude/skills/`). Populated
     * when the adapter implements `listLocalArtifacts` and `localScanDir`
     * is not set to `null`.
     */
    localArtifacts?: LocalArtifacts;
}
/**
 * Prepare to start an agent session.
 *
 * Resolves artifacts, finds the adapter, generates config, checks availability,
 * and builds the start command. Does NOT actually execute the agent.
 *
 * @throws Error if the adapter is not found or the specified root doesn't exist.
 */
export declare function startSession(agent: string, options?: StartSessionOptions): Promise<StartSessionResult>;
//# sourceMappingURL=start.d.ts.map