semantic_query

┌ ┐

└ ┘

│

┌ ┐

[semantic]

Runs compact read-only semantic query patterns for package imports, cross-project API usage, and symbols with references.

Why this tool exists

Package importer, API surface, and symbols-with-references questions are expensive to assemble manually.

How it helps the agent

The model gets compact, workflow-shaped evidence without repeated symbol searches and file reads.

Try it locally in the TGlider playground

Parameters

Name	Type	Required	Description
pattern	string	Yes	Query pattern: 'package_importers', 'project_exports_referenced_by_project', or 'symbols_with_references'.
packageName	string	No	Package name for package importer queries.
projectName	string	No	Optional loaded project name to scope the query.
referencedByProjectName	string	No	Project that references another project API.
text	string	No	Optional symbol name text filter.
kind	string	No	Optional TypeScript symbol kind filter.
exportedOnly	boolean	No	Return only exported symbols where the pattern supports it.
surface	string	No	API surface for project export queries: 'entrypoints' or 'allExports'.
exportKind	string	No	Filter exports by 'all', 'value', or 'type'.
includeTypeOnly	boolean	No	Include type-only imports and references where the pattern supports it.
includeReExports	boolean	No	Include re-export relationships where the pattern supports it.
matchSubpaths	boolean	No	Match package subpath imports for package importer queries.
maxReferencesPerSymbol	number	No	Maximum references to include for each symbol result.
candidateLimit	number	No	Maximum candidate symbols to inspect before returning matches.
skip	number	No	Number of matching results to skip.
take	number	No	Maximum number of matching results to return.

Examples

Find files importing a package

Request 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "semantic_query",
    "arguments": {
      "pattern": "package_importers",
      "packageName": "react"
    }
  }
}

Response Notes

Returns query-specific compact semantic evidence and next-tool hints.

└ ┘