Skip to content

feat: SQLite state database explorer#98

Merged
cristipufu merged 1 commit intomainfrom
feat/statedb-explorer
Mar 3, 2026
Merged

feat: SQLite state database explorer#98
cristipufu merged 1 commit intomainfrom
feat/statedb-explorer

Conversation

@cristipufu
Copy link
Member

Summary

  • Adds a lightweight SQLite explorer in the Explorer section for inspecting __uipath/state.db
  • Backend: 4 API endpoints (status, tables, table data, custom query) with read-only access and generic blob decoding (JSON, msgpack, zlib variants, UTF-8, base64 fallback)
  • Frontend: collapsible "State Database" sidebar section with refresh, table list view, data viewer with expandable JSON for BLOBs, SQL query bar, and pagination
  • Both sidebar sections (State Database, Files) are now collapsible for consistency

Test plan

  • Create a __uipath/state.db with sample tables (or use a LangGraph agent that persists state)
  • Start dev server, verify "State Database" section appears in explorer sidebar
  • Click a table — verify data grid renders with column headers and types
  • Expand a BLOB cell — verify decoded JSON is readable
  • Run a custom SQL query via the query bar (Ctrl+Enter)
  • Verify pagination loads more rows
  • Verify refresh button re-fetches table list
  • Verify "Files" section is collapsible

🤖 Generated with Claude Code

This comment was marked as outdated.

@cristipufu cristipufu force-pushed the feat/statedb-explorer branch 2 times, most recently from 5395daf to 5b4cde8 Compare March 3, 2026 18:14
Add a lightweight SQLite explorer integrated into the Explorer section
for inspecting agent runtime state persisted in __uipath/state.db.

Backend:
- New statedb routes: status, tables, table data (paginated), custom query
- Read-only connections, SELECT-only query validation
- Generic blob decoder: tries JSON, msgpack, zlib+JSON, zlib+msgpack,
  UTF-8, base64 fallback — recursively sanitizes nested structures
- Add aiosqlite dependency, optional msgpack support

Frontend:
- Collapsible "State Database" section in explorer sidebar with refresh
- Collapsible "Files" section for consistency
- Table list view and data viewer with sticky headers
- Expandable JSON rendering for decoded BLOB columns
- SQL query bar with Ctrl+Enter shortcut
- Pagination support
- Hash routes: #/explorer/statedb and #/explorer/statedb/{tableName}

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@cristipufu cristipufu force-pushed the feat/statedb-explorer branch from 5b4cde8 to 189a169 Compare March 3, 2026 18:21
@cristipufu cristipufu merged commit 5d3ff59 into main Mar 3, 2026
11 checks passed
@cristipufu cristipufu deleted the feat/statedb-explorer branch March 3, 2026 18:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants