/**
 * `agent-cards agents add` — wire coding agents to the Agentcard tool catalog,
 * the `npx -y @posthog/wizard cli add` experience without a separate wizard
 * package: detect the agents on this machine, make sure the CLI is installed
 * where their shells can find it, and install a managed steering block into
 * each agent's global instruction file teaching it to use `agent-cards api`.
 *
 * The block is idempotent (marker-delimited add-or-replace), so re-running
 * after an upgrade refreshes the instructions in place.
 */
export declare const STEERING_START = "<!-- agentcard:start -->";
export declare const STEERING_END = "<!-- agentcard:end -->";
export interface AgentTarget {
    id: string;
    label: string;
    /** Global instruction file, relative to $HOME. */
    file: string;
}
export declare const AGENT_TARGETS: AgentTarget[];
/** The managed block body — everything an agent needs to drive Agentcard from a shell. */
export declare function steeringBlock(): string;
/** Detect which agents exist on this machine (their instruction file OR its parent dir exists). */
export declare function detectAgents(home?: string): Array<AgentTarget & {
    filePath: string;
    fileExists: boolean;
    detected: boolean;
}>;
/**
 * Install (or refresh) the managed steering block in one instruction file.
 * Returns 'added' | 'updated' | 'unchanged'.
 */
export declare function installSteeringBlock(filePath: string, block?: string): 'added' | 'updated' | 'unchanged';
export interface AgentsAddOptions {
    agent?: string;
    all?: boolean;
    path?: string;
    /** Skip the global-install offer (first-run already handles it in its own step). */
    skipInstall?: boolean;
}
export declare function agentsAdd(options?: AgentsAddOptions): Promise<void>;
/**
 * Keep installed steering blocks current WITHOUT the user re-running
 * `agents add`: on the first run after a version change, rewrite the managed
 * block in any instruction file that ALREADY carries our markers. Files
 * without markers are never touched (nobody gets steering they didn't ask
 * for), and unchanged blocks are left alone. This closes the loop the CLI's
 * self-update opens: the binary stays current automatically, so its installed
 * instructions do too.
 */
export declare function refreshManagedSteeringBlocks(currentVersion: string): void;
//# sourceMappingURL=agents.d.ts.map