Database governance built for humans and agents — controlling changes and access across every major database.
Page agent module
Follow ../../../AGENTS.md. This file adds rules for the in-product page agent under src/modules/agent/.
Ownership map
src/modules/agent/
├── components/ # React window, chat, input, tool cards, agent-owned overlays
├── dom/ # DOM snapshots and browser interaction primitives
├── logic/
│ ├── agentLoop.ts # Tool-call loop and retry behavior
│ ├── context.ts # Page and application context extraction
│ ├── prompt.ts # System prompt
│ ├── skills/ # On-demand workflow guides exposed by get_skill
│ └── tools/ # API, navigation, page-state, and DOM tool implementations
├── store/ # Zustand state for the agent window and conversation
├── index.tsx # Public module exports
└── window.ts # Window-level integration
Keep agent-only UI and state inside this module. Shared application primitives still come from @/components/ui, but agent overlays must use the wrappers in components/ui/ so they mount in the agent layer.
Tool behavior
search_apidiscovers endpoints and request/response shapes from the generated OpenAPI index.call_apiexecutes Bytebase API requests.navigateuses the React Router instance from@/app/routerand can list registered route patterns.get_page_statereturns semantic application context or a DOM snapshot.dom_actioninteracts with elements from the latest DOM snapshot.get_skillloads workflow guidance fromlogic/skills/.
DOM refs such as e1 are local to one get_page_state(mode="dom") snapshot. Refresh the snapshot after navigation or any DOM-changing action; never describe refs as durable identifiers.
OpenAPI index
Run:
pnpm --dir frontend run prepare
The generator reads backend/api/mcp/gen/openapi.yaml and writes logic/tools/gen/openapi-index.ts. Do not edit the generated file manually.
search_api(query="...") searches generated OpenAPI metadata and returns a
small ranked endpoint set. The generated index remains the endpoint source of
truth; do not duplicate a service catalogue in logic/prompt.ts.
Extending the agent
- Add a workflow guide in
logic/skills/and register it inlogic/skills/index.ts. - Add tool implementation and tests under
logic/tools/, then register it inlogic/tools/index.ts. - Keep API discovery in
searchApi.ts; update its semantic-search tests when changing generated endpoint metadata. - Use the Zustand store in
store/agent.ts; do not introduce a second state system. - Run focused Vitest for the touched agent subtree, then the standard frontend verification sequence.