When something goes wrong
StoryVault always shows errors directly in the interface, never silently in the background. If something goes wrong, you should see it immediately — and in most cases be able to act on it with a single click.
What error messages look like
Section titled “What error messages look like”Errors appear as toast messages in the bottom-right corner. A toast fades
out automatically after a few seconds, or you can dismiss it with the ×.
Three kinds of toasts
Section titled “Three kinds of toasts”- Success (green) — the action completed.
- Info (neutral) — something happened you should know about, no problem.
- Error (red) — the action failed.
”Try again”
Section titled “”Try again””Most errors include a Retry button in the toast. If the error was transient (brief network hiccup, service briefly busy), a second attempt usually succeeds right away.
What the messages mean
Section titled “What the messages mean”| Message | What it means | What you can do |
|---|---|---|
| ”Connection failed” | Your browser couldn’t reach the server. | Check your internet, then retry. |
| ”Not authorized” | Your user doesn’t have permission for this action. | Ask your admin to grant the role. |
| ”Session expired” | You were inactive too long and got logged out. | Sign in again — your data is safe. |
| ”Too many requests” | You hit a rate-limit on an API/AI feature. | Wait a minute, then retry. |
| ”Server error” | Something went wrong on our side. | Retry. If it persists: report via Contact — we get auto-notified. |
Confirmation dialogs
Section titled “Confirmation dialogs”Before StoryVault does anything irreversible — deleting sessions, removing attachments, unbinding sources — it always asks via a confirmation dialog. You have to actively click “Delete” or “Confirm”; an accidental click never deletes anything without asking.
Upload errors
Section titled “Upload errors”While uploading large files, things can go wrong en route — bad Wi-Fi, browser tab closed, etc. What you’ll see:
- “Upload failed” — the file didn’t make it. The session shows up as “cancelled” or doesn’t appear at all. Just upload again.
- Session shows “processing” — the file arrived; the server is still working on it. Updates automatically.
Attachments with many pages
Section titled “Attachments with many pages”Very long documents (PDFs, Word files) get truncated at around 50 pages for AI processing. Content beyond that doesn’t flow into AI Chat, the Knowledge Store, or the knowledge graph.
You see this hint as a small info note wherever you upload attachments or pick them as a source. The file itself stays fully available in original form — only AI processing is bounded.
What can I do?
Section titled “What can I do?”- Click “Try again” — the fastest path.
- Reload the page (
Cmd/Ctrl + R) — when the first try isn’t enough. - Clear browser cache — for stubborn display issues.
- Try incognito mode — rules out browser extensions.
- Try a different browser — rules out browser-specific issues.
- Report via Contact — describe what you did, what message you saw, and roughly the time. We can investigate the event more quickly precisely with that.