@q00bs/agent-sdk 1.0.0

package/dist/Q00bsAgent.js

@@ -0,0 +1,695 @@
+"use strict";
+/**
+ * @q00bs/agent-sdk — Q00bsAgent (Main Entry Point)
+ *
+ * This is the primary class developers interact with. It wraps all SDK
+ * modules (trust, escrow, consensus, discovery) behind a clean interface.
+ *
+ * WHAT THIS CLASS DOES:
+ *   - Initializes blockchain clients from a private key (Mode 1) OR Privy (Mode 2).
+ *   - Registers the agent on-chain as an ERC-721 on the owner's q00b.
+ *   - Provides methods for trust verification, agent discovery, payments, and consensus.
+ *   - Enforces spend limits and trust-path checks BEFORE sending transactions.
+ *
+ * TWO WALLET MODES:
+ *
+ *   MODE 1 — Raw Private Key (legacy):
+ *     Pass `privateKey` in config. The SDK creates viem clients locally.
+ *
+ *   MODE 2 — Privy Server Wallet (recommended for ClawBot / OpenClaw agents):
+ *     Pass `privy` in config (appId + appSecret). The SDK creates a Privy-managed
+ *     wallet with spending policies. No private keys in your code.
+ *     See: https://privy.io/blog/securely-equipping-openclaw-agents-with-privy-wallets
+ *
+ * SECURITY GUARANTEES:
+ *   - In Mode 1: Private keys are used by viem locally and never leave the process.
+ *   - In Mode 2: Private keys are held by Privy's HSM and NEVER appear in your code.
+ *   - All state-changing operations go through on-chain contracts.
+ *   - Spend limits are enforced at 3 layers: Privy policy → SDK pre-check → on-chain.
+ *   - Trust paths are verified on-chain through the q00b graph before communication.
+ *
+ * USAGE (Mode 1 — raw key):
+ *   ```ts
+ *   const agent = new Q00bsAgent({
+ *     privateKey: process.env.AGENT_PRIVATE_KEY!,
+ *     rpcUrl: process.env.BASE_RPC_URL!,
+ *     registryAddress: '0x...',
+ *   });
+ *   await agent.initialize();
+ *   ```
+ *
+ * USAGE (Mode 2 — Privy, recommended):
+ *   ```ts
+ *   const agent = new Q00bsAgent({
+ *     privy: {
+ *       appId: process.env.PRIVY_APP_ID!,
+ *       appSecret: process.env.PRIVY_APP_SECRET!,
+ *       walletId: process.env.PRIVY_WALLET_ID, // optional, creates new if omitted
+ *     },
+ *     rpcUrl: process.env.BASE_RPC_URL!,
+ *     registryAddress: '0x...',
+ *   });
+ *   await agent.initialize();
+ *   ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Q00bsAgent = void 0;
+const viem_1 = require("viem");
+const client_1 = require("./client");
+const trust_1 = require("./trust");
+const escrow_1 = require("./escrow");
+const consensus_1 = require("./consensus");
+const discovery_1 = require("./discovery");
+const privy_1 = require("./privy");
+const erc8004_1 = require("./erc8004");
+const AgentRegistry_1 = require("./abis/AgentRegistry");
+const errors_1 = require("./errors");
+// ─────────────────────────────────────────────────────────────
+// Q00BS AGENT
+// ─────────────────────────────────────────────────────────────
+class Q00bsAgent {
+    // ── Configuration ───────────────────────────────────────────
+    config;
+    logger;
+    // ── Blockchain clients ──────────────────────────────────────
+    publicClient;
+    walletClient;
+    walletAddress;
+    // ── Privy wallet (Mode 2) ──────────────────────────────────
+    privyManager;
+    _walletMode = 'privateKey';
+    // ── Sub-modules ─────────────────────────────────────────────
+    trustResolver;
+    escrowManager;
+    consensusManager;
+    agentDiscovery;
+    _erc8004Manager;
+    // ── State ───────────────────────────────────────────────────
+    _agentId;
+    _initialized = false;
+    /** The agent's on-chain ID (set after register() or from config). */
+    get agentId() {
+        return this._agentId;
+    }
+    /** Whether initialize() has been called. */
+    get initialized() {
+        return this._initialized;
+    }
+    /** The agent's wallet address (derived from private key or Privy). */
+    get address() {
+        return this.walletAddress;
+    }
+    /** Which wallet mode is active: 'privateKey' (Mode 1) or 'privy' (Mode 2). */
+    get walletMode() {
+        return this._walletMode;
+    }
+    /** Whether this agent uses a Privy-managed wallet (Mode 2). */
+    get isPrivyMode() {
+        return this._walletMode === 'privy';
+    }
+    /** The Privy wallet manager (only available in Mode 2). */
+    get privyWallet() {
+        return this.privyManager;
+    }
+    /** The ERC-8004 manager (available if erc8004 config is set or after initialize). */
+    get erc8004() {
+        return this._erc8004Manager;
+    }
+    // ─────────────────────────────────────────────────────────────
+    // CONSTRUCTOR
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Create a new Q00bsAgent.
+     *
+     * @param config - Agent configuration. Must include either `privateKey` (Mode 1) or `privy` (Mode 2).
+     *
+     * NOTE: This does NOT connect to the blockchain yet. Call initialize() next.
+     */
+    constructor(config) {
+        // Validate that at least one wallet mode is configured
+        if (!config.privateKey && !config.privy) {
+            throw new Error('Agent requires a wallet. Provide either:\n' +
+                '  • privateKey (Mode 1 — raw key, simpler but less secure)\n' +
+                '  • privy (Mode 2 — Privy server wallet, recommended for ClawBots)\n' +
+                'See: https://privy.io/blog/securely-equipping-openclaw-agents-with-privy-wallets');
+        }
+        // Privy mode takes precedence (safer default)
+        this._walletMode = config.privy ? 'privy' : 'privateKey';
+        this.config = config;
+        this.logger = (0, client_1.createLogger)(config.logLevel || 'info');
+        this._agentId = config.agentId;
+    }
+    // ─────────────────────────────────────────────────────────────
+    // INITIALIZATION
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Initialize blockchain connections and sub-modules.
+     * Must be called before any other method.
+     *
+     * In Mode 1 (private key): Creates viem clients and derives wallet address.
+     * In Mode 2 (Privy): Creates/loads Privy wallet with policy, gets address.
+     *
+     * @param walletPolicy - (Mode 2 only) Policy to apply when creating a new Privy wallet.
+     * @throws If configuration is invalid.
+     */
+    async initialize(walletPolicy) {
+        this.logger.info(`Initializing Q00bs Agent (mode: ${this._walletMode})...`);
+        if (this._walletMode === 'privy') {
+            // ── MODE 2: Privy server wallet ────────────────────────
+            const clients = (0, client_1.createPrivyClients)({
+                privy: this.config.privy,
+                rpcUrl: this.config.rpcUrl,
+                logger: this.logger,
+            });
+            this.publicClient = clients.publicClient;
+            this.privyManager = clients.privyWalletManager;
+            // Create or load the Privy wallet
+            const defaultPolicy = walletPolicy || privy_1.PrivyWalletManager.buildDefaultPolicy(this.config.maxTransactionValue || '0.1', this.config.dailySpendLimit || '1.0', 
+            // Whitelist all configured contract addresses
+            [
+                this.config.registryAddress,
+                this.config.escrowAddress,
+                this.config.consensusAddress,
+            ].filter(Boolean));
+            const walletInfo = await this.privyManager.initialize(defaultPolicy);
+            this.walletAddress = walletInfo.address;
+            this.logger.info(`Privy wallet ${walletInfo.isNew ? 'created' : 'loaded'}: ${this.walletAddress}`);
+        }
+        else {
+            // ── MODE 1: Raw private key ────────────────────────────
+            const clients = (0, client_1.createClients)({
+                privateKey: this.config.privateKey,
+                rpcUrl: this.config.rpcUrl,
+                logger: this.logger,
+            });
+            this.publicClient = clients.publicClient;
+            this.walletClient = clients.walletClient;
+            this.walletAddress = clients.account.address;
+        }
+        // Initialize sub-modules (same for both modes)
+        this.trustResolver = new trust_1.TrustResolver(this.publicClient, this.config.registryAddress, this.logger);
+        this.agentDiscovery = new discovery_1.AgentDiscovery(this.publicClient, this.config.registryAddress, this.trustResolver, this.logger);
+        if (this.config.escrowAddress) {
+            if (this._walletMode === 'privateKey' && this.walletClient) {
+                this.escrowManager = new escrow_1.EscrowManager(this.publicClient, this.walletClient, this.config.escrowAddress, this.logger);
+            }
+            // In Privy mode, escrow transactions are routed through PrivyWalletManager
+            // instead of the walletClient — the escrow methods handle this internally.
+        }
+        if (this.config.consensusAddress) {
+            if (this._walletMode === 'privateKey' && this.walletClient) {
+                this.consensusManager = new consensus_1.ConsensusManager(this.publicClient, this.walletClient, this.config.consensusAddress, this.logger);
+            }
+            // In Privy mode, consensus transactions are routed through PrivyWalletManager.
+        }
+        // ── Initialize ERC-8004 (if configured or by default) ──
+        // ERC-8004 reads are always available (publicClient only).
+        // Writes require walletClient (Mode 1) — in Privy mode, use API.
+        this._erc8004Manager = new erc8004_1.ERC8004Manager(this.publicClient, this.logger, this.walletClient, // undefined in Privy mode — write ops go through API
+        this.config.erc8004);
+        this.logger.info('ERC-8004 Trustless Agents integration enabled');
+        // If agentId was provided, verify it exists on-chain
+        if (this._agentId) {
+            const record = await this.agentDiscovery.getAgent(this._agentId);
+            if (!record) {
+                this.logger.warn(`Agent ID ${this._agentId} not found on-chain`);
+                this._agentId = undefined;
+            }
+            else if (record.wallet.toLowerCase() !== this.walletAddress.toLowerCase()) {
+                this.logger.warn(`Agent ID ${this._agentId} wallet mismatch: ` +
+                    `expected ${this.walletAddress}, got ${record.wallet}`);
+                this._agentId = undefined;
+            }
+            else {
+                this.logger.info(`Loaded agent ID ${this._agentId} (trust: ${record.trustScore / 100}%)`);
+            }
+        }
+        // Try to find agent by wallet if not set
+        if (!this._agentId) {
+            const found = await this.agentDiscovery.getAgentByWallet(this.walletAddress);
+            if (found) {
+                this._agentId = found.id;
+                this.logger.info(`Found existing agent ID ${this._agentId} for wallet ${this.walletAddress}`);
+            }
+        }
+        this._initialized = true;
+        this.logger.info(`Q00bs Agent initialized | Mode: ${this._walletMode} | Wallet: ${this.walletAddress}`);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // REGISTRATION
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Register this agent on-chain on one side of the owner's q00b.
+     *
+     * @param ownerQ00bAddress - The q00b contract address owned by this agent's human.
+     * @param sidePosition - Which side of the q00b (0-5) to occupy.
+     * @returns The new agent's on-chain ID.
+     *
+     * IMPORTANT: The transaction sender must be the q00b OWNER (not the agent wallet).
+     * In practice, the owner calls registerAgent() from their wallet, passing
+     * the agent's wallet address. This method is for convenience when the owner's
+     * private key is used.
+     *
+     * @example
+     * ```ts
+     * const agentId = await agent.register('0xMyQ00bAddress', 0);
+     * console.log(`Registered as agent #${agentId}`);
+     * ```
+     */
+    async register(ownerQ00bAddress, sidePosition) {
+        this.ensureInitialized();
+        if (this._agentId) {
+            this.logger.warn(`Agent already registered with ID ${this._agentId}`);
+            return this._agentId;
+        }
+        // Hash capabilities for on-chain storage
+        const capabilities = this.config.capabilities || [];
+        const capabilitiesHash = (0, viem_1.keccak256)((0, viem_1.toHex)(JSON.stringify(capabilities)));
+        this.logger.info(`Registering agent on q00b ${ownerQ00bAddress}, side ${sidePosition}`);
+        if (!this.walletClient) {
+            throw new errors_1.PrivyWalletError('register() requires a viem walletClient (Mode 1). ' +
+                'In Privy mode (Mode 2), registration must go through the API or a separate owner transaction.');
+        }
+        const hash = await this.walletClient.writeContract({
+            address: this.config.registryAddress,
+            abi: AgentRegistry_1.AGENT_REGISTRY_ABI,
+            functionName: 'registerAgent',
+            args: [
+                this.walletAddress,
+                sidePosition,
+                capabilitiesHash,
+            ],
+        });
+        const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
+        this.logger.info(`Registration tx confirmed in block ${receipt.blockNumber}`);
+        // Parse agent ID from AgentRegistered event
+        for (const log of receipt.logs) {
+            if (log.topics && log.topics.length > 1) {
+                const id = Number(BigInt(log.topics[1]));
+                if (id > 0) {
+                    this._agentId = id;
+                    this.logger.info(`Registered as agent #${id}`);
+                    return id;
+                }
+            }
+        }
+        // Fallback: look up by wallet
+        const found = await this.agentDiscovery.getAgentByWallet(this.walletAddress);
+        if (found) {
+            this._agentId = found.id;
+            return found.id;
+        }
+        throw new Error('Registration succeeded but could not determine agent ID');
+    }
+    // ─────────────────────────────────────────────────────────────
+    // TRUST
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Check the trust path between this agent and another.
+     *
+     * @param targetAgentId - The other agent's on-chain ID.
+     * @returns TrustPath with connection status, hops, and effective trust score.
+     */
+    async checkTrust(targetAgentId) {
+        this.ensureRegistered();
+        return this.trustResolver.resolve(this._agentId, targetAgentId);
+    }
+    /**
+     * Get this agent's on-chain record.
+     */
+    async getMyRecord() {
+        this.ensureRegistered();
+        return this.agentDiscovery.getAgent(this._agentId);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // DISCOVERY
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Search for agents in the trust network.
+     *
+     * @param query - Optional filters (minTrustScore, maxHops, limit, sortBy).
+     * @returns Array of discovered agents sorted by effective trust.
+     */
+    async discoverAgents(query) {
+        this.ensureRegistered();
+        return this.agentDiscovery.find(this._agentId, query);
+    }
+    /**
+     * Get any agent's record by ID.
+     */
+    async getAgent(agentId) {
+        this.ensureInitialized();
+        return this.agentDiscovery.getAgent(agentId);
+    }
+    /**
+     * Get any agent's record by wallet address.
+     */
+    async getAgentByWallet(wallet) {
+        this.ensureInitialized();
+        return this.agentDiscovery.getAgentByWallet(wallet);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // ESCROW (PAYMENTS)
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Create an escrow to pay another agent for a task.
+     *
+     * @param params - Service agent ID, task description, payment amount, deadline.
+     * @returns The new escrow ID.
+     * @throws If escrow module is not configured.
+     */
+    async createEscrow(params) {
+        this.ensureRegistered();
+        this.ensureEscrow();
+        return this.escrowManager.create(this._agentId, params);
+    }
+    /**
+     * Accept an escrow (as the service agent).
+     */
+    async acceptEscrow(escrowId) {
+        this.ensureInitialized();
+        this.ensureEscrow();
+        return this.escrowManager.accept(escrowId);
+    }
+    /**
+     * Mark an escrow complete (as the service agent).
+     */
+    async completeEscrow(escrowId, deliverableDescription) {
+        this.ensureInitialized();
+        this.ensureEscrow();
+        return this.escrowManager.markComplete(escrowId, deliverableDescription);
+    }
+    /**
+     * Release escrowed funds to the service agent (as the client agent).
+     */
+    async releaseEscrow(escrowId) {
+        this.ensureInitialized();
+        this.ensureEscrow();
+        return this.escrowManager.release(escrowId);
+    }
+    /**
+     * Request refund for an expired escrow.
+     */
+    async refundEscrow(escrowId) {
+        this.ensureInitialized();
+        this.ensureEscrow();
+        return this.escrowManager.refund(escrowId);
+    }
+    /**
+     * Get escrow details.
+     */
+    async getEscrow(escrowId) {
+        this.ensureInitialized();
+        this.ensureEscrow();
+        return this.escrowManager.get(escrowId);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // CONSENSUS
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Request consensus from peer agents for a high-stakes action.
+     *
+     * @param params - Action description, value, and optional timeout.
+     * @returns The consensus request ID.
+     */
+    async requestConsensus(params) {
+        this.ensureRegistered();
+        this.ensureConsensus();
+        return this.consensusManager.request(this._agentId, params);
+    }
+    /**
+     * Vote on a peer's consensus request.
+     */
+    async voteOnConsensus(requestId, approve) {
+        this.ensureRegistered();
+        this.ensureConsensus();
+        return this.consensusManager.vote(requestId, this._agentId, approve);
+    }
+    /**
+     * Wait for a consensus request to reach a decision (blocking).
+     */
+    async waitForConsensus(requestId, pollIntervalMs, timeoutMs) {
+        this.ensureInitialized();
+        this.ensureConsensus();
+        return this.consensusManager.waitForResult(requestId, pollIntervalMs, timeoutMs);
+    }
+    /**
+     * Get consensus request details.
+     */
+    async getConsensusRequest(requestId) {
+        this.ensureInitialized();
+        this.ensureConsensus();
+        return this.consensusManager.get(requestId);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // PRIVY WALLET MANAGEMENT (MODE 2 ONLY)
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Get this agent's Privy wallet info (Mode 2 only).
+     *
+     * @returns The Privy wallet info, or undefined if not in Privy mode.
+     */
+    getPrivyWalletInfo() {
+        return this.privyManager?.walletInfo;
+    }
+    /**
+     * Update the spending policy on this agent's Privy wallet (Mode 2 only).
+     *
+     * Use this to dynamically adjust limits — for example, after the agent
+     * gains more trust or is granted higher permissions by its owner.
+     *
+     * @param policy - The new wallet policy to apply.
+     * @throws PrivyWalletError if not in Privy mode or update fails.
+     *
+     * @example
+     * ```ts
+     * await agent.updatePrivyPolicy({
+     *   name: 'Elevated Limits',
+     *   rules: [
+     *     { type: 'max_transaction_value', value: '0.5' },
+     *     { type: 'daily_spend_limit', value: '5.0' },
+     *   ],
+     * });
+     * ```
+     */
+    async updatePrivyPolicy(policy) {
+        this.ensureInitialized();
+        if (!this.privyManager) {
+            throw new errors_1.PrivyWalletError('updatePrivyPolicy() is only available in Privy mode (Mode 2). ' +
+                'Set `privy` in AgentConfig to use Privy wallets.');
+        }
+        const walletInfo = this.privyManager.walletInfo;
+        if (!walletInfo) {
+            throw new errors_1.PrivyWalletError('Privy wallet not initialized');
+        }
+        await this.privyManager.setPolicy(walletInfo.walletId, policy);
+        this.logger.info(`Privy wallet policy updated: "${policy.name}"`);
+    }
+    /**
+     * Sign a message with this agent's wallet.
+     *
+     * Works in both modes:
+     *   - Mode 1: Uses viem walletClient.signMessage()
+     *   - Mode 2: Uses Privy's signMessage API
+     *
+     * @param message - The message to sign.
+     * @returns The signature hex string.
+     */
+    async signMessage(message) {
+        this.ensureInitialized();
+        if (this._walletMode === 'privy' && this.privyManager) {
+            const walletInfo = this.privyManager.walletInfo;
+            if (!walletInfo)
+                throw new errors_1.PrivyWalletError('Privy wallet not initialized');
+            return this.privyManager.signMessage(walletInfo.walletId, message);
+        }
+        if (this.walletClient) {
+            return this.walletClient.signMessage({
+                message,
+                account: this.walletClient.account,
+            });
+        }
+        throw new Error('No wallet available for signing');
+    }
+    // ─────────────────────────────────────────────────────────────
+    // ERC-8004 TRUSTLESS AGENTS
+    // ─────────────────────────────────────────────────────────────
+    //
+    // These methods provide a convenient interface for ERC-8004 operations
+    // directly from the Q00bsAgent. For advanced usage, access the
+    // underlying ERC8004Manager via `agent.erc8004`.
+    //
+    // ERC-8004 gives your Q00bs agents interoperable identity and
+    // reputation that other agent platforms can read and verify.
+    /**
+     * Register this agent's ERC-8004 identity in the IdentityRegistry.
+     *
+     * This creates a portable identity on the canonical ERC-8004 registry
+     * that other agent platforms can discover and verify.
+     *
+     * @param ownerAddress - Address to mint the identity NFT to (usually your wallet).
+     * @returns The new ERC-8004 identity.
+     *
+     * @example
+     * ```ts
+     * const identity = await agent.registerERC8004Identity(agent.address);
+     * console.log(`ERC-8004 ID: ${identity.agentId}`);
+     * console.log(`Identifier: ${identity.identifier}`);
+     * ```
+     */
+    async registerERC8004Identity(ownerAddress) {
+        this.ensureInitialized();
+        this.ensureERC8004();
+        const owner = ownerAddress || this.walletAddress;
+        return this._erc8004Manager.registerIdentity(owner);
+    }
+    /**
+     * Get an ERC-8004 identity by agentId.
+     *
+     * @param agentId - The ERC-8004 agentId (tokenId in IdentityRegistry).
+     * @returns The identity, or null if not found.
+     */
+    async getERC8004Identity(agentId) {
+        this.ensureInitialized();
+        this.ensureERC8004();
+        return this._erc8004Manager.getIdentity(agentId);
+    }
+    /**
+     * Set the agentURI on this agent's ERC-8004 identity.
+     *
+     * The URI should point to a JSON registration file describing
+     * the agent (name, capabilities, endpoints, trust level, etc.).
+     *
+     * @param erc8004AgentId - The agent's ERC-8004 ID.
+     * @param uri - The URI (IPFS, HTTPS, etc.).
+     */
+    async setERC8004AgentURI(erc8004AgentId, uri) {
+        this.ensureInitialized();
+        this.ensureERC8004();
+        return this._erc8004Manager.setAgentURI(erc8004AgentId, uri);
+    }
+    /**
+     * Sync this agent's Q00bs trust score to its ERC-8004 metadata.
+     *
+     * This makes the Q00bs trust score visible to other agent platforms
+     * that read ERC-8004 metadata.
+     *
+     * @param erc8004AgentId - The agent's ERC-8004 ID.
+     */
+    async syncTrustToERC8004(erc8004AgentId) {
+        this.ensureRegistered();
+        this.ensureERC8004();
+        const record = await this.agentDiscovery.getAgent(this._agentId);
+        if (!record) {
+            throw new Error(`Q00bs agent ${this._agentId} not found on-chain`);
+        }
+        await this._erc8004Manager.syncTrustToMetadata(erc8004AgentId, this._agentId, record.trustScore);
+    }
+    /**
+     * Give ERC-8004 feedback to another agent.
+     *
+     * This publishes a reputation signal on the canonical ReputationRegistry.
+     * Other agent platforms can read this feedback to assess your peer's
+     * trustworthiness.
+     *
+     * @param params - Feedback parameters (subject, value, decimals).
+     * @param fromERC8004AgentId - Your agent's ERC-8004 ID.
+     * @returns The feedback index.
+     *
+     * @example
+     * ```ts
+     * await agent.giveERC8004Feedback({
+     *   subjectAgentId: 7,
+     *   value: 4.5,     // positive feedback
+     *   decimals: 2,
+     * }, myERC8004Id);
+     * ```
+     */
+    async giveERC8004Feedback(params, fromERC8004AgentId) {
+        this.ensureInitialized();
+        this.ensureERC8004();
+        return this._erc8004Manager.giveFeedback(params, fromERC8004AgentId);
+    }
+    /**
+     * Get the ERC-8004 reputation summary for an agent.
+     *
+     * @param erc8004AgentId - The agent's ERC-8004 ID.
+     * @returns Aggregate reputation summary.
+     */
+    async getERC8004Reputation(erc8004AgentId) {
+        this.ensureInitialized();
+        this.ensureERC8004();
+        return this._erc8004Manager.getReputationSummary(erc8004AgentId);
+    }
+    /**
+     * Read all ERC-8004 feedback for an agent.
+     *
+     * @param erc8004AgentId - The agent's ERC-8004 ID.
+     * @returns Array of feedback entries.
+     */
+    async getERC8004Feedback(erc8004AgentId) {
+        this.ensureInitialized();
+        this.ensureERC8004();
+        return this._erc8004Manager.readAllFeedback(erc8004AgentId);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // UTILITIES
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Calculate effective trust locally (no blockchain call).
+     * Useful for quick UI previews.
+     */
+    calculateTrust(baseTrustScore, hops) {
+        return trust_1.TrustResolver.calculateLocally(baseTrustScore, hops);
+    }
+    /**
+     * Clear the trust cache (call after known on-chain changes).
+     */
+    clearTrustCache() {
+        this.trustResolver?.clearCache();
+    }
+    // ─────────────────────────────────────────────────────────────
+    // PRIVATE GUARDS
+    // ─────────────────────────────────────────────────────────────
+    ensureInitialized() {
+        if (!this._initialized) {
+            throw new Error('Agent not initialized. Call agent.initialize() first.');
+        }
+    }
+    ensureRegistered() {
+        this.ensureInitialized();
+        if (!this._agentId) {
+            throw new errors_1.AgentNotRegisteredError();
+        }
+    }
+    ensureEscrow() {
+        if (this._walletMode === 'privy') {
+            // In Privy mode, escrow doesn't need a walletClient — it uses Privy.
+            if (!this.config.escrowAddress) {
+                throw new Error('Escrow not configured. Pass escrowAddress in AgentConfig to enable payments.');
+            }
+            return;
+        }
+        if (!this.escrowManager) {
+            throw new Error('Escrow not configured. Pass escrowAddress in AgentConfig to enable payments.');
+        }
+    }
+    ensureConsensus() {
+        if (this._walletMode === 'privy') {
+            if (!this.config.consensusAddress) {
+                throw new Error('Consensus not configured. Pass consensusAddress in AgentConfig to enable consensus.');
+            }
+            return;
+        }
+        if (!this.consensusManager) {
+            throw new Error('Consensus not configured. Pass consensusAddress in AgentConfig to enable consensus.');
+        }
+    }
+    ensureERC8004() {
+        if (!this._erc8004Manager) {
+            throw new errors_1.ERC8004NotConfiguredError();
+        }
+    }
+}
+exports.Q00bsAgent = Q00bsAgent;
+//# sourceMappingURL=Q00bsAgent.js.map