RocketVault Agent

Overview

RocketVault Agent is a conversational AI scoped to your cards. Ask it what's worth flipping, what needs review, how this month's P&L looks — and ask it to do things: mark a card ready, reprice a listing, create a lot, publish to eBay. Every action surfaces a category-specific preview card that you approve before anything mutates.

On desktop, summon the agent from anywhere with Cmd-K (Ctrl-K on Windows) or the RocketVault Agent entry near the top of the left sidebar — it opens as a side panel, so you keep your place on whatever page you're working in. The full-page /agent view still exists, and it's what mobile uses. You can also open the agent pre-loaded with a specific card from the Dashboard, Card Detail, and Needs Review pages — look for the Ask Agent button.

What you can ask

Vault Agent is grounded in your data only. Every number it cites comes from a tool call against your inventory, listings, sales, or P&L — it does not fabricate prices. The one place it reaches the live market is listing recommendations: ask it what to list and it checks current news to back its picks, with sources (more on that below).

Examples that work today:

• "What's my best flip right now?"
• "Which cards should I list right now?" (checks live news + recent sales to recommend which of your unlisted cards to list, and why — each pick linked to a real source)
• "How much P&L did I do this month?"
• "What needs my attention?" (price drops below cost, stale listings, strong sell signals)
• "Which of my cards are worth grading?" (ranked by expected value after grading fees)
• "Am I set up to publish to eBay?" (onboarding checklist: account connected, policies, first listing)
• "Show me cards that need review"
• "Which players in my inventory are trending?"
• "What's my inventory worth?"
• "What did I sell in the last 30 days?"
• "Show me my Patrick Mahomes cards"
• "Show me my Lakers cards" (search by team — case-insensitive, multiple teams at once)
• "Find my numbered Yankees rookies under $50 that aren't listed yet" (any combination of the Cards-page filters)
• "What's the comp range on this card I own?" (when opened from a specific Card Detail page)

Vault searches your inventory with the same filters available on the Cards page — player, team, set, brand, sport, status, year and price ranges, quantity, and every attribute toggle (graded, rookie, autograph, parallel, insert, numbered, has price, in a lot, in a collection, listed/unlisted, has duplicates). It also honors sold visibility, so you can include or exclude sold cards from any search.

If you ask Vault something outside this scope — "what's the going rate on a 2017 Mahomes rookie?" (one you don't own), "what parallels exist for X?", "how does RocketVault Pricing work?" — it will say so plainly and offer the in-scope version of the question (for example, "Want me to check whether you OWN a 2017 Mahomes rookie?"). It won't make up an answer.

The one exception — "what should I list?" When you ask which of your cards to list, Vault runs a live web search behind the scenes, matches what's moving in the news against your unlisted cards, and tells you which to list and why — each reason linked to a real source. It only ever recommends cards you actually own; if it can't tie a card to real, current news it won't claim one. On a quiet news day it falls back to your hottest unlisted cards by Heat Score and recent-sales demand, and says so rather than inventing a reason. Cards without a recorded cost basis are included — what you list doesn't depend on what you paid.

On first load, a row of suggested-prompt chips appears above the input — tap one to start without typing.

What's NOT in scope (right now)

RocketVault Agent is deliberately scoped to your account. It does not:

• Pull general market or news research on demand — a blind comp on a card you don't own, or broad market trends. (It does check live news for one narrow purpose: recommending which of your unlisted cards to list. Broader market reads live in your Daily Briefing.)
• Look up players, sets, or parallels that aren't in your inventory
• Answer how-does-RocketVault-work questions (those live in this docs site)
• Compare subscription tiers (see the pricing page)
• Change your subscription, payment method, or account email (Stripe + Settings handle those directly)
• Run admin or webhook operations

How it works

Every assistant reply shows the tool calls Vault made to answer your question — for example, "Queried 2,847 inventory cards filtered by player = 'Patrick Mahomes'." This is intentional: you can always see where a number came from, and you can challenge any answer that doesn't line up with what you expect.

Responses stream token-by-token as the model thinks, so you see partial answers before the full reply lands. There's no spinner — the answer visibly types.

Actions you can ask for

The agent can now run actions across your account. Every write goes through an inline confirmation card with the relevant preview — photo, price, fees, net, diff — and only executes after you click Approve. Ask for several actions at once (e.g. "create listings for these five cards") and each gets its own confirmation card you can approve, reject, or dismiss independently. Changed your mind about any card? Close it out with the ✕ in its corner — it leaves the conversation without running.

Cards

• Edit a card — "Set this card's grade to PSA 9 and bump the price to $80" → diff preview → approve.
• Mark ready / archive / delete — "Mark these 12 cards READY for listing."
• Bulk status + bulk field changes (up to 200 cards per turn) — "Move my Mahomes refractors to READY_HIGH_VALUE."

Listings

• Create a draft listing from a card — "Draft a listing for this card at $42."
• Edit a draft listing — "Drop the price on draft #4827 to $38."
• Publish to eBay — "Publish that draft live." Confirmation card surfaces estimated eBay fees, net payout, and your remaining eBay daily quota.
• End / relist — "End my Joe Burrow listing — relist at $95."
• Bulk markdown / reprice campaign — "Mark down everything I've had listed over 30 days by 10%, but never below cost." The confirmation card projects the full impact — how many listings, total markdown, and how many would be held back by a cost floor — before any price changes. The "never below cost" guard only protects cards where you've recorded a cost basis; cards without one are still marked down (there's no known cost to stay above). Add an explicit price floor if you want a hard minimum regardless. Capped at 200 listings.

