import type { Args, ICommandAgent, IQueryCacheEntry, TCommandAgentState, TTriggerPromise } from "../../../query/types/index.js";
import type { ReadonlySignal } from "../../../signals/types/index.js";
export interface ICommandForAgent<TArgs, TData> {
    execute(args: Args<TArgs>, key?: string): Promise<TData>;
    getEntry$(key: string): IQueryCacheEntry<TArgs, TData> | null;
}
export declare class CommandAgent<TArgs, TData, TError = unknown> implements ICommandAgent<TArgs, TData, TError> {
    private readonly _command;
    private readonly _tracking$;
    /** Cache key the agent is bound to (via constructor/setKey), reused by trigger. */
    private _boundKey;
    readonly state$: ReadonlySignal<TCommandAgentState<TArgs, TData, TError>>;
    constructor(command: ICommandForAgent<TArgs, TData>, key?: string);
    /**
     * Execute the mutation and track its cache entry via {@link state$}.
     *
     * Returns a {@link TTriggerPromise}: the envelope promise never rejects, so
     * a fire-and-forget call site cannot surface an unhandled rejection (the
     * failure still lands in {@link state$}); `unwrap()` hands back the raw
     * throwing promise.
     */
    trigger(args: Args<TArgs>, key?: string): TTriggerPromise<TData, TError>;
    setKey(key: string): void;
    retry: () => void;
    private _observeKey;
    private _deriveState;
    private _createIdleState;
}