{ "schemaVersion": 1, "tools": [ { "name": "catalog_get", "description": "Get the compact definition and type-specific metadata for one exact catalog ref. A dashboard/page location is required when a visual or filter is shared.", "privilege": "VIEW_ITEM", "effect": "read", "operationId": "manual", "defaults": {}, "tags": [ "catalog", "describe" ], "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }, "inputSchema": { "additionalProperties": false, "properties": { "location": { "additionalProperties": false, "properties": { "dashboardId": { "minLength": 1, "type": "string" }, "pageId": { "minLength": 1, "type": "string" } }, "required": [ "dashboardId", "pageId" ], "type": "object" }, "ref": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" } }, "required": [ "ref" ], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "details": { "oneOf": [ { "additionalProperties": false, "allOf": [ { "properties": { "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } ], "properties": { "activeServingStateId": { "type": "string" }, "type": { "enum": [ "workspace" ], "type": "string" } }, "required": [ "activeServingStateId", "type" ], "type": "object" }, { "additionalProperties": false, "allOf": [ { "properties": { "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } ], "properties": { "filterCount": { "type": "integer" }, "pageCount": { "type": "integer" }, "semanticModelRef": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "type": { "enum": [ "dashboard" ], "type": "string" }, "visualCount": { "type": "integer" } }, "required": [ "filterCount", "pageCount", "semanticModelRef", "type", "visualCount" ], "type": "object" }, { "additionalProperties": false, "allOf": [ { "properties": { "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } ], "properties": { "components": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "filterId": { "type": "string" }, "height": { "type": "number" }, "id": { "type": "string" }, "kind": { "type": "string" }, "placement": { "additionalProperties": false, "properties": { "col": { "type": "integer" }, "colSpan": { "type": "integer" }, "height": { "type": "number" }, "row": { "type": "integer" }, "rowSpan": { "type": "integer" }, "width": { "type": "number" }, "x": { "type": "number" }, "y": { "type": "number" } }, "type": "object" }, "ref": { "type": "string" }, "title": { "type": "string" }, "visualId": { "type": "string" }, "width": { "type": "number" }, "x": { "type": "number" }, "y": { "type": "number" } }, "required": [ "id", "kind" ], "type": "object" }, "type": "array" }, "type": { "enum": [ "page" ], "type": "string" } }, "required": [ "components", "type" ], "type": "object" }, { "additionalProperties": false, "allOf": [ { "properties": { "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } ], "properties": { "columns": { "items": { "additionalProperties": false, "properties": { "format": { "type": "string" }, "key": { "type": "string" }, "label": { "type": "string" }, "role": { "type": "string" } }, "required": [ "key", "label" ], "type": "object" }, "type": "array" }, "placement": { "additionalProperties": false, "properties": { "col": { "type": "integer" }, "colSpan": { "type": "integer" }, "height": { "type": "number" }, "row": { "type": "integer" }, "rowSpan": { "type": "integer" }, "width": { "type": "number" }, "x": { "type": "number" }, "y": { "type": "number" } }, "type": "object" }, "query": { "additionalProperties": {}, "type": "object" }, "renderer": { "type": "string" }, "shape": { "type": "string" }, "type": { "enum": [ "visual" ], "type": "string" }, "visualType": { "type": "string" } }, "required": [ "columns", "placement", "query", "renderer", "shape", "type", "visualType" ], "type": "object" }, { "additionalProperties": false, "allOf": [ { "properties": { "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } ], "properties": { "configuration": { "additionalProperties": {}, "type": "object" }, "field": { "type": "string" }, "placement": { "additionalProperties": false, "properties": { "col": { "type": "integer" }, "colSpan": { "type": "integer" }, "height": { "type": "number" }, "row": { "type": "integer" }, "rowSpan": { "type": "integer" }, "width": { "type": "number" }, "x": { "type": "number" }, "y": { "type": "number" } }, "type": "object" }, "type": { "enum": [ "filter" ], "type": "string" } }, "required": [ "configuration", "field", "placement", "type" ], "type": "object" }, { "additionalProperties": false, "allOf": [ { "properties": { "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } ], "properties": { "atomicMeasureCount": { "type": "integer" }, "conformedDimensionCount": { "type": "integer" }, "dashboardCount": { "type": "integer" }, "dashboardUsage": { "items": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "type": "array" }, "factCount": { "type": "integer" }, "fieldCount": { "type": "integer" }, "metricCount": { "type": "integer" }, "relationshipCount": { "type": "integer" }, "relationships": { "items": { "additionalProperties": false, "properties": { "active": { "type": "boolean" }, "cardinality": { "type": "string" }, "description": { "type": "string" }, "fromFieldRef": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "id": { "type": "string" }, "toFieldRef": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" } }, "required": [ "active", "cardinality", "description", "fromFieldRef", "id", "toFieldRef" ], "type": "object" }, "type": "array" }, "semanticTableCount": { "type": "integer" }, "type": { "enum": [ "semantic_model" ], "type": "string" } }, "required": [ "atomicMeasureCount", "conformedDimensionCount", "dashboardCount", "dashboardUsage", "factCount", "fieldCount", "metricCount", "relationshipCount", "relationships", "semanticTableCount", "type" ], "type": "object" }, { "additionalProperties": false, "allOf": [ { "properties": { "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } ], "properties": { "fieldCount": { "type": "integer" }, "grain": { "type": "string" }, "keys": { "items": { "type": "string" }, "type": "array" }, "measureCount": { "type": "integer" }, "primaryKey": { "type": "string" }, "roles": { "items": { "enum": [ "fact", "dimension" ], "type": "string" }, "type": "array" }, "source": { "type": "string" }, "sources": { "items": { "type": "string" }, "type": "array" }, "type": { "enum": [ "semantic_table" ], "type": "string" } }, "required": [ "fieldCount", "grain", "keys", "measureCount", "primaryKey", "roles", "source", "sources", "type" ], "type": "object" }, { "additionalProperties": false, "allOf": [ { "properties": { "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } ], "properties": { "bindings": { "items": { "additionalProperties": false, "properties": { "fieldRef": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "relationshipPath": { "items": { "type": "string" }, "type": "array" }, "semanticTableRef": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" } }, "required": [ "fieldRef", "relationshipPath", "semanticTableRef" ], "type": "object" }, "type": "array" }, "dataType": { "type": "string" }, "expression": { "type": "string" }, "grain": { "type": "string" }, "kind": { "type": "string" }, "label": { "type": "string" }, "nullable": { "type": "boolean" }, "primaryKey": { "type": "boolean" }, "sourceField": { "type": "string" }, "table": { "type": "string" }, "timeGrains": { "items": { "type": "string" }, "type": "array" }, "type": { "enum": [ "field" ], "type": "string" } }, "required": [ "dataType", "kind", "label", "type" ], "type": "object" }, { "additionalProperties": false, "allOf": [ { "properties": { "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } ], "properties": { "aggregation": { "type": "string" }, "dependencyRefs": { "items": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "type": "array" }, "empty": { "type": "string" }, "expression": { "type": "string" }, "factRef": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "filters": { "items": { "additionalProperties": false, "properties": { "fieldRef": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "operator": { "type": "string" }, "values": { "items": {}, "type": "array" } }, "required": [ "fieldRef", "operator", "values" ], "type": "object" }, "type": "array" }, "format": { "type": "string" }, "hidden": { "type": "boolean" }, "input": { "additionalProperties": false, "properties": { "expression": { "type": "string" }, "fieldRef": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" } }, "type": "object" }, "kind": { "type": "string" }, "label": { "type": "string" }, "table": { "type": "string" }, "type": { "enum": [ "measure" ], "type": "string" }, "unit": { "type": "string" } }, "required": [ "dependencyRefs", "format", "hidden", "kind", "label", "type", "unit" ], "type": "object" } ] }, "item": { "additionalProperties": false, "properties": { "capabilities": { "items": { "enum": [ "catalog_get", "catalog_list", "query_semantic_model", "query_dashboard_visual", "query_visual" ], "type": "string" }, "type": "array" }, "description": { "type": "string" }, "hierarchy": { "items": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "ref": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" } }, "required": [ "name", "ref" ], "type": "object" }, "type": "array" }, "href": { "type": "string" }, "locations": { "items": { "additionalProperties": false, "properties": { "dashboardId": { "minLength": 1, "type": "string" }, "dashboardName": { "type": "string" }, "href": { "type": "string" }, "pageId": { "minLength": 1, "type": "string" }, "pageName": { "type": "string" } }, "required": [ "dashboardId", "pageId" ], "type": "object" }, "type": "array" }, "name": { "type": "string" }, "ref": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "workspace": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "ref": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" } }, "required": [ "name", "ref" ], "type": "object" } }, "required": [ "capabilities", "hierarchy", "name", "ref", "workspace" ], "type": "object" } }, "required": [ "details", "item" ], "type": "object" } }, { "name": "catalog_list", "description": "Browse one deterministic level of the authorized LeapView catalog hierarchy. Omit parent to list workspaces, then pass returned refs to continue browsing.", "privilege": "VIEW_ITEM", "effect": "read", "operationId": "manual", "defaults": { "limit": 25 }, "tags": [ "catalog", "browse" ], "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }, "inputSchema": { "additionalProperties": false, "properties": { "childTypes": { "items": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "type": "array" }, "cursor": { "type": "string" }, "limit": { "maximum": 50, "minimum": 1, "type": "integer" }, "parent": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" } }, "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "count": { "minimum": 0, "type": "integer" }, "hasMore": { "type": "boolean" }, "items": { "items": { "additionalProperties": false, "properties": { "capabilities": { "items": { "enum": [ "catalog_get", "catalog_list", "query_semantic_model", "query_dashboard_visual", "query_visual" ], "type": "string" }, "type": "array" }, "description": { "type": "string" }, "hierarchy": { "items": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "ref": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" } }, "required": [ "name", "ref" ], "type": "object" }, "type": "array" }, "href": { "type": "string" }, "locations": { "items": { "additionalProperties": false, "properties": { "dashboardId": { "minLength": 1, "type": "string" }, "dashboardName": { "type": "string" }, "href": { "type": "string" }, "pageId": { "minLength": 1, "type": "string" }, "pageName": { "type": "string" } }, "required": [ "dashboardId", "pageId" ], "type": "object" }, "type": "array" }, "name": { "type": "string" }, "ref": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "workspace": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "ref": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" } }, "required": [ "name", "ref" ], "type": "object" } }, "required": [ "capabilities", "hierarchy", "name", "ref", "workspace" ], "type": "object" }, "type": "array" }, "nextCursor": { "type": "string" } }, "required": [ "count", "hasMore", "items" ], "type": "object" } }, { "name": "catalog_search", "description": "Search the complete authorized LeapView BI catalog across workspaces. Use this when you know words from a resource name or description but not its exact location.", "privilege": "VIEW_ITEM", "effect": "read", "operationId": "manual", "defaults": { "limit": 10 }, "tags": [ "catalog", "search" ], "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }, "inputSchema": { "additionalProperties": false, "properties": { "context": { "additionalProperties": false, "properties": { "dashboardId": { "type": "string" }, "pageId": { "type": "string" } }, "type": "object" }, "cursor": { "type": "string" }, "limit": { "maximum": 25, "minimum": 1, "type": "integer" }, "query": { "minLength": 1, "type": "string" }, "types": { "items": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "type": "array" }, "workspaceIds": { "items": { "type": "string" }, "type": "array" } }, "required": [ "query" ], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "count": { "minimum": 0, "type": "integer" }, "hasMore": { "type": "boolean" }, "items": { "items": { "additionalProperties": false, "properties": { "capabilities": { "items": { "enum": [ "catalog_get", "catalog_list", "query_semantic_model", "query_dashboard_visual", "query_visual" ], "type": "string" }, "type": "array" }, "description": { "type": "string" }, "hierarchy": { "items": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "ref": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" } }, "required": [ "name", "ref" ], "type": "object" }, "type": "array" }, "href": { "type": "string" }, "locations": { "items": { "additionalProperties": false, "properties": { "dashboardId": { "minLength": 1, "type": "string" }, "dashboardName": { "type": "string" }, "href": { "type": "string" }, "pageId": { "minLength": 1, "type": "string" }, "pageName": { "type": "string" } }, "required": [ "dashboardId", "pageId" ], "type": "object" }, "type": "array" }, "name": { "type": "string" }, "ref": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "workspace": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "ref": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" } }, "required": [ "name", "ref" ], "type": "object" } }, "required": [ "capabilities", "hierarchy", "name", "ref", "workspace" ], "type": "object" }, "type": "array" }, "nextCursor": { "type": "string" } }, "required": [ "count", "hasMore", "items" ], "type": "object" } }, { "name": "docs_read", "description": "Read a bounded line window from one LeapView document returned by docs_search. Continue with nextOffset when truncated is true.", "privilege": "USE_AGENT", "effect": "read", "operationId": "manual", "defaults": { "limit": 200, "offset": 1 }, "tags": [ "documentation" ], "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }, "inputSchema": { "additionalProperties": false, "properties": { "id": { "description": "Stable doc:\u003cpath\u003e ID returned by docs_search.", "minLength": 1, "type": "string" }, "limit": { "description": "Maximum lines to read; defaults to 200 and is also byte-bounded.", "maximum": 500, "minimum": 1, "type": "integer" }, "offset": { "description": "First line to read, starting at 1; defaults to 1.", "minimum": 1, "type": "integer" } }, "required": [ "id" ], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "content": { "type": "string" }, "id": { "type": "string" }, "lineEnd": { "type": "integer" }, "lineStart": { "type": "integer" }, "nextOffset": { "type": "integer" }, "path": { "type": "string" }, "title": { "type": "string" }, "totalLines": { "type": "integer" }, "truncated": { "type": "boolean" }, "url": { "type": "string" } }, "required": [ "content", "id", "lineEnd", "lineStart", "path", "title", "totalLines", "truncated", "url" ], "type": "object" } }, { "name": "docs_search", "description": "Search LeapView's version-matched product documentation. Returns ranked, bounded matches with stable document IDs and excerpts. Continue with nextCursor when hasMore is true, or use the optional path prefix to narrow broad searches.", "privilege": "USE_AGENT", "effect": "read", "operationId": "manual", "defaults": { "limit": 8 }, "tags": [ "documentation", "search" ], "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }, "inputSchema": { "additionalProperties": false, "properties": { "cursor": { "description": "Opaque nextCursor from a previous call with the same query and path.", "minLength": 1, "type": "string" }, "limit": { "description": "Maximum matches to return; defaults to 8.", "maximum": 25, "minimum": 1, "type": "integer" }, "path": { "description": "Optional documentation path prefix, such as guides/build, api, cli, or visuals.", "type": "string" }, "query": { "description": "Words or phrases to find in LeapView documentation.", "minLength": 1, "type": "string" } }, "required": [ "query" ], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "count": { "minimum": 0, "type": "integer" }, "hasMore": { "type": "boolean" }, "matches": { "items": { "additionalProperties": false, "properties": { "excerpt": { "type": "string" }, "id": { "type": "string" }, "path": { "type": "string" }, "summary": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" } }, "required": [ "excerpt", "id", "path", "summary", "title", "url" ], "type": "object" }, "type": "array" }, "nextCursor": { "type": "string" }, "path": { "type": "string" }, "query": { "type": "string" } }, "required": [ "count", "hasMore", "matches", "query" ], "type": "object" } }, { "name": "query_dashboard_visual", "description": "Query an existing dashboard visual with governed filters and compact analytical output", "privilege": "QUERY_DATA", "effect": "read", "operationId": "queryDashboardVisualData", "defaults": { "limit": 50 }, "tags": [ "dashboard", "visual", "query" ], "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }, "inputSchema": { "additionalProperties": false, "properties": { "dashboard": { "type": "string" }, "limit": { "maximum": 50, "minimum": 1, "type": "integer" }, "page": { "type": "string" }, "pageToken": { "maxLength": 2048, "minLength": 1, "type": "string" }, "visual": { "type": "string" }, "workspace": { "description": "Workspace ID to query.", "minLength": 1, "type": "string" } }, "required": [ "dashboard", "page", "visual", "workspace" ], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "appliedFilters": { "additionalProperties": false, "properties": { "controls": { "additionalProperties": { "additionalProperties": false, "properties": { "from": { "type": "string" }, "operator": { "type": "string" }, "preset": { "type": "string" }, "to": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" }, "values": { "items": { "type": "string" }, "type": "array" } }, "required": [ "type" ], "type": "object" }, "type": "object" }, "selections": { "items": { "additionalProperties": {}, "type": "object" }, "type": "array" }, "spatialSelections": { "items": { "additionalProperties": {}, "type": "object" }, "type": "array" } }, "required": [ "controls", "selections", "spatialSelections" ], "type": "object" }, "columns": { "items": { "additionalProperties": false, "properties": { "dataType": { "enum": [ "string", "boolean", "integer", "decimal", "temporal", "date", "geographic" ], "type": "string" }, "format": { "additionalProperties": {}, "type": "object" }, "grain": { "type": "string" }, "id": { "type": "string" }, "label": { "type": "string" }, "nullable": { "type": "boolean" }, "role": { "enum": [ "dimension", "measure", "metadata", "identity" ], "type": "string" }, "sourceRef": { "type": "string" } }, "required": [ "dataType", "id", "label", "nullable", "role" ], "type": "object" }, "type": "array" }, "completeness": { "additionalProperties": false, "properties": { "availableRows": { "type": "integer" }, "cardinality": { "enum": [ "unknown", "lower_bound", "estimated", "exact" ], "type": "string" }, "cardinalityCount": { "type": "integer" }, "returnedRows": { "type": "integer" }, "state": { "enum": [ "complete", "truncated", "partial", "empty" ], "type": "string" } }, "required": [ "cardinality", "returnedRows", "state" ], "type": "object" }, "datasetId": { "type": "string" }, "diagnostics": { "items": { "additionalProperties": false, "properties": { "code": { "type": "string" }, "fieldId": { "type": "string" }, "message": { "type": "string" }, "severity": { "enum": [ "info", "warning", "error" ], "type": "string" } }, "required": [ "code", "message", "severity" ], "type": "object" }, "type": "array" }, "freshness": { "additionalProperties": false, "properties": { "lastSuccessfulRefreshAt": { "description": "Completion time of the last successful publish or refresh. This is not an upstream event-time watermark.", "type": "string" }, "servingStateId": { "description": "Serving state that produced the successful data version.", "type": "string" }, "snapshotId": { "description": "DuckLake snapshot ID recorded for the successful data version.", "type": "string" }, "source": { "description": "Whether the data version came from publish or refresh.", "enum": [ "publish", "refresh" ], "type": "string" }, "status": { "description": "current when the successful data version belongs to the queried serving snapshot; stale otherwise.", "enum": [ "current", "stale" ], "type": "string" } }, "required": [ "lastSuccessfulRefreshAt", "servingStateId", "snapshotId", "source", "status" ], "type": "object" }, "hasMore": { "type": "boolean" }, "mark": { "type": "string" }, "nextCursor": { "type": "string" }, "queryId": { "type": "string" }, "rows": { "items": { "items": {}, "type": "array" }, "type": "array" }, "servingSnapshot": { "type": "string" }, "status": { "additionalProperties": false, "properties": { "kind": { "enum": [ "idle", "loading", "ready", "no_data", "partial", "error" ], "type": "string" }, "message": { "type": "string" } }, "required": [ "kind" ], "type": "object" }, "title": { "type": "string" }, "type": { "type": "string" }, "visualId": { "type": "string" } }, "required": [ "appliedFilters", "columns", "completeness", "datasetId", "diagnostics", "hasMore", "queryId", "rows", "servingSnapshot", "status", "title", "type", "visualId" ], "type": "object" } }, { "name": "query_semantic_model", "description": "Query governed semantic data with typed columns, filters, pagination, and provenance", "privilege": "QUERY_DATA", "effect": "read", "operationId": "querySemanticModel", "defaults": { "limit": 25 }, "tags": [ "semantic-model", "query" ], "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }, "inputSchema": { "additionalProperties": false, "properties": { "dimensions": { "items": { "additionalProperties": false, "properties": { "alias": { "description": "Optional output column name.", "type": "string" }, "field": { "description": "Semantic field or measure ID. Use the ID returned by catalog_list or catalog_get.", "type": "string" } }, "required": [ "field" ], "type": "object" }, "type": "array" }, "filters": { "items": { "additionalProperties": false, "properties": { "fact": { "description": "Fact table used to resolve a conformed dimension when it is otherwise ambiguous.", "type": "string" }, "field": { "description": "Semantic field ID. Omit only when groups supplies nested filters.", "type": "string" }, "groups": { "description": "Nested filter groups.", "items": { "additionalProperties": false, "properties": { "filters": { "description": "Filters combined within this nested group.", "items": { "type": "object" }, "type": "array" } }, "required": [ "filters" ], "type": "object" }, "type": "array" }, "operator": { "description": "Governed comparison operator. equals is used when omitted.", "enum": [ "equals", "in", "contains", "not_contains", "starts_with", "greater_than_or_equal", "less_than", "is_null", "is_not_null" ], "type": "string" }, "values": { "description": "Comparison values. is_null and is_not_null accept no values.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "type": "array" }, "limit": { "maximum": 50, "minimum": 1, "type": "integer" }, "measures": { "items": { "additionalProperties": false, "properties": { "alias": { "description": "Optional output column name.", "type": "string" }, "field": { "description": "Semantic field or measure ID. Use the ID returned by catalog_list or catalog_get.", "type": "string" } }, "required": [ "field" ], "type": "object" }, "type": "array" }, "model": { "type": "string" }, "pageToken": { "maxLength": 2048, "minLength": 1, "type": "string" }, "sort": { "items": { "additionalProperties": false, "properties": { "direction": { "description": "Sort direction. Defaults to ascending when omitted.", "enum": [ "asc", "desc" ], "type": "string" }, "field": { "description": "Selected output field or alias to sort.", "type": "string" } }, "required": [ "field" ], "type": "object" }, "type": "array" }, "time": { "additionalProperties": false, "properties": { "alias": { "description": "Optional output column name.", "type": "string" }, "field": { "description": "Date or timestamp field ID.", "type": "string" }, "grain": { "description": "Calendar grain used to group the time field.", "enum": [ "day", "week", "month", "quarter", "year" ], "type": "string" } }, "required": [ "field" ], "type": "object" }, "workspace": { "description": "Workspace ID to query.", "minLength": 1, "type": "string" } }, "required": [ "model", "workspace" ], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "columns": { "items": { "additionalProperties": false, "properties": { "dataType": { "enum": [ "boolean", "int64", "decimal", "float64", "string", "date", "timestamp", "json" ], "type": "string" }, "fieldRef": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "format": { "type": "string" }, "kind": { "type": "string" }, "label": { "type": "string" }, "name": { "type": "string" }, "nullable": { "type": "boolean" }, "unit": { "type": "string" } }, "required": [ "dataType", "name", "nullable" ], "type": "object" }, "type": "array" }, "completeness": { "additionalProperties": false, "properties": { "hasMore": { "type": "boolean" }, "returnedRows": { "type": "integer" } }, "required": [ "hasMore", "returnedRows" ], "type": "object" }, "freshness": { "additionalProperties": false, "properties": { "lastSuccessfulRefreshAt": { "type": "string" }, "servingStateId": { "type": "string" }, "snapshotId": { "type": "string" }, "source": { "type": "string" }, "status": { "type": "string" } }, "required": [ "lastSuccessfulRefreshAt", "servingStateId", "snapshotId", "source", "status" ], "type": "object" }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string" }, "queryId": { "type": "string" }, "rows": { "items": { "items": {}, "type": "array" }, "type": "array" }, "servingSnapshot": { "type": "string" } }, "required": [ "columns", "completeness", "hasMore", "queryId", "rows", "servingSnapshot" ], "type": "object" } }, { "name": "query_visual", "description": "Create one read-only visual from LeapView semantic model fields. Data is queried from semantic models; do not provide inline data.", "privilege": "QUERY_DATA", "effect": "read", "operationId": "manual", "defaults": { "limit": 50 }, "tags": [ "analytics", "visualization" ], "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }, "inputSchema": { "additionalProperties": false, "properties": { "columns": { "description": "Optional table column display configuration.", "items": { "additionalProperties": false, "properties": { "align": { "type": "string" }, "columnValue": { "type": "string" }, "format": { "type": "string" }, "formatting": { "items": { "additionalProperties": false, "properties": { "background": { "type": "string" }, "color": { "type": "string" }, "highColor": { "type": "string" }, "kind": { "type": "string" }, "lowColor": { "type": "string" }, "max": { "type": "number" }, "min": { "type": "number" }, "values": { "additionalProperties": { "type": "string" }, "type": "object" } }, "required": [ "kind" ], "type": "object" }, "type": "array" }, "group": { "type": "string" }, "key": { "type": "string" }, "label": { "type": "string" }, "measure": { "type": "string" }, "role": { "type": "string" }, "width": { "type": "integer" } }, "required": [ "key", "label" ], "type": "object" }, "type": "array" }, "dataset": { "description": "Semantic dataset/table ID.", "minLength": 1, "type": "string" }, "dimensions": { "description": "Dimension fields for chart grouping.", "items": { "additionalProperties": false, "properties": { "alias": { "description": "Optional output alias.", "type": "string" }, "field": { "description": "Semantic field ID.", "minLength": 1, "type": "string" } }, "required": [ "field" ], "type": "object" }, "type": "array" }, "fields": { "description": "Fields for table output.", "items": { "additionalProperties": false, "properties": { "alias": { "description": "Optional output alias.", "type": "string" }, "field": { "description": "Semantic field ID.", "minLength": 1, "type": "string" } }, "required": [ "field" ], "type": "object" }, "type": "array" }, "filters": { "description": "Governed semantic filters applied before visualization. Inline data and arbitrary expressions are not accepted.", "items": { "additionalProperties": false, "properties": { "fact": { "description": "Fact table used to resolve an otherwise ambiguous conformed dimension.", "type": "string" }, "field": { "description": "Semantic field ID. Omit only when groups supplies nested filters.", "type": "string" }, "groups": { "description": "Nested filter groups.", "items": { "additionalProperties": false, "properties": { "filters": { "description": "Nested governed filters. The next recursive level is validated by the tool provider.", "items": { "additionalProperties": {}, "type": "object" }, "type": "array" } }, "required": [ "filters" ], "type": "object" }, "type": "array" }, "operator": { "description": "Governed comparison operator. Defaults to equals.", "enum": [ "equals", "in", "contains", "not_contains", "starts_with", "greater_than_or_equal", "less_than", "is_null", "is_not_null" ], "type": "string" }, "values": { "description": "Comparison values. is_null and is_not_null accept no values.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "type": "array" }, "limit": { "description": "Maximum result rows.", "maximum": 50, "minimum": 1, "type": "integer" }, "measures": { "description": "Measure fields for chart values.", "items": { "additionalProperties": false, "properties": { "alias": { "description": "Optional output alias.", "type": "string" }, "field": { "description": "Semantic field ID.", "minLength": 1, "type": "string" } }, "required": [ "field" ], "type": "object" }, "type": "array" }, "model": { "description": "Semantic model ID.", "minLength": 1, "type": "string" }, "presentation": { "additionalProperties": false, "properties": { "align": { "type": "string" }, "area": { "type": "boolean" }, "basemap": { "type": "string" }, "breadcrumb": { "type": "boolean" }, "centerLabel": { "type": "string" }, "curveness": { "maximum": 1, "minimum": 0, "type": "number" }, "dataZoom": { "type": "boolean" }, "dualAxis": { "type": "boolean" }, "focus": { "type": "string" }, "histogramBins": { "maximum": 60, "minimum": 5, "type": "integer" }, "initialDepth": { "minimum": 0, "type": "integer" }, "innerRadius": { "minimum": 0, "type": "number" }, "labelPosition": { "enum": [ "inside", "outside", "top", "right", "bottom", "left", "center" ], "type": "string" }, "layout": { "type": "string" }, "legend": { "enum": [ "none", "top", "right", "bottom", "left" ], "type": "string" }, "maximum": { "type": "number" }, "minimum": { "type": "number" }, "nodeGap": { "minimum": 0, "type": "number" }, "note": { "type": "string" }, "orientation": { "enum": [ "horizontal", "vertical" ], "type": "string" }, "outerRadius": { "minimum": 0, "type": "number" }, "progressWidth": { "minimum": 0, "type": "number" }, "roam": { "type": "boolean" }, "rose": { "type": "boolean" }, "seriesTypes": { "additionalProperties": { "enum": [ "line", "area", "bar", "column" ], "type": "string" }, "type": "object" }, "showLabels": { "type": "boolean" }, "showSymbols": { "type": "boolean" }, "smooth": { "type": "boolean" }, "sort": { "type": "string" }, "stacked": { "type": "boolean" }, "step": { "type": "boolean" }, "symbolSize": { "minimum": 0, "type": "number" }, "thresholds": { "items": { "additionalProperties": false, "properties": { "tone": { "type": "string" }, "value": { "type": "number" } }, "required": [ "tone", "value" ], "type": "object" }, "type": "array" }, "tone": { "type": "string" } }, "type": "object" }, "rows": { "description": "Row fields for matrix-style table output.", "items": { "additionalProperties": false, "properties": { "alias": { "description": "Optional output alias.", "type": "string" }, "field": { "description": "Semantic field ID.", "minLength": 1, "type": "string" } }, "required": [ "field" ], "type": "object" }, "type": "array" }, "series": { "additionalProperties": false, "properties": { "alias": { "description": "Optional output alias.", "type": "string" }, "field": { "description": "Semantic field ID.", "minLength": 1, "type": "string" } }, "required": [ "field" ], "type": "object" }, "sort": { "description": "Sort fields applied to the query result.", "items": { "additionalProperties": false, "properties": { "direction": { "description": "Sort direction.", "enum": [ "asc", "desc" ], "type": "string" }, "field": { "description": "Semantic field ID.", "minLength": 1, "type": "string" } }, "required": [ "field" ], "type": "object" }, "type": "array" }, "title": { "description": "Optional display title.", "type": "string" }, "type": { "enum": [ "line", "area", "bar", "column", "pie", "donut", "scatter", "funnel", "treemap", "gauge", "heatmap", "sankey", "graph", "map", "candlestick", "boxplot", "combo", "waterfall", "histogram", "radar", "tree", "sunburst", "kpi", "table", "matrix", "pivot" ], "type": "string" }, "workspace": { "minLength": 1, "type": "string" } }, "required": [ "dataset", "model", "type", "workspace" ], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "completeness": { "additionalProperties": false, "properties": { "limit": { "type": "integer" }, "returnedRows": { "type": "integer" }, "status": { "enum": [ "complete", "limit_reached", "empty" ], "type": "string" } }, "required": [ "limit", "returnedRows", "status" ], "type": "object" }, "datasetRef": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "diagnostics": { "items": { "additionalProperties": false, "properties": { "code": { "type": "string" }, "fieldId": { "type": "string" }, "message": { "type": "string" }, "severity": { "enum": [ "info", "warning", "error" ], "type": "string" } }, "required": [ "code", "message", "severity" ], "type": "object" }, "type": "array" }, "fields": { "items": { "additionalProperties": false, "properties": { "alias": { "type": "string" }, "dataType": { "type": "string" }, "format": { "type": "string" }, "label": { "type": "string" }, "ref": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "role": { "enum": [ "dimension", "series", "measure", "table_field", "table_row" ], "type": "string" }, "unit": { "type": "string" } }, "required": [ "label", "ref", "role" ], "type": "object" }, "type": "array" }, "filters": { "items": { "additionalProperties": false, "properties": { "operator": { "enum": [ "equals", "in", "contains", "not_contains", "starts_with", "greater_than_or_equal", "less_than", "is_null", "is_not_null" ], "type": "string" }, "path": { "description": "Zero-based nested group path. Omitted for a root-level filter.", "items": { "type": "integer" }, "type": "array" }, "ref": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "resolvedFactRef": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "values": { "description": "Comparison values. Omitted for unary operators.", "items": { "type": "string" }, "type": "array" } }, "required": [ "operator", "ref" ], "type": "object" }, "type": "array" }, "freshness": { "additionalProperties": false, "properties": { "lastSuccessfulRefreshAt": { "description": "Completion time of the last successful publish or refresh. This is not an upstream event-time watermark.", "type": "string" }, "servingStateId": { "description": "Serving state that produced the successful data version.", "type": "string" }, "snapshotId": { "description": "DuckLake snapshot ID recorded for the successful data version.", "type": "string" }, "source": { "description": "Whether the data version came from publish or refresh.", "enum": [ "publish", "refresh" ], "type": "string" }, "status": { "description": "current when the successful data version belongs to the queried serving snapshot; stale otherwise.", "enum": [ "current", "stale" ], "type": "string" } }, "required": [ "lastSuccessfulRefreshAt", "servingStateId", "snapshotId", "source", "status" ], "type": "object" }, "id": { "type": "string" }, "modelRef": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "ok": { "type": "boolean" }, "queryId": { "type": "string" }, "servingSnapshot": { "type": "string" }, "signal": { "type": "string" }, "status": { "additionalProperties": false, "properties": { "kind": { "enum": [ "idle", "loading", "ready", "no_data", "partial", "error" ], "type": "string" }, "message": { "type": "string" } }, "required": [ "kind" ], "type": "object" }, "summary": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" } }, "required": [ "completeness", "datasetRef", "diagnostics", "fields", "filters", "id", "modelRef", "ok", "queryId", "servingSnapshot", "signal", "status", "summary", "title", "type" ], "type": "object" } } ] }