Lots

• Create a lot from a set of cards — "Bundle these eight cards into a lot called 'Mahomes Refractors' at 15% off." Skip the name and the agent auto-generates a descriptive, SEO-style title from the cards (year, players, sport, parallels, autos).
• Edit / archive / delete / revert — "Drop the discount on lot #12 to 10%", "Archive that lot."
• Add / remove cards from a lot — "Pull card #3847 out of the rookie lot."
• Duplicate a lot — "Clone the Mahomes lot but at 20% off."
• Publish a lot to eBay — "List the Refractors lot live." Same preview shape as single listings (fees + net + quota).

Review queue + settings + watchlist

• Confirm or reject a parallel match — "Yes that's Pink Refractor." / "No that one's wrong."
• Edit your settings — "Bump the high-value review threshold to $75." The preview card surfaces the full diff before any write.
• Watch a player or card — "Watch for 2022 Mahomes Pink Refractors."

eBay setup

• Refresh your eBay policies — "Refresh my eBay shipping and return policies." Pulls your current business policies (shipping, payment, return) from eBay and syncs them into RocketVault so new listings use the right terms.

Notifications

• Morning briefing — RocketVault can email you a once-a-day briefing of your recent P&L plus what needs your attention (price drops below cost, stale listings, strong sell signals). It's on by default; toggle it with "Turn off my morning briefing" or "Turn my daily briefing back on."

Safety rails

• Preview before every write. No write tool runs without a confirmation card.
• Close out any action. Every confirmation card has an ✕ — dismiss it and it leaves the conversation without running (a still-pending card is cancelled). Works even while a card is mid-action, so nothing ever gets stuck on screen.
• 5 writes max per turn. Ask for more and the agent surfaces a confirmation card for the first five, then asks you to confirm those before continuing.
• eBay-touching tools reserve quota. The publish / end / relist flows check the shared eBay daily quota and refuse politely if it would overflow.
• Destructive ops always offer the archive alternative. Hard delete is one click away from soft archive in every preview card.

What's coming next

Phase C will land:

• Shipping — mark sales shipped + attach tracking numbers from chat.
• Action chaining — propose "create lot → publish lot" as a single approval card.
• Undo — flip a recent agent action back to its pre-mutation state (non-eBay actions only).
• Per-user preference learning — the agent picks up your usual lot discount, default listing duration, common player filters, and bakes them into suggested prompts and pre-filled defaults.
• Voice + photo input — talk to the agent on mobile, drop a card photo into chat for instant recognition + action chips.

Privacy & safety

Vault Agent runs on RocketVault's AI engine with your data scoped to your authenticated account. Three layers of protection:

1. Auth — every Vault request is JWT-authenticated like the rest of the app. No anonymous queries.
2. Database scoping — every tool that reads your inventory, pricing, or listings filters by your user_id at the SQL layer. Even if the model "tried" to ask for another user's data, the query would return nothing.
3. Approval-gated writes — no write tool runs without an explicit confirmation card that you approve. There is no path from a prompt injection straight to a database mutation.

Vault Agent does not train on your data. Conversations are stored in your account so you can re-read them later, and you can delete a session at any time from the chat history menu.

Cost & quotas

Each "query" counts as one full user-to-assistant round trip (you ask → Vault responds, even if it ran 5 tool calls under the hood). Counters surface as a budget chip in the chat header and reset on the 1st of each month.

If you hit your monthly cap, the input field disables until the next reset (or you upgrade your plan). Vault never silently fails or trims your question — you'll see a clear "quota exceeded" message with a link to upgrade.

Mobile parity

On mobile, the agent opens as the full-page /agent view (the Cmd-K side panel is desktop-only) — same features as desktop, no stripping:

• Suggested-prompt chips scroll horizontally
• Tool call cards collapse to a "1 tool call" pill that expands on tap
• The keyboard pushes the input above the safe area; the thread auto-scrolls on send
• Streaming respects iOS Low Power Mode (drops to non-streaming if prefers-reduced-motion is set)

Common questions

Can I ask Vault about cards I don't own yet? Not in this release. Vault Agent is scoped to your inventory, listings, and sales. For market and news research, your Daily Briefing carries that read every morning — grounded and cited. We may broaden the agent's scope in a future release.

Why doesn't Vault just take the action when I say "reprice these"? By design. Every write goes through a confirmation card so you see exactly what's about to change — prices, fees, diffs — before anything mutates. One click to approve; nothing happens without it.

What happens if I ask about another user's inventory? Vault literally can't see other accounts. Tool calls filter by your user_id at the database layer — the model has no path to other users' data even if it wanted one.

Does my plan's Vault Agent quota roll over? No, query budgets reset on the 1st of each month and do not roll over. On Pro and Enterprise, queries are unlimited (with a generous soft-cap for fair use).

Can I export my Vault chat history? Conversations are saved in your account and viewable in the chat history sidebar. CSV/JSON export of chat history is on the roadmap.