mcp

type CatalogDescription struct {
	Kind            string `json:"kind"`
	Name            string `json:"name"`
	Description     string `json:"description,omitempty"`
	LongDescription string `json:"long_description,omitempty"`
	Module          string `json:"module,omitempty"`
	DataSource      string `json:"data_source,omitempty"`

	// Data object.
	Type            string              `json:"type,omitempty"        jsonschema_description:"TABLE or VIEW"`
	Queries         []DescribedQuery    `` /* 140-byte string literal not displayed */
	PrimaryKey      []string            `json:"primary_key,omitempty"`
	Properties      *ObjectProperties   `json:"properties,omitempty"`
	Args            []DescribedArg      `json:"args,omitempty"        jsonschema_description:"Parameterized-view arguments — pass them as the query's args:{...}"`
	Relations       []DescribedRelation `json:"relations,omitempty"`
	RelationsTotal  int                 `json:"relations_total,omitempty"`
	RelationsOffset int                 `json:"relations_offset,omitempty"`
	RelationsMore   bool                `json:"relations_has_more,omitempty" jsonschema_description:"Call again with a larger relations_offset for the rest"`
	FieldsCount     int                 `json:"fields_count,omitempty" jsonschema_description:"Call catalog-object_fields for the fields themselves"`
	DataSources     []string            `` /* 143-byte string literal not displayed */

	// Function.
	Returns string `json:"returns,omitempty"`
	IsTable *bool  `` /* 130-byte string literal not displayed */

	// Module.
	DataObjectsCount *int `json:"data_objects_count,omitempty"`
	FunctionsCount   *int `json:"functions_count,omitempty"`
	SubmodulesCount  *int `json:"submodules_count,omitempty"`

	// Data source. Pointers so that false is reported for a data source and the
	// field is absent for every other kind.
	Engine      string   `json:"engine,omitempty"`
	ReadOnly    *bool    `json:"read_only,omitempty"`
	AsModule    *bool    `json:"as_module,omitempty"`
	IsExtension *bool    `json:"is_extension,omitempty"`
	Modules     []string `json:"modules,omitempty"`
}

type CatalogItem struct {
	Kind string `json:"kind" jsonschema_description:"module | data_source | data_object | function"`
	Name string `` /* 143-byte string literal not displayed */
	// Type is TABLE|VIEW for a data object, FUNCTION|MUTATION|SUBSCRIPTION for
	// a callable, and the engine type string for a data source.
	Type        string `json:"type,omitempty"`
	Module      string `json:"module,omitempty"      jsonschema_description:"Owning module — REQUIRED to nest the GraphQL query"`
	DataSource  string `json:"data_source,omitempty"`
	Description string `json:"description,omitempty"`

	// Module only.
	DataObjects *int `json:"data_objects,omitempty" jsonschema_description:"Number of data objects directly in this module"`
	Functions   *int `json:"functions,omitempty"    jsonschema_description:"Number of callables directly in this module"`
	Submodules  *int `json:"submodules,omitempty"`

	// Data source only. Pointers so that false is reported for a data source
	// and the field is absent for every other kind.
	ReadOnly    *bool    `json:"read_only,omitempty"    jsonschema_description:"Mutations are not generated for this source"`
	AsModule    *bool    `json:"as_module,omitempty"`
	IsExtension *bool    `json:"is_extension,omitempty"`
	Modules     []string `json:"modules,omitempty"      jsonschema_description:"Modules this source places members in"`
}

type Config struct {
	Debug bool
	// QueryTTL is how long a viz query's result stays cached, so the view's
	// own fetch of the same rows is a cache read rather than a second
	// execution. Zero leaves caching off unless a tool call asks for it.
	QueryTTL time.Duration
}

type DescribeResult struct {
	Items    []CatalogDescription `json:"items"`
	NotFound []string             `` /* 150-byte string literal not displayed */
}

type DescribedArg struct {
	Name        string `json:"name"`
	Type        string `json:"type"`
	Description string `json:"description,omitempty"`
}

type DescribedQuery struct {
	Name         string         `json:"name"`
	Type         string         `` /* 205-byte string literal not displayed */
	RootTypeName string         `json:"root_type_name,omitempty"`
	Args         []DescribedArg `json:"args,omitempty"`
}

