@agentsbazaar/sdk 0.2.0 → 0.4.0

package/dist/client.d.ts

@@ -1,11 +1,13 @@
 import { Keypair } from "@solana/web3.js";
-import type { Agent, Job, Rating, RegisterParams, RegisterResult, CallParams, CallResult, HireParams, HireResult, A2ATaskResult, A2AStreamEvent, PlatformStats, Pagination, AgentCard } from "./types.js";
+import type { Agent, Job, Rating, RegisterParams, RegisterResult, CallParams, CallResult, HireParams, HireResult, A2ATaskResult, A2AStreamEvent, PlatformStats, Pagination, AgentCard, QuoteParams, QuoteResponse, SessionInfo, SessionMessage, UploadResult, TrustData, FeedbackEntry, LeaderboardEntry, UpdateAgentParams, TransferResult, CrawlResult } from "./types.js";
 export declare class AgentBazaarClient {
     private baseUrl;
     private keypair;
-    constructor(options: {
+    private apiKey;
+    constructor(options?: {
         baseUrl?: string;
         keypair?: Keypair;
+        apiKey?: string;
     });
     private signMessage;
     private request;
@@ -50,12 +52,386 @@ export declare class AgentBazaarClient {
         status: string;
         timestamp: string;
     }>;
-    a2aSend(slug: string, task: string): Promise<A2ATaskResult>;
+    a2aSend(slug: string, task: string, options?: {
+        files?: Array<{
+            url: string;
+            name?: string;
+            mimeType?: string;
+        }>;
+    }): Promise<A2ATaskResult>;
     a2aGet(slug: string, taskId: string): Promise<A2ATaskResult>;
     a2aCancel(slug: string, taskId: string): Promise<A2ATaskResult>;
-    a2aStream(slug: string, task: string): AsyncGenerator<A2AStreamEvent>;
+    a2aStream(slug: string, task: string, options?: {
+        files?: Array<{
+            url: string;
+            name?: string;
+            mimeType?: string;
+        }>;
+        timeoutMs?: number;
+    }): AsyncGenerator<A2AStreamEvent>;
+    quote(params: QuoteParams): Promise<QuoteResponse>;
+    getQuote(quoteId: string): Promise<QuoteResponse>;
+    /**
+     * Start a session with an agent. Returns a sessionId for multi-turn conversations.
+     */
+    startSession(agentPubkey: string, budgetLimit?: number): Promise<{
+        sessionId: string;
+        agent: {
+            name: string;
+            price: number;
+            priceUsdc: number;
+        };
+    }>;
+    /**
+     * Send a message in an existing session. Returns a quote with an unsigned payment transaction.
+     * Call paySession() with the paymentId to execute.
+     */
+    sendMessage(sessionId: string, task: string, fileUrl?: string): Promise<{
+        sessionId: string;
+        price: number;
+        priceUsdc: number;
+        paymentId?: string;
+        pendingPayment?: {
+            transaction: string;
+        };
+        free?: boolean;
+        result?: string;
+    }>;
+    /**
+     * Pay for a message and get the agent's response.
+     * Pass the paymentId from sendMessage() and the signed transaction.
+     */
+    paySession(paymentId: string, signedTransaction: string): Promise<{
+        success: boolean;
+        txSignature: string;
+        result: string;
+        status: string;
+        job: {
+            id: number;
+            status: string;
+        };
+        sessionId: string;
+        question?: string;
+        taskId?: string;
+    }>;
+    listSessions(buyer?: string, status?: string): Promise<{
+        sessions: SessionInfo[];
+    }>;
+    getSession(sessionId: string): Promise<SessionInfo>;
+    getSessionMessages(sessionId: string, limit?: number): Promise<{
+        messages: SessionMessage[];
+        sessionId: string;
+    }>;
+    closeSession(sessionId: string): Promise<{
+        success: boolean;
+        sessionId: string;
+        totalSpent: number;
+        messageCount: number;
+    }>;
     uploadImage(imagePath: string): Promise<{
         success: boolean;
         imageUrl: string;
     }>;
+    /**
+     * Submit an on-chain review for an agent after a completed job.
+     * The SDK keypair signs as the reviewer, platform pays gas.
+     * For agent-to-agent: the hiring agent's keypair signs the review.
+     */
+    submitReview(agentPubkey: string, jobId: number, score: number, comment?: string): Promise<{
+        success: boolean;
+        txSignature: string;
+    }>;
+    getTrustData(pubkey: string): Promise<TrustData>;
+    getLeaderboard(options?: {
+        limit?: number;
+        minTier?: number;
+    }): Promise<{
+        agents: LeaderboardEntry[];
+    }>;
+    getFeedback(pubkey: string): Promise<{
+        feedback: FeedbackEntry[];
+        verifiedCount: number;
+        totalCount: number;
+    }>;
+    revokeFeedback(pubkey: string, feedbackIndex: number): Promise<{
+        success: boolean;
+    }>;
+    respondToFeedback(pubkey: string, feedbackIndex: number, response: string): Promise<{
+        success: boolean;
+    }>;
+    updateAgent(params: UpdateAgentParams): Promise<{
+        success: boolean;
+        agent: Agent;
+    }>;
+    transferAgent(newOwner: string): Promise<TransferResult>;
+    setOperationalWallet(wallet: string, deadline: number): Promise<{
+        success: boolean;
+    }>;
+    setParentAgent(parentPubkey: string): Promise<{
+        success: boolean;
+    }>;
+    crawlEndpoint(endpoint: string): Promise<CrawlResult>;
+    /**
+     * Create a new custodial wallet. Returns an API key — save it, it cannot be recovered.
+     * No keypair needed — this is for users without their own Solana wallet.
+     */
+    static createWallet(baseUrl?: string, label?: string): Promise<{
+        apiKey: string;
+        publicKey: string;
+        message: string;
+    }>;
+    /**
+     * Get wallet info and balance using API key auth.
+     */
+    getWallet(): Promise<{
+        publicKey: string;
+        balances: {
+            sol: string;
+            usdc: string;
+        };
+    }>;
+    /**
+     * Export the private key for the custodial wallet. Returns the full 64-byte keypair.
+     * Save this and import into Phantom/Solflare for self-custody.
+     */
+    exportKey(): Promise<{
+        privateKey: number[];
+        publicKey: string;
+    }>;
+    /**
+     * List emails in the agent's inbox.
+     */
+    getInbox(options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        messages: Array<{
+            id: string;
+            from: string;
+            to: string;
+            subject: string;
+            created_at: string;
+        }>;
+    }>;
+    /**
+     * Read a specific email from the agent's inbox.
+     */
+    readEmail(messageId: string): Promise<{
+        id: string;
+        from: string;
+        to: string;
+        subject: string;
+        text: string;
+        html?: string;
+        created_at: string;
+    }>;
+    /**
+     * Send an email from the agent's inbox.
+     */
+    sendEmail(params: {
+        to: string;
+        subject: string;
+        text: string;
+        html?: string;
+    }): Promise<{
+        success: boolean;
+        messageId?: string;
+    }>;
+    uploadFile(filePath: string): Promise<UploadResult>;
+    private authHeaders;
+    getCreditBalance(): Promise<{
+        balance: number;
+        balanceUsdc: number;
+    }>;
+    getCreditHistory(limit?: number): Promise<{
+        transactions: Array<{
+            type: string;
+            amount: number;
+            description: string;
+            created_at: string;
+        }>;
+    }>;
+    depositCredits(stripePaymentIntentId: string): Promise<{
+        success: boolean;
+        balance: number;
+    }>;
+    createPrepaidSession(agentPubkey: string, budgetUsdc: number): Promise<{
+        sessionId: string;
+        token: string;
+        budgetUsdc: number;
+        estimatedMessages: number;
+        transaction?: string;
+    }>;
+    openPrepaidSession(agentPubkey: string, budgetUsdc: number, signedTransaction: string): Promise<{
+        sessionId: string;
+        token: string;
+        budgetUsdc: number;
+        estimatedMessages: number;
+        txSignature: string;
+    }>;
+    extendSession(sessionId: string, additionalUsdc: number): Promise<{
+        sessionId: string;
+        budgetUsdc: number;
+        spentUsdc: number;
+        remainingUsdc: number;
+    }>;
+    sendMessageWithBudget(sessionId: string, task: string, maxBudget: number, fileUrl?: string): Promise<{
+        price: number;
+        priceUsdc: number;
+        negotiated?: boolean;
+        paymentId?: string;
+        pendingPayment?: {
+            transaction: string;
+        };
+    }>;
+    getNotifications(limit?: number): Promise<{
+        notifications: Array<{
+            id: number;
+            type: string;
+            title: string;
+            description: string;
+            is_read: boolean;
+            created_at: string;
+        }>;
+    }>;
+    getUnreadCount(): Promise<{
+        count: number;
+    }>;
+    markNotificationsRead(ids?: number[]): Promise<{
+        success: boolean;
+    }>;
+    registerWebhook(url: string, events?: string[]): Promise<{
+        success: boolean;
+        url: string;
+        events: string[];
+    }>;
+    getWebhook(): Promise<{
+        subscribed: boolean;
+        url?: string;
+        events?: string[];
+    }>;
+    deleteWebhook(): Promise<{
+        success: boolean;
+    }>;
+    getSwapQuote(inputMint: string, outputMint: string, amount: number): Promise<{
+        inputMint: string;
+        outputMint: string;
+        inAmount: string;
+        outAmount: string;
+        priceImpact: string;
+    }>;
+    buildSwapTransaction(inputMint: string, outputMint: string, amount: number): Promise<{
+        transaction: string;
+        inputMint: string;
+        outputMint: string;
+    }>;
+    getTokenPrice(token: string): Promise<{
+        token: string;
+        priceUsd: number;
+    }>;
+    getTokenPrices(): Promise<{
+        prices: Record<string, number>;
+    }>;
+    getSolanaPayQR(agentSlug: string): Promise<{
+        url: string;
+        qrData: string;
+    }>;
+    getBlink(agentSlug: string): Promise<{
+        icon: string;
+        title: string;
+        description: string;
+        links: {
+            actions: Array<{
+                label: string;
+                href: string;
+            }>;
+        };
+    }>;
+    createRecurringTask(params: {
+        agentAuth: string;
+        task: string;
+        intervalMs: number;
+        budgetPerExecution: number;
+        maxExecutions?: number;
+    }): Promise<{
+        id: number;
+        success: boolean;
+    }>;
+    listRecurringTasks(): Promise<{
+        tasks: Array<{
+            id: number;
+            agent_auth: string;
+            task: string;
+            status: string;
+            executions: number;
+        }>;
+    }>;
+    pauseRecurringTask(id: number): Promise<{
+        success: boolean;
+    }>;
+    resumeRecurringTask(id: number): Promise<{
+        success: boolean;
+    }>;
+    stopRecurringTask(id: number): Promise<{
+        success: boolean;
+    }>;
+    getAgentBalance(): Promise<{
+        sol: string;
+        usdc: string;
+        publicKey: string;
+    }>;
+    getAgentSpendHistory(): Promise<{
+        transactions: Array<{
+            type: string;
+            amount: number;
+            created_at: string;
+        }>;
+    }>;
+    getTransactionHistory(): Promise<{
+        transactions: Array<{
+            signature: string;
+            type: string;
+            amount: number;
+            timestamp: string;
+        }>;
+    }>;
+    createMandate(params: {
+        agentAuth: string;
+        budgetLimit: number;
+        expiresInMs: number;
+        allowedActions?: string[];
+    }): Promise<{
+        id: number;
+        success: boolean;
+    }>;
+    listMandates(): Promise<{
+        mandates: Array<{
+            id: number;
+            agent_auth: string;
+            budget_limit: number;
+            status: string;
+        }>;
+    }>;
+    revokeMandate(id: number): Promise<{
+        success: boolean;
+    }>;
+    getPresignedUploadUrl(fileName: string, mimeType: string, size?: number): Promise<{
+        uploadUrl: string;
+        token: string;
+        fileId: string;
+        storagePath: string;
+    }>;
+    confirmUpload(fileId: string): Promise<{
+        success: boolean;
+        url: string;
+        name: string;
+        size: number;
+    }>;
+    discover(skills: string): Promise<Agent[]>;
+    myAgents(): Promise<{
+        agents: Agent[];
+    }>;
+    claimAgent(agentPubkey: string, accessCode: string): Promise<{
+        success: boolean;
+    }>;
 }