Struct StoredQuery 

pub struct StoredQuery {
    pub name: String,
    pub source: Arc<str>,
    pub decl: QueryDecl,
    pub expose: bool,
    pub tool_name: Option<String>,
}

One loaded stored query. source is the full .gq file text — the invocation handler hands it to run_query / run_mutate verbatim, which reuse the same parse/IR/exec path as the inline routes (no parallel implementation).

Fields

name: String

Identity: manifest key == query <name> symbol.

source: Arc<str>

Full .gq source text the query was selected from.

decl: QueryDecl

Parsed declaration (params, mutations, description, …).

expose: bool

Whether this query is listed in the MCP tool catalog (GET /queries). Default true (the manifest entry is the opt-in); expose: false keeps it HTTP/service-callable but hidden from the agent tool list. Catalog membership only — not an authorization gate.

tool_name: Option<String>

Optional MCP tool-name override; defaults to name.

Implementations

impl StoredQuery

pub fn is_mutation(&self) -> bool

true if the selected declaration contains insert/update/delete statements — drives read-vs-mutate routing at invocation time.

pub fn effective_tool_name(&self) -> &str

The MCP tool name this query is catalogued under: the explicit tool_name override, else the query name. The catalog key — enforced unique across exposed queries at load. Server-side consumers (the uniqueness check, the future catalog projection) read this; the CLI queries list resolves the same rule on its own DTO.

Trait Implementations

impl Clone for StoredQuery

fn clone(&self) -> StoredQuery

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StoredQuery

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.