type DescribedRelation struct {
	Name       string `json:"name"`
	Direction  string `json:"direction"  jsonschema_description:"FORWARD (this object points out) or BACK (something points here)"`
	Kind       string `json:"kind"       jsonschema_description:"FK | M2M | JOIN"`
	FieldName  string `` /* 127-byte string literal not displayed */
	DataObject string `json:"data_object,omitempty" jsonschema_description:"The far data object"`
	Through    string `json:"through,omitempty"     jsonschema_description:"M2M junction object"`
}

type EnumValue struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Deprecated  bool   `json:"deprecated,omitempty"`
}

type FieldArgs struct {
	Field string         `json:"field"`
	Args  []DescribedArg `json:"args"`
}

type FieldArgsResult struct {
	TypeName string      `json:"type_name"`
	Items    []FieldArgs `json:"items"`
	NotFound []string    `json:"not_found,omitempty"`
}

type FieldValueBucket struct {
	Value any `json:"value"`
	Rows  int `json:"rows"`
}

type FieldValues struct {
	Object string             `json:"object"`
	Field  string             `json:"field"`
	Values []FieldValueBucket `json:"values,omitempty"`
	Stats  map[string]any     `json:"stats,omitempty" jsonschema_description:"min/max/avg where the field's type allows, plus the distinct count"`
}

type ObjectProperties struct {
	IsCube       bool `json:"is_cube,omitempty"`
	IsM2M        bool `json:"is_m2m,omitempty"`
	IsHypertable bool `json:"is_hypertable,omitempty"`
	SoftDelete   bool `json:"soft_delete,omitempty"`
	HasVectors   bool `` /* 128-byte string literal not displayed */
}

type Page[T any] struct {
	Items   []T  `json:"items"`
	Total   int  `json:"total"    jsonschema_description:"Total matching items after permission filtering"`
	Limit   int  `json:"limit"`
	Offset  int  `json:"offset"`
	HasMore bool `json:"has_more" jsonschema_description:"More items exist past this page"`
	// Truncated marks a module tree deeper than the walk reaches: re-run with
	// `module` set to a deeper node to enumerate the rest.
	Truncated bool `json:"truncated,omitempty"`
}

type ReportEnvelope struct {
	Spec *reports.Spec       `json:"spec"`
	Data *reports.ReportData `json:"data"`
}

type SearchHit struct {
	Kind        string  `json:"kind"        jsonschema_description:"module | data_source | data_object | function | field"`
	Name        string  `json:"name"`
	Module      string  `json:"module,omitempty"      jsonschema_description:"Owning module — REQUIRED to nest the GraphQL query"`
	DataSource  string  `json:"data_source,omitempty"`
	Description string  `json:"description,omitempty"`
	Score       float64 `json:"score"       jsonschema_description:"0-1, higher is better. Lexical fallback scores are coarse"`

	// Field hits only.
	Object    string `json:"object,omitempty"     jsonschema_description:"The data object this field belongs to"`
	FieldKind string `json:"field_kind,omitempty" jsonschema_description:"column | relation | extra"`
	HugrType  string `json:"hugr_type,omitempty"  jsonschema_description:"The field's GraphQL type"`
	RefObject string `` /* 152-byte string literal not displayed */

	// NextCall names the rung that turns this hit into something callable.
	NextCall string `json:"next_call,omitempty"`
}

type SearchResultPage struct {
	Items    []SearchHit `json:"items"`
	Limit    int         `json:"limit"`
	Offset   int         `json:"offset"`
	HasMore  bool        `json:"has_more"`
	Filtered int         `json:"filtered_out,omitempty" jsonschema_description:"Candidates dropped because the caller may not see them"`
	Lexical  bool        `` /* 165-byte string literal not displayed */
	// LexicalReason says WHY the vector index was unusable. A silent fallback
	// is indistinguishable from a broken ranking query, and would stay broken
	// unnoticed; this makes the difference observable to operators and tests.
	LexicalReason string `json:"lexical_reason,omitempty"`
}

type Server struct {
	// contains filtered or unexported fields
}

