@agentsbazaar/sdk 0.2.0 → 0.3.0

package/dist/cli.js

@@ -28,7 +28,7 @@ const program = new Command();
 program
     .name("bazaar")
     .description("AgentBazaar CLI — register, discover, and hire AI agents on Solana")
-    .version("0.2.0");
+    .version("0.3.0");
 // ── register ──
 program
     .command("register")
@@ -187,6 +187,38 @@ program
         process.exit(1);
     }
 });
+// ── quote ──
+program
+    .command("quote")
+    .description("Get a price quote from an agent before paying")
+    .requiredOption("--task <text>", "Task to get a quote for")
+    .option("--agent <wallet>", "Target specific agent by wallet address")
+    .option("--skills <skills>", "Filter agents by skills")
+    .option("--api <url>", "API base URL")
+    .action(async (opts) => {
+    try {
+        const client = createClient({ api: opts.api, wallet: false });
+        console.log("Requesting quote...\n");
+        const quote = await client.quote({
+            task: opts.task,
+            agent: opts.agent,
+            skills: opts.skills,
+        });
+        console.log(`Agent: ${quote.agent.name} (${quote.agent.authority})`);
+        console.log(`Price: ${quote.priceUsdc} USDC (${quote.source} pricing)`);
+        console.log(`Quote ID: ${quote.quoteId}`);
+        console.log(`Expires: ${new Date(Number(quote.expiresAt)).toLocaleString()}`);
+        if (quote.estimate)
+            console.log(`Estimate: ${quote.estimate}`);
+        if (quote.breakdown)
+            console.log(`Breakdown: ${quote.breakdown}`);
+        console.log(`\nUse with: bazaar call --task "..." --quote ${quote.quoteId}`);
+    }
+    catch (err) {
+        console.error(`Quote failed: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+});
 // ── call ──
 program
     .command("call")
@@ -194,6 +226,9 @@ program
     .requiredOption("--task <text>", "Task for the agent to perform")
     .option("--skills <skills>", "Filter agents by skills")
     .option("--agent <wallet>", "Target specific agent by wallet address")
+    .option("--quote <id>", "Use a previously obtained quote ID")
+    .option("--session <id>", "Continue an existing session")
+    .option("--new-session", "Create a new multi-turn session")
     .option("--api <url>", "API base URL")
     .action(async (opts) => {
     try {
@@ -203,11 +238,18 @@ program
             task: opts.task,
             skills: opts.skills,
             agent: opts.agent,
+            quoteId: opts.quote,
+            sessionId: opts.session,
+            createSession: opts.newSession || false,
         });
         console.log(`Agent: ${result.agent.name} (${result.agent.authority})`);
         console.log(`Price: ${result.agent.price} USDC`);
         console.log(`Score: ${result.verification.score}/100 — ${result.verification.action}`);
         console.log(`Job: #${result.job.id} (${result.job.status})`);
+        if (result.sessionId)
+            console.log(`Session: ${result.sessionId}`);
+        if (result.quoteId)
+            console.log(`Quote: ${result.quoteId}`);
         console.log(`Latency: ${result.meta.agentLatencyMs}ms (total: ${result.meta.totalMs}ms)`);
         console.log(`\nResult:`);
         console.log(typeof result.result === "string" ? result.result : JSON.stringify(result.result, null, 2));
@@ -264,6 +306,34 @@ program
         process.exit(1);
     }
 });
+// ── sessions ──
+program
+    .command("sessions")
+    .description("List your sessions")
+    .requiredOption("--buyer <wallet>", "Your wallet address")
+    .option("--status <status>", "Filter by status: active, closed, expired")
+    .option("--api <url>", "API base URL")
+    .action(async (opts) => {
+    try {
+        const client = createClient({ api: opts.api, wallet: false });
+        const { sessions } = await client.listSessions(opts.buyer, opts.status);
+        if (sessions.length === 0) {
+            console.log("No sessions found.");
+            return;
+        }
+        console.log(`${sessions.length} session(s):\n`);
+        for (const s of sessions) {
+            console.log(`  ${s.id} [${s.status}]`);
+            console.log(`    Agent: ${s.agent_auth}`);
+            console.log(`    Messages: ${s.message_count} | Spent: ${formatUsdc(s.total_spent)} USDC`);
+            console.log();
+        }
+    }
+    catch (err) {
+        console.error(`Failed: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+});
 // ── stats ──
 program
     .command("stats")

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;
+    }>;
 }