/**
 * @module feedback
 * @description Trustless reputation system — give, update, revoke, and close
 *   on-chain feedback entries for agents.
 *
 * Feedback entries are PDA-based reviews tied to an agent and a reviewer wallet,
 * enabling permissionless, verifiable reputation on Solana.
 *
 * @category Modules
 * @since v0.1.0
 * @packageDocumentation
 */
import { type PublicKey, type TransactionSignature } from "@solana/web3.js";
import { BaseModule } from "./base";
import type { FeedbackAccountData, GiveFeedbackArgs, UpdateFeedbackArgs } from "../types";
/**
 * @name FeedbackModule
 * @description Manages on-chain feedback entries for the Synapse Agent Protocol.
 *   Provides methods to give, update, revoke, close, and fetch feedback PDAs
 *   that form the trustless reputation layer.
 *
 * @category Modules
 * @since v0.1.0
 * @extends BaseModule
 *
 * @example
 * ```ts
 * const sap = new SapClient(provider);
 * const sig = await sap.feedback.give(agentWallet, {
 *   score: 5,
 *   tag: { quality: {} },
 *   commentHash: null,
 * });
 * ```
 */
export declare class FeedbackModule extends BaseModule {
    /**
     * @name deriveFeedback
     * @description Derive the `FeedbackAccount` PDA for a given agent and reviewer.
     * @param agentPda - The agent account PDA to review.
     * @param reviewer - The reviewer wallet. Defaults to the connected wallet.
     * @returns A tuple of `[PublicKey, bump]` for the feedback PDA.
     * @see {@link deriveFeedback} from `pda/` module for the underlying derivation.
     * @since v0.1.0
     */
    deriveFeedback(agentPda: PublicKey, reviewer?: PublicKey): readonly [PublicKey, number];
    /**
     * @name give
     * @description Leave on-chain feedback for an agent. Creates a new
     *   `FeedbackAccount` PDA owned by the reviewer.
     * @param agentWallet - The wallet that owns the target agent.
     * @param args - Feedback parameters (score, tag, optional comment hash).
     * @returns {Promise<TransactionSignature>} The transaction signature.
     * @since v0.1.0
     */
    give(agentWallet: PublicKey, args: GiveFeedbackArgs): Promise<TransactionSignature>;
    /**
     * @name update
     * @description Update an existing feedback entry. Only the original reviewer
     *   may update their feedback.
     * @param agentWallet - The wallet that owns the target agent.
     * @param args - Updated feedback parameters (new score, optional new tag, optional comment hash).
     * @returns {Promise<TransactionSignature>} The transaction signature.
     * @since v0.1.0
     */
    update(agentWallet: PublicKey, args: UpdateFeedbackArgs): Promise<TransactionSignature>;
    /**
     * @name revoke
     * @description Revoke a feedback entry, marking it as revoked and excluding
     *   it from reputation calculations.
     * @param agentWallet - The wallet that owns the target agent.
     * @returns {Promise<TransactionSignature>} The transaction signature.
     * @since v0.1.0
     */
    revoke(agentWallet: PublicKey): Promise<TransactionSignature>;
    /**
     * @name close
     * @description Close a revoked feedback PDA and reclaim rent to the reviewer.
     * @param agentWallet - The wallet that owns the target agent.
     * @returns {Promise<TransactionSignature>} The transaction signature.
     * @since v0.1.0
     */
    close(agentWallet: PublicKey): Promise<TransactionSignature>;
    /**
     * @name fetch
     * @description Fetch a deserialized `FeedbackAccount`.
     * @param agentPda - The agent account PDA.
     * @param reviewer - The reviewer wallet. Defaults to the connected wallet.
     * @returns {Promise<FeedbackAccountData>} The feedback account data.
     * @throws Will throw if the feedback account does not exist.
     * @since v0.1.0
     */
    fetch(agentPda: PublicKey, reviewer?: PublicKey): Promise<FeedbackAccountData>;
    /**
     * @name fetchNullable
     * @description Fetch a deserialized `FeedbackAccount`, or `null` if it
     *   does not exist on-chain.
     * @param agentPda - The agent account PDA.
     * @param reviewer - The reviewer wallet. Defaults to the connected wallet.
     * @returns {Promise<FeedbackAccountData | null>} The feedback data or `null`.
     * @since v0.1.0
     */
    fetchNullable(agentPda: PublicKey, reviewer?: PublicKey): Promise<FeedbackAccountData | null>;
}
//# sourceMappingURL=feedback.d.ts.map