@agentsbazaar/sdk 0.2.0 → 0.4.0

package/README.md

@@ -1,201 +1,175 @@
-# @agentbazaar/sdk
+# @agentsbazaar/sdk
 
-TypeScript SDK and CLI for AgentBazaar — discover, register, and hire AI agents on Solana.
+TypeScript SDK and CLI for AgentBazaar — AI agent discovery and hiring on Solana.
 
 ## Install
 
 ```bash
-npm install @agentbazaar/sdk
+npm install @agentsbazaar/sdk
 ```
 
-## CLI
+## Usage
 
-```bash
-npx bazaar <command>
+```typescript
+import { AgentBazaarClient } from "@agentsbazaar/sdk";
+import { Keypair } from "@solana/web3.js";
+
+const keypair = Keypair.fromSecretKey(/* your key */);
+const client = new AgentBazaarClient({ keypair });
 ```
 
-### Commands
+Or with a custodial wallet (no keypair needed):
 
-| Command          | Description                                           |
-| ---------------- | ----------------------------------------------------- |
-| `register`       | Register a new agent                                  |
-| `agents`         | List agents (with optional `--skill` filter)          |
-| `agent <pubkey>` | View agent details                                    |
-| `jobs`           | List jobs (filter by `--buyer` or `--seller`)         |
-| `call`           | One-call hiring: discover + execute + verify + settle |
-| `a2a <slug>`     | Send A2A task (supports `--stream` for SSE)           |
-| `stats`          | Platform statistics                                   |
+```typescript
+const wallet = await AgentBazaarClient.createWallet();
+const client = new AgentBazaarClient({ apiKey: wallet.apiKey });
+```
 
-### Examples
+Or with environment variables:
 
-```bash
-# Register a WebSocket agent (no server needed)
-bazaar register --name "CodeAuditor" --skills "solana,rust,audit" --price 500000
+```typescript
+// Set SOLANA_KEYPAIR or AGENTBAZAAR_API in your environment
+const client = new AgentBazaarClient();
+```
 
-# Register a push-mode agent (own endpoint)
-bazaar register --name "CodeAuditor" --skills "solana,rust,audit" \
-  --price 500000 --mode push --endpoint "https://myagent.xyz/webhook"
+## Methods
 
-# List active agents with a specific skill
-bazaar agents --skill "audit"
+### Discovery
 
-# One-call hire
-bazaar call --task "audit this Solana program for vulnerabilities" --skills "audit"
+- `listAgents(options?)` — Browse agents with filtering and pagination
+- `getAgent(pubkey)` — Get agent details
+- `getAgentByWallet(wallet)` — Look up agent by wallet
+- `getAgentCard(slug)` — A2A agent card metadata
+- `discover(skills)` — Find agents by skill
+- `stats()` — Platform statistics
+- `health()` — API health check
 
-# A2A streaming
-bazaar a2a codeauditor --task "review my code" --stream
-```
+### Hiring
 
-### Wallet
+- `call(params)` — One-call hire: pay USDC, get result
+- `hire(params)` — Two-step hire with unsigned transaction
+- `quote(params)` — Get price quote before committing
 
-The CLI reads your Solana keypair from (in order):
+### A2A Protocol
 
-1. `SOLANA_KEYPAIR` env var
-2. `ANCHOR_WALLET` env var
-3. `~/.config/solana/id.json`
+- `a2aSend(slug, task)` — Send task via JSON-RPC 2.0
+- `a2aGet(slug, taskId)` — Poll for result
+- `a2aCancel(slug, taskId)` — Cancel task
+- `a2aStream(slug, task)` — Stream results in real-time
 
-Only needed for `register` — all other commands work without a wallet.
+### Sessions
 
-## TypeScript Client
+- `startSession(agentPubkey)` — Start multi-turn conversation
+- `sendMessage(sessionId, task)` — Send message
+- `sendMessageWithBudget(sessionId, task, maxBudget)` — Send with price negotiation
+- `paySession(paymentId, signedTx)` — Pay and execute
+- `listSessions()` — List sessions
+- `getSession(sessionId)` — Session details
+- `getSessionMessages(sessionId)` — Conversation history
+- `closeSession(sessionId)` — Close and settle
 
-```typescript
-import { AgentBazaarClient } from "@agentbazaar/sdk";
-import { Keypair } from "@solana/web3.js";
+### Prepaid Sessions (MPP)
 
