Vault Agent

Overview

Vault Agent is a conversational AI you can ask about your inventory, market data, and sales history. It's like having an analyst on your payroll who's already read every comp in your account.

Open Vault Agent from the Vault Agent entry in the left nav (desktop) or the Vault bottom-tab on mobile. You can also open it pre-loaded with a specific card from the Dashboard, Card Detail, and Needs Review pages — look for the Ask Vault button.

What you can ask

Vault Agent is grounded in your real RocketVault data. Every number it cites comes from a tool call against your inventory, market intelligence, or pricing data — it doesn't fabricate prices or comps.

Some examples to get started:

• "What's my best flip right now?"
• "Show my P&L this month."
• "Which cards need review?"
• "How much did I make last week on Mahomes cards?"
• "Which players in my inventory are trending up?"
• "What should I reprice this week?"
• "Run a grading ROI check on my 2023 Topps Chrome Mahomes."

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

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.

V1 limitations (read-only)

This is the first release of Vault Agent. We deliberately scoped it conservatively:

• Vault Agent can suggest actions (reprice, list, hold, end-and-relist) but won't take them in V1 — every action is yours to confirm.
• One active session per user at a time. Starting a new chat archives the previous one (your history is preserved).
• Vault is read-only on your inventory — no mutations to cards, listings, or settings.
• Your data is scoped to your account at the database layer. Vault literally cannot see another user's cards, lots, or sales — multi-tenancy is enforced below the model, not by prompt instructions.

What's coming in V2

The pipeline we're building toward:

• Write actions with confirmation — "Reprice these 47 cards down 8%" → agent shows you the diff → you approve before anything changes.
• Multi-session — keep a "what should I list today" thread alive while you start a separate "P&L by player" thread.
• Voice mode at shows — talk to Vault from your phone at a card show: "Add this card, parallel is Gold /50, asking $80, want net $65."
• Vision Q&A — snap a photo and ask Vault what it's looking at, what it's worth, and whether it's a grading candidate.

Privacy & safety

Vault Agent runs on Google Vertex AI (Gemini) 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. Read-only V1 — Vault has no write tools. There is no path from a prompt injection to a database mutation in V1.

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

Vault Agent is a full-screen experience on mobile under the Vault bottom-tab — 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

Does Vault Agent know about cards I haven't uploaded yet? No. Vault sees what's in your RocketVault account — your inventory, listings, sales, pricing data, and market intelligence for the cards you own. It does not browse external marketplaces on your behalf in V1.

Why doesn't Vault just take the action when I say "reprice these"? By design, in V1. We're shipping read-only first so you can validate the agent's judgement before it starts making changes. V2 will add write actions with explicit confirmations.

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.