type TypeDescription struct {
	Name        string `json:"name"`
	Kind        string `json:"kind"        jsonschema_description:"OBJECT | INPUT_OBJECT | ENUM | SCALAR | INTERFACE | UNION | LIST | NON_NULL"`
	Description string `json:"description,omitempty"`

	// Member counts — call schema-type_fields / schema-enum_values for the
	// members themselves.
	FieldsCount      int `json:"fields_count,omitempty"`
	InputFieldsCount int `json:"input_fields_count,omitempty"`
	EnumValuesCount  int `json:"enum_values_count,omitempty"`

	// Role in the logical model, when it has one.
	LogicalKind string `json:"logical_kind,omitempty" jsonschema_description:"Set when this type IS a logical entity: data_object, or module_root"`
	Module      string `json:"module,omitempty"`
	DerivedFrom string `` /* 170-byte string literal not displayed */
	Role        string `` /* 199-byte string literal not displayed */

	NextCall string `json:"next_call,omitempty" jsonschema_description:"The tool that owns this name"`
}

type TypeDescriptions struct {
	Items    []TypeDescription `json:"items"`
	NotFound []string          `json:"not_found,omitempty" jsonschema_description:"Names that do not exist OR that the caller may not see"`
}

type TypeField struct {
	Name        string `json:"name"`
	Type        string `json:"type"        jsonschema_description:"GraphQL type, SDL spelling"`
	ArgsCount   int    `` /* 133-byte string literal not displayed */
	Description string `json:"description,omitempty"`

	// Data-object fields only.
	FieldKind string `json:"field_kind,omitempty" jsonschema_description:"column | relation | extra"`
	RefObject string `` /* 141-byte string literal not displayed */
	IsPK      bool   `json:"is_pk,omitempty"`
}

type VizChartSpec = viz.ChartSpec

type VizColumnSpec = viz.ColumnSpec

type VizDataResult struct {
	Rows      []map[string]any `json:"rows"`
	RowCount  int              `json:"row_count"`
	Truncated bool             `json:"truncated"`
}

type VizEnvelope struct {
	Kind      string           `json:"kind" jsonschema_description:"chart | table | kpi"`
	Title     string           `json:"title"`
	Chart     *VizChartSpec    `json:"chart,omitempty"`
	Columns   []VizColumnSpec  `json:"columns,omitempty"`
	Kpis      []VizKPI         `json:"kpis,omitempty" jsonschema_description:"The KPI cards (kind=kpi); always complete — a panel is never sampled"`
	Filters   []VizFilterSpec  `` /* 130-byte string literal not displayed */
	Source    *VizSource       `json:"source,omitempty"`
	Rows      []map[string]any `json:"rows" jsonschema_description:"Canonical flat rows the view renders"`
	RowCount  int              `json:"row_count"`
	Truncated bool             `json:"truncated" jsonschema_description:"true when the hard cap cut the result"`
	AtLimit   bool             `` /* 158-byte string literal not displayed */
	// Both only ever set on the copy the caller receives.
	RowsSampled bool `json:"rows_sampled,omitempty" jsonschema_description:"rows here is a sample of the first few; row_count is the real length"`
	Fetch       bool `` /* 211-byte string literal not displayed */
}

type VizFilterSpec struct {
	Name    string `json:"name" jsonschema_description:"Identifier of the control, unique within the view"`
	Label   string `json:"label,omitempty"`
	Control string `` /* 197-byte string literal not displayed */
	Field   string `json:"field,omitempty" jsonschema_description:"Row field the control matches against (default: name)"`
	Default any    `json:"default,omitempty" jsonschema_description:"Initial value when the user has not touched the control"`
	Value   any    `json:"value,omitempty" jsonschema_description:"Pre-applied value set from the conversation; applied to the first render too"`
}

type VizKPI = viz.KPI

type VizSource struct {
	Type        string         `json:"type" jsonschema_description:"query | inline"`
	Query       string         `json:"query,omitempty"`
	Variables   map[string]any `json:"variables,omitempty" jsonschema_description:"Original variables, passed back unchanged when the view fetches its rows"`
	JQTransform string         `json:"jq_transform,omitempty"`
}