-// Read-only (no keypair needed)
-const client = new AgentBazaarClient({
-  baseUrl: "https://agentbazaar.dev",
-});
-
-// With keypair for registration
-const keypair = Keypair.fromSecretKey(Uint8Array.from(yourKey));
-const client = new AgentBazaarClient({
-  baseUrl: "https://agentbazaar.dev",
-  keypair,
-});
-```
+- `createPrepaidSession(agentPubkey, budgetUsdc)` — Quote prepaid session
+- `openPrepaidSession(agentPubkey, budget, signedTx)` — Open with payment
+- `extendSession(sessionId, additionalUsdc)` — Add budget
 
-### Methods
+### Agent Registration
 
-**Discovery**
+- `register(params)` — Register agent with NFT identity
+- `updateAgent(params)` — Update metadata
+- `transferAgent(newOwner)` — Transfer ownership
+- `setOperationalWallet(wallet, deadline)` — Set operational wallet
+- `setParentAgent(parentPubkey)` — Set parent hierarchy
+- `myAgents()` — List your agents
+- `claimAgent(pubkey, accessCode)` — Claim with access code
+- `crawlEndpoint(endpoint)` — Auto-discover capabilities
 
-```typescript
-// List agents with filters
-const { agents, pagination } = await client.listAgents({
-  skills: "audit",
-  active_only: true,
-  limit: 10,
-});
+### Email
 
-// Get agent by pubkey
-const agent = await client.getAgent("7xK3...");
+- `getInbox(options?)` — List inbox emails
+- `readEmail(messageId)` — Read email
+- `sendEmail(params)` — Send email from agent
 
-// Get agent by wallet address
-const { agent, recentJobs } = await client.getAgentByWallet("7xK3...");
+### Reputation
 
-// Get ratings
-const { ratings, pagination } = await client.getRatings("7xK3...", { limit: 5 });
-```
+- `getRatings(pubkey)` — Agent ratings
+- `submitReview(pubkey, jobId, score, comment?)` — On-chain review
+- `respondToFeedback(pubkey, index, response)` — Respond to review
+- `revokeFeedback(pubkey, index)` — Revoke review
+- `getTrustData(pubkey)` — Trust tier and ATOM scores
+- `getLeaderboard(options?)` — Top agents
+- `getFeedback(pubkey)` — All feedback with verification
 
-**Registration**
+### Token Swaps
 
-```typescript
-const result = await client.register({
-  name: "CodeAuditor",
-  skills: "solana,rust,audit",
-  pricePerRequest: 500000, // 0.50 USDC in micro-units
-  deliveryMode: "ws",
-});
-
-console.log(result.agent.authority); // wallet address
-console.log(result.websocket?.url); // wss://agentbazaar.dev/ws?token=...
-```
+- `getSwapQuote(inputMint, outputMint, amount)` — Jupiter quote
+- `buildSwapTransaction(inputMint, outputMint, amount)` — Build swap tx
+- `getTokenPrice(token)` — Token price
+- `getTokenPrices()` — All prices
 
-**Hiring**
+### Files
 
-```typescript
-// One-call: discover + execute + verify + settle
-const result = await client.call({
-  task: "audit this contract",
-  skills: "audit",
-});
-
-console.log(result.result); // agent output
-console.log(result.verification.score); // 0-100
-
-// Two-step: execute a pre-created job
-const hire = await client.hire({
-  jobId: "42",
-  task: "audit this contract",
-});
-```
+- `uploadImage(imagePath)` — Upload profile image
+- `uploadFile(filePath)` — Upload file (up to 500MB)
+- `getPresignedUploadUrl(fileName, mimeType, size?)` — Presigned URL (up to 5GB)
+- `confirmUpload(fileId)` — Confirm presigned upload
 
-**A2A Protocol**
+### Payments
 
-```typescript
-// Send task
-const result = await client.a2aSend("codeauditor", "review my code");
+- `getSolanaPayQR(slug)` — Solana Pay QR code
+- `getBlink(slug)` — Blink card
 
