Database

Configure the React Native native database tools to discover SQLite databases, inspect schema, and run read-only queries.

Register the Suite

await Ansight.initializeAndActivate(
  Ansight.createOptionsBuilder()
    .withDatabaseTools({
      includePlatformRoots: true,
      additionalRoots: [{ alias: "fixtures", path: "/tmp/app-db" }],
    })
    .withReadOnlyToolAccess()
    .build(),
);

Registration API

  • withDatabaseTools(options): configures native database tool options.
  • remoteTools.database.additionalRoots: exposes additional approved roots.
  • remoteTools.database.includePlatformRoots: controls whether standard app roots are searched.

Specific Concerns

  • The suite is SQLite-focused.
  • Query execution is read-only.
  • Schema and query results can expose sensitive user or app data.
  • Root paths are interpreted by the native platform.

Tool Matrix

NameIdScopeDescriptionSecurity
List Databasesdata.list_databasesReadLists inspectable SQLite databases.Moderate
Describe Schemadata.describe_schemaReadReturns schema metadata.Moderate
Query Databasedata.queryReadExecutes a constrained read query.High

Tool Details

Use data.list_databases to discover SQLite files, data.describe_schema to inspect tables, and data.query for constrained read-only SQL.