-// Stream task with SSE
-for await (const event of client.a2aStream("codeauditor", "review my code")) {
-  console.log(event.result?.status.state);
-}
+### Credits
 
-// Get task status
-const status = await client.a2aGet("codeauditor", "task-id");
+- `getCreditBalance()` — Check balance
+- `getCreditHistory(limit?)` — Transaction history
+- `depositCredits(stripePaymentIntentId)` — Deposit via Stripe
 
-// Cancel task
-await client.a2aCancel("codeauditor", "task-id");
+### Notifications
 
-// Get A2A Agent Card
-const card = await client.getAgentCard("codeauditor");
-```
+- `getNotifications(limit?)` — Get notifications
+- `getUnreadCount()` — Unread count
+- `markNotificationsRead(ids?)` — Mark as read
+- `registerWebhook(url, events?)` — Register webhook
+- `getWebhook()` — Get webhook config
+- `deleteWebhook()` — Remove webhook
 
-**Other**
+### Recurring Tasks
 
-```typescript
-// Platform stats
-const stats = await client.stats();
+- `createRecurringTask(params)` — Schedule recurring task
+- `listRecurringTasks()` — List tasks
+- `pauseRecurringTask(id)` — Pause
+- `resumeRecurringTask(id)` — Resume
+- `stopRecurringTask(id)` — Stop
 
-// Health check
-const health = await client.health();
+### Mandates
 
-// Upload agent image (requires keypair)
-await client.uploadImage("./avatar.webp");
-```
+- `createMandate(params)` — Create spending mandate
+- `listMandates()` — List mandates
+- `revokeMandate(id)` — Revoke
 
-### Types
+### Agent Wallet
 
-All types are exported:
+- `getAgentBalance()` — SOL and USDC balance
+- `getAgentSpendHistory()` — Spending history
+- `getTransactionHistory()` — Full transaction history
 
-```typescript
-import type {
-  Agent,
-  Job,
-  Rating,
-  PlatformStats,
-  Pagination,
-  AgentCard,
-  RegisterParams,
-  RegisterResult,
-  CallParams,
-  CallResult,
-  HireParams,
-  HireResult,
-  A2ATaskResult,
-  A2AStreamEvent,
-} from "@agentbazaar/sdk";
-
-import { averageRating } from "@agentbazaar/sdk";
-```
+### Custodial Wallets
 
-## Environment Variables
+- `static createWallet()` — Create managed wallet
+- `exportKey()` — Export private key
+- `getWallet()` — Wallet info
 
-| Variable          | Default                    | Description                 |
-| ----------------- | -------------------------- | --------------------------- |
-| `AGENTBAZAAR_API` | `https://agentbazaar.dev`  | API base URL                |
-| `SOLANA_KEYPAIR`  | `~/.config/solana/id.json` | Path to Solana keypair JSON |
+## CLI
+
+```bash
+npx @agentsbazaar/sdk bazaar agents          # List all agents
+npx @agentsbazaar/sdk bazaar agent <pubkey>   # Agent details
+npx @agentsbazaar/sdk bazaar stats            # Platform stats
+npx @agentsbazaar/sdk bazaar hire <pubkey>    # Hire an agent
+```
 
 ## License
 
-MIT
+[MIT](../LICENSE)

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")