@lightdash/common 2.598.0 → 2.599.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cjs/.tsbuildinfo +1 -1
- package/dist/cjs/ee/AiAgent/chartConfig/web/getWebAiChartConfig.d.ts +7 -7
- package/dist/cjs/ee/AiAgent/schemas/tools/index.d.ts +2 -0
- package/dist/cjs/ee/AiAgent/schemas/tools/index.d.ts.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/index.js +2 -0
- package/dist/cjs/ee/AiAgent/schemas/tools/index.js.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolDefinitions.d.ts +4 -0
- package/dist/cjs/ee/AiAgent/schemas/tools/toolDefinitions.d.ts.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolDefinitions.js +29 -2
- package/dist/cjs/ee/AiAgent/schemas/tools/toolDefinitions.js.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolFindCustomChartTypesMcpArgs.d.ts +119 -0
- package/dist/cjs/ee/AiAgent/schemas/tools/toolFindCustomChartTypesMcpArgs.d.ts.map +1 -0
- package/dist/cjs/ee/AiAgent/schemas/tools/toolFindCustomChartTypesMcpArgs.js +119 -0
- package/dist/cjs/ee/AiAgent/schemas/tools/toolFindCustomChartTypesMcpArgs.js.map +1 -0
- package/dist/cjs/ee/AiAgent/schemas/tools/toolListCustomChartTypesMcpArgs.d.ts +75 -0
- package/dist/cjs/ee/AiAgent/schemas/tools/toolListCustomChartTypesMcpArgs.d.ts.map +1 -0
- package/dist/cjs/ee/AiAgent/schemas/tools/toolListCustomChartTypesMcpArgs.js +29 -0
- package/dist/cjs/ee/AiAgent/schemas/tools/toolListCustomChartTypesMcpArgs.js.map +1 -0
- package/dist/cjs/ee/AiAgent/schemas/tools/toolRunMetricQueryArgs.d.ts +97 -97
- package/dist/cjs/ee/AiAgent/utils.d.ts +29 -29
- package/dist/cjs/schemas/json/mcp-tools-1.0.json +2149 -1423
- package/dist/esm/.tsbuildinfo +1 -1
- package/dist/esm/ee/AiAgent/chartConfig/web/getWebAiChartConfig.d.ts +29 -29
- package/dist/esm/ee/AiAgent/schemas/tools/index.d.ts +2 -0
- package/dist/esm/ee/AiAgent/schemas/tools/index.d.ts.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/index.js +2 -0
- package/dist/esm/ee/AiAgent/schemas/tools/index.js.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolDefinitions.d.ts +4 -0
- package/dist/esm/ee/AiAgent/schemas/tools/toolDefinitions.d.ts.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolDefinitions.js +27 -0
- package/dist/esm/ee/AiAgent/schemas/tools/toolDefinitions.js.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolFindCustomChartTypesMcpArgs.d.ts +119 -0
- package/dist/esm/ee/AiAgent/schemas/tools/toolFindCustomChartTypesMcpArgs.d.ts.map +1 -0
- package/dist/esm/ee/AiAgent/schemas/tools/toolFindCustomChartTypesMcpArgs.js +115 -0
- package/dist/esm/ee/AiAgent/schemas/tools/toolFindCustomChartTypesMcpArgs.js.map +1 -0
- package/dist/esm/ee/AiAgent/schemas/tools/toolListCustomChartTypesMcpArgs.d.ts +75 -0
- package/dist/esm/ee/AiAgent/schemas/tools/toolListCustomChartTypesMcpArgs.d.ts.map +1 -0
- package/dist/esm/ee/AiAgent/schemas/tools/toolListCustomChartTypesMcpArgs.js +26 -0
- package/dist/esm/ee/AiAgent/schemas/tools/toolListCustomChartTypesMcpArgs.js.map +1 -0
- package/dist/esm/ee/AiAgent/schemas/tools/toolRunMetricQueryArgs.d.ts +97 -97
- package/dist/esm/ee/AiAgent/utils.d.ts +7 -7
- package/dist/esm/schemas/json/mcp-tools-1.0.json +2149 -1423
- package/dist/types/.tsbuildinfo +1 -1
- package/dist/types/ee/AiAgent/chartConfig/web/getWebAiChartConfig.d.ts +29 -29
- package/dist/types/ee/AiAgent/schemas/tools/index.d.ts +2 -0
- package/dist/types/ee/AiAgent/schemas/tools/index.d.ts.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/index.js +2 -0
- package/dist/types/ee/AiAgent/schemas/tools/index.js.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolDefinitions.d.ts +4 -0
- package/dist/types/ee/AiAgent/schemas/tools/toolDefinitions.d.ts.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolDefinitions.js +27 -0
- package/dist/types/ee/AiAgent/schemas/tools/toolDefinitions.js.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolFindCustomChartTypesMcpArgs.d.ts +119 -0
- package/dist/types/ee/AiAgent/schemas/tools/toolFindCustomChartTypesMcpArgs.d.ts.map +1 -0
- package/dist/types/ee/AiAgent/schemas/tools/toolFindCustomChartTypesMcpArgs.js +115 -0
- package/dist/types/ee/AiAgent/schemas/tools/toolFindCustomChartTypesMcpArgs.js.map +1 -0
- package/dist/types/ee/AiAgent/schemas/tools/toolListCustomChartTypesMcpArgs.d.ts +75 -0
- package/dist/types/ee/AiAgent/schemas/tools/toolListCustomChartTypesMcpArgs.d.ts.map +1 -0
- package/dist/types/ee/AiAgent/schemas/tools/toolListCustomChartTypesMcpArgs.js +26 -0
- package/dist/types/ee/AiAgent/schemas/tools/toolListCustomChartTypesMcpArgs.js.map +1 -0
- package/dist/types/ee/AiAgent/schemas/tools/toolRunMetricQueryArgs.d.ts +97 -97
- package/dist/types/ee/AiAgent/utils.d.ts +7 -7
- package/dist/types/schemas/json/mcp-tools-1.0.json +2149 -1423
- package/package.json +1 -1
|
@@ -548,150 +548,6 @@
|
|
|
548
548
|
"outputSchema": null,
|
|
549
549
|
"title": "Find content"
|
|
550
550
|
},
|
|
551
|
-
{
|
|
552
|
-
"annotations": {
|
|
553
|
-
"destructiveHint": false,
|
|
554
|
-
"idempotentHint": false,
|
|
555
|
-
"openWorldHint": false,
|
|
556
|
-
"readOnlyHint": false
|
|
557
|
-
},
|
|
558
|
-
"description": "Tool: generate_data_app\n\nPurpose:\nStart building a new data app: an interactive application generated from a brief on top of a Lightdash project's semantic layer. Each build produces one version of the app. Charts, dashboards, and other saved content have their own tools.\n\nImportant:\n- You name the app. The name fixes both the app's name and its slug at creation, and neither changes afterwards. A name already taken in the project gets a numeric suffix on the slug, so identify the app by the slug this call returns, never one you derived from the name.\n- The build runs in the background for several minutes. This call returns as soon as the build has started. Poll get_data_app_build_status with the returned slug every 15 seconds until its status is \"ready\", \"error\", or \"cancelled\". Call this tool once per request.\n- The app is created as the calling user's personal app: at the project root, in no space, visible only to them until they move it.\n- An agent-scoped session restricted to specific spaces cannot read a personal app. Call this tool and get_data_app_build_status without agentUuid to build and poll an app you own.\n- An unknown themeSlug fails before the build starts and lists the valid slugs. Call list_data_app_themes when the user names a theme, brand, or look.\n\nResponse shape (MCP CallToolResult):\n- content: [{ type: \"text\", text: \"<confirmation that the build started>\" }]\n- structuredContent: {\n slug: string, // the app's permanent slug; pass it to get_data_app_build_status\n version: number // the version of the app this build produces\n }\n\nErrors: an unknown themeSlug, dashboardSlug, or chartSlug returns an error and starts no build.\n",
|
|
559
|
-
"inputSchema": {
|
|
560
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
561
|
-
"properties": {
|
|
562
|
-
"chartSlugs": {
|
|
563
|
-
"anyOf": [
|
|
564
|
-
{
|
|
565
|
-
"items": {
|
|
566
|
-
"type": "string"
|
|
567
|
-
},
|
|
568
|
-
"type": "array"
|
|
569
|
-
},
|
|
570
|
-
{
|
|
571
|
-
"type": "null"
|
|
572
|
-
}
|
|
573
|
-
],
|
|
574
|
-
"default": null,
|
|
575
|
-
"description": "Saved charts (slugs from findContent) whose queries the app is built on; the charts themselves stay unchanged. Omit when not building on saved charts."
|
|
576
|
-
},
|
|
577
|
-
"dashboardSlug": {
|
|
578
|
-
"anyOf": [
|
|
579
|
-
{
|
|
580
|
-
"type": "string"
|
|
581
|
-
},
|
|
582
|
-
{
|
|
583
|
-
"type": "null"
|
|
584
|
-
}
|
|
585
|
-
],
|
|
586
|
-
"default": null,
|
|
587
|
-
"description": "Generate from an existing dashboard: its slug (from findContent). The app starts from the dashboard's layout and charts; the dashboard itself stays unchanged. Omit when not generating from a dashboard."
|
|
588
|
-
},
|
|
589
|
-
"name": {
|
|
590
|
-
"description": "Display name for the app: a headline-short title, in title case, naming what the app shows (\"Revenue Overview\"). The app's slug is derived from it at creation, so treat the name as final — it is not renamed later.",
|
|
591
|
-
"type": "string"
|
|
592
|
-
},
|
|
593
|
-
"prompt": {
|
|
594
|
-
"description": "A self-contained brief for the coding agent that builds the app: what the app shows, for whom, and how it behaves. The coding agent explores the semantic layer itself but sees neither this conversation nor its query results: when this thread has already settled the analysis, carry it over — for each visualization, its title, a one-line description, and a metric query line `[viz title][explore; metrics; dimensions; filters; sort]` — as queries, never pasted numbers, which would be hardcoded into the app.",
|
|
595
|
-
"type": "string"
|
|
596
|
-
},
|
|
597
|
-
"template": {
|
|
598
|
-
"anyOf": [
|
|
599
|
-
{
|
|
600
|
-
"enum": [
|
|
601
|
-
"dashboard",
|
|
602
|
-
"slideshow",
|
|
603
|
-
"pdf",
|
|
604
|
-
"custom"
|
|
605
|
-
],
|
|
606
|
-
"type": "string"
|
|
607
|
-
},
|
|
608
|
-
{
|
|
609
|
-
"type": "null"
|
|
610
|
-
}
|
|
611
|
-
],
|
|
612
|
-
"default": null,
|
|
613
|
-
"description": "Starter template the builder would use: \"dashboard\" for a dashboard-style app, \"slideshow\" for a slide show, \"pdf\" for a PDF report, \"custom\" for anything else. Omit when the user did not ask for one."
|
|
614
|
-
},
|
|
615
|
-
"themeSlug": {
|
|
616
|
-
"anyOf": [
|
|
617
|
-
{
|
|
618
|
-
"type": "string"
|
|
619
|
-
},
|
|
620
|
-
{
|
|
621
|
-
"type": "null"
|
|
622
|
-
}
|
|
623
|
-
],
|
|
624
|
-
"default": null,
|
|
625
|
-
"description": "Organization theme to build the app with: its slug, from the attached context (\"Theme: <name> (slug: <slug>)\"). Omit when no theme is given — the organization default applies. An unknown slug returns an error listing the valid slugs and starts no build."
|
|
626
|
-
}
|
|
627
|
-
},
|
|
628
|
-
"required": ["name", "prompt"],
|
|
629
|
-
"type": "object"
|
|
630
|
-
},
|
|
631
|
-
"name": "generate_data_app",
|
|
632
|
-
"outputSchema": {
|
|
633
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
634
|
-
"additionalProperties": false,
|
|
635
|
-
"properties": {
|
|
636
|
-
"slug": {
|
|
637
|
-
"description": "The app's permanent slug. Poll get_data_app_build_status with it.",
|
|
638
|
-
"type": "string"
|
|
639
|
-
},
|
|
640
|
-
"version": {
|
|
641
|
-
"description": "The version of the app this build produces.",
|
|
642
|
-
"exclusiveMinimum": 0,
|
|
643
|
-
"maximum": 9007199254740991,
|
|
644
|
-
"type": "integer"
|
|
645
|
-
}
|
|
646
|
-
},
|
|
647
|
-
"required": ["slug", "version"],
|
|
648
|
-
"type": "object"
|
|
649
|
-
},
|
|
650
|
-
"title": "Generate data app"
|
|
651
|
-
},
|
|
652
|
-
{
|
|
653
|
-
"annotations": {
|
|
654
|
-
"destructiveHint": false,
|
|
655
|
-
"idempotentHint": true,
|
|
656
|
-
"openWorldHint": false,
|
|
657
|
-
"readOnlyHint": true
|
|
658
|
-
},
|
|
659
|
-
"description": "Generate deterministic base-36 hashes for input strings.",
|
|
660
|
-
"inputSchema": {
|
|
661
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
662
|
-
"properties": {
|
|
663
|
-
"inputs": {
|
|
664
|
-
"description": "Input strings to hash.",
|
|
665
|
-
"items": {
|
|
666
|
-
"type": "string"
|
|
667
|
-
},
|
|
668
|
-
"maxItems": 20,
|
|
669
|
-
"minItems": 1,
|
|
670
|
-
"type": "array"
|
|
671
|
-
}
|
|
672
|
-
},
|
|
673
|
-
"required": ["inputs"],
|
|
674
|
-
"type": "object"
|
|
675
|
-
},
|
|
676
|
-
"name": "generate_hashes",
|
|
677
|
-
"outputSchema": {
|
|
678
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
679
|
-
"additionalProperties": false,
|
|
680
|
-
"properties": {
|
|
681
|
-
"hashes": {
|
|
682
|
-
"description": "Base-36 hashes in the same order as the input strings.",
|
|
683
|
-
"items": {
|
|
684
|
-
"pattern": "^[0-9a-z]{6}$",
|
|
685
|
-
"type": "string"
|
|
686
|
-
},
|
|
687
|
-
"type": "array"
|
|
688
|
-
}
|
|
689
|
-
},
|
|
690
|
-
"required": ["hashes"],
|
|
691
|
-
"type": "object"
|
|
692
|
-
},
|
|
693
|
-
"title": "Generate hashes"
|
|
694
|
-
},
|
|
695
551
|
{
|
|
696
552
|
"annotations": {
|
|
697
553
|
"destructiveHint": false,
|
|
@@ -699,26 +555,11 @@
|
|
|
699
555
|
"openWorldHint": false,
|
|
700
556
|
"readOnlyHint": true
|
|
701
557
|
},
|
|
702
|
-
"description": "Tool:
|
|
558
|
+
"description": "Tool: find_custom_chart_types\n\nSearch the project's custom chart types (reusable visualizations, including ones installed from the library) by `query` against name and description, or fetch one by `slug`. Set exactly one of the two; to browse page by page, use list_custom_chart_types.\n\n- Each match has its latest version, field slots, config options and a Chart Studio link.\n- Reuse a fitting type before building one with create_custom_chart_type, if available.\n- To save a chart with a type, call create_content (if available) with chartConfig { type: \"data_app_viz\", config: { dataAppVizSlug, fieldMapping, optionValues } }, binding each slot name to query field IDs.\n",
|
|
703
559
|
"inputSchema": {
|
|
704
560
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
705
561
|
"properties": {
|
|
706
|
-
"
|
|
707
|
-
"description": "The id returned by run_ai_writeback.",
|
|
708
|
-
"format": "uuid",
|
|
709
|
-
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
|
|
710
|
-
"type": "string"
|
|
711
|
-
}
|
|
712
|
-
},
|
|
713
|
-
"required": ["aiWritebackRunUuid"],
|
|
714
|
-
"type": "object"
|
|
715
|
-
},
|
|
716
|
-
"name": "get_ai_writeback_status",
|
|
717
|
-
"outputSchema": {
|
|
718
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
719
|
-
"additionalProperties": false,
|
|
720
|
-
"properties": {
|
|
721
|
-
"errorMessage": {
|
|
562
|
+
"query": {
|
|
722
563
|
"anyOf": [
|
|
723
564
|
{
|
|
724
565
|
"type": "string"
|
|
@@ -727,9 +568,10 @@
|
|
|
727
568
|
"type": "null"
|
|
728
569
|
}
|
|
729
570
|
],
|
|
730
|
-
"
|
|
571
|
+
"default": null,
|
|
572
|
+
"description": "Keyword terms matched against chart type names and descriptions. Set exactly one of query or slug."
|
|
731
573
|
},
|
|
732
|
-
"
|
|
574
|
+
"slug": {
|
|
733
575
|
"anyOf": [
|
|
734
576
|
{
|
|
735
577
|
"type": "string"
|
|
@@ -738,149 +580,25 @@
|
|
|
738
580
|
"type": "null"
|
|
739
581
|
}
|
|
740
582
|
],
|
|
741
|
-
"
|
|
742
|
-
|
|
743
|
-
"status": {
|
|
744
|
-
"description": "\"pending\" | a pipeline stage (e.g. \"sandbox\", \"agent\", \"pull_request\") | \"ready\" | \"error\" | \"cancelled\".",
|
|
745
|
-
"type": "string"
|
|
583
|
+
"default": null,
|
|
584
|
+
"description": "Exact slug of one chart type. Set exactly one of query or slug."
|
|
746
585
|
}
|
|
747
586
|
},
|
|
748
|
-
"required": ["status", "prUrl", "errorMessage"],
|
|
749
|
-
"type": "object"
|
|
750
|
-
},
|
|
751
|
-
"title": "Get AI writeback status"
|
|
752
|
-
},
|
|
753
|
-
{
|
|
754
|
-
"annotations": {
|
|
755
|
-
"destructiveHint": false,
|
|
756
|
-
"idempotentHint": true,
|
|
757
|
-
"openWorldHint": false,
|
|
758
|
-
"readOnlyHint": true
|
|
759
|
-
},
|
|
760
|
-
"description": "Call this first to discover available projects, the agents you can access in each project, and Lightdash-configured context. Pass the selected projectUuid to every project-scoped tool call. When agent-specific scope is useful and routing is available, use route_agent and pass its returned agentUuid explicitly. If routing is unavailable or full project scope is desired, omit agentUuid; use set_agent for manual selection. This tool reports context but does not establish implicit execution state. When the session is pinned to a project, activeProject is the only allowed project. Otherwise it is a stored default, not a restriction on projectUuid. Use the project the user requested; if none was specified, use activeProject if present or ask. If the requested project is unavailable or rejected, explain rather than substitute another project.",
|
|
761
|
-
"inputSchema": {
|
|
762
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
763
|
-
"properties": {},
|
|
764
587
|
"type": "object"
|
|
765
588
|
},
|
|
766
|
-
"name": "
|
|
589
|
+
"name": "find_custom_chart_types",
|
|
767
590
|
"outputSchema": {
|
|
768
591
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
769
592
|
"additionalProperties": false,
|
|
770
593
|
"properties": {
|
|
771
|
-
"
|
|
772
|
-
"anyOf": [
|
|
773
|
-
{
|
|
774
|
-
"additionalProperties": false,
|
|
775
|
-
"properties": {
|
|
776
|
-
"agentName": {
|
|
777
|
-
"type": "string"
|
|
778
|
-
},
|
|
779
|
-
"agentUuid": {
|
|
780
|
-
"type": "string"
|
|
781
|
-
},
|
|
782
|
-
"projectUuid": {
|
|
783
|
-
"type": "string"
|
|
784
|
-
}
|
|
785
|
-
},
|
|
786
|
-
"required": [
|
|
787
|
-
"agentUuid",
|
|
788
|
-
"agentName",
|
|
789
|
-
"projectUuid"
|
|
790
|
-
],
|
|
791
|
-
"type": "object"
|
|
792
|
-
},
|
|
793
|
-
{
|
|
794
|
-
"type": "null"
|
|
795
|
-
}
|
|
796
|
-
]
|
|
797
|
-
},
|
|
798
|
-
"activeProject": {
|
|
799
|
-
"anyOf": [
|
|
800
|
-
{
|
|
801
|
-
"additionalProperties": false,
|
|
802
|
-
"properties": {
|
|
803
|
-
"projectName": {
|
|
804
|
-
"type": "string"
|
|
805
|
-
},
|
|
806
|
-
"projectUuid": {
|
|
807
|
-
"type": "string"
|
|
808
|
-
},
|
|
809
|
-
"selectedTags": {
|
|
810
|
-
"anyOf": [
|
|
811
|
-
{
|
|
812
|
-
"items": {
|
|
813
|
-
"type": "string"
|
|
814
|
-
},
|
|
815
|
-
"type": "array"
|
|
816
|
-
},
|
|
817
|
-
{
|
|
818
|
-
"type": "null"
|
|
819
|
-
}
|
|
820
|
-
]
|
|
821
|
-
}
|
|
822
|
-
},
|
|
823
|
-
"required": [
|
|
824
|
-
"projectUuid",
|
|
825
|
-
"projectName",
|
|
826
|
-
"selectedTags"
|
|
827
|
-
],
|
|
828
|
-
"type": "object"
|
|
829
|
-
},
|
|
830
|
-
{
|
|
831
|
-
"type": "null"
|
|
832
|
-
}
|
|
833
|
-
]
|
|
834
|
-
},
|
|
835
|
-
"availableProjects": {
|
|
594
|
+
"results": {
|
|
836
595
|
"items": {
|
|
837
596
|
"additionalProperties": false,
|
|
838
597
|
"properties": {
|
|
839
|
-
"
|
|
840
|
-
"
|
|
841
|
-
"additionalProperties": false,
|
|
842
|
-
"properties": {
|
|
843
|
-
"agentUuid": {
|
|
844
|
-
"type": "string"
|
|
845
|
-
},
|
|
846
|
-
"description": {
|
|
847
|
-
"anyOf": [
|
|
848
|
-
{
|
|
849
|
-
"type": "string"
|
|
850
|
-
},
|
|
851
|
-
{
|
|
852
|
-
"type": "null"
|
|
853
|
-
}
|
|
854
|
-
]
|
|
855
|
-
},
|
|
856
|
-
"name": {
|
|
857
|
-
"type": "string"
|
|
858
|
-
},
|
|
859
|
-
"tags": {
|
|
860
|
-
"anyOf": [
|
|
861
|
-
{
|
|
862
|
-
"items": {
|
|
863
|
-
"type": "string"
|
|
864
|
-
},
|
|
865
|
-
"type": "array"
|
|
866
|
-
},
|
|
867
|
-
{
|
|
868
|
-
"type": "null"
|
|
869
|
-
}
|
|
870
|
-
]
|
|
871
|
-
}
|
|
872
|
-
},
|
|
873
|
-
"required": [
|
|
874
|
-
"agentUuid",
|
|
875
|
-
"name",
|
|
876
|
-
"description",
|
|
877
|
-
"tags"
|
|
878
|
-
],
|
|
879
|
-
"type": "object"
|
|
880
|
-
},
|
|
881
|
-
"type": "array"
|
|
598
|
+
"chartStudioUrl": {
|
|
599
|
+
"type": "string"
|
|
882
600
|
},
|
|
883
|
-
"
|
|
601
|
+
"description": {
|
|
884
602
|
"anyOf": [
|
|
885
603
|
{
|
|
886
604
|
"type": "string"
|
|
@@ -893,372 +611,130 @@
|
|
|
893
611
|
"name": {
|
|
894
612
|
"type": "string"
|
|
895
613
|
},
|
|
896
|
-
"
|
|
614
|
+
"slug": {
|
|
897
615
|
"type": "string"
|
|
898
616
|
},
|
|
899
|
-
"
|
|
900
|
-
"
|
|
901
|
-
|
|
902
|
-
|
|
903
|
-
|
|
904
|
-
"projectUuid",
|
|
905
|
-
"name",
|
|
906
|
-
"type",
|
|
907
|
-
"expiresAt",
|
|
908
|
-
"availableAgents"
|
|
909
|
-
],
|
|
910
|
-
"type": "object"
|
|
911
|
-
},
|
|
912
|
-
"type": "array"
|
|
913
|
-
}
|
|
914
|
-
},
|
|
915
|
-
"required": [
|
|
916
|
-
"activeProject",
|
|
917
|
-
"activeAgent",
|
|
918
|
-
"availableProjects"
|
|
919
|
-
],
|
|
920
|
-
"type": "object"
|
|
921
|
-
},
|
|
922
|
-
"title": "Get context"
|
|
923
|
-
},
|
|
924
|
-
{
|
|
925
|
-
"annotations": {
|
|
926
|
-
"destructiveHint": false,
|
|
927
|
-
"idempotentHint": true,
|
|
928
|
-
"openWorldHint": false,
|
|
929
|
-
"readOnlyHint": true
|
|
930
|
-
},
|
|
931
|
-
"description": "@deprecated Use get_context for legacy configured context or route_agent for an explicit agent selection.",
|
|
932
|
-
"inputSchema": {
|
|
933
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
934
|
-
"properties": {},
|
|
935
|
-
"type": "object"
|
|
936
|
-
},
|
|
937
|
-
"name": "get_current_agent",
|
|
938
|
-
"outputSchema": null,
|
|
939
|
-
"title": "Get current agent (deprecated)"
|
|
940
|
-
},
|
|
941
|
-
{
|
|
942
|
-
"annotations": {
|
|
943
|
-
"destructiveHint": false,
|
|
944
|
-
"idempotentHint": true,
|
|
945
|
-
"openWorldHint": false,
|
|
946
|
-
"readOnlyHint": true
|
|
947
|
-
},
|
|
948
|
-
"description": "@deprecated Use get_context instead. Returns legacy shared project context for older clients.",
|
|
949
|
-
"inputSchema": {
|
|
950
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
951
|
-
"properties": {},
|
|
952
|
-
"type": "object"
|
|
953
|
-
},
|
|
954
|
-
"name": "get_current_project",
|
|
955
|
-
"outputSchema": null,
|
|
956
|
-
"title": "Get current project (deprecated)"
|
|
957
|
-
},
|
|
958
|
-
{
|
|
959
|
-
"annotations": {
|
|
960
|
-
"destructiveHint": false,
|
|
961
|
-
"idempotentHint": true,
|
|
962
|
-
"openWorldHint": false,
|
|
963
|
-
"readOnlyHint": true
|
|
964
|
-
},
|
|
965
|
-
"description": "Tool: get_data_app_build_status\n\nPurpose:\nCheck how a data app build is going, and get the app's URL once it is ready. A data app is an interactive application generated from a brief on top of a Lightdash project's semantic layer; each build produces one version of it.\n\nImportant:\n- Poll every 15 seconds — \"nextPollAfterMs\" in the response carries the same number in milliseconds. A build usually takes several minutes.\n- Stop polling once \"status\" is \"ready\", \"error\", or \"cancelled\". Those are terminal; the version never changes again.\n- \"slug\" is the app's permanent identifier and never changes, even when the app is renamed. Keep using the slug you started the build with.\n- An agent-scoped session restricted to specific spaces cannot read a personal app, which is what a build started over MCP creates. Call this tool without agentUuid to poll a build you started.\n\nParameters:\n- appSlug: The app's slug, as returned when the build started.\n- version: Which version of the app to report on. Omit it for the latest version, which is the one a build you just started produces.\n\nResponse shape (MCP CallToolResult):\n- content: [{ type: \"text\", text: \"<human-readable status summary>\" }]\n- structuredContent: {\n status: string, // \"pending\" | \"sandbox\" | \"catalog\" | \"generating\" | \"building\" | \"packaging\" | \"ready\" | \"error\" | \"cancelled\"\n statusMessage: string, // short line describing what the build is doing, or how it ended\n errorMessage: string | null, // why the build failed, set only when status is \"error\"\n name: string, // the app's name\n slug: string, // the app's permanent slug\n href: string, // URL to open the app in Lightdash; Chart Studio for a custom chart type\n nextPollAfterMs: number // how long to wait before polling again\n }\n\nErrors: an unknown slug, or an app or version this caller may not view, returns an error rather than a status.\n",
|
|
966
|
-
"inputSchema": {
|
|
967
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
968
|
-
"properties": {
|
|
969
|
-
"appSlug": {
|
|
970
|
-
"description": "The data app's slug, as returned when the build started.",
|
|
971
|
-
"minLength": 1,
|
|
972
|
-
"type": "string"
|
|
973
|
-
},
|
|
974
|
-
"version": {
|
|
975
|
-
"description": "Which version of the app to report on. Omit for the latest version — the one a build you just started produces.",
|
|
976
|
-
"exclusiveMinimum": 0,
|
|
977
|
-
"maximum": 9007199254740991,
|
|
978
|
-
"type": "integer"
|
|
979
|
-
}
|
|
980
|
-
},
|
|
981
|
-
"required": ["appSlug"],
|
|
982
|
-
"type": "object"
|
|
983
|
-
},
|
|
984
|
-
"name": "get_data_app_build_status",
|
|
985
|
-
"outputSchema": {
|
|
986
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
987
|
-
"additionalProperties": false,
|
|
988
|
-
"properties": {
|
|
989
|
-
"errorMessage": {
|
|
990
|
-
"anyOf": [
|
|
991
|
-
{
|
|
992
|
-
"type": "string"
|
|
993
|
-
},
|
|
994
|
-
{
|
|
995
|
-
"type": "null"
|
|
996
|
-
}
|
|
997
|
-
],
|
|
998
|
-
"description": "Why the build failed. Set only when status is \"error\"."
|
|
999
|
-
},
|
|
1000
|
-
"href": {
|
|
1001
|
-
"description": "URL that opens the app, or Chart Studio for a custom chart type.",
|
|
1002
|
-
"type": "string"
|
|
1003
|
-
},
|
|
1004
|
-
"name": {
|
|
1005
|
-
"description": "The app's name.",
|
|
1006
|
-
"type": "string"
|
|
1007
|
-
},
|
|
1008
|
-
"nextPollAfterMs": {
|
|
1009
|
-
"description": "How long to wait before polling again. Stop polling on a terminal status.",
|
|
1010
|
-
"exclusiveMinimum": 0,
|
|
1011
|
-
"maximum": 9007199254740991,
|
|
1012
|
-
"type": "integer"
|
|
1013
|
-
},
|
|
1014
|
-
"slug": {
|
|
1015
|
-
"description": "The app's permanent slug; it never changes.",
|
|
1016
|
-
"type": "string"
|
|
1017
|
-
},
|
|
1018
|
-
"status": {
|
|
1019
|
-
"description": "Pipeline stage the build has reached, or a terminal outcome: \"ready\", \"error\", or \"cancelled\".",
|
|
1020
|
-
"enum": [
|
|
1021
|
-
"pending",
|
|
1022
|
-
"sandbox",
|
|
1023
|
-
"catalog",
|
|
1024
|
-
"compact",
|
|
1025
|
-
"generating",
|
|
1026
|
-
"building",
|
|
1027
|
-
"packaging",
|
|
1028
|
-
"ready",
|
|
1029
|
-
"error",
|
|
1030
|
-
"cancelled"
|
|
1031
|
-
],
|
|
1032
|
-
"type": "string"
|
|
1033
|
-
},
|
|
1034
|
-
"statusMessage": {
|
|
1035
|
-
"description": "Short line describing what the build is doing, or how it ended.",
|
|
1036
|
-
"type": "string"
|
|
1037
|
-
}
|
|
1038
|
-
},
|
|
1039
|
-
"required": [
|
|
1040
|
-
"status",
|
|
1041
|
-
"statusMessage",
|
|
1042
|
-
"errorMessage",
|
|
1043
|
-
"name",
|
|
1044
|
-
"slug",
|
|
1045
|
-
"href",
|
|
1046
|
-
"nextPollAfterMs"
|
|
1047
|
-
],
|
|
1048
|
-
"type": "object"
|
|
1049
|
-
},
|
|
1050
|
-
"title": "Get data app build status"
|
|
1051
|
-
},
|
|
1052
|
-
{
|
|
1053
|
-
"annotations": {
|
|
1054
|
-
"destructiveHint": false,
|
|
1055
|
-
"idempotentHint": true,
|
|
1056
|
-
"openWorldHint": false,
|
|
1057
|
-
"readOnlyHint": true
|
|
1058
|
-
},
|
|
1059
|
-
"description": "Get the current Lightdash version",
|
|
1060
|
-
"inputSchema": {
|
|
1061
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1062
|
-
"properties": {},
|
|
1063
|
-
"type": "object"
|
|
1064
|
-
},
|
|
1065
|
-
"name": "get_lightdash_version",
|
|
1066
|
-
"outputSchema": null,
|
|
1067
|
-
"title": "Get Lightdash version"
|
|
1068
|
-
},
|
|
1069
|
-
{
|
|
1070
|
-
"annotations": {
|
|
1071
|
-
"destructiveHint": false,
|
|
1072
|
-
"idempotentHint": true,
|
|
1073
|
-
"openWorldHint": false,
|
|
1074
|
-
"readOnlyHint": true
|
|
1075
|
-
},
|
|
1076
|
-
"description": "Tool: get_metadata\n\nPurpose:\nGet the full metadata for specific explores and/or fields that you already know the IDs of (typically from grep_fields). grep_fields is lean — it tells you WHICH fields exist; get_metadata gives you the DETAIL you need to build a correct query: an explore's joined tables, table filters, required filters, and parameters, and a field's filter type, case-sensitivity, resolved default time dimension, parameter dependencies, hints, and whether it comes from a joined table. A field marked with required parameters returns different results depending on the parameter values the query runs with — unset parameters resolve to their default.\n\nCall this AFTER grep_fields, once you have narrowed down to the explore(s) and field(s) you intend to use, and BEFORE render_chart. You can ask for several explores and several fields across explores in a SINGLE call — batch everything you need at once instead of one request per item.\n\nEach entry in `requests` is one of:\n- `{ \"type\": \"explore\", \"exploreIds\": [\"orders\", \"customers\"] }` — full metadata for those explores (joined tables, table filters, field counts).\n- `{ \"type\": \"field\", \"fields\": [{ \"exploreId\": \"orders\", \"fieldId\": \"orders_status\" }] }` — full metadata for those specific fields.\n",
|
|
1077
|
-
"inputSchema": {
|
|
1078
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1079
|
-
"properties": {
|
|
1080
|
-
"requests": {
|
|
1081
|
-
"description": "A batch of explore and/or field metadata requests, resolved together in one call.",
|
|
1082
|
-
"items": {
|
|
1083
|
-
"anyOf": [
|
|
1084
|
-
{
|
|
1085
|
-
"properties": {
|
|
1086
|
-
"exploreIds": {
|
|
1087
|
-
"description": "Explore IDs (names) to fetch full metadata for.",
|
|
1088
|
-
"items": {
|
|
1089
|
-
"minLength": 1,
|
|
1090
|
-
"type": "string"
|
|
1091
|
-
},
|
|
1092
|
-
"minItems": 1,
|
|
1093
|
-
"type": "array"
|
|
1094
|
-
},
|
|
1095
|
-
"type": {
|
|
1096
|
-
"const": "explore",
|
|
1097
|
-
"type": "string"
|
|
1098
|
-
}
|
|
1099
|
-
},
|
|
1100
|
-
"required": ["type", "exploreIds"],
|
|
1101
|
-
"type": "object"
|
|
617
|
+
"version": {
|
|
618
|
+
"description": "Latest ready version, the one a new chart renders.",
|
|
619
|
+
"exclusiveMinimum": 0,
|
|
620
|
+
"maximum": 9007199254740991,
|
|
621
|
+
"type": "integer"
|
|
1102
622
|
},
|
|
1103
|
-
{
|
|
623
|
+
"vizSchema": {
|
|
624
|
+
"additionalProperties": false,
|
|
1104
625
|
"properties": {
|
|
1105
|
-
"
|
|
1106
|
-
"description": "Specific fields to fetch full metadata for.",
|
|
1107
|
-
"items": {
|
|
1108
|
-
"properties": {
|
|
1109
|
-
"exploreId": {
|
|
1110
|
-
"description": "The explore the field belongs to.",
|
|
1111
|
-
"minLength": 1,
|
|
1112
|
-
"type": "string"
|
|
1113
|
-
},
|
|
1114
|
-
"fieldId": {
|
|
1115
|
-
"description": "The fieldId, e.g. `orders_status`.",
|
|
1116
|
-
"minLength": 1,
|
|
1117
|
-
"type": "string"
|
|
1118
|
-
}
|
|
1119
|
-
},
|
|
1120
|
-
"required": [
|
|
1121
|
-
"exploreId",
|
|
1122
|
-
"fieldId"
|
|
1123
|
-
],
|
|
1124
|
-
"type": "object"
|
|
1125
|
-
},
|
|
1126
|
-
"minItems": 1,
|
|
1127
|
-
"type": "array"
|
|
1128
|
-
},
|
|
1129
|
-
"type": {
|
|
1130
|
-
"const": "field",
|
|
1131
|
-
"type": "string"
|
|
1132
|
-
}
|
|
1133
|
-
},
|
|
1134
|
-
"required": ["type", "fields"],
|
|
1135
|
-
"type": "object"
|
|
1136
|
-
}
|
|
1137
|
-
]
|
|
1138
|
-
},
|
|
1139
|
-
"maxItems": 20,
|
|
1140
|
-
"minItems": 1,
|
|
1141
|
-
"type": "array"
|
|
1142
|
-
}
|
|
1143
|
-
},
|
|
1144
|
-
"required": ["requests"],
|
|
1145
|
-
"type": "object"
|
|
1146
|
-
},
|
|
1147
|
-
"name": "get_metadata",
|
|
1148
|
-
"outputSchema": {
|
|
1149
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1150
|
-
"additionalProperties": false,
|
|
1151
|
-
"properties": {
|
|
1152
|
-
"explores": {
|
|
1153
|
-
"items": {
|
|
1154
|
-
"anyOf": [
|
|
1155
|
-
{
|
|
1156
|
-
"additionalProperties": false,
|
|
1157
|
-
"properties": {
|
|
1158
|
-
"baseDimensions": {
|
|
1159
|
-
"additionalProperties": false,
|
|
1160
|
-
"properties": {
|
|
1161
|
-
"count": {
|
|
1162
|
-
"type": "number"
|
|
1163
|
-
},
|
|
1164
|
-
"fieldIds": {
|
|
1165
|
-
"items": {
|
|
1166
|
-
"type": "string"
|
|
1167
|
-
},
|
|
1168
|
-
"type": "array"
|
|
1169
|
-
}
|
|
1170
|
-
},
|
|
1171
|
-
"required": ["count", "fieldIds"],
|
|
1172
|
-
"type": "object"
|
|
1173
|
-
},
|
|
1174
|
-
"baseMetrics": {
|
|
1175
|
-
"additionalProperties": false,
|
|
1176
|
-
"properties": {
|
|
1177
|
-
"count": {
|
|
1178
|
-
"type": "number"
|
|
1179
|
-
},
|
|
1180
|
-
"fieldIds": {
|
|
1181
|
-
"items": {
|
|
1182
|
-
"type": "string"
|
|
1183
|
-
},
|
|
1184
|
-
"type": "array"
|
|
1185
|
-
}
|
|
1186
|
-
},
|
|
1187
|
-
"required": ["count", "fieldIds"],
|
|
1188
|
-
"type": "object"
|
|
1189
|
-
},
|
|
1190
|
-
"baseTable": {
|
|
1191
|
-
"type": "string"
|
|
1192
|
-
},
|
|
1193
|
-
"description": {
|
|
1194
|
-
"anyOf": [
|
|
1195
|
-
{
|
|
1196
|
-
"type": "string"
|
|
1197
|
-
},
|
|
1198
|
-
{
|
|
1199
|
-
"type": "null"
|
|
1200
|
-
}
|
|
1201
|
-
]
|
|
1202
|
-
},
|
|
1203
|
-
"exploreId": {
|
|
1204
|
-
"type": "string"
|
|
1205
|
-
},
|
|
1206
|
-
"hint": {
|
|
626
|
+
"colorPalette": {
|
|
1207
627
|
"anyOf": [
|
|
1208
628
|
{
|
|
1209
|
-
"
|
|
629
|
+
"additionalProperties": false,
|
|
630
|
+
"properties": {
|
|
631
|
+
"group": {
|
|
632
|
+
"anyOf": [
|
|
633
|
+
{
|
|
634
|
+
"type": "string"
|
|
635
|
+
},
|
|
636
|
+
{
|
|
637
|
+
"type": "null"
|
|
638
|
+
}
|
|
639
|
+
]
|
|
640
|
+
}
|
|
641
|
+
},
|
|
642
|
+
"required": ["group"],
|
|
643
|
+
"type": "object"
|
|
1210
644
|
},
|
|
1211
645
|
{
|
|
1212
646
|
"type": "null"
|
|
1213
647
|
}
|
|
1214
|
-
]
|
|
1215
|
-
|
|
1216
|
-
"joinedTables": {
|
|
1217
|
-
"items": {
|
|
1218
|
-
"type": "string"
|
|
1219
|
-
},
|
|
1220
|
-
"type": "array"
|
|
1221
|
-
},
|
|
1222
|
-
"label": {
|
|
1223
|
-
"type": "string"
|
|
648
|
+
],
|
|
649
|
+
"description": "Set when the chart colours series from the palette."
|
|
1224
650
|
},
|
|
1225
|
-
"
|
|
651
|
+
"configOptions": {
|
|
652
|
+
"description": "Settings the chart accepts in optionValues.",
|
|
1226
653
|
"items": {
|
|
1227
654
|
"additionalProperties": false,
|
|
1228
655
|
"properties": {
|
|
1229
|
-
"
|
|
1230
|
-
"
|
|
656
|
+
"choices": {
|
|
657
|
+
"anyOf": [
|
|
658
|
+
{
|
|
659
|
+
"items": {
|
|
660
|
+
"additionalProperties": false,
|
|
661
|
+
"properties": {
|
|
662
|
+
"label": {
|
|
663
|
+
"type": "string"
|
|
664
|
+
},
|
|
665
|
+
"value": {
|
|
666
|
+
"type": "string"
|
|
667
|
+
}
|
|
668
|
+
},
|
|
669
|
+
"required": [
|
|
670
|
+
"value",
|
|
671
|
+
"label"
|
|
672
|
+
],
|
|
673
|
+
"type": "object"
|
|
674
|
+
},
|
|
675
|
+
"type": "array"
|
|
676
|
+
},
|
|
677
|
+
{
|
|
678
|
+
"type": "null"
|
|
679
|
+
}
|
|
680
|
+
],
|
|
681
|
+
"description": "Allowed values of a select option."
|
|
1231
682
|
},
|
|
1232
683
|
"default": {
|
|
1233
684
|
"anyOf": [
|
|
1234
685
|
{
|
|
1235
|
-
"
|
|
1236
|
-
|
|
1237
|
-
|
|
1238
|
-
|
|
1239
|
-
|
|
1240
|
-
|
|
1241
|
-
|
|
1242
|
-
|
|
686
|
+
"type": "boolean"
|
|
687
|
+
},
|
|
688
|
+
{
|
|
689
|
+
"type": "number"
|
|
690
|
+
},
|
|
691
|
+
{
|
|
692
|
+
"type": "string"
|
|
693
|
+
},
|
|
694
|
+
{
|
|
695
|
+
"additionalProperties": false,
|
|
696
|
+
"properties": {
|
|
697
|
+
"colors": {
|
|
1243
698
|
"items": {
|
|
1244
699
|
"type": "string"
|
|
1245
700
|
},
|
|
701
|
+
"maxItems": 5,
|
|
702
|
+
"minItems": 2,
|
|
1246
703
|
"type": "array"
|
|
1247
704
|
},
|
|
1248
|
-
{
|
|
1249
|
-
"
|
|
1250
|
-
|
|
1251
|
-
|
|
1252
|
-
|
|
705
|
+
"max": {
|
|
706
|
+
"anyOf": [
|
|
707
|
+
{
|
|
708
|
+
"type": "number"
|
|
709
|
+
},
|
|
710
|
+
{
|
|
711
|
+
"const": "auto",
|
|
712
|
+
"type": "string"
|
|
713
|
+
}
|
|
714
|
+
]
|
|
715
|
+
},
|
|
716
|
+
"min": {
|
|
717
|
+
"anyOf": [
|
|
718
|
+
{
|
|
719
|
+
"type": "number"
|
|
720
|
+
},
|
|
721
|
+
{
|
|
722
|
+
"const": "auto",
|
|
723
|
+
"type": "string"
|
|
724
|
+
}
|
|
725
|
+
]
|
|
1253
726
|
}
|
|
1254
|
-
|
|
1255
|
-
|
|
1256
|
-
|
|
1257
|
-
|
|
727
|
+
},
|
|
728
|
+
"required": [
|
|
729
|
+
"colors",
|
|
730
|
+
"min",
|
|
731
|
+
"max"
|
|
732
|
+
],
|
|
733
|
+
"type": "object"
|
|
1258
734
|
}
|
|
1259
735
|
]
|
|
1260
736
|
},
|
|
1261
|
-
"
|
|
737
|
+
"group": {
|
|
1262
738
|
"anyOf": [
|
|
1263
739
|
{
|
|
1264
740
|
"type": "string"
|
|
@@ -1271,60 +747,38 @@
|
|
|
1271
747
|
"label": {
|
|
1272
748
|
"type": "string"
|
|
1273
749
|
},
|
|
1274
|
-
"
|
|
1275
|
-
"type": "boolean"
|
|
1276
|
-
},
|
|
1277
|
-
"name": {
|
|
1278
|
-
"type": "string"
|
|
1279
|
-
},
|
|
1280
|
-
"options": {
|
|
750
|
+
"max": {
|
|
1281
751
|
"anyOf": [
|
|
1282
752
|
{
|
|
1283
|
-
"
|
|
1284
|
-
"anyOf": [
|
|
1285
|
-
{
|
|
1286
|
-
"type": "string"
|
|
1287
|
-
},
|
|
1288
|
-
{
|
|
1289
|
-
"type": "number"
|
|
1290
|
-
}
|
|
1291
|
-
]
|
|
1292
|
-
},
|
|
1293
|
-
"type": "array"
|
|
753
|
+
"type": "number"
|
|
1294
754
|
},
|
|
1295
755
|
{
|
|
1296
756
|
"type": "null"
|
|
1297
757
|
}
|
|
1298
758
|
]
|
|
1299
759
|
},
|
|
1300
|
-
"
|
|
760
|
+
"min": {
|
|
1301
761
|
"anyOf": [
|
|
1302
762
|
{
|
|
1303
|
-
"
|
|
1304
|
-
"properties": {
|
|
1305
|
-
"dimension": {
|
|
1306
|
-
"type": "string"
|
|
1307
|
-
},
|
|
1308
|
-
"model": {
|
|
1309
|
-
"type": "string"
|
|
1310
|
-
}
|
|
1311
|
-
},
|
|
1312
|
-
"required": [
|
|
1313
|
-
"model",
|
|
1314
|
-
"dimension"
|
|
1315
|
-
],
|
|
1316
|
-
"type": "object"
|
|
763
|
+
"type": "number"
|
|
1317
764
|
},
|
|
1318
765
|
{
|
|
1319
766
|
"type": "null"
|
|
1320
767
|
}
|
|
1321
768
|
]
|
|
1322
769
|
},
|
|
770
|
+
"name": {
|
|
771
|
+
"description": "Option name: the key to set in optionValues.",
|
|
772
|
+
"type": "string"
|
|
773
|
+
},
|
|
1323
774
|
"type": {
|
|
1324
775
|
"enum": [
|
|
1325
|
-
"
|
|
776
|
+
"boolean",
|
|
777
|
+
"select",
|
|
1326
778
|
"number",
|
|
1327
|
-
"
|
|
779
|
+
"text",
|
|
780
|
+
"color",
|
|
781
|
+
"gradient"
|
|
1328
782
|
],
|
|
1329
783
|
"type": "string"
|
|
1330
784
|
}
|
|
@@ -1332,171 +786,86 @@
|
|
|
1332
786
|
"required": [
|
|
1333
787
|
"name",
|
|
1334
788
|
"label",
|
|
1335
|
-
"description",
|
|
1336
789
|
"type",
|
|
790
|
+
"group",
|
|
1337
791
|
"default",
|
|
1338
|
-
"
|
|
1339
|
-
"
|
|
1340
|
-
"
|
|
1341
|
-
"optionsFromDimension"
|
|
792
|
+
"choices",
|
|
793
|
+
"min",
|
|
794
|
+
"max"
|
|
1342
795
|
],
|
|
1343
796
|
"type": "object"
|
|
1344
797
|
},
|
|
1345
798
|
"type": "array"
|
|
1346
799
|
},
|
|
1347
|
-
"
|
|
800
|
+
"fields": {
|
|
801
|
+
"description": "Field slots to bind query fields to.",
|
|
1348
802
|
"items": {
|
|
1349
803
|
"additionalProperties": false,
|
|
1350
804
|
"properties": {
|
|
1351
|
-
"
|
|
1352
|
-
"
|
|
1353
|
-
|
|
1354
|
-
|
|
1355
|
-
|
|
805
|
+
"description": {
|
|
806
|
+
"anyOf": [
|
|
807
|
+
{
|
|
808
|
+
"type": "string"
|
|
809
|
+
},
|
|
810
|
+
{
|
|
811
|
+
"type": "null"
|
|
812
|
+
}
|
|
813
|
+
]
|
|
1356
814
|
},
|
|
1357
|
-
"
|
|
815
|
+
"label": {
|
|
1358
816
|
"type": "string"
|
|
1359
817
|
},
|
|
1360
|
-
"
|
|
818
|
+
"multiple": {
|
|
819
|
+
"description": "Whether the slot takes an ordered list.",
|
|
1361
820
|
"type": "boolean"
|
|
1362
821
|
},
|
|
1363
|
-
"
|
|
1364
|
-
|
|
822
|
+
"name": {
|
|
823
|
+
"description": "Slot name: the key to bind in fieldMapping.",
|
|
1365
824
|
"type": "string"
|
|
1366
825
|
},
|
|
1367
|
-
"
|
|
1368
|
-
"
|
|
1369
|
-
|
|
826
|
+
"required": {
|
|
827
|
+
"type": "boolean"
|
|
828
|
+
},
|
|
829
|
+
"type": {
|
|
830
|
+
"enum": [
|
|
831
|
+
"dimension",
|
|
832
|
+
"metric",
|
|
833
|
+
"series",
|
|
834
|
+
"column"
|
|
835
|
+
],
|
|
836
|
+
"type": "string"
|
|
1370
837
|
}
|
|
1371
838
|
},
|
|
1372
839
|
"required": [
|
|
1373
|
-
"
|
|
1374
|
-
"
|
|
1375
|
-
"
|
|
1376
|
-
"
|
|
1377
|
-
"
|
|
840
|
+
"name",
|
|
841
|
+
"label",
|
|
842
|
+
"type",
|
|
843
|
+
"required",
|
|
844
|
+
"multiple",
|
|
845
|
+
"description"
|
|
1378
846
|
],
|
|
1379
847
|
"type": "object"
|
|
1380
848
|
},
|
|
1381
849
|
"type": "array"
|
|
1382
850
|
},
|
|
1383
|
-
"
|
|
1384
|
-
"const": "found",
|
|
1385
|
-
"type": "string"
|
|
1386
|
-
}
|
|
1387
|
-
},
|
|
1388
|
-
"required": [
|
|
1389
|
-
"exploreId",
|
|
1390
|
-
"status",
|
|
1391
|
-
"label",
|
|
1392
|
-
"description",
|
|
1393
|
-
"hint",
|
|
1394
|
-
"baseTable",
|
|
1395
|
-
"joinedTables",
|
|
1396
|
-
"requiredFilters",
|
|
1397
|
-
"parameters",
|
|
1398
|
-
"baseDimensions",
|
|
1399
|
-
"baseMetrics"
|
|
1400
|
-
],
|
|
1401
|
-
"type": "object"
|
|
1402
|
-
},
|
|
1403
|
-
{
|
|
1404
|
-
"additionalProperties": false,
|
|
1405
|
-
"properties": {
|
|
1406
|
-
"error": {
|
|
1407
|
-
"type": "string"
|
|
1408
|
-
},
|
|
1409
|
-
"exploreId": {
|
|
1410
|
-
"type": "string"
|
|
1411
|
-
},
|
|
1412
|
-
"status": {
|
|
1413
|
-
"const": "not_found",
|
|
1414
|
-
"type": "string"
|
|
1415
|
-
}
|
|
1416
|
-
},
|
|
1417
|
-
"required": [
|
|
1418
|
-
"exploreId",
|
|
1419
|
-
"status",
|
|
1420
|
-
"error"
|
|
1421
|
-
],
|
|
1422
|
-
"type": "object"
|
|
1423
|
-
}
|
|
1424
|
-
]
|
|
1425
|
-
},
|
|
1426
|
-
"type": "array"
|
|
1427
|
-
},
|
|
1428
|
-
"fields": {
|
|
1429
|
-
"items": {
|
|
1430
|
-
"anyOf": [
|
|
1431
|
-
{
|
|
1432
|
-
"additionalProperties": false,
|
|
1433
|
-
"properties": {
|
|
1434
|
-
"caseSensitiveFilters": {
|
|
1435
|
-
"anyOf": [
|
|
1436
|
-
{
|
|
1437
|
-
"type": "boolean"
|
|
1438
|
-
},
|
|
1439
|
-
{
|
|
1440
|
-
"type": "null"
|
|
1441
|
-
}
|
|
1442
|
-
]
|
|
1443
|
-
},
|
|
1444
|
-
"defaultTimeDimension": {
|
|
1445
|
-
"anyOf": [
|
|
1446
|
-
{
|
|
1447
|
-
"type": "string"
|
|
1448
|
-
},
|
|
1449
|
-
{
|
|
1450
|
-
"type": "null"
|
|
1451
|
-
}
|
|
1452
|
-
]
|
|
1453
|
-
},
|
|
1454
|
-
"defaultTimeDimensionGranularity": {
|
|
1455
|
-
"anyOf": [
|
|
1456
|
-
{
|
|
1457
|
-
"type": "string"
|
|
1458
|
-
},
|
|
1459
|
-
{
|
|
1460
|
-
"type": "null"
|
|
1461
|
-
}
|
|
1462
|
-
]
|
|
1463
|
-
},
|
|
1464
|
-
"description": {
|
|
1465
|
-
"anyOf": [
|
|
1466
|
-
{
|
|
1467
|
-
"type": "string"
|
|
1468
|
-
},
|
|
1469
|
-
{
|
|
1470
|
-
"type": "null"
|
|
1471
|
-
}
|
|
1472
|
-
]
|
|
1473
|
-
},
|
|
1474
|
-
"exploreId": {
|
|
1475
|
-
"type": "string"
|
|
1476
|
-
},
|
|
1477
|
-
"fieldId": {
|
|
1478
|
-
"type": "string"
|
|
1479
|
-
},
|
|
1480
|
-
"fieldType": {
|
|
1481
|
-
"type": "string"
|
|
1482
|
-
},
|
|
1483
|
-
"filterType": {
|
|
1484
|
-
"type": "string"
|
|
1485
|
-
},
|
|
1486
|
-
"hint": {
|
|
851
|
+
"hierarchy": {
|
|
1487
852
|
"anyOf": [
|
|
1488
853
|
{
|
|
1489
|
-
"
|
|
854
|
+
"additionalProperties": false,
|
|
855
|
+
"properties": {
|
|
856
|
+
"field": {
|
|
857
|
+
"type": "string"
|
|
858
|
+
}
|
|
859
|
+
},
|
|
860
|
+
"required": ["field"],
|
|
861
|
+
"type": "object"
|
|
1490
862
|
},
|
|
1491
863
|
{
|
|
1492
864
|
"type": "null"
|
|
1493
865
|
}
|
|
1494
866
|
]
|
|
1495
867
|
},
|
|
1496
|
-
"
|
|
1497
|
-
"type": "boolean"
|
|
1498
|
-
},
|
|
1499
|
-
"joinedTableName": {
|
|
868
|
+
"inputGuidance": {
|
|
1500
869
|
"anyOf": [
|
|
1501
870
|
{
|
|
1502
871
|
"type": "string"
|
|
@@ -1505,283 +874,136 @@
|
|
|
1505
874
|
"type": "null"
|
|
1506
875
|
}
|
|
1507
876
|
]
|
|
1508
|
-
},
|
|
1509
|
-
"kind": {
|
|
1510
|
-
"enum": ["dimension", "metric"],
|
|
1511
|
-
"type": "string"
|
|
1512
|
-
},
|
|
1513
|
-
"label": {
|
|
1514
|
-
"type": "string"
|
|
1515
|
-
},
|
|
1516
|
-
"requiredParameters": {
|
|
1517
|
-
"items": {
|
|
1518
|
-
"type": "string"
|
|
1519
|
-
},
|
|
1520
|
-
"type": "array"
|
|
1521
|
-
},
|
|
1522
|
-
"status": {
|
|
1523
|
-
"const": "found",
|
|
1524
|
-
"type": "string"
|
|
1525
|
-
}
|
|
1526
|
-
},
|
|
1527
|
-
"required": [
|
|
1528
|
-
"exploreId",
|
|
1529
|
-
"fieldId",
|
|
1530
|
-
"status",
|
|
1531
|
-
"kind",
|
|
1532
|
-
"fieldType",
|
|
1533
|
-
"label",
|
|
1534
|
-
"filterType",
|
|
1535
|
-
"isFromJoinedTable",
|
|
1536
|
-
"joinedTableName",
|
|
1537
|
-
"caseSensitiveFilters",
|
|
1538
|
-
"defaultTimeDimension",
|
|
1539
|
-
"defaultTimeDimensionGranularity",
|
|
1540
|
-
"requiredParameters",
|
|
1541
|
-
"description",
|
|
1542
|
-
"hint"
|
|
1543
|
-
],
|
|
1544
|
-
"type": "object"
|
|
1545
|
-
},
|
|
1546
|
-
{
|
|
1547
|
-
"additionalProperties": false,
|
|
1548
|
-
"properties": {
|
|
1549
|
-
"error": {
|
|
1550
|
-
"type": "string"
|
|
1551
|
-
},
|
|
1552
|
-
"exploreId": {
|
|
1553
|
-
"type": "string"
|
|
1554
|
-
},
|
|
1555
|
-
"fieldId": {
|
|
1556
|
-
"type": "string"
|
|
1557
|
-
},
|
|
1558
|
-
"status": {
|
|
1559
|
-
"const": "not_found",
|
|
1560
|
-
"type": "string"
|
|
1561
877
|
}
|
|
1562
878
|
},
|
|
1563
879
|
"required": [
|
|
1564
|
-
"
|
|
1565
|
-
"
|
|
1566
|
-
"
|
|
1567
|
-
"
|
|
880
|
+
"fields",
|
|
881
|
+
"configOptions",
|
|
882
|
+
"colorPalette",
|
|
883
|
+
"hierarchy",
|
|
884
|
+
"inputGuidance"
|
|
1568
885
|
],
|
|
1569
886
|
"type": "object"
|
|
1570
887
|
}
|
|
1571
|
-
|
|
888
|
+
},
|
|
889
|
+
"required": [
|
|
890
|
+
"slug",
|
|
891
|
+
"name",
|
|
892
|
+
"description",
|
|
893
|
+
"version",
|
|
894
|
+
"chartStudioUrl",
|
|
895
|
+
"vizSchema"
|
|
896
|
+
],
|
|
897
|
+
"type": "object"
|
|
1572
898
|
},
|
|
1573
899
|
"type": "array"
|
|
1574
900
|
}
|
|
1575
901
|
},
|
|
1576
|
-
"required": ["
|
|
902
|
+
"required": ["results"],
|
|
1577
903
|
"type": "object"
|
|
1578
904
|
},
|
|
1579
|
-
"title": "
|
|
905
|
+
"title": "Find custom chart types"
|
|
1580
906
|
},
|
|
1581
907
|
{
|
|
1582
908
|
"annotations": {
|
|
1583
909
|
"destructiveHint": false,
|
|
1584
|
-
"idempotentHint":
|
|
910
|
+
"idempotentHint": false,
|
|
1585
911
|
"openWorldHint": false,
|
|
1586
|
-
"readOnlyHint":
|
|
912
|
+
"readOnlyHint": false
|
|
1587
913
|
},
|
|
1588
|
-
"description": "
|
|
914
|
+
"description": "Tool: generate_data_app\n\nPurpose:\nStart building a new data app: an interactive application generated from a brief on top of a Lightdash project's semantic layer. Each build produces one version of the app. Charts, dashboards, and other saved content have their own tools.\n\nImportant:\n- You name the app. The name fixes both the app's name and its slug at creation, and neither changes afterwards. A name already taken in the project gets a numeric suffix on the slug, so identify the app by the slug this call returns, never one you derived from the name.\n- The build runs in the background for several minutes. This call returns as soon as the build has started. Poll get_data_app_build_status with the returned slug every 15 seconds until its status is \"ready\", \"error\", or \"cancelled\". Call this tool once per request.\n- The app is created as the calling user's personal app: at the project root, in no space, visible only to them until they move it.\n- An agent-scoped session restricted to specific spaces cannot read a personal app. Call this tool and get_data_app_build_status without agentUuid to build and poll an app you own.\n- An unknown themeSlug fails before the build starts and lists the valid slugs. Call list_data_app_themes when the user names a theme, brand, or look.\n\nResponse shape (MCP CallToolResult):\n- content: [{ type: \"text\", text: \"<confirmation that the build started>\" }]\n- structuredContent: {\n slug: string, // the app's permanent slug; pass it to get_data_app_build_status\n version: number // the version of the app this build produces\n }\n\nErrors: an unknown themeSlug, dashboardSlug, or chartSlug returns an error and starts no build.\n",
|
|
1589
915
|
"inputSchema": {
|
|
1590
916
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1591
917
|
"properties": {
|
|
1592
|
-
"
|
|
1593
|
-
"description": "Async query UUID returned by the query tool.",
|
|
1594
|
-
"format": "uuid",
|
|
1595
|
-
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
|
|
1596
|
-
"type": "string"
|
|
1597
|
-
}
|
|
1598
|
-
},
|
|
1599
|
-
"required": ["queryUuid"],
|
|
1600
|
-
"type": "object"
|
|
1601
|
-
},
|
|
1602
|
-
"name": "get_query_result",
|
|
1603
|
-
"outputSchema": {
|
|
1604
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1605
|
-
"additionalProperties": false,
|
|
1606
|
-
"properties": {
|
|
1607
|
-
"result": {
|
|
918
|
+
"chartSlugs": {
|
|
1608
919
|
"anyOf": [
|
|
1609
920
|
{
|
|
1610
|
-
"
|
|
1611
|
-
|
|
1612
|
-
"heartbeatAt": {
|
|
1613
|
-
"description": "ISO timestamp for when Lightdash last checked this async query and confirmed it is still running.",
|
|
1614
|
-
"type": "string"
|
|
1615
|
-
},
|
|
1616
|
-
"nextPollAfterMs": {
|
|
1617
|
-
"description": "Suggested delay before polling get_query_result for this query.",
|
|
1618
|
-
"exclusiveMinimum": 0,
|
|
1619
|
-
"maximum": 9007199254740991,
|
|
1620
|
-
"type": "integer"
|
|
1621
|
-
},
|
|
1622
|
-
"queryUuid": {
|
|
1623
|
-
"description": "Async query UUID to pass to get_query_result when status is running.",
|
|
1624
|
-
"format": "uuid",
|
|
1625
|
-
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
|
|
1626
|
-
"type": "string"
|
|
1627
|
-
},
|
|
1628
|
-
"status": {
|
|
1629
|
-
"const": "running",
|
|
1630
|
-
"description": "Present when the query is still running and should be polled with get_query_result.",
|
|
1631
|
-
"type": "string"
|
|
1632
|
-
}
|
|
921
|
+
"items": {
|
|
922
|
+
"type": "string"
|
|
1633
923
|
},
|
|
1634
|
-
"
|
|
1635
|
-
"status",
|
|
1636
|
-
"queryUuid",
|
|
1637
|
-
"nextPollAfterMs",
|
|
1638
|
-
"heartbeatAt"
|
|
1639
|
-
],
|
|
1640
|
-
"type": "object"
|
|
924
|
+
"type": "array"
|
|
1641
925
|
},
|
|
1642
926
|
{
|
|
1643
|
-
"
|
|
1644
|
-
|
|
1645
|
-
|
|
1646
|
-
|
|
1647
|
-
|
|
1648
|
-
|
|
1649
|
-
|
|
1650
|
-
|
|
1651
|
-
|
|
1652
|
-
|
|
1653
|
-
"format": "uuid",
|
|
1654
|
-
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
|
|
1655
|
-
"type": "string"
|
|
1656
|
-
},
|
|
1657
|
-
"rowCount": {
|
|
1658
|
-
"description": "Total number of rows returned. May be less than the requested limit.",
|
|
1659
|
-
"maximum": 9007199254740991,
|
|
1660
|
-
"minimum": 0,
|
|
1661
|
-
"type": "integer"
|
|
1662
|
-
},
|
|
1663
|
-
"rows": {
|
|
1664
|
-
"description": "Result rows. Each row is an object keyed by column name. Values come from the warehouse as JSON-serializable primitives (numbers, strings, booleans, ISO date strings, or null).",
|
|
1665
|
-
"items": {
|
|
1666
|
-
"additionalProperties": {},
|
|
1667
|
-
"propertyNames": {
|
|
1668
|
-
"type": "string"
|
|
1669
|
-
},
|
|
1670
|
-
"type": "object"
|
|
1671
|
-
},
|
|
1672
|
-
"type": "array"
|
|
1673
|
-
},
|
|
1674
|
-
"sqlRunnerUrl": {
|
|
1675
|
-
"anyOf": [
|
|
1676
|
-
{
|
|
1677
|
-
"type": "string"
|
|
1678
|
-
},
|
|
1679
|
-
{
|
|
1680
|
-
"type": "null"
|
|
1681
|
-
}
|
|
1682
|
-
]
|
|
1683
|
-
},
|
|
1684
|
-
"status": {
|
|
1685
|
-
"const": "done",
|
|
1686
|
-
"type": "string"
|
|
1687
|
-
}
|
|
1688
|
-
},
|
|
1689
|
-
"required": [
|
|
1690
|
-
"status",
|
|
1691
|
-
"queryUuid",
|
|
1692
|
-
"sqlRunnerUrl",
|
|
1693
|
-
"rows",
|
|
1694
|
-
"columns",
|
|
1695
|
-
"rowCount"
|
|
1696
|
-
],
|
|
1697
|
-
"type": "object"
|
|
927
|
+
"type": "null"
|
|
928
|
+
}
|
|
929
|
+
],
|
|
930
|
+
"default": null,
|
|
931
|
+
"description": "Saved charts (slugs from findContent) whose queries the app is built on; the charts themselves stay unchanged. Omit when not building on saved charts."
|
|
932
|
+
},
|
|
933
|
+
"dashboardSlug": {
|
|
934
|
+
"anyOf": [
|
|
935
|
+
{
|
|
936
|
+
"type": "string"
|
|
1698
937
|
},
|
|
1699
938
|
{
|
|
1700
|
-
"
|
|
1701
|
-
|
|
1702
|
-
|
|
1703
|
-
|
|
1704
|
-
|
|
1705
|
-
|
|
1706
|
-
|
|
1707
|
-
|
|
1708
|
-
|
|
1709
|
-
|
|
1710
|
-
|
|
1711
|
-
|
|
1712
|
-
|
|
1713
|
-
|
|
1714
|
-
|
|
1715
|
-
|
|
1716
|
-
|
|
1717
|
-
|
|
1718
|
-
|
|
1719
|
-
"
|
|
1720
|
-
|
|
1721
|
-
|
|
1722
|
-
"type": "string"
|
|
1723
|
-
},
|
|
1724
|
-
"rows": {
|
|
1725
|
-
"items": {
|
|
1726
|
-
"additionalProperties": {},
|
|
1727
|
-
"propertyNames": {
|
|
1728
|
-
"type": "string"
|
|
1729
|
-
},
|
|
1730
|
-
"type": "object"
|
|
1731
|
-
},
|
|
1732
|
-
"type": "array"
|
|
1733
|
-
},
|
|
1734
|
-
"status": {
|
|
1735
|
-
"const": "done",
|
|
1736
|
-
"type": "string"
|
|
1737
|
-
}
|
|
1738
|
-
},
|
|
1739
|
-
"required": [
|
|
1740
|
-
"status",
|
|
1741
|
-
"queryUuid",
|
|
1742
|
-
"exploreUrl",
|
|
1743
|
-
"rows",
|
|
1744
|
-
"fields"
|
|
939
|
+
"type": "null"
|
|
940
|
+
}
|
|
941
|
+
],
|
|
942
|
+
"default": null,
|
|
943
|
+
"description": "Generate from an existing dashboard: its slug (from findContent). The app starts from the dashboard's layout and charts; the dashboard itself stays unchanged. Omit when not generating from a dashboard."
|
|
944
|
+
},
|
|
945
|
+
"name": {
|
|
946
|
+
"description": "Display name for the app: a headline-short title, in title case, naming what the app shows (\"Revenue Overview\"). The app's slug is derived from it at creation, so treat the name as final — it is not renamed later.",
|
|
947
|
+
"type": "string"
|
|
948
|
+
},
|
|
949
|
+
"prompt": {
|
|
950
|
+
"description": "A self-contained brief for the coding agent that builds the app: what the app shows, for whom, and how it behaves. The coding agent explores the semantic layer itself but sees neither this conversation nor its query results: when this thread has already settled the analysis, carry it over — for each visualization, its title, a one-line description, and a metric query line `[viz title][explore; metrics; dimensions; filters; sort]` — as queries, never pasted numbers, which would be hardcoded into the app.",
|
|
951
|
+
"type": "string"
|
|
952
|
+
},
|
|
953
|
+
"template": {
|
|
954
|
+
"anyOf": [
|
|
955
|
+
{
|
|
956
|
+
"enum": [
|
|
957
|
+
"dashboard",
|
|
958
|
+
"slideshow",
|
|
959
|
+
"pdf",
|
|
960
|
+
"custom"
|
|
1745
961
|
],
|
|
1746
|
-
"type": "
|
|
962
|
+
"type": "string"
|
|
1747
963
|
},
|
|
1748
964
|
{
|
|
1749
|
-
"
|
|
1750
|
-
"properties": {
|
|
1751
|
-
"error": {
|
|
1752
|
-
"anyOf": [
|
|
1753
|
-
{
|
|
1754
|
-
"type": "string"
|
|
1755
|
-
},
|
|
1756
|
-
{
|
|
1757
|
-
"type": "null"
|
|
1758
|
-
}
|
|
1759
|
-
]
|
|
1760
|
-
},
|
|
1761
|
-
"queryUuid": {
|
|
1762
|
-
"format": "uuid",
|
|
1763
|
-
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
|
|
1764
|
-
"type": "string"
|
|
1765
|
-
},
|
|
1766
|
-
"status": {
|
|
1767
|
-
"enum": [
|
|
1768
|
-
"error",
|
|
1769
|
-
"cancelled",
|
|
1770
|
-
"expired"
|
|
1771
|
-
],
|
|
1772
|
-
"type": "string"
|
|
1773
|
-
}
|
|
1774
|
-
},
|
|
1775
|
-
"required": ["status", "queryUuid", "error"],
|
|
1776
|
-
"type": "object"
|
|
965
|
+
"type": "null"
|
|
1777
966
|
}
|
|
1778
|
-
]
|
|
967
|
+
],
|
|
968
|
+
"default": null,
|
|
969
|
+
"description": "Starter template the builder would use: \"dashboard\" for a dashboard-style app, \"slideshow\" for a slide show, \"pdf\" for a PDF report, \"custom\" for anything else. Omit when the user did not ask for one."
|
|
970
|
+
},
|
|
971
|
+
"themeSlug": {
|
|
972
|
+
"anyOf": [
|
|
973
|
+
{
|
|
974
|
+
"type": "string"
|
|
975
|
+
},
|
|
976
|
+
{
|
|
977
|
+
"type": "null"
|
|
978
|
+
}
|
|
979
|
+
],
|
|
980
|
+
"default": null,
|
|
981
|
+
"description": "Organization theme to build the app with: its slug, from the attached context (\"Theme: <name> (slug: <slug>)\"). Omit when no theme is given — the organization default applies. An unknown slug returns an error listing the valid slugs and starts no build."
|
|
1779
982
|
}
|
|
1780
983
|
},
|
|
1781
|
-
"required": ["
|
|
984
|
+
"required": ["name", "prompt"],
|
|
1782
985
|
"type": "object"
|
|
1783
986
|
},
|
|
1784
|
-
"
|
|
987
|
+
"name": "generate_data_app",
|
|
988
|
+
"outputSchema": {
|
|
989
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
990
|
+
"additionalProperties": false,
|
|
991
|
+
"properties": {
|
|
992
|
+
"slug": {
|
|
993
|
+
"description": "The app's permanent slug. Poll get_data_app_build_status with it.",
|
|
994
|
+
"type": "string"
|
|
995
|
+
},
|
|
996
|
+
"version": {
|
|
997
|
+
"description": "The version of the app this build produces.",
|
|
998
|
+
"exclusiveMinimum": 0,
|
|
999
|
+
"maximum": 9007199254740991,
|
|
1000
|
+
"type": "integer"
|
|
1001
|
+
}
|
|
1002
|
+
},
|
|
1003
|
+
"required": ["slug", "version"],
|
|
1004
|
+
"type": "object"
|
|
1005
|
+
},
|
|
1006
|
+
"title": "Generate data app"
|
|
1785
1007
|
},
|
|
1786
1008
|
{
|
|
1787
1009
|
"annotations": {
|
|
@@ -1790,140 +1012,231 @@
|
|
|
1790
1012
|
"openWorldHint": false,
|
|
1791
1013
|
"readOnlyHint": true
|
|
1792
1014
|
},
|
|
1793
|
-
"description": "
|
|
1015
|
+
"description": "Generate deterministic base-36 hashes for input strings.",
|
|
1794
1016
|
"inputSchema": {
|
|
1795
1017
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1796
1018
|
"properties": {
|
|
1797
|
-
"
|
|
1798
|
-
"description": "
|
|
1799
|
-
"type": "string"
|
|
1800
|
-
},
|
|
1801
|
-
"patterns": {
|
|
1802
|
-
"description": "Up to 5 case-insensitive keyword patterns, run together in one call. Use `|` to OR synonyms and a space or `.*` between words to require all of them. Each is matched against field names, labels, descriptions, hints and tags.",
|
|
1019
|
+
"inputs": {
|
|
1020
|
+
"description": "Input strings to hash.",
|
|
1803
1021
|
"items": {
|
|
1804
|
-
"minLength": 1,
|
|
1805
1022
|
"type": "string"
|
|
1806
1023
|
},
|
|
1807
|
-
"maxItems":
|
|
1024
|
+
"maxItems": 20,
|
|
1808
1025
|
"minItems": 1,
|
|
1809
1026
|
"type": "array"
|
|
1810
1027
|
}
|
|
1811
1028
|
},
|
|
1812
|
-
"required": ["
|
|
1029
|
+
"required": ["inputs"],
|
|
1813
1030
|
"type": "object"
|
|
1814
1031
|
},
|
|
1815
|
-
"name": "
|
|
1032
|
+
"name": "generate_hashes",
|
|
1816
1033
|
"outputSchema": {
|
|
1817
1034
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1818
1035
|
"additionalProperties": false,
|
|
1819
1036
|
"properties": {
|
|
1820
|
-
"
|
|
1821
|
-
"description": "
|
|
1822
|
-
"type": "string"
|
|
1823
|
-
},
|
|
1824
|
-
"exploreName": {
|
|
1825
|
-
"anyOf": [
|
|
1826
|
-
{
|
|
1827
|
-
"type": "string"
|
|
1828
|
-
},
|
|
1829
|
-
{
|
|
1830
|
-
"type": "null"
|
|
1831
|
-
}
|
|
1832
|
-
],
|
|
1833
|
-
"description": "The explore the grep was scoped to, or null for all."
|
|
1834
|
-
},
|
|
1835
|
-
"fuzzyMatches": {
|
|
1836
|
-
"description": "Catalog-search near matches not already surfaced by the grep.",
|
|
1037
|
+
"hashes": {
|
|
1038
|
+
"description": "Base-36 hashes in the same order as the input strings.",
|
|
1837
1039
|
"items": {
|
|
1838
|
-
"
|
|
1839
|
-
"
|
|
1840
|
-
|
|
1841
|
-
|
|
1842
|
-
|
|
1843
|
-
|
|
1844
|
-
|
|
1845
|
-
|
|
1846
|
-
|
|
1847
|
-
|
|
1848
|
-
|
|
1849
|
-
|
|
1850
|
-
|
|
1851
|
-
|
|
1852
|
-
|
|
1853
|
-
|
|
1854
|
-
|
|
1855
|
-
|
|
1856
|
-
|
|
1857
|
-
|
|
1858
|
-
|
|
1859
|
-
|
|
1860
|
-
|
|
1861
|
-
|
|
1862
|
-
|
|
1863
|
-
|
|
1864
|
-
|
|
1865
|
-
|
|
1866
|
-
|
|
1867
|
-
|
|
1868
|
-
|
|
1869
|
-
|
|
1870
|
-
|
|
1871
|
-
|
|
1040
|
+
"pattern": "^[0-9a-z]{6}$",
|
|
1041
|
+
"type": "string"
|
|
1042
|
+
},
|
|
1043
|
+
"type": "array"
|
|
1044
|
+
}
|
|
1045
|
+
},
|
|
1046
|
+
"required": ["hashes"],
|
|
1047
|
+
"type": "object"
|
|
1048
|
+
},
|
|
1049
|
+
"title": "Generate hashes"
|
|
1050
|
+
},
|
|
1051
|
+
{
|
|
1052
|
+
"annotations": {
|
|
1053
|
+
"destructiveHint": false,
|
|
1054
|
+
"idempotentHint": true,
|
|
1055
|
+
"openWorldHint": false,
|
|
1056
|
+
"readOnlyHint": true
|
|
1057
|
+
},
|
|
1058
|
+
"description": "Tool: get_ai_writeback_status\n\nPurpose:\nCheck the status of a writeback run started by run_ai_writeback, and get the pull request URL once it's ready.\n\nImportant:\n- Poll every 10-15 seconds rather than immediately looping — a run typically takes a few minutes.\n- \"status\" is either \"pending\" (not yet picked up), an in-progress pipeline stage (e.g. \"sandbox\", \"agent\", \"pull_request\"), or a terminal value: \"ready\" (finished — check prUrl), \"error\" (finished — check errorMessage; this also covers the \"more than one dbt source\" case described in run_ai_writeback), or \"cancelled\" (stopped before finishing).\n\nParameters:\n- aiWritebackRunUuid: The id returned by run_ai_writeback.\n\nResponse shape (MCP CallToolResult):\n- content: [{ type: \"text\", text: \"<human-readable status summary>\" }]\n- structuredContent: {\n status: string, // \"pending\" | a pipeline stage | \"ready\" | \"error\" | \"cancelled\"\n prUrl: string | null, // set once status is \"ready\" and a PR was opened\n errorMessage: string | null // set once status is \"error\"\n }\n",
|
|
1059
|
+
"inputSchema": {
|
|
1060
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1061
|
+
"properties": {
|
|
1062
|
+
"aiWritebackRunUuid": {
|
|
1063
|
+
"description": "The id returned by run_ai_writeback.",
|
|
1064
|
+
"format": "uuid",
|
|
1065
|
+
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
|
|
1066
|
+
"type": "string"
|
|
1067
|
+
}
|
|
1068
|
+
},
|
|
1069
|
+
"required": ["aiWritebackRunUuid"],
|
|
1070
|
+
"type": "object"
|
|
1071
|
+
},
|
|
1072
|
+
"name": "get_ai_writeback_status",
|
|
1073
|
+
"outputSchema": {
|
|
1074
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1075
|
+
"additionalProperties": false,
|
|
1076
|
+
"properties": {
|
|
1077
|
+
"errorMessage": {
|
|
1078
|
+
"anyOf": [
|
|
1079
|
+
{
|
|
1080
|
+
"type": "string"
|
|
1081
|
+
},
|
|
1082
|
+
{
|
|
1083
|
+
"type": "null"
|
|
1084
|
+
}
|
|
1085
|
+
],
|
|
1086
|
+
"description": "Set once status is \"error\"; null otherwise."
|
|
1087
|
+
},
|
|
1088
|
+
"prUrl": {
|
|
1089
|
+
"anyOf": [
|
|
1090
|
+
{
|
|
1091
|
+
"type": "string"
|
|
1092
|
+
},
|
|
1093
|
+
{
|
|
1094
|
+
"type": "null"
|
|
1095
|
+
}
|
|
1096
|
+
],
|
|
1097
|
+
"description": "URL of the pull request opened from the agent changes, set once status is \"ready\"; null if the agent made no file changes or the run has not finished yet."
|
|
1098
|
+
},
|
|
1099
|
+
"status": {
|
|
1100
|
+
"description": "\"pending\" | a pipeline stage (e.g. \"sandbox\", \"agent\", \"pull_request\") | \"ready\" | \"error\" | \"cancelled\".",
|
|
1101
|
+
"type": "string"
|
|
1102
|
+
}
|
|
1103
|
+
},
|
|
1104
|
+
"required": ["status", "prUrl", "errorMessage"],
|
|
1105
|
+
"type": "object"
|
|
1106
|
+
},
|
|
1107
|
+
"title": "Get AI writeback status"
|
|
1108
|
+
},
|
|
1109
|
+
{
|
|
1110
|
+
"annotations": {
|
|
1111
|
+
"destructiveHint": false,
|
|
1112
|
+
"idempotentHint": true,
|
|
1113
|
+
"openWorldHint": false,
|
|
1114
|
+
"readOnlyHint": true
|
|
1115
|
+
},
|
|
1116
|
+
"description": "Call this first to discover available projects, the agents you can access in each project, and Lightdash-configured context. Pass the selected projectUuid to every project-scoped tool call. When agent-specific scope is useful and routing is available, use route_agent and pass its returned agentUuid explicitly. If routing is unavailable or full project scope is desired, omit agentUuid; use set_agent for manual selection. This tool reports context but does not establish implicit execution state. When the session is pinned to a project, activeProject is the only allowed project. Otherwise it is a stored default, not a restriction on projectUuid. Use the project the user requested; if none was specified, use activeProject if present or ask. If the requested project is unavailable or rejected, explain rather than substitute another project.",
|
|
1117
|
+
"inputSchema": {
|
|
1118
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1119
|
+
"properties": {},
|
|
1120
|
+
"type": "object"
|
|
1121
|
+
},
|
|
1122
|
+
"name": "get_context",
|
|
1123
|
+
"outputSchema": {
|
|
1124
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1125
|
+
"additionalProperties": false,
|
|
1126
|
+
"properties": {
|
|
1127
|
+
"activeAgent": {
|
|
1128
|
+
"anyOf": [
|
|
1129
|
+
{
|
|
1130
|
+
"additionalProperties": false,
|
|
1131
|
+
"properties": {
|
|
1132
|
+
"agentName": {
|
|
1133
|
+
"type": "string"
|
|
1134
|
+
},
|
|
1135
|
+
"agentUuid": {
|
|
1136
|
+
"type": "string"
|
|
1137
|
+
},
|
|
1138
|
+
"projectUuid": {
|
|
1139
|
+
"type": "string"
|
|
1140
|
+
}
|
|
1872
1141
|
},
|
|
1873
|
-
"
|
|
1874
|
-
"
|
|
1142
|
+
"required": [
|
|
1143
|
+
"agentUuid",
|
|
1144
|
+
"agentName",
|
|
1145
|
+
"projectUuid"
|
|
1146
|
+
],
|
|
1147
|
+
"type": "object"
|
|
1148
|
+
},
|
|
1149
|
+
{
|
|
1150
|
+
"type": "null"
|
|
1151
|
+
}
|
|
1152
|
+
]
|
|
1153
|
+
},
|
|
1154
|
+
"activeProject": {
|
|
1155
|
+
"anyOf": [
|
|
1156
|
+
{
|
|
1157
|
+
"additionalProperties": false,
|
|
1158
|
+
"properties": {
|
|
1159
|
+
"projectName": {
|
|
1160
|
+
"type": "string"
|
|
1161
|
+
},
|
|
1162
|
+
"projectUuid": {
|
|
1163
|
+
"type": "string"
|
|
1164
|
+
},
|
|
1165
|
+
"selectedTags": {
|
|
1166
|
+
"anyOf": [
|
|
1167
|
+
{
|
|
1168
|
+
"items": {
|
|
1169
|
+
"type": "string"
|
|
1170
|
+
},
|
|
1171
|
+
"type": "array"
|
|
1172
|
+
},
|
|
1173
|
+
{
|
|
1174
|
+
"type": "null"
|
|
1175
|
+
}
|
|
1176
|
+
]
|
|
1177
|
+
}
|
|
1875
1178
|
},
|
|
1876
|
-
"
|
|
1877
|
-
"
|
|
1878
|
-
|
|
1179
|
+
"required": [
|
|
1180
|
+
"projectUuid",
|
|
1181
|
+
"projectName",
|
|
1182
|
+
"selectedTags"
|
|
1183
|
+
],
|
|
1184
|
+
"type": "object"
|
|
1879
1185
|
},
|
|
1880
|
-
|
|
1881
|
-
"
|
|
1882
|
-
|
|
1883
|
-
|
|
1884
|
-
"fieldType",
|
|
1885
|
-
"description",
|
|
1886
|
-
"searchRank",
|
|
1887
|
-
"usageInCharts",
|
|
1888
|
-
"usageInVerifiedCharts"
|
|
1889
|
-
],
|
|
1890
|
-
"type": "object"
|
|
1891
|
-
},
|
|
1892
|
-
"type": "array"
|
|
1186
|
+
{
|
|
1187
|
+
"type": "null"
|
|
1188
|
+
}
|
|
1189
|
+
]
|
|
1893
1190
|
},
|
|
1894
|
-
"
|
|
1895
|
-
"description": "One entry per input pattern, in input order.",
|
|
1191
|
+
"availableProjects": {
|
|
1896
1192
|
"items": {
|
|
1897
1193
|
"additionalProperties": false,
|
|
1898
1194
|
"properties": {
|
|
1899
|
-
"
|
|
1900
|
-
"description": "Fields matched before the display cap.",
|
|
1901
|
-
"type": "number"
|
|
1902
|
-
},
|
|
1903
|
-
"matchedAllFields": {
|
|
1904
|
-
"type": "boolean"
|
|
1905
|
-
},
|
|
1906
|
-
"matchingExploresByName": {
|
|
1907
|
-
"description": "Explores whose own name/label/hint matched but had no field matches.",
|
|
1195
|
+
"availableAgents": {
|
|
1908
1196
|
"items": {
|
|
1909
1197
|
"additionalProperties": false,
|
|
1910
1198
|
"properties": {
|
|
1911
|
-
"
|
|
1199
|
+
"agentUuid": {
|
|
1912
1200
|
"type": "string"
|
|
1913
1201
|
},
|
|
1914
|
-
"
|
|
1202
|
+
"description": {
|
|
1203
|
+
"anyOf": [
|
|
1204
|
+
{
|
|
1205
|
+
"type": "string"
|
|
1206
|
+
},
|
|
1207
|
+
{
|
|
1208
|
+
"type": "null"
|
|
1209
|
+
}
|
|
1210
|
+
]
|
|
1211
|
+
},
|
|
1212
|
+
"name": {
|
|
1915
1213
|
"type": "string"
|
|
1214
|
+
},
|
|
1215
|
+
"tags": {
|
|
1216
|
+
"anyOf": [
|
|
1217
|
+
{
|
|
1218
|
+
"items": {
|
|
1219
|
+
"type": "string"
|
|
1220
|
+
},
|
|
1221
|
+
"type": "array"
|
|
1222
|
+
},
|
|
1223
|
+
{
|
|
1224
|
+
"type": "null"
|
|
1225
|
+
}
|
|
1226
|
+
]
|
|
1916
1227
|
}
|
|
1917
1228
|
},
|
|
1918
1229
|
"required": [
|
|
1919
|
-
"
|
|
1920
|
-
"
|
|
1230
|
+
"agentUuid",
|
|
1231
|
+
"name",
|
|
1232
|
+
"description",
|
|
1233
|
+
"tags"
|
|
1921
1234
|
],
|
|
1922
1235
|
"type": "object"
|
|
1923
1236
|
},
|
|
1924
1237
|
"type": "array"
|
|
1925
1238
|
},
|
|
1926
|
-
"
|
|
1239
|
+
"expiresAt": {
|
|
1927
1240
|
"anyOf": [
|
|
1928
1241
|
{
|
|
1929
1242
|
"type": "string"
|
|
@@ -1931,29 +1244,1072 @@
|
|
|
1931
1244
|
{
|
|
1932
1245
|
"type": "null"
|
|
1933
1246
|
}
|
|
1934
|
-
]
|
|
1935
|
-
"description": "Warning when similarly named metrics could be confused."
|
|
1247
|
+
]
|
|
1936
1248
|
},
|
|
1937
|
-
"
|
|
1938
|
-
"description": "The per-pattern summary line.",
|
|
1249
|
+
"name": {
|
|
1939
1250
|
"type": "string"
|
|
1940
1251
|
},
|
|
1941
|
-
"
|
|
1252
|
+
"projectUuid": {
|
|
1942
1253
|
"type": "string"
|
|
1943
1254
|
},
|
|
1944
|
-
"
|
|
1945
|
-
"
|
|
1946
|
-
|
|
1947
|
-
|
|
1948
|
-
|
|
1949
|
-
|
|
1950
|
-
|
|
1951
|
-
|
|
1952
|
-
|
|
1953
|
-
|
|
1954
|
-
|
|
1955
|
-
|
|
1956
|
-
|
|
1255
|
+
"type": {
|
|
1256
|
+
"type": "string"
|
|
1257
|
+
}
|
|
1258
|
+
},
|
|
1259
|
+
"required": [
|
|
1260
|
+
"projectUuid",
|
|
1261
|
+
"name",
|
|
1262
|
+
"type",
|
|
1263
|
+
"expiresAt",
|
|
1264
|
+
"availableAgents"
|
|
1265
|
+
],
|
|
1266
|
+
"type": "object"
|
|
1267
|
+
},
|
|
1268
|
+
"type": "array"
|
|
1269
|
+
}
|
|
1270
|
+
},
|
|
1271
|
+
"required": [
|
|
1272
|
+
"activeProject",
|
|
1273
|
+
"activeAgent",
|
|
1274
|
+
"availableProjects"
|
|
1275
|
+
],
|
|
1276
|
+
"type": "object"
|
|
1277
|
+
},
|
|
1278
|
+
"title": "Get context"
|
|
1279
|
+
},
|
|
1280
|
+
{
|
|
1281
|
+
"annotations": {
|
|
1282
|
+
"destructiveHint": false,
|
|
1283
|
+
"idempotentHint": true,
|
|
1284
|
+
"openWorldHint": false,
|
|
1285
|
+
"readOnlyHint": true
|
|
1286
|
+
},
|
|
1287
|
+
"description": "@deprecated Use get_context for legacy configured context or route_agent for an explicit agent selection.",
|
|
1288
|
+
"inputSchema": {
|
|
1289
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1290
|
+
"properties": {},
|
|
1291
|
+
"type": "object"
|
|
1292
|
+
},
|
|
1293
|
+
"name": "get_current_agent",
|
|
1294
|
+
"outputSchema": null,
|
|
1295
|
+
"title": "Get current agent (deprecated)"
|
|
1296
|
+
},
|
|
1297
|
+
{
|
|
1298
|
+
"annotations": {
|
|
1299
|
+
"destructiveHint": false,
|
|
1300
|
+
"idempotentHint": true,
|
|
1301
|
+
"openWorldHint": false,
|
|
1302
|
+
"readOnlyHint": true
|
|
1303
|
+
},
|
|
1304
|
+
"description": "@deprecated Use get_context instead. Returns legacy shared project context for older clients.",
|
|
1305
|
+
"inputSchema": {
|
|
1306
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1307
|
+
"properties": {},
|
|
1308
|
+
"type": "object"
|
|
1309
|
+
},
|
|
1310
|
+
"name": "get_current_project",
|
|
1311
|
+
"outputSchema": null,
|
|
1312
|
+
"title": "Get current project (deprecated)"
|
|
1313
|
+
},
|
|
1314
|
+
{
|
|
1315
|
+
"annotations": {
|
|
1316
|
+
"destructiveHint": false,
|
|
1317
|
+
"idempotentHint": true,
|
|
1318
|
+
"openWorldHint": false,
|
|
1319
|
+
"readOnlyHint": true
|
|
1320
|
+
},
|
|
1321
|
+
"description": "Tool: get_data_app_build_status\n\nPurpose:\nCheck how a data app build is going, and get the app's URL once it is ready. A data app is an interactive application generated from a brief on top of a Lightdash project's semantic layer; each build produces one version of it.\n\nImportant:\n- Poll every 15 seconds — \"nextPollAfterMs\" in the response carries the same number in milliseconds. A build usually takes several minutes.\n- Stop polling once \"status\" is \"ready\", \"error\", or \"cancelled\". Those are terminal; the version never changes again.\n- \"slug\" is the app's permanent identifier and never changes, even when the app is renamed. Keep using the slug you started the build with.\n- An agent-scoped session restricted to specific spaces cannot read a personal app, which is what a build started over MCP creates. Call this tool without agentUuid to poll a build you started.\n\nParameters:\n- appSlug: The app's slug, as returned when the build started.\n- version: Which version of the app to report on. Omit it for the latest version, which is the one a build you just started produces.\n\nResponse shape (MCP CallToolResult):\n- content: [{ type: \"text\", text: \"<human-readable status summary>\" }]\n- structuredContent: {\n status: string, // \"pending\" | \"sandbox\" | \"catalog\" | \"generating\" | \"building\" | \"packaging\" | \"ready\" | \"error\" | \"cancelled\"\n statusMessage: string, // short line describing what the build is doing, or how it ended\n errorMessage: string | null, // why the build failed, set only when status is \"error\"\n name: string, // the app's name\n slug: string, // the app's permanent slug\n href: string, // URL to open the app in Lightdash; Chart Studio for a custom chart type\n nextPollAfterMs: number // how long to wait before polling again\n }\n\nErrors: an unknown slug, or an app or version this caller may not view, returns an error rather than a status.\n",
|
|
1322
|
+
"inputSchema": {
|
|
1323
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1324
|
+
"properties": {
|
|
1325
|
+
"appSlug": {
|
|
1326
|
+
"description": "The data app's slug, as returned when the build started.",
|
|
1327
|
+
"minLength": 1,
|
|
1328
|
+
"type": "string"
|
|
1329
|
+
},
|
|
1330
|
+
"version": {
|
|
1331
|
+
"description": "Which version of the app to report on. Omit for the latest version — the one a build you just started produces.",
|
|
1332
|
+
"exclusiveMinimum": 0,
|
|
1333
|
+
"maximum": 9007199254740991,
|
|
1334
|
+
"type": "integer"
|
|
1335
|
+
}
|
|
1336
|
+
},
|
|
1337
|
+
"required": ["appSlug"],
|
|
1338
|
+
"type": "object"
|
|
1339
|
+
},
|
|
1340
|
+
"name": "get_data_app_build_status",
|
|
1341
|
+
"outputSchema": {
|
|
1342
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1343
|
+
"additionalProperties": false,
|
|
1344
|
+
"properties": {
|
|
1345
|
+
"errorMessage": {
|
|
1346
|
+
"anyOf": [
|
|
1347
|
+
{
|
|
1348
|
+
"type": "string"
|
|
1349
|
+
},
|
|
1350
|
+
{
|
|
1351
|
+
"type": "null"
|
|
1352
|
+
}
|
|
1353
|
+
],
|
|
1354
|
+
"description": "Why the build failed. Set only when status is \"error\"."
|
|
1355
|
+
},
|
|
1356
|
+
"href": {
|
|
1357
|
+
"description": "URL that opens the app, or Chart Studio for a custom chart type.",
|
|
1358
|
+
"type": "string"
|
|
1359
|
+
},
|
|
1360
|
+
"name": {
|
|
1361
|
+
"description": "The app's name.",
|
|
1362
|
+
"type": "string"
|
|
1363
|
+
},
|
|
1364
|
+
"nextPollAfterMs": {
|
|
1365
|
+
"description": "How long to wait before polling again. Stop polling on a terminal status.",
|
|
1366
|
+
"exclusiveMinimum": 0,
|
|
1367
|
+
"maximum": 9007199254740991,
|
|
1368
|
+
"type": "integer"
|
|
1369
|
+
},
|
|
1370
|
+
"slug": {
|
|
1371
|
+
"description": "The app's permanent slug; it never changes.",
|
|
1372
|
+
"type": "string"
|
|
1373
|
+
},
|
|
1374
|
+
"status": {
|
|
1375
|
+
"description": "Pipeline stage the build has reached, or a terminal outcome: \"ready\", \"error\", or \"cancelled\".",
|
|
1376
|
+
"enum": [
|
|
1377
|
+
"pending",
|
|
1378
|
+
"sandbox",
|
|
1379
|
+
"catalog",
|
|
1380
|
+
"compact",
|
|
1381
|
+
"generating",
|
|
1382
|
+
"building",
|
|
1383
|
+
"packaging",
|
|
1384
|
+
"ready",
|
|
1385
|
+
"error",
|
|
1386
|
+
"cancelled"
|
|
1387
|
+
],
|
|
1388
|
+
"type": "string"
|
|
1389
|
+
},
|
|
1390
|
+
"statusMessage": {
|
|
1391
|
+
"description": "Short line describing what the build is doing, or how it ended.",
|
|
1392
|
+
"type": "string"
|
|
1393
|
+
}
|
|
1394
|
+
},
|
|
1395
|
+
"required": [
|
|
1396
|
+
"status",
|
|
1397
|
+
"statusMessage",
|
|
1398
|
+
"errorMessage",
|
|
1399
|
+
"name",
|
|
1400
|
+
"slug",
|
|
1401
|
+
"href",
|
|
1402
|
+
"nextPollAfterMs"
|
|
1403
|
+
],
|
|
1404
|
+
"type": "object"
|
|
1405
|
+
},
|
|
1406
|
+
"title": "Get data app build status"
|
|
1407
|
+
},
|
|
1408
|
+
{
|
|
1409
|
+
"annotations": {
|
|
1410
|
+
"destructiveHint": false,
|
|
1411
|
+
"idempotentHint": true,
|
|
1412
|
+
"openWorldHint": false,
|
|
1413
|
+
"readOnlyHint": true
|
|
1414
|
+
},
|
|
1415
|
+
"description": "Get the current Lightdash version",
|
|
1416
|
+
"inputSchema": {
|
|
1417
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1418
|
+
"properties": {},
|
|
1419
|
+
"type": "object"
|
|
1420
|
+
},
|
|
1421
|
+
"name": "get_lightdash_version",
|
|
1422
|
+
"outputSchema": null,
|
|
1423
|
+
"title": "Get Lightdash version"
|
|
1424
|
+
},
|
|
1425
|
+
{
|
|
1426
|
+
"annotations": {
|
|
1427
|
+
"destructiveHint": false,
|
|
1428
|
+
"idempotentHint": true,
|
|
1429
|
+
"openWorldHint": false,
|
|
1430
|
+
"readOnlyHint": true
|
|
1431
|
+
},
|
|
1432
|
+
"description": "Tool: get_metadata\n\nPurpose:\nGet the full metadata for specific explores and/or fields that you already know the IDs of (typically from grep_fields). grep_fields is lean — it tells you WHICH fields exist; get_metadata gives you the DETAIL you need to build a correct query: an explore's joined tables, table filters, required filters, and parameters, and a field's filter type, case-sensitivity, resolved default time dimension, parameter dependencies, hints, and whether it comes from a joined table. A field marked with required parameters returns different results depending on the parameter values the query runs with — unset parameters resolve to their default.\n\nCall this AFTER grep_fields, once you have narrowed down to the explore(s) and field(s) you intend to use, and BEFORE render_chart. You can ask for several explores and several fields across explores in a SINGLE call — batch everything you need at once instead of one request per item.\n\nEach entry in `requests` is one of:\n- `{ \"type\": \"explore\", \"exploreIds\": [\"orders\", \"customers\"] }` — full metadata for those explores (joined tables, table filters, field counts).\n- `{ \"type\": \"field\", \"fields\": [{ \"exploreId\": \"orders\", \"fieldId\": \"orders_status\" }] }` — full metadata for those specific fields.\n",
|
|
1433
|
+
"inputSchema": {
|
|
1434
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1435
|
+
"properties": {
|
|
1436
|
+
"requests": {
|
|
1437
|
+
"description": "A batch of explore and/or field metadata requests, resolved together in one call.",
|
|
1438
|
+
"items": {
|
|
1439
|
+
"anyOf": [
|
|
1440
|
+
{
|
|
1441
|
+
"properties": {
|
|
1442
|
+
"exploreIds": {
|
|
1443
|
+
"description": "Explore IDs (names) to fetch full metadata for.",
|
|
1444
|
+
"items": {
|
|
1445
|
+
"minLength": 1,
|
|
1446
|
+
"type": "string"
|
|
1447
|
+
},
|
|
1448
|
+
"minItems": 1,
|
|
1449
|
+
"type": "array"
|
|
1450
|
+
},
|
|
1451
|
+
"type": {
|
|
1452
|
+
"const": "explore",
|
|
1453
|
+
"type": "string"
|
|
1454
|
+
}
|
|
1455
|
+
},
|
|
1456
|
+
"required": ["type", "exploreIds"],
|
|
1457
|
+
"type": "object"
|
|
1458
|
+
},
|
|
1459
|
+
{
|
|
1460
|
+
"properties": {
|
|
1461
|
+
"fields": {
|
|
1462
|
+
"description": "Specific fields to fetch full metadata for.",
|
|
1463
|
+
"items": {
|
|
1464
|
+
"properties": {
|
|
1465
|
+
"exploreId": {
|
|
1466
|
+
"description": "The explore the field belongs to.",
|
|
1467
|
+
"minLength": 1,
|
|
1468
|
+
"type": "string"
|
|
1469
|
+
},
|
|
1470
|
+
"fieldId": {
|
|
1471
|
+
"description": "The fieldId, e.g. `orders_status`.",
|
|
1472
|
+
"minLength": 1,
|
|
1473
|
+
"type": "string"
|
|
1474
|
+
}
|
|
1475
|
+
},
|
|
1476
|
+
"required": [
|
|
1477
|
+
"exploreId",
|
|
1478
|
+
"fieldId"
|
|
1479
|
+
],
|
|
1480
|
+
"type": "object"
|
|
1481
|
+
},
|
|
1482
|
+
"minItems": 1,
|
|
1483
|
+
"type": "array"
|
|
1484
|
+
},
|
|
1485
|
+
"type": {
|
|
1486
|
+
"const": "field",
|
|
1487
|
+
"type": "string"
|
|
1488
|
+
}
|
|
1489
|
+
},
|
|
1490
|
+
"required": ["type", "fields"],
|
|
1491
|
+
"type": "object"
|
|
1492
|
+
}
|
|
1493
|
+
]
|
|
1494
|
+
},
|
|
1495
|
+
"maxItems": 20,
|
|
1496
|
+
"minItems": 1,
|
|
1497
|
+
"type": "array"
|
|
1498
|
+
}
|
|
1499
|
+
},
|
|
1500
|
+
"required": ["requests"],
|
|
1501
|
+
"type": "object"
|
|
1502
|
+
},
|
|
1503
|
+
"name": "get_metadata",
|
|
1504
|
+
"outputSchema": {
|
|
1505
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1506
|
+
"additionalProperties": false,
|
|
1507
|
+
"properties": {
|
|
1508
|
+
"explores": {
|
|
1509
|
+
"items": {
|
|
1510
|
+
"anyOf": [
|
|
1511
|
+
{
|
|
1512
|
+
"additionalProperties": false,
|
|
1513
|
+
"properties": {
|
|
1514
|
+
"baseDimensions": {
|
|
1515
|
+
"additionalProperties": false,
|
|
1516
|
+
"properties": {
|
|
1517
|
+
"count": {
|
|
1518
|
+
"type": "number"
|
|
1519
|
+
},
|
|
1520
|
+
"fieldIds": {
|
|
1521
|
+
"items": {
|
|
1522
|
+
"type": "string"
|
|
1523
|
+
},
|
|
1524
|
+
"type": "array"
|
|
1525
|
+
}
|
|
1526
|
+
},
|
|
1527
|
+
"required": ["count", "fieldIds"],
|
|
1528
|
+
"type": "object"
|
|
1529
|
+
},
|
|
1530
|
+
"baseMetrics": {
|
|
1531
|
+
"additionalProperties": false,
|
|
1532
|
+
"properties": {
|
|
1533
|
+
"count": {
|
|
1534
|
+
"type": "number"
|
|
1535
|
+
},
|
|
1536
|
+
"fieldIds": {
|
|
1537
|
+
"items": {
|
|
1538
|
+
"type": "string"
|
|
1539
|
+
},
|
|
1540
|
+
"type": "array"
|
|
1541
|
+
}
|
|
1542
|
+
},
|
|
1543
|
+
"required": ["count", "fieldIds"],
|
|
1544
|
+
"type": "object"
|
|
1545
|
+
},
|
|
1546
|
+
"baseTable": {
|
|
1547
|
+
"type": "string"
|
|
1548
|
+
},
|
|
1549
|
+
"description": {
|
|
1550
|
+
"anyOf": [
|
|
1551
|
+
{
|
|
1552
|
+
"type": "string"
|
|
1553
|
+
},
|
|
1554
|
+
{
|
|
1555
|
+
"type": "null"
|
|
1556
|
+
}
|
|
1557
|
+
]
|
|
1558
|
+
},
|
|
1559
|
+
"exploreId": {
|
|
1560
|
+
"type": "string"
|
|
1561
|
+
},
|
|
1562
|
+
"hint": {
|
|
1563
|
+
"anyOf": [
|
|
1564
|
+
{
|
|
1565
|
+
"type": "string"
|
|
1566
|
+
},
|
|
1567
|
+
{
|
|
1568
|
+
"type": "null"
|
|
1569
|
+
}
|
|
1570
|
+
]
|
|
1571
|
+
},
|
|
1572
|
+
"joinedTables": {
|
|
1573
|
+
"items": {
|
|
1574
|
+
"type": "string"
|
|
1575
|
+
},
|
|
1576
|
+
"type": "array"
|
|
1577
|
+
},
|
|
1578
|
+
"label": {
|
|
1579
|
+
"type": "string"
|
|
1580
|
+
},
|
|
1581
|
+
"parameters": {
|
|
1582
|
+
"items": {
|
|
1583
|
+
"additionalProperties": false,
|
|
1584
|
+
"properties": {
|
|
1585
|
+
"allowCustomValues": {
|
|
1586
|
+
"type": "boolean"
|
|
1587
|
+
},
|
|
1588
|
+
"default": {
|
|
1589
|
+
"anyOf": [
|
|
1590
|
+
{
|
|
1591
|
+
"anyOf": [
|
|
1592
|
+
{
|
|
1593
|
+
"type": "string"
|
|
1594
|
+
},
|
|
1595
|
+
{
|
|
1596
|
+
"type": "number"
|
|
1597
|
+
},
|
|
1598
|
+
{
|
|
1599
|
+
"items": {
|
|
1600
|
+
"type": "string"
|
|
1601
|
+
},
|
|
1602
|
+
"type": "array"
|
|
1603
|
+
},
|
|
1604
|
+
{
|
|
1605
|
+
"items": {
|
|
1606
|
+
"type": "number"
|
|
1607
|
+
},
|
|
1608
|
+
"type": "array"
|
|
1609
|
+
}
|
|
1610
|
+
]
|
|
1611
|
+
},
|
|
1612
|
+
{
|
|
1613
|
+
"type": "null"
|
|
1614
|
+
}
|
|
1615
|
+
]
|
|
1616
|
+
},
|
|
1617
|
+
"description": {
|
|
1618
|
+
"anyOf": [
|
|
1619
|
+
{
|
|
1620
|
+
"type": "string"
|
|
1621
|
+
},
|
|
1622
|
+
{
|
|
1623
|
+
"type": "null"
|
|
1624
|
+
}
|
|
1625
|
+
]
|
|
1626
|
+
},
|
|
1627
|
+
"label": {
|
|
1628
|
+
"type": "string"
|
|
1629
|
+
},
|
|
1630
|
+
"multiple": {
|
|
1631
|
+
"type": "boolean"
|
|
1632
|
+
},
|
|
1633
|
+
"name": {
|
|
1634
|
+
"type": "string"
|
|
1635
|
+
},
|
|
1636
|
+
"options": {
|
|
1637
|
+
"anyOf": [
|
|
1638
|
+
{
|
|
1639
|
+
"items": {
|
|
1640
|
+
"anyOf": [
|
|
1641
|
+
{
|
|
1642
|
+
"type": "string"
|
|
1643
|
+
},
|
|
1644
|
+
{
|
|
1645
|
+
"type": "number"
|
|
1646
|
+
}
|
|
1647
|
+
]
|
|
1648
|
+
},
|
|
1649
|
+
"type": "array"
|
|
1650
|
+
},
|
|
1651
|
+
{
|
|
1652
|
+
"type": "null"
|
|
1653
|
+
}
|
|
1654
|
+
]
|
|
1655
|
+
},
|
|
1656
|
+
"optionsFromDimension": {
|
|
1657
|
+
"anyOf": [
|
|
1658
|
+
{
|
|
1659
|
+
"additionalProperties": false,
|
|
1660
|
+
"properties": {
|
|
1661
|
+
"dimension": {
|
|
1662
|
+
"type": "string"
|
|
1663
|
+
},
|
|
1664
|
+
"model": {
|
|
1665
|
+
"type": "string"
|
|
1666
|
+
}
|
|
1667
|
+
},
|
|
1668
|
+
"required": [
|
|
1669
|
+
"model",
|
|
1670
|
+
"dimension"
|
|
1671
|
+
],
|
|
1672
|
+
"type": "object"
|
|
1673
|
+
},
|
|
1674
|
+
{
|
|
1675
|
+
"type": "null"
|
|
1676
|
+
}
|
|
1677
|
+
]
|
|
1678
|
+
},
|
|
1679
|
+
"type": {
|
|
1680
|
+
"enum": [
|
|
1681
|
+
"string",
|
|
1682
|
+
"number",
|
|
1683
|
+
"date"
|
|
1684
|
+
],
|
|
1685
|
+
"type": "string"
|
|
1686
|
+
}
|
|
1687
|
+
},
|
|
1688
|
+
"required": [
|
|
1689
|
+
"name",
|
|
1690
|
+
"label",
|
|
1691
|
+
"description",
|
|
1692
|
+
"type",
|
|
1693
|
+
"default",
|
|
1694
|
+
"multiple",
|
|
1695
|
+
"allowCustomValues",
|
|
1696
|
+
"options",
|
|
1697
|
+
"optionsFromDimension"
|
|
1698
|
+
],
|
|
1699
|
+
"type": "object"
|
|
1700
|
+
},
|
|
1701
|
+
"type": "array"
|
|
1702
|
+
},
|
|
1703
|
+
"requiredFilters": {
|
|
1704
|
+
"items": {
|
|
1705
|
+
"additionalProperties": false,
|
|
1706
|
+
"properties": {
|
|
1707
|
+
"fieldId": {
|
|
1708
|
+
"type": "string"
|
|
1709
|
+
},
|
|
1710
|
+
"fieldRef": {
|
|
1711
|
+
"type": "string"
|
|
1712
|
+
},
|
|
1713
|
+
"operator": {
|
|
1714
|
+
"type": "string"
|
|
1715
|
+
},
|
|
1716
|
+
"required": {
|
|
1717
|
+
"type": "boolean"
|
|
1718
|
+
},
|
|
1719
|
+
"settings": {},
|
|
1720
|
+
"tableName": {
|
|
1721
|
+
"type": "string"
|
|
1722
|
+
},
|
|
1723
|
+
"values": {
|
|
1724
|
+
"items": {},
|
|
1725
|
+
"type": "array"
|
|
1726
|
+
}
|
|
1727
|
+
},
|
|
1728
|
+
"required": [
|
|
1729
|
+
"fieldId",
|
|
1730
|
+
"fieldRef",
|
|
1731
|
+
"tableName",
|
|
1732
|
+
"operator",
|
|
1733
|
+
"required"
|
|
1734
|
+
],
|
|
1735
|
+
"type": "object"
|
|
1736
|
+
},
|
|
1737
|
+
"type": "array"
|
|
1738
|
+
},
|
|
1739
|
+
"status": {
|
|
1740
|
+
"const": "found",
|
|
1741
|
+
"type": "string"
|
|
1742
|
+
}
|
|
1743
|
+
},
|
|
1744
|
+
"required": [
|
|
1745
|
+
"exploreId",
|
|
1746
|
+
"status",
|
|
1747
|
+
"label",
|
|
1748
|
+
"description",
|
|
1749
|
+
"hint",
|
|
1750
|
+
"baseTable",
|
|
1751
|
+
"joinedTables",
|
|
1752
|
+
"requiredFilters",
|
|
1753
|
+
"parameters",
|
|
1754
|
+
"baseDimensions",
|
|
1755
|
+
"baseMetrics"
|
|
1756
|
+
],
|
|
1757
|
+
"type": "object"
|
|
1758
|
+
},
|
|
1759
|
+
{
|
|
1760
|
+
"additionalProperties": false,
|
|
1761
|
+
"properties": {
|
|
1762
|
+
"error": {
|
|
1763
|
+
"type": "string"
|
|
1764
|
+
},
|
|
1765
|
+
"exploreId": {
|
|
1766
|
+
"type": "string"
|
|
1767
|
+
},
|
|
1768
|
+
"status": {
|
|
1769
|
+
"const": "not_found",
|
|
1770
|
+
"type": "string"
|
|
1771
|
+
}
|
|
1772
|
+
},
|
|
1773
|
+
"required": [
|
|
1774
|
+
"exploreId",
|
|
1775
|
+
"status",
|
|
1776
|
+
"error"
|
|
1777
|
+
],
|
|
1778
|
+
"type": "object"
|
|
1779
|
+
}
|
|
1780
|
+
]
|
|
1781
|
+
},
|
|
1782
|
+
"type": "array"
|
|
1783
|
+
},
|
|
1784
|
+
"fields": {
|
|
1785
|
+
"items": {
|
|
1786
|
+
"anyOf": [
|
|
1787
|
+
{
|
|
1788
|
+
"additionalProperties": false,
|
|
1789
|
+
"properties": {
|
|
1790
|
+
"caseSensitiveFilters": {
|
|
1791
|
+
"anyOf": [
|
|
1792
|
+
{
|
|
1793
|
+
"type": "boolean"
|
|
1794
|
+
},
|
|
1795
|
+
{
|
|
1796
|
+
"type": "null"
|
|
1797
|
+
}
|
|
1798
|
+
]
|
|
1799
|
+
},
|
|
1800
|
+
"defaultTimeDimension": {
|
|
1801
|
+
"anyOf": [
|
|
1802
|
+
{
|
|
1803
|
+
"type": "string"
|
|
1804
|
+
},
|
|
1805
|
+
{
|
|
1806
|
+
"type": "null"
|
|
1807
|
+
}
|
|
1808
|
+
]
|
|
1809
|
+
},
|
|
1810
|
+
"defaultTimeDimensionGranularity": {
|
|
1811
|
+
"anyOf": [
|
|
1812
|
+
{
|
|
1813
|
+
"type": "string"
|
|
1814
|
+
},
|
|
1815
|
+
{
|
|
1816
|
+
"type": "null"
|
|
1817
|
+
}
|
|
1818
|
+
]
|
|
1819
|
+
},
|
|
1820
|
+
"description": {
|
|
1821
|
+
"anyOf": [
|
|
1822
|
+
{
|
|
1823
|
+
"type": "string"
|
|
1824
|
+
},
|
|
1825
|
+
{
|
|
1826
|
+
"type": "null"
|
|
1827
|
+
}
|
|
1828
|
+
]
|
|
1829
|
+
},
|
|
1830
|
+
"exploreId": {
|
|
1831
|
+
"type": "string"
|
|
1832
|
+
},
|
|
1833
|
+
"fieldId": {
|
|
1834
|
+
"type": "string"
|
|
1835
|
+
},
|
|
1836
|
+
"fieldType": {
|
|
1837
|
+
"type": "string"
|
|
1838
|
+
},
|
|
1839
|
+
"filterType": {
|
|
1840
|
+
"type": "string"
|
|
1841
|
+
},
|
|
1842
|
+
"hint": {
|
|
1843
|
+
"anyOf": [
|
|
1844
|
+
{
|
|
1845
|
+
"type": "string"
|
|
1846
|
+
},
|
|
1847
|
+
{
|
|
1848
|
+
"type": "null"
|
|
1849
|
+
}
|
|
1850
|
+
]
|
|
1851
|
+
},
|
|
1852
|
+
"isFromJoinedTable": {
|
|
1853
|
+
"type": "boolean"
|
|
1854
|
+
},
|
|
1855
|
+
"joinedTableName": {
|
|
1856
|
+
"anyOf": [
|
|
1857
|
+
{
|
|
1858
|
+
"type": "string"
|
|
1859
|
+
},
|
|
1860
|
+
{
|
|
1861
|
+
"type": "null"
|
|
1862
|
+
}
|
|
1863
|
+
]
|
|
1864
|
+
},
|
|
1865
|
+
"kind": {
|
|
1866
|
+
"enum": ["dimension", "metric"],
|
|
1867
|
+
"type": "string"
|
|
1868
|
+
},
|
|
1869
|
+
"label": {
|
|
1870
|
+
"type": "string"
|
|
1871
|
+
},
|
|
1872
|
+
"requiredParameters": {
|
|
1873
|
+
"items": {
|
|
1874
|
+
"type": "string"
|
|
1875
|
+
},
|
|
1876
|
+
"type": "array"
|
|
1877
|
+
},
|
|
1878
|
+
"status": {
|
|
1879
|
+
"const": "found",
|
|
1880
|
+
"type": "string"
|
|
1881
|
+
}
|
|
1882
|
+
},
|
|
1883
|
+
"required": [
|
|
1884
|
+
"exploreId",
|
|
1885
|
+
"fieldId",
|
|
1886
|
+
"status",
|
|
1887
|
+
"kind",
|
|
1888
|
+
"fieldType",
|
|
1889
|
+
"label",
|
|
1890
|
+
"filterType",
|
|
1891
|
+
"isFromJoinedTable",
|
|
1892
|
+
"joinedTableName",
|
|
1893
|
+
"caseSensitiveFilters",
|
|
1894
|
+
"defaultTimeDimension",
|
|
1895
|
+
"defaultTimeDimensionGranularity",
|
|
1896
|
+
"requiredParameters",
|
|
1897
|
+
"description",
|
|
1898
|
+
"hint"
|
|
1899
|
+
],
|
|
1900
|
+
"type": "object"
|
|
1901
|
+
},
|
|
1902
|
+
{
|
|
1903
|
+
"additionalProperties": false,
|
|
1904
|
+
"properties": {
|
|
1905
|
+
"error": {
|
|
1906
|
+
"type": "string"
|
|
1907
|
+
},
|
|
1908
|
+
"exploreId": {
|
|
1909
|
+
"type": "string"
|
|
1910
|
+
},
|
|
1911
|
+
"fieldId": {
|
|
1912
|
+
"type": "string"
|
|
1913
|
+
},
|
|
1914
|
+
"status": {
|
|
1915
|
+
"const": "not_found",
|
|
1916
|
+
"type": "string"
|
|
1917
|
+
}
|
|
1918
|
+
},
|
|
1919
|
+
"required": [
|
|
1920
|
+
"exploreId",
|
|
1921
|
+
"fieldId",
|
|
1922
|
+
"status",
|
|
1923
|
+
"error"
|
|
1924
|
+
],
|
|
1925
|
+
"type": "object"
|
|
1926
|
+
}
|
|
1927
|
+
]
|
|
1928
|
+
},
|
|
1929
|
+
"type": "array"
|
|
1930
|
+
}
|
|
1931
|
+
},
|
|
1932
|
+
"required": ["explores", "fields"],
|
|
1933
|
+
"type": "object"
|
|
1934
|
+
},
|
|
1935
|
+
"title": "Get metadata"
|
|
1936
|
+
},
|
|
1937
|
+
{
|
|
1938
|
+
"annotations": {
|
|
1939
|
+
"destructiveHint": false,
|
|
1940
|
+
"idempotentHint": true,
|
|
1941
|
+
"openWorldHint": false,
|
|
1942
|
+
"readOnlyHint": true
|
|
1943
|
+
},
|
|
1944
|
+
"description": "Poll an existing run_sql or run_metric_query query until done, error, cancelled, or expired. Use the exact queryUuid returned by the query tool; never invent it. This tool retrieves results without rerunning the query.\n\nIf running, follow the response's polling instructions and call get_query_result with the same queryUuid; never resubmit the query.\nStop on terminal errors and correct the request before retrying.\n\nReturns the original query's data on completion. For a visual, call render_chart after get_query_result returns done for a metric query. SQL results cannot be rendered by render_chart.\n\nWhen building an HTML/React artifact that calls MCP, load the mcp-artifact-integration skill (read_skill with name: \"mcp-artifact-integration\") for response parsing, polling, errors and chart data. This is not needed for ordinary chat or the built-in chart app.",
|
|
1945
|
+
"inputSchema": {
|
|
1946
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1947
|
+
"properties": {
|
|
1948
|
+
"queryUuid": {
|
|
1949
|
+
"description": "Async query UUID returned by the query tool.",
|
|
1950
|
+
"format": "uuid",
|
|
1951
|
+
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
|
|
1952
|
+
"type": "string"
|
|
1953
|
+
}
|
|
1954
|
+
},
|
|
1955
|
+
"required": ["queryUuid"],
|
|
1956
|
+
"type": "object"
|
|
1957
|
+
},
|
|
1958
|
+
"name": "get_query_result",
|
|
1959
|
+
"outputSchema": {
|
|
1960
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1961
|
+
"additionalProperties": false,
|
|
1962
|
+
"properties": {
|
|
1963
|
+
"result": {
|
|
1964
|
+
"anyOf": [
|
|
1965
|
+
{
|
|
1966
|
+
"additionalProperties": false,
|
|
1967
|
+
"properties": {
|
|
1968
|
+
"heartbeatAt": {
|
|
1969
|
+
"description": "ISO timestamp for when Lightdash last checked this async query and confirmed it is still running.",
|
|
1970
|
+
"type": "string"
|
|
1971
|
+
},
|
|
1972
|
+
"nextPollAfterMs": {
|
|
1973
|
+
"description": "Suggested delay before polling get_query_result for this query.",
|
|
1974
|
+
"exclusiveMinimum": 0,
|
|
1975
|
+
"maximum": 9007199254740991,
|
|
1976
|
+
"type": "integer"
|
|
1977
|
+
},
|
|
1978
|
+
"queryUuid": {
|
|
1979
|
+
"description": "Async query UUID to pass to get_query_result when status is running.",
|
|
1980
|
+
"format": "uuid",
|
|
1981
|
+
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
|
|
1982
|
+
"type": "string"
|
|
1983
|
+
},
|
|
1984
|
+
"status": {
|
|
1985
|
+
"const": "running",
|
|
1986
|
+
"description": "Present when the query is still running and should be polled with get_query_result.",
|
|
1987
|
+
"type": "string"
|
|
1988
|
+
}
|
|
1989
|
+
},
|
|
1990
|
+
"required": [
|
|
1991
|
+
"status",
|
|
1992
|
+
"queryUuid",
|
|
1993
|
+
"nextPollAfterMs",
|
|
1994
|
+
"heartbeatAt"
|
|
1995
|
+
],
|
|
1996
|
+
"type": "object"
|
|
1997
|
+
},
|
|
1998
|
+
{
|
|
1999
|
+
"additionalProperties": false,
|
|
2000
|
+
"properties": {
|
|
2001
|
+
"columns": {
|
|
2002
|
+
"description": "Ordered list of column names matching the keys in each row of `rows`.",
|
|
2003
|
+
"items": {
|
|
2004
|
+
"type": "string"
|
|
2005
|
+
},
|
|
2006
|
+
"type": "array"
|
|
2007
|
+
},
|
|
2008
|
+
"queryUuid": {
|
|
2009
|
+
"format": "uuid",
|
|
2010
|
+
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
|
|
2011
|
+
"type": "string"
|
|
2012
|
+
},
|
|
2013
|
+
"rowCount": {
|
|
2014
|
+
"description": "Total number of rows returned. May be less than the requested limit.",
|
|
2015
|
+
"maximum": 9007199254740991,
|
|
2016
|
+
"minimum": 0,
|
|
2017
|
+
"type": "integer"
|
|
2018
|
+
},
|
|
2019
|
+
"rows": {
|
|
2020
|
+
"description": "Result rows. Each row is an object keyed by column name. Values come from the warehouse as JSON-serializable primitives (numbers, strings, booleans, ISO date strings, or null).",
|
|
2021
|
+
"items": {
|
|
2022
|
+
"additionalProperties": {},
|
|
2023
|
+
"propertyNames": {
|
|
2024
|
+
"type": "string"
|
|
2025
|
+
},
|
|
2026
|
+
"type": "object"
|
|
2027
|
+
},
|
|
2028
|
+
"type": "array"
|
|
2029
|
+
},
|
|
2030
|
+
"sqlRunnerUrl": {
|
|
2031
|
+
"anyOf": [
|
|
2032
|
+
{
|
|
2033
|
+
"type": "string"
|
|
2034
|
+
},
|
|
2035
|
+
{
|
|
2036
|
+
"type": "null"
|
|
2037
|
+
}
|
|
2038
|
+
]
|
|
2039
|
+
},
|
|
2040
|
+
"status": {
|
|
2041
|
+
"const": "done",
|
|
2042
|
+
"type": "string"
|
|
2043
|
+
}
|
|
2044
|
+
},
|
|
2045
|
+
"required": [
|
|
2046
|
+
"status",
|
|
2047
|
+
"queryUuid",
|
|
2048
|
+
"sqlRunnerUrl",
|
|
2049
|
+
"rows",
|
|
2050
|
+
"columns",
|
|
2051
|
+
"rowCount"
|
|
2052
|
+
],
|
|
2053
|
+
"type": "object"
|
|
2054
|
+
},
|
|
2055
|
+
{
|
|
2056
|
+
"additionalProperties": false,
|
|
2057
|
+
"properties": {
|
|
2058
|
+
"exploreUrl": {
|
|
2059
|
+
"anyOf": [
|
|
2060
|
+
{
|
|
2061
|
+
"type": "string"
|
|
2062
|
+
},
|
|
2063
|
+
{
|
|
2064
|
+
"type": "null"
|
|
2065
|
+
}
|
|
2066
|
+
]
|
|
2067
|
+
},
|
|
2068
|
+
"fields": {
|
|
2069
|
+
"additionalProperties": {},
|
|
2070
|
+
"propertyNames": {
|
|
2071
|
+
"type": "string"
|
|
2072
|
+
},
|
|
2073
|
+
"type": "object"
|
|
2074
|
+
},
|
|
2075
|
+
"queryUuid": {
|
|
2076
|
+
"format": "uuid",
|
|
2077
|
+
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
|
|
2078
|
+
"type": "string"
|
|
2079
|
+
},
|
|
2080
|
+
"rows": {
|
|
2081
|
+
"items": {
|
|
2082
|
+
"additionalProperties": {},
|
|
2083
|
+
"propertyNames": {
|
|
2084
|
+
"type": "string"
|
|
2085
|
+
},
|
|
2086
|
+
"type": "object"
|
|
2087
|
+
},
|
|
2088
|
+
"type": "array"
|
|
2089
|
+
},
|
|
2090
|
+
"status": {
|
|
2091
|
+
"const": "done",
|
|
2092
|
+
"type": "string"
|
|
2093
|
+
}
|
|
2094
|
+
},
|
|
2095
|
+
"required": [
|
|
2096
|
+
"status",
|
|
2097
|
+
"queryUuid",
|
|
2098
|
+
"exploreUrl",
|
|
2099
|
+
"rows",
|
|
2100
|
+
"fields"
|
|
2101
|
+
],
|
|
2102
|
+
"type": "object"
|
|
2103
|
+
},
|
|
2104
|
+
{
|
|
2105
|
+
"additionalProperties": false,
|
|
2106
|
+
"properties": {
|
|
2107
|
+
"error": {
|
|
2108
|
+
"anyOf": [
|
|
2109
|
+
{
|
|
2110
|
+
"type": "string"
|
|
2111
|
+
},
|
|
2112
|
+
{
|
|
2113
|
+
"type": "null"
|
|
2114
|
+
}
|
|
2115
|
+
]
|
|
2116
|
+
},
|
|
2117
|
+
"queryUuid": {
|
|
2118
|
+
"format": "uuid",
|
|
2119
|
+
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
|
|
2120
|
+
"type": "string"
|
|
2121
|
+
},
|
|
2122
|
+
"status": {
|
|
2123
|
+
"enum": [
|
|
2124
|
+
"error",
|
|
2125
|
+
"cancelled",
|
|
2126
|
+
"expired"
|
|
2127
|
+
],
|
|
2128
|
+
"type": "string"
|
|
2129
|
+
}
|
|
2130
|
+
},
|
|
2131
|
+
"required": ["status", "queryUuid", "error"],
|
|
2132
|
+
"type": "object"
|
|
2133
|
+
}
|
|
2134
|
+
]
|
|
2135
|
+
}
|
|
2136
|
+
},
|
|
2137
|
+
"required": ["result"],
|
|
2138
|
+
"type": "object"
|
|
2139
|
+
},
|
|
2140
|
+
"title": "Get query result"
|
|
2141
|
+
},
|
|
2142
|
+
{
|
|
2143
|
+
"annotations": {
|
|
2144
|
+
"destructiveHint": false,
|
|
2145
|
+
"idempotentHint": true,
|
|
2146
|
+
"openWorldHint": false,
|
|
2147
|
+
"readOnlyHint": true
|
|
2148
|
+
},
|
|
2149
|
+
"description": "Tool: grep_fields\n\nPurpose:\nFind which explores and fields can answer a question by grepping an in-memory, annotated view of the project's fields (names, labels, descriptions, hints and tags). Returns matching fields as `explore/fieldId [kind type]` lines grouped by explore.\n\nUse this as the FIRST step whenever the user asks a data question (counts, totals, breakdowns, trends, \"what is\", \"show me\", \"how many\"). Do NOT call this for questions about existing dashboards/charts (use find_content).\n\nEach pattern is a case-insensitive keyword pattern (not a full regex): use `|` to OR synonyms (\"revenue|sales\") and a space or `.*` between words to require all of them (\"order.*status\" matches fields mentioning both \"order\" and \"status\"). Pass 1–5 patterns in a SINGLE call covering the different angles of the question — they run together so you see all results at once instead of grepping one at a time. Start broad with meaningful keywords (e.g. [\"revenue|sales\", \"country|region\", \"segment|tier\"]) and narrow from there — long natural-language phrases will not match. If results are empty, try synonyms or broader patterns before giving up. Read the returned fieldIds and pick the single explore that answers at the right grain before building a query.\n\nA description or hint ending in \"...(truncated)\" is incomplete — call get_metadata to read the full text before using that field.\n\nA field annotated with `⚠params: <names>` depends on those Lightdash parameters — what it returns changes with the parameter values the query runs with (unset parameters resolve to their default). Call get_metadata on its explore to see the parameter definitions before querying such a field.\n",
|
|
2150
|
+
"inputSchema": {
|
|
2151
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2152
|
+
"properties": {
|
|
2153
|
+
"exploreName": {
|
|
2154
|
+
"description": "Restrict the search to this explore only, or null to search all explores.",
|
|
2155
|
+
"type": "string"
|
|
2156
|
+
},
|
|
2157
|
+
"patterns": {
|
|
2158
|
+
"description": "Up to 5 case-insensitive keyword patterns, run together in one call. Use `|` to OR synonyms and a space or `.*` between words to require all of them. Each is matched against field names, labels, descriptions, hints and tags.",
|
|
2159
|
+
"items": {
|
|
2160
|
+
"minLength": 1,
|
|
2161
|
+
"type": "string"
|
|
2162
|
+
},
|
|
2163
|
+
"maxItems": 5,
|
|
2164
|
+
"minItems": 1,
|
|
2165
|
+
"type": "array"
|
|
2166
|
+
}
|
|
2167
|
+
},
|
|
2168
|
+
"required": ["patterns"],
|
|
2169
|
+
"type": "object"
|
|
2170
|
+
},
|
|
2171
|
+
"name": "grep_fields",
|
|
2172
|
+
"outputSchema": {
|
|
2173
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2174
|
+
"additionalProperties": false,
|
|
2175
|
+
"properties": {
|
|
2176
|
+
"description": {
|
|
2177
|
+
"description": "How to read `patterns` and `fuzzyMatches`.",
|
|
2178
|
+
"type": "string"
|
|
2179
|
+
},
|
|
2180
|
+
"exploreName": {
|
|
2181
|
+
"anyOf": [
|
|
2182
|
+
{
|
|
2183
|
+
"type": "string"
|
|
2184
|
+
},
|
|
2185
|
+
{
|
|
2186
|
+
"type": "null"
|
|
2187
|
+
}
|
|
2188
|
+
],
|
|
2189
|
+
"description": "The explore the grep was scoped to, or null for all."
|
|
2190
|
+
},
|
|
2191
|
+
"fuzzyMatches": {
|
|
2192
|
+
"description": "Catalog-search near matches not already surfaced by the grep.",
|
|
2193
|
+
"items": {
|
|
2194
|
+
"additionalProperties": false,
|
|
2195
|
+
"properties": {
|
|
2196
|
+
"description": {
|
|
2197
|
+
"anyOf": [
|
|
2198
|
+
{
|
|
2199
|
+
"type": "string"
|
|
2200
|
+
},
|
|
2201
|
+
{
|
|
2202
|
+
"type": "null"
|
|
2203
|
+
}
|
|
2204
|
+
]
|
|
2205
|
+
},
|
|
2206
|
+
"exploreName": {
|
|
2207
|
+
"type": "string"
|
|
2208
|
+
},
|
|
2209
|
+
"fieldId": {
|
|
2210
|
+
"type": "string"
|
|
2211
|
+
},
|
|
2212
|
+
"fieldType": {
|
|
2213
|
+
"type": "string"
|
|
2214
|
+
},
|
|
2215
|
+
"label": {
|
|
2216
|
+
"type": "string"
|
|
2217
|
+
},
|
|
2218
|
+
"searchRank": {
|
|
2219
|
+
"anyOf": [
|
|
2220
|
+
{
|
|
2221
|
+
"type": "number"
|
|
2222
|
+
},
|
|
2223
|
+
{
|
|
2224
|
+
"type": "null"
|
|
2225
|
+
}
|
|
2226
|
+
],
|
|
2227
|
+
"description": "Full-text search rank; higher is better."
|
|
2228
|
+
},
|
|
2229
|
+
"usageInCharts": {
|
|
2230
|
+
"type": "number"
|
|
2231
|
+
},
|
|
2232
|
+
"usageInVerifiedCharts": {
|
|
2233
|
+
"type": "number"
|
|
2234
|
+
}
|
|
2235
|
+
},
|
|
2236
|
+
"required": [
|
|
2237
|
+
"exploreName",
|
|
2238
|
+
"fieldId",
|
|
2239
|
+
"label",
|
|
2240
|
+
"fieldType",
|
|
2241
|
+
"description",
|
|
2242
|
+
"searchRank",
|
|
2243
|
+
"usageInCharts",
|
|
2244
|
+
"usageInVerifiedCharts"
|
|
2245
|
+
],
|
|
2246
|
+
"type": "object"
|
|
2247
|
+
},
|
|
2248
|
+
"type": "array"
|
|
2249
|
+
},
|
|
2250
|
+
"patterns": {
|
|
2251
|
+
"description": "One entry per input pattern, in input order.",
|
|
2252
|
+
"items": {
|
|
2253
|
+
"additionalProperties": false,
|
|
2254
|
+
"properties": {
|
|
2255
|
+
"matchCount": {
|
|
2256
|
+
"description": "Fields matched before the display cap.",
|
|
2257
|
+
"type": "number"
|
|
2258
|
+
},
|
|
2259
|
+
"matchedAllFields": {
|
|
2260
|
+
"type": "boolean"
|
|
2261
|
+
},
|
|
2262
|
+
"matchingExploresByName": {
|
|
2263
|
+
"description": "Explores whose own name/label/hint matched but had no field matches.",
|
|
2264
|
+
"items": {
|
|
2265
|
+
"additionalProperties": false,
|
|
2266
|
+
"properties": {
|
|
2267
|
+
"exploreLabel": {
|
|
2268
|
+
"type": "string"
|
|
2269
|
+
},
|
|
2270
|
+
"exploreName": {
|
|
2271
|
+
"type": "string"
|
|
2272
|
+
}
|
|
2273
|
+
},
|
|
2274
|
+
"required": [
|
|
2275
|
+
"exploreName",
|
|
2276
|
+
"exploreLabel"
|
|
2277
|
+
],
|
|
2278
|
+
"type": "object"
|
|
2279
|
+
},
|
|
2280
|
+
"type": "array"
|
|
2281
|
+
},
|
|
2282
|
+
"metricAmbiguityNote": {
|
|
2283
|
+
"anyOf": [
|
|
2284
|
+
{
|
|
2285
|
+
"type": "string"
|
|
2286
|
+
},
|
|
2287
|
+
{
|
|
2288
|
+
"type": "null"
|
|
2289
|
+
}
|
|
2290
|
+
],
|
|
2291
|
+
"description": "Warning when similarly named metrics could be confused."
|
|
2292
|
+
},
|
|
2293
|
+
"note": {
|
|
2294
|
+
"description": "The per-pattern summary line.",
|
|
2295
|
+
"type": "string"
|
|
2296
|
+
},
|
|
2297
|
+
"pattern": {
|
|
2298
|
+
"type": "string"
|
|
2299
|
+
},
|
|
2300
|
+
"resultsByExplore": {
|
|
2301
|
+
"description": "Matched fields grouped by explore, best matches first.",
|
|
2302
|
+
"items": {
|
|
2303
|
+
"additionalProperties": false,
|
|
2304
|
+
"properties": {
|
|
2305
|
+
"exploreLabel": {
|
|
2306
|
+
"type": "string"
|
|
2307
|
+
},
|
|
2308
|
+
"exploreName": {
|
|
2309
|
+
"type": "string"
|
|
2310
|
+
},
|
|
2311
|
+
"fields": {
|
|
2312
|
+
"items": {
|
|
1957
2313
|
"additionalProperties": false,
|
|
1958
2314
|
"properties": {
|
|
1959
2315
|
"defaultTimeDimension": {
|
|
@@ -2115,53 +2471,376 @@
|
|
|
2115
2471
|
},
|
|
2116
2472
|
"type": "array"
|
|
2117
2473
|
},
|
|
2118
|
-
"scopeSize": {
|
|
2119
|
-
"description": "Fields the pattern was run against.",
|
|
2474
|
+
"scopeSize": {
|
|
2475
|
+
"description": "Fields the pattern was run against.",
|
|
2476
|
+
"type": "number"
|
|
2477
|
+
},
|
|
2478
|
+
"status": {
|
|
2479
|
+
"description": "`no_signal` means the pattern matched every field in scope and was discarded.",
|
|
2480
|
+
"enum": [
|
|
2481
|
+
"matches",
|
|
2482
|
+
"no_matches",
|
|
2483
|
+
"no_signal"
|
|
2484
|
+
],
|
|
2485
|
+
"type": "string"
|
|
2486
|
+
}
|
|
2487
|
+
},
|
|
2488
|
+
"required": [
|
|
2489
|
+
"pattern",
|
|
2490
|
+
"status",
|
|
2491
|
+
"matchCount",
|
|
2492
|
+
"scopeSize",
|
|
2493
|
+
"matchedAllFields",
|
|
2494
|
+
"note",
|
|
2495
|
+
"resultsByExplore",
|
|
2496
|
+
"metricAmbiguityNote",
|
|
2497
|
+
"matchingExploresByName"
|
|
2498
|
+
],
|
|
2499
|
+
"type": "object"
|
|
2500
|
+
},
|
|
2501
|
+
"type": "array"
|
|
2502
|
+
},
|
|
2503
|
+
"relevantVerifiedAnswers": {
|
|
2504
|
+
"items": {
|
|
2505
|
+
"additionalProperties": false,
|
|
2506
|
+
"properties": {
|
|
2507
|
+
"artifactType": {
|
|
2508
|
+
"enum": ["chart", "dashboard"],
|
|
2509
|
+
"type": "string"
|
|
2510
|
+
},
|
|
2511
|
+
"artifactVersionUuid": {
|
|
2512
|
+
"type": "string"
|
|
2513
|
+
},
|
|
2514
|
+
"chartConfig": {
|
|
2515
|
+
"additionalProperties": {},
|
|
2516
|
+
"propertyNames": {
|
|
2517
|
+
"type": "string"
|
|
2518
|
+
},
|
|
2519
|
+
"type": "object"
|
|
2520
|
+
},
|
|
2521
|
+
"description": {
|
|
2522
|
+
"anyOf": [
|
|
2523
|
+
{
|
|
2524
|
+
"type": "string"
|
|
2525
|
+
},
|
|
2526
|
+
{
|
|
2527
|
+
"type": "null"
|
|
2528
|
+
}
|
|
2529
|
+
]
|
|
2530
|
+
},
|
|
2531
|
+
"similarity": {
|
|
2120
2532
|
"type": "number"
|
|
2121
2533
|
},
|
|
2122
|
-
"
|
|
2123
|
-
"
|
|
2124
|
-
|
|
2125
|
-
|
|
2126
|
-
|
|
2127
|
-
|
|
2128
|
-
|
|
2129
|
-
|
|
2534
|
+
"title": {
|
|
2535
|
+
"anyOf": [
|
|
2536
|
+
{
|
|
2537
|
+
"type": "string"
|
|
2538
|
+
},
|
|
2539
|
+
{
|
|
2540
|
+
"type": "null"
|
|
2541
|
+
}
|
|
2542
|
+
]
|
|
2543
|
+
},
|
|
2544
|
+
"verifiedQuestion": {
|
|
2545
|
+
"anyOf": [
|
|
2546
|
+
{
|
|
2547
|
+
"type": "string"
|
|
2548
|
+
},
|
|
2549
|
+
{
|
|
2550
|
+
"type": "null"
|
|
2551
|
+
}
|
|
2552
|
+
]
|
|
2130
2553
|
}
|
|
2131
2554
|
},
|
|
2132
|
-
"required": [
|
|
2133
|
-
"
|
|
2134
|
-
"
|
|
2135
|
-
"
|
|
2136
|
-
"
|
|
2137
|
-
"
|
|
2138
|
-
"
|
|
2139
|
-
"
|
|
2140
|
-
|
|
2141
|
-
|
|
2142
|
-
|
|
2143
|
-
|
|
2555
|
+
"required": [
|
|
2556
|
+
"artifactVersionUuid",
|
|
2557
|
+
"chartConfig",
|
|
2558
|
+
"artifactType",
|
|
2559
|
+
"verifiedQuestion",
|
|
2560
|
+
"title",
|
|
2561
|
+
"description",
|
|
2562
|
+
"similarity"
|
|
2563
|
+
],
|
|
2564
|
+
"type": "object"
|
|
2565
|
+
},
|
|
2566
|
+
"type": "array"
|
|
2567
|
+
}
|
|
2568
|
+
},
|
|
2569
|
+
"required": [
|
|
2570
|
+
"description",
|
|
2571
|
+
"exploreName",
|
|
2572
|
+
"patterns",
|
|
2573
|
+
"fuzzyMatches"
|
|
2574
|
+
],
|
|
2575
|
+
"type": "object"
|
|
2576
|
+
},
|
|
2577
|
+
"title": "Search fields"
|
|
2578
|
+
},
|
|
2579
|
+
{
|
|
2580
|
+
"annotations": {
|
|
2581
|
+
"destructiveHint": false,
|
|
2582
|
+
"idempotentHint": false,
|
|
2583
|
+
"openWorldHint": false,
|
|
2584
|
+
"readOnlyHint": false
|
|
2585
|
+
},
|
|
2586
|
+
"description": "Tool: iterate_custom_chart_type\n\nStart a build that adds a version to an existing custom chart type from a follow-up brief. For a new chart type use create_custom_chart_type; for a data app use iterate_data_app.\n\n- Describe the change, not the whole chart type. The build keeps the chart type's inputs, so charts that already use it keep working. Pass queryUuid to share the first rows of a completed run_metric_query as sample data. Pass themeSlug only to switch the theme.\n- Poll get_data_app_build_status with appSlug set to the slug until it is \"ready\", \"error\" or \"cancelled\". If a version is already building, wait for it to end before calling again.\n- A chart type created over MCP is the caller's personal one, in no space, so a space-restricted agent-scoped session cannot read it. Omit agentUuid here and in get_data_app_build_status.\n",
|
|
2587
|
+
"inputSchema": {
|
|
2588
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2589
|
+
"properties": {
|
|
2590
|
+
"prompt": {
|
|
2591
|
+
"description": "Self-contained brief of the change for the coding agent, which works from the chart type's current source. The agent does not see this conversation, only the sample rows from queryUuid if given.",
|
|
2592
|
+
"type": "string"
|
|
2593
|
+
},
|
|
2594
|
+
"queryUuid": {
|
|
2595
|
+
"anyOf": [
|
|
2596
|
+
{
|
|
2597
|
+
"format": "uuid",
|
|
2598
|
+
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
|
|
2599
|
+
"type": "string"
|
|
2600
|
+
},
|
|
2601
|
+
{
|
|
2602
|
+
"type": "null"
|
|
2603
|
+
}
|
|
2604
|
+
],
|
|
2605
|
+
"default": null,
|
|
2606
|
+
"description": "Optional uuid of a completed run_metric_query whose first rows are shared with the build as sample data. It does not bind the chart type to that query."
|
|
2607
|
+
},
|
|
2608
|
+
"slug": {
|
|
2609
|
+
"description": "Slug of the custom chart type to change, from an earlier create_custom_chart_type result or its Chart Studio URL.",
|
|
2610
|
+
"type": "string"
|
|
2611
|
+
},
|
|
2612
|
+
"themeSlug": {
|
|
2613
|
+
"anyOf": [
|
|
2614
|
+
{
|
|
2615
|
+
"type": "string"
|
|
2616
|
+
},
|
|
2617
|
+
{
|
|
2618
|
+
"type": "null"
|
|
2619
|
+
}
|
|
2620
|
+
],
|
|
2621
|
+
"default": null,
|
|
2622
|
+
"description": "Organization theme to rebuild the chart type with: its slug, from list_data_app_themes. Omit it to keep the current theme. An unknown slug returns an error and starts no build."
|
|
2623
|
+
}
|
|
2624
|
+
},
|
|
2625
|
+
"required": ["slug", "prompt"],
|
|
2626
|
+
"type": "object"
|
|
2627
|
+
},
|
|
2628
|
+
"name": "iterate_custom_chart_type",
|
|
2629
|
+
"outputSchema": {
|
|
2630
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2631
|
+
"additionalProperties": false,
|
|
2632
|
+
"properties": {
|
|
2633
|
+
"slug": {
|
|
2634
|
+
"description": "The chart type's permanent slug. Pass it as appSlug to get_data_app_build_status.",
|
|
2635
|
+
"type": "string"
|
|
2636
|
+
},
|
|
2637
|
+
"version": {
|
|
2638
|
+
"description": "The version of the chart type this build produces.",
|
|
2639
|
+
"exclusiveMinimum": 0,
|
|
2640
|
+
"maximum": 9007199254740991,
|
|
2641
|
+
"type": "integer"
|
|
2642
|
+
}
|
|
2643
|
+
},
|
|
2644
|
+
"required": ["slug", "version"],
|
|
2645
|
+
"type": "object"
|
|
2646
|
+
},
|
|
2647
|
+
"title": "Iterate on custom chart type"
|
|
2648
|
+
},
|
|
2649
|
+
{
|
|
2650
|
+
"annotations": {
|
|
2651
|
+
"destructiveHint": false,
|
|
2652
|
+
"idempotentHint": false,
|
|
2653
|
+
"openWorldHint": false,
|
|
2654
|
+
"readOnlyHint": false
|
|
2655
|
+
},
|
|
2656
|
+
"description": "Tool: iterate_data_app\n\nPurpose:\nStart a build that adds a version to an existing data app from a follow-up brief. Use it to change, fix, or extend an app that already exists; generate_data_app is the tool for a brand-new app.\n\nImportant:\n- The coding agent works from the app's current source, so the brief describes the change rather than restating the whole app.\n- The app's name and slug stay as they are. The build adds a version to the app named by appSlug.\n- The build runs in the background for several minutes. This call returns as soon as the build has started. Poll get_data_app_build_status with the same appSlug every 15 seconds until its status is \"ready\", \"error\", or \"cancelled\". Call this tool once per request.\n- While a version is already building for the app, this call fails with \"A version is already building for this app\". Poll get_data_app_build_status until that build reaches a terminal status, then call this tool again.\n- An agent-scoped session restricted to specific spaces cannot read a personal app. Call this tool and get_data_app_build_status without agentUuid to build and poll an app you own.\n- Pass themeSlug only when the user asks to switch the app's theme; omitting it keeps the current one. An unknown themeSlug fails before the build starts and lists the valid slugs, which list_data_app_themes also returns.\n\nResponse shape (MCP CallToolResult):\n- content: [{ type: \"text\", text: \"<confirmation that the build started>\" }]\n- structuredContent: {\n slug: string, // the app's slug, unchanged by this build\n version: number // the version of the app this build produces\n }\n\nErrors: an unknown appSlug, themeSlug, dashboardSlug, or chartSlug returns an error and starts no build. So does a custom chart type's slug: use iterate_custom_chart_type for those.\n",
|
|
2657
|
+
"inputSchema": {
|
|
2658
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2659
|
+
"properties": {
|
|
2660
|
+
"appSlug": {
|
|
2661
|
+
"description": "Slug of the data app to change — from an earlier generateDataApp or iterateDataApp result, findContent, or readContent.",
|
|
2662
|
+
"type": "string"
|
|
2663
|
+
},
|
|
2664
|
+
"chartSlugs": {
|
|
2665
|
+
"anyOf": [
|
|
2666
|
+
{
|
|
2667
|
+
"items": {
|
|
2668
|
+
"type": "string"
|
|
2669
|
+
},
|
|
2670
|
+
"type": "array"
|
|
2671
|
+
},
|
|
2672
|
+
{
|
|
2673
|
+
"type": "null"
|
|
2674
|
+
}
|
|
2675
|
+
],
|
|
2676
|
+
"default": null,
|
|
2677
|
+
"description": "Saved charts (slugs from findContent) whose queries the change builds on; the charts themselves stay unchanged. Omit when the change does not reference saved charts."
|
|
2678
|
+
},
|
|
2679
|
+
"dashboardSlug": {
|
|
2680
|
+
"anyOf": [
|
|
2681
|
+
{
|
|
2682
|
+
"type": "string"
|
|
2683
|
+
},
|
|
2684
|
+
{
|
|
2685
|
+
"type": "null"
|
|
2686
|
+
}
|
|
2687
|
+
],
|
|
2688
|
+
"default": null,
|
|
2689
|
+
"description": "Pull in an existing dashboard: its slug (from findContent). The coding agent gets the dashboard's layout and charts as context; the dashboard itself stays unchanged. Omit when the change does not reference a dashboard."
|
|
2690
|
+
},
|
|
2691
|
+
"prompt": {
|
|
2692
|
+
"description": "A self-contained brief of the change for the coding agent, which works from the app's current source and explores the semantic layer itself, but sees neither this conversation nor its query results. Describe what to change and the outcome you expect; carry over any analysis this thread already settled as queries — a number pasted into the brief gets hardcoded into the app.",
|
|
2693
|
+
"type": "string"
|
|
2694
|
+
},
|
|
2695
|
+
"themeSlug": {
|
|
2696
|
+
"anyOf": [
|
|
2697
|
+
{
|
|
2698
|
+
"type": "string"
|
|
2699
|
+
},
|
|
2700
|
+
{
|
|
2701
|
+
"type": "null"
|
|
2702
|
+
}
|
|
2703
|
+
],
|
|
2704
|
+
"default": null,
|
|
2705
|
+
"description": "Organization theme to build the app with: its slug, from the attached context (\"Theme: <name> (slug: <slug>)\"). Omit when no theme is given — the organization default applies. An unknown slug returns an error listing the valid slugs and starts no build. On an existing app, passing it switches the app's theme; omit it unless the user asked to switch the theme in this request, so the app keeps its current theme."
|
|
2706
|
+
}
|
|
2707
|
+
},
|
|
2708
|
+
"required": ["appSlug", "prompt"],
|
|
2709
|
+
"type": "object"
|
|
2710
|
+
},
|
|
2711
|
+
"name": "iterate_data_app",
|
|
2712
|
+
"outputSchema": {
|
|
2713
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2714
|
+
"additionalProperties": false,
|
|
2715
|
+
"properties": {
|
|
2716
|
+
"slug": {
|
|
2717
|
+
"description": "The app's permanent slug. Poll get_data_app_build_status with it.",
|
|
2718
|
+
"type": "string"
|
|
2719
|
+
},
|
|
2720
|
+
"version": {
|
|
2721
|
+
"description": "The version of the app this build produces.",
|
|
2722
|
+
"exclusiveMinimum": 0,
|
|
2723
|
+
"maximum": 9007199254740991,
|
|
2724
|
+
"type": "integer"
|
|
2725
|
+
}
|
|
2726
|
+
},
|
|
2727
|
+
"required": ["slug", "version"],
|
|
2728
|
+
"type": "object"
|
|
2729
|
+
},
|
|
2730
|
+
"title": "Iterate on data app"
|
|
2731
|
+
},
|
|
2732
|
+
{
|
|
2733
|
+
"annotations": {
|
|
2734
|
+
"destructiveHint": false,
|
|
2735
|
+
"idempotentHint": true,
|
|
2736
|
+
"openWorldHint": false,
|
|
2737
|
+
"readOnlyHint": true
|
|
2738
|
+
},
|
|
2739
|
+
"description": "List accessible AI agents for the required projectUuid. Each agent is pre-configured with specific explores, tags, verified questions, and instructions that define its domain expertise. Prefer route_agent for automatic selection.",
|
|
2740
|
+
"inputSchema": {
|
|
2741
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2742
|
+
"properties": {
|
|
2743
|
+
"projectUuid": {
|
|
2744
|
+
"type": "string"
|
|
2745
|
+
}
|
|
2746
|
+
},
|
|
2747
|
+
"type": "object"
|
|
2748
|
+
},
|
|
2749
|
+
"name": "list_agents",
|
|
2750
|
+
"outputSchema": null,
|
|
2751
|
+
"title": "List agents"
|
|
2752
|
+
},
|
|
2753
|
+
{
|
|
2754
|
+
"annotations": {
|
|
2755
|
+
"destructiveHint": false,
|
|
2756
|
+
"idempotentHint": true,
|
|
2757
|
+
"openWorldHint": false,
|
|
2758
|
+
"readOnlyHint": true
|
|
2759
|
+
},
|
|
2760
|
+
"description": "Tool: \"list_content\"\nPurpose:\nLists accessible Lightdash content in a project as a browsable hierarchy.\n\nUsage tips:\n- By default, lists root-level spaces.\n- Pass a spaceSlug to list direct children and content inside that space.\n- Use page for pagination. Page starts at 1.\n- Results include names, slugs, content types, URLs, and space content counts.",
|
|
2761
|
+
"inputSchema": {
|
|
2762
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2763
|
+
"properties": {
|
|
2764
|
+
"page": {
|
|
2765
|
+
"description": "Paginate results starting at 1. Pass a positive number (e.g. 1), never NaN or the string \"null\".",
|
|
2766
|
+
"exclusiveMinimum": 0,
|
|
2767
|
+
"type": "number"
|
|
2768
|
+
},
|
|
2769
|
+
"spaceSlug": {
|
|
2770
|
+
"description": "Optional space slug/path to list. Use null to list root-level content.",
|
|
2771
|
+
"type": "string"
|
|
2772
|
+
}
|
|
2773
|
+
},
|
|
2774
|
+
"type": "object"
|
|
2775
|
+
},
|
|
2776
|
+
"name": "list_content",
|
|
2777
|
+
"outputSchema": null,
|
|
2778
|
+
"title": "List content"
|
|
2779
|
+
},
|
|
2780
|
+
{
|
|
2781
|
+
"annotations": {
|
|
2782
|
+
"destructiveHint": false,
|
|
2783
|
+
"idempotentHint": true,
|
|
2784
|
+
"openWorldHint": false,
|
|
2785
|
+
"readOnlyHint": true
|
|
2786
|
+
},
|
|
2787
|
+
"description": "Tool: list_custom_chart_types\n\nBrowse the project's custom chart types (including ones installed from the library), newest first, one page at a time. Page starts at 1.\n\n- Each item has the same fields as find_custom_chart_types: latest version, field slots, config options and a Chart Studio link.\n- Use find_custom_chart_types to search by text or fetch one by slug.\n",
|
|
2788
|
+
"inputSchema": {
|
|
2789
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2790
|
+
"properties": {
|
|
2791
|
+
"page": {
|
|
2792
|
+
"description": "Paginate results starting at 1. Pass a positive number (e.g. 1), never NaN or the string \"null\".",
|
|
2793
|
+
"exclusiveMinimum": 0,
|
|
2794
|
+
"type": "number"
|
|
2795
|
+
}
|
|
2796
|
+
},
|
|
2797
|
+
"type": "object"
|
|
2798
|
+
},
|
|
2799
|
+
"name": "list_custom_chart_types",
|
|
2800
|
+
"outputSchema": {
|
|
2801
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2802
|
+
"additionalProperties": false,
|
|
2803
|
+
"properties": {
|
|
2804
|
+
"pagination": {
|
|
2805
|
+
"additionalProperties": false,
|
|
2806
|
+
"properties": {
|
|
2807
|
+
"page": {
|
|
2808
|
+
"maximum": 9007199254740991,
|
|
2809
|
+
"minimum": -9007199254740991,
|
|
2810
|
+
"type": "integer"
|
|
2811
|
+
},
|
|
2812
|
+
"pageSize": {
|
|
2813
|
+
"maximum": 9007199254740991,
|
|
2814
|
+
"minimum": -9007199254740991,
|
|
2815
|
+
"type": "integer"
|
|
2816
|
+
},
|
|
2817
|
+
"totalPageCount": {
|
|
2818
|
+
"maximum": 9007199254740991,
|
|
2819
|
+
"minimum": -9007199254740991,
|
|
2820
|
+
"type": "integer"
|
|
2821
|
+
},
|
|
2822
|
+
"totalResults": {
|
|
2823
|
+
"maximum": 9007199254740991,
|
|
2824
|
+
"minimum": -9007199254740991,
|
|
2825
|
+
"type": "integer"
|
|
2826
|
+
}
|
|
2144
2827
|
},
|
|
2145
|
-
"
|
|
2828
|
+
"required": [
|
|
2829
|
+
"page",
|
|
2830
|
+
"pageSize",
|
|
2831
|
+
"totalResults",
|
|
2832
|
+
"totalPageCount"
|
|
2833
|
+
],
|
|
2834
|
+
"type": "object"
|
|
2146
2835
|
},
|
|
2147
|
-
"
|
|
2836
|
+
"results": {
|
|
2837
|
+
"description": "Chart types on this page, newest first.",
|
|
2148
2838
|
"items": {
|
|
2149
2839
|
"additionalProperties": false,
|
|
2150
2840
|
"properties": {
|
|
2151
|
-
"
|
|
2152
|
-
"enum": ["chart", "dashboard"],
|
|
2153
|
-
"type": "string"
|
|
2154
|
-
},
|
|
2155
|
-
"artifactVersionUuid": {
|
|
2841
|
+
"chartStudioUrl": {
|
|
2156
2842
|
"type": "string"
|
|
2157
2843
|
},
|
|
2158
|
-
"chartConfig": {
|
|
2159
|
-
"additionalProperties": {},
|
|
2160
|
-
"propertyNames": {
|
|
2161
|
-
"type": "string"
|
|
2162
|
-
},
|
|
2163
|
-
"type": "object"
|
|
2164
|
-
},
|
|
2165
2844
|
"description": {
|
|
2166
2845
|
"anyOf": [
|
|
2167
2846
|
{
|
|
@@ -2172,254 +2851,301 @@
|
|
|
2172
2851
|
}
|
|
2173
2852
|
]
|
|
2174
2853
|
},
|
|
2175
|
-
"
|
|
2176
|
-
"type": "
|
|
2854
|
+
"name": {
|
|
2855
|
+
"type": "string"
|
|
2177
2856
|
},
|
|
2178
|
-
"
|
|
2179
|
-
"
|
|
2180
|
-
|
|
2181
|
-
|
|
2857
|
+
"slug": {
|
|
2858
|
+
"type": "string"
|
|
2859
|
+
},
|
|
2860
|
+
"version": {
|
|
2861
|
+
"description": "Latest ready version, the one a new chart renders.",
|
|
2862
|
+
"exclusiveMinimum": 0,
|
|
2863
|
+
"maximum": 9007199254740991,
|
|
2864
|
+
"type": "integer"
|
|
2865
|
+
},
|
|
2866
|
+
"vizSchema": {
|
|
2867
|
+
"additionalProperties": false,
|
|
2868
|
+
"properties": {
|
|
2869
|
+
"colorPalette": {
|
|
2870
|
+
"anyOf": [
|
|
2871
|
+
{
|
|
2872
|
+
"additionalProperties": false,
|
|
2873
|
+
"properties": {
|
|
2874
|
+
"group": {
|
|
2875
|
+
"anyOf": [
|
|
2876
|
+
{
|
|
2877
|
+
"type": "string"
|
|
2878
|
+
},
|
|
2879
|
+
{
|
|
2880
|
+
"type": "null"
|
|
2881
|
+
}
|
|
2882
|
+
]
|
|
2883
|
+
}
|
|
2884
|
+
},
|
|
2885
|
+
"required": ["group"],
|
|
2886
|
+
"type": "object"
|
|
2887
|
+
},
|
|
2888
|
+
{
|
|
2889
|
+
"type": "null"
|
|
2890
|
+
}
|
|
2891
|
+
],
|
|
2892
|
+
"description": "Set when the chart colours series from the palette."
|
|
2893
|
+
},
|
|
2894
|
+
"configOptions": {
|
|
2895
|
+
"description": "Settings the chart accepts in optionValues.",
|
|
2896
|
+
"items": {
|
|
2897
|
+
"additionalProperties": false,
|
|
2898
|
+
"properties": {
|
|
2899
|
+
"choices": {
|
|
2900
|
+
"anyOf": [
|
|
2901
|
+
{
|
|
2902
|
+
"items": {
|
|
2903
|
+
"additionalProperties": false,
|
|
2904
|
+
"properties": {
|
|
2905
|
+
"label": {
|
|
2906
|
+
"type": "string"
|
|
2907
|
+
},
|
|
2908
|
+
"value": {
|
|
2909
|
+
"type": "string"
|
|
2910
|
+
}
|
|
2911
|
+
},
|
|
2912
|
+
"required": [
|
|
2913
|
+
"value",
|
|
2914
|
+
"label"
|
|
2915
|
+
],
|
|
2916
|
+
"type": "object"
|
|
2917
|
+
},
|
|
2918
|
+
"type": "array"
|
|
2919
|
+
},
|
|
2920
|
+
{
|
|
2921
|
+
"type": "null"
|
|
2922
|
+
}
|
|
2923
|
+
],
|
|
2924
|
+
"description": "Allowed values of a select option."
|
|
2925
|
+
},
|
|
2926
|
+
"default": {
|
|
2927
|
+
"anyOf": [
|
|
2928
|
+
{
|
|
2929
|
+
"type": "boolean"
|
|
2930
|
+
},
|
|
2931
|
+
{
|
|
2932
|
+
"type": "number"
|
|
2933
|
+
},
|
|
2934
|
+
{
|
|
2935
|
+
"type": "string"
|
|
2936
|
+
},
|
|
2937
|
+
{
|
|
2938
|
+
"additionalProperties": false,
|
|
2939
|
+
"properties": {
|
|
2940
|
+
"colors": {
|
|
2941
|
+
"items": {
|
|
2942
|
+
"type": "string"
|
|
2943
|
+
},
|
|
2944
|
+
"maxItems": 5,
|
|
2945
|
+
"minItems": 2,
|
|
2946
|
+
"type": "array"
|
|
2947
|
+
},
|
|
2948
|
+
"max": {
|
|
2949
|
+
"anyOf": [
|
|
2950
|
+
{
|
|
2951
|
+
"type": "number"
|
|
2952
|
+
},
|
|
2953
|
+
{
|
|
2954
|
+
"const": "auto",
|
|
2955
|
+
"type": "string"
|
|
2956
|
+
}
|
|
2957
|
+
]
|
|
2958
|
+
},
|
|
2959
|
+
"min": {
|
|
2960
|
+
"anyOf": [
|
|
2961
|
+
{
|
|
2962
|
+
"type": "number"
|
|
2963
|
+
},
|
|
2964
|
+
{
|
|
2965
|
+
"const": "auto",
|
|
2966
|
+
"type": "string"
|
|
2967
|
+
}
|
|
2968
|
+
]
|
|
2969
|
+
}
|
|
2970
|
+
},
|
|
2971
|
+
"required": [
|
|
2972
|
+
"colors",
|
|
2973
|
+
"min",
|
|
2974
|
+
"max"
|
|
2975
|
+
],
|
|
2976
|
+
"type": "object"
|
|
2977
|
+
}
|
|
2978
|
+
]
|
|
2979
|
+
},
|
|
2980
|
+
"group": {
|
|
2981
|
+
"anyOf": [
|
|
2982
|
+
{
|
|
2983
|
+
"type": "string"
|
|
2984
|
+
},
|
|
2985
|
+
{
|
|
2986
|
+
"type": "null"
|
|
2987
|
+
}
|
|
2988
|
+
]
|
|
2989
|
+
},
|
|
2990
|
+
"label": {
|
|
2991
|
+
"type": "string"
|
|
2992
|
+
},
|
|
2993
|
+
"max": {
|
|
2994
|
+
"anyOf": [
|
|
2995
|
+
{
|
|
2996
|
+
"type": "number"
|
|
2997
|
+
},
|
|
2998
|
+
{
|
|
2999
|
+
"type": "null"
|
|
3000
|
+
}
|
|
3001
|
+
]
|
|
3002
|
+
},
|
|
3003
|
+
"min": {
|
|
3004
|
+
"anyOf": [
|
|
3005
|
+
{
|
|
3006
|
+
"type": "number"
|
|
3007
|
+
},
|
|
3008
|
+
{
|
|
3009
|
+
"type": "null"
|
|
3010
|
+
}
|
|
3011
|
+
]
|
|
3012
|
+
},
|
|
3013
|
+
"name": {
|
|
3014
|
+
"description": "Option name: the key to set in optionValues.",
|
|
3015
|
+
"type": "string"
|
|
3016
|
+
},
|
|
3017
|
+
"type": {
|
|
3018
|
+
"enum": [
|
|
3019
|
+
"boolean",
|
|
3020
|
+
"select",
|
|
3021
|
+
"number",
|
|
3022
|
+
"text",
|
|
3023
|
+
"color",
|
|
3024
|
+
"gradient"
|
|
3025
|
+
],
|
|
3026
|
+
"type": "string"
|
|
3027
|
+
}
|
|
3028
|
+
},
|
|
3029
|
+
"required": [
|
|
3030
|
+
"name",
|
|
3031
|
+
"label",
|
|
3032
|
+
"type",
|
|
3033
|
+
"group",
|
|
3034
|
+
"default",
|
|
3035
|
+
"choices",
|
|
3036
|
+
"min",
|
|
3037
|
+
"max"
|
|
3038
|
+
],
|
|
3039
|
+
"type": "object"
|
|
3040
|
+
},
|
|
3041
|
+
"type": "array"
|
|
3042
|
+
},
|
|
3043
|
+
"fields": {
|
|
3044
|
+
"description": "Field slots to bind query fields to.",
|
|
3045
|
+
"items": {
|
|
3046
|
+
"additionalProperties": false,
|
|
3047
|
+
"properties": {
|
|
3048
|
+
"description": {
|
|
3049
|
+
"anyOf": [
|
|
3050
|
+
{
|
|
3051
|
+
"type": "string"
|
|
3052
|
+
},
|
|
3053
|
+
{
|
|
3054
|
+
"type": "null"
|
|
3055
|
+
}
|
|
3056
|
+
]
|
|
3057
|
+
},
|
|
3058
|
+
"label": {
|
|
3059
|
+
"type": "string"
|
|
3060
|
+
},
|
|
3061
|
+
"multiple": {
|
|
3062
|
+
"description": "Whether the slot takes an ordered list.",
|
|
3063
|
+
"type": "boolean"
|
|
3064
|
+
},
|
|
3065
|
+
"name": {
|
|
3066
|
+
"description": "Slot name: the key to bind in fieldMapping.",
|
|
3067
|
+
"type": "string"
|
|
3068
|
+
},
|
|
3069
|
+
"required": {
|
|
3070
|
+
"type": "boolean"
|
|
3071
|
+
},
|
|
3072
|
+
"type": {
|
|
3073
|
+
"enum": [
|
|
3074
|
+
"dimension",
|
|
3075
|
+
"metric",
|
|
3076
|
+
"series",
|
|
3077
|
+
"column"
|
|
3078
|
+
],
|
|
3079
|
+
"type": "string"
|
|
3080
|
+
}
|
|
3081
|
+
},
|
|
3082
|
+
"required": [
|
|
3083
|
+
"name",
|
|
3084
|
+
"label",
|
|
3085
|
+
"type",
|
|
3086
|
+
"required",
|
|
3087
|
+
"multiple",
|
|
3088
|
+
"description"
|
|
3089
|
+
],
|
|
3090
|
+
"type": "object"
|
|
3091
|
+
},
|
|
3092
|
+
"type": "array"
|
|
2182
3093
|
},
|
|
2183
|
-
{
|
|
2184
|
-
"
|
|
2185
|
-
|
|
2186
|
-
|
|
2187
|
-
|
|
2188
|
-
|
|
2189
|
-
|
|
2190
|
-
|
|
2191
|
-
|
|
3094
|
+
"hierarchy": {
|
|
3095
|
+
"anyOf": [
|
|
3096
|
+
{
|
|
3097
|
+
"additionalProperties": false,
|
|
3098
|
+
"properties": {
|
|
3099
|
+
"field": {
|
|
3100
|
+
"type": "string"
|
|
3101
|
+
}
|
|
3102
|
+
},
|
|
3103
|
+
"required": ["field"],
|
|
3104
|
+
"type": "object"
|
|
3105
|
+
},
|
|
3106
|
+
{
|
|
3107
|
+
"type": "null"
|
|
3108
|
+
}
|
|
3109
|
+
]
|
|
2192
3110
|
},
|
|
2193
|
-
{
|
|
2194
|
-
"
|
|
3111
|
+
"inputGuidance": {
|
|
3112
|
+
"anyOf": [
|
|
3113
|
+
{
|
|
3114
|
+
"type": "string"
|
|
3115
|
+
},
|
|
3116
|
+
{
|
|
3117
|
+
"type": "null"
|
|
3118
|
+
}
|
|
3119
|
+
]
|
|
2195
3120
|
}
|
|
2196
|
-
|
|
3121
|
+
},
|
|
3122
|
+
"required": [
|
|
3123
|
+
"fields",
|
|
3124
|
+
"configOptions",
|
|
3125
|
+
"colorPalette",
|
|
3126
|
+
"hierarchy",
|
|
3127
|
+
"inputGuidance"
|
|
3128
|
+
],
|
|
3129
|
+
"type": "object"
|
|
2197
3130
|
}
|
|
2198
3131
|
},
|
|
2199
3132
|
"required": [
|
|
2200
|
-
"
|
|
2201
|
-
"
|
|
2202
|
-
"artifactType",
|
|
2203
|
-
"verifiedQuestion",
|
|
2204
|
-
"title",
|
|
3133
|
+
"slug",
|
|
3134
|
+
"name",
|
|
2205
3135
|
"description",
|
|
2206
|
-
"
|
|
3136
|
+
"version",
|
|
3137
|
+
"chartStudioUrl",
|
|
3138
|
+
"vizSchema"
|
|
2207
3139
|
],
|
|
2208
3140
|
"type": "object"
|
|
2209
3141
|
},
|
|
2210
3142
|
"type": "array"
|
|
2211
3143
|
}
|
|
2212
3144
|
},
|
|
2213
|
-
"required": [
|
|
2214
|
-
"description",
|
|
2215
|
-
"exploreName",
|
|
2216
|
-
"patterns",
|
|
2217
|
-
"fuzzyMatches"
|
|
2218
|
-
],
|
|
2219
|
-
"type": "object"
|
|
2220
|
-
},
|
|
2221
|
-
"title": "Search fields"
|
|
2222
|
-
},
|
|
2223
|
-
{
|
|
2224
|
-
"annotations": {
|
|
2225
|
-
"destructiveHint": false,
|
|
2226
|
-
"idempotentHint": false,
|
|
2227
|
-
"openWorldHint": false,
|
|
2228
|
-
"readOnlyHint": false
|
|
2229
|
-
},
|
|
2230
|
-
"description": "Tool: iterate_custom_chart_type\n\nStart a build that adds a version to an existing custom chart type from a follow-up brief. For a new chart type use create_custom_chart_type; for a data app use iterate_data_app.\n\n- Describe the change, not the whole chart type. The build keeps the chart type's inputs, so charts that already use it keep working. Pass queryUuid to share the first rows of a completed run_metric_query as sample data. Pass themeSlug only to switch the theme.\n- Poll get_data_app_build_status with appSlug set to the slug until it is \"ready\", \"error\" or \"cancelled\". If a version is already building, wait for it to end before calling again.\n- A chart type created over MCP is the caller's personal one, in no space, so a space-restricted agent-scoped session cannot read it. Omit agentUuid here and in get_data_app_build_status.\n",
|
|
2231
|
-
"inputSchema": {
|
|
2232
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2233
|
-
"properties": {
|
|
2234
|
-
"prompt": {
|
|
2235
|
-
"description": "Self-contained brief of the change for the coding agent, which works from the chart type's current source. The agent does not see this conversation, only the sample rows from queryUuid if given.",
|
|
2236
|
-
"type": "string"
|
|
2237
|
-
},
|
|
2238
|
-
"queryUuid": {
|
|
2239
|
-
"anyOf": [
|
|
2240
|
-
{
|
|
2241
|
-
"format": "uuid",
|
|
2242
|
-
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
|
|
2243
|
-
"type": "string"
|
|
2244
|
-
},
|
|
2245
|
-
{
|
|
2246
|
-
"type": "null"
|
|
2247
|
-
}
|
|
2248
|
-
],
|
|
2249
|
-
"default": null,
|
|
2250
|
-
"description": "Optional uuid of a completed run_metric_query whose first rows are shared with the build as sample data. It does not bind the chart type to that query."
|
|
2251
|
-
},
|
|
2252
|
-
"slug": {
|
|
2253
|
-
"description": "Slug of the custom chart type to change, from an earlier create_custom_chart_type result or its Chart Studio URL.",
|
|
2254
|
-
"type": "string"
|
|
2255
|
-
},
|
|
2256
|
-
"themeSlug": {
|
|
2257
|
-
"anyOf": [
|
|
2258
|
-
{
|
|
2259
|
-
"type": "string"
|
|
2260
|
-
},
|
|
2261
|
-
{
|
|
2262
|
-
"type": "null"
|
|
2263
|
-
}
|
|
2264
|
-
],
|
|
2265
|
-
"default": null,
|
|
2266
|
-
"description": "Organization theme to rebuild the chart type with: its slug, from list_data_app_themes. Omit it to keep the current theme. An unknown slug returns an error and starts no build."
|
|
2267
|
-
}
|
|
2268
|
-
},
|
|
2269
|
-
"required": ["slug", "prompt"],
|
|
2270
|
-
"type": "object"
|
|
2271
|
-
},
|
|
2272
|
-
"name": "iterate_custom_chart_type",
|
|
2273
|
-
"outputSchema": {
|
|
2274
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2275
|
-
"additionalProperties": false,
|
|
2276
|
-
"properties": {
|
|
2277
|
-
"slug": {
|
|
2278
|
-
"description": "The chart type's permanent slug. Pass it as appSlug to get_data_app_build_status.",
|
|
2279
|
-
"type": "string"
|
|
2280
|
-
},
|
|
2281
|
-
"version": {
|
|
2282
|
-
"description": "The version of the chart type this build produces.",
|
|
2283
|
-
"exclusiveMinimum": 0,
|
|
2284
|
-
"maximum": 9007199254740991,
|
|
2285
|
-
"type": "integer"
|
|
2286
|
-
}
|
|
2287
|
-
},
|
|
2288
|
-
"required": ["slug", "version"],
|
|
2289
|
-
"type": "object"
|
|
2290
|
-
},
|
|
2291
|
-
"title": "Iterate on custom chart type"
|
|
2292
|
-
},
|
|
2293
|
-
{
|
|
2294
|
-
"annotations": {
|
|
2295
|
-
"destructiveHint": false,
|
|
2296
|
-
"idempotentHint": false,
|
|
2297
|
-
"openWorldHint": false,
|
|
2298
|
-
"readOnlyHint": false
|
|
2299
|
-
},
|
|
2300
|
-
"description": "Tool: iterate_data_app\n\nPurpose:\nStart a build that adds a version to an existing data app from a follow-up brief. Use it to change, fix, or extend an app that already exists; generate_data_app is the tool for a brand-new app.\n\nImportant:\n- The coding agent works from the app's current source, so the brief describes the change rather than restating the whole app.\n- The app's name and slug stay as they are. The build adds a version to the app named by appSlug.\n- The build runs in the background for several minutes. This call returns as soon as the build has started. Poll get_data_app_build_status with the same appSlug every 15 seconds until its status is \"ready\", \"error\", or \"cancelled\". Call this tool once per request.\n- While a version is already building for the app, this call fails with \"A version is already building for this app\". Poll get_data_app_build_status until that build reaches a terminal status, then call this tool again.\n- An agent-scoped session restricted to specific spaces cannot read a personal app. Call this tool and get_data_app_build_status without agentUuid to build and poll an app you own.\n- Pass themeSlug only when the user asks to switch the app's theme; omitting it keeps the current one. An unknown themeSlug fails before the build starts and lists the valid slugs, which list_data_app_themes also returns.\n\nResponse shape (MCP CallToolResult):\n- content: [{ type: \"text\", text: \"<confirmation that the build started>\" }]\n- structuredContent: {\n slug: string, // the app's slug, unchanged by this build\n version: number // the version of the app this build produces\n }\n\nErrors: an unknown appSlug, themeSlug, dashboardSlug, or chartSlug returns an error and starts no build. So does a custom chart type's slug: use iterate_custom_chart_type for those.\n",
|
|
2301
|
-
"inputSchema": {
|
|
2302
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2303
|
-
"properties": {
|
|
2304
|
-
"appSlug": {
|
|
2305
|
-
"description": "Slug of the data app to change — from an earlier generateDataApp or iterateDataApp result, findContent, or readContent.",
|
|
2306
|
-
"type": "string"
|
|
2307
|
-
},
|
|
2308
|
-
"chartSlugs": {
|
|
2309
|
-
"anyOf": [
|
|
2310
|
-
{
|
|
2311
|
-
"items": {
|
|
2312
|
-
"type": "string"
|
|
2313
|
-
},
|
|
2314
|
-
"type": "array"
|
|
2315
|
-
},
|
|
2316
|
-
{
|
|
2317
|
-
"type": "null"
|
|
2318
|
-
}
|
|
2319
|
-
],
|
|
2320
|
-
"default": null,
|
|
2321
|
-
"description": "Saved charts (slugs from findContent) whose queries the change builds on; the charts themselves stay unchanged. Omit when the change does not reference saved charts."
|
|
2322
|
-
},
|
|
2323
|
-
"dashboardSlug": {
|
|
2324
|
-
"anyOf": [
|
|
2325
|
-
{
|
|
2326
|
-
"type": "string"
|
|
2327
|
-
},
|
|
2328
|
-
{
|
|
2329
|
-
"type": "null"
|
|
2330
|
-
}
|
|
2331
|
-
],
|
|
2332
|
-
"default": null,
|
|
2333
|
-
"description": "Pull in an existing dashboard: its slug (from findContent). The coding agent gets the dashboard's layout and charts as context; the dashboard itself stays unchanged. Omit when the change does not reference a dashboard."
|
|
2334
|
-
},
|
|
2335
|
-
"prompt": {
|
|
2336
|
-
"description": "A self-contained brief of the change for the coding agent, which works from the app's current source and explores the semantic layer itself, but sees neither this conversation nor its query results. Describe what to change and the outcome you expect; carry over any analysis this thread already settled as queries — a number pasted into the brief gets hardcoded into the app.",
|
|
2337
|
-
"type": "string"
|
|
2338
|
-
},
|
|
2339
|
-
"themeSlug": {
|
|
2340
|
-
"anyOf": [
|
|
2341
|
-
{
|
|
2342
|
-
"type": "string"
|
|
2343
|
-
},
|
|
2344
|
-
{
|
|
2345
|
-
"type": "null"
|
|
2346
|
-
}
|
|
2347
|
-
],
|
|
2348
|
-
"default": null,
|
|
2349
|
-
"description": "Organization theme to build the app with: its slug, from the attached context (\"Theme: <name> (slug: <slug>)\"). Omit when no theme is given — the organization default applies. An unknown slug returns an error listing the valid slugs and starts no build. On an existing app, passing it switches the app's theme; omit it unless the user asked to switch the theme in this request, so the app keeps its current theme."
|
|
2350
|
-
}
|
|
2351
|
-
},
|
|
2352
|
-
"required": ["appSlug", "prompt"],
|
|
2353
|
-
"type": "object"
|
|
2354
|
-
},
|
|
2355
|
-
"name": "iterate_data_app",
|
|
2356
|
-
"outputSchema": {
|
|
2357
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2358
|
-
"additionalProperties": false,
|
|
2359
|
-
"properties": {
|
|
2360
|
-
"slug": {
|
|
2361
|
-
"description": "The app's permanent slug. Poll get_data_app_build_status with it.",
|
|
2362
|
-
"type": "string"
|
|
2363
|
-
},
|
|
2364
|
-
"version": {
|
|
2365
|
-
"description": "The version of the app this build produces.",
|
|
2366
|
-
"exclusiveMinimum": 0,
|
|
2367
|
-
"maximum": 9007199254740991,
|
|
2368
|
-
"type": "integer"
|
|
2369
|
-
}
|
|
2370
|
-
},
|
|
2371
|
-
"required": ["slug", "version"],
|
|
2372
|
-
"type": "object"
|
|
2373
|
-
},
|
|
2374
|
-
"title": "Iterate on data app"
|
|
2375
|
-
},
|
|
2376
|
-
{
|
|
2377
|
-
"annotations": {
|
|
2378
|
-
"destructiveHint": false,
|
|
2379
|
-
"idempotentHint": true,
|
|
2380
|
-
"openWorldHint": false,
|
|
2381
|
-
"readOnlyHint": true
|
|
2382
|
-
},
|
|
2383
|
-
"description": "List accessible AI agents for the required projectUuid. Each agent is pre-configured with specific explores, tags, verified questions, and instructions that define its domain expertise. Prefer route_agent for automatic selection.",
|
|
2384
|
-
"inputSchema": {
|
|
2385
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2386
|
-
"properties": {
|
|
2387
|
-
"projectUuid": {
|
|
2388
|
-
"type": "string"
|
|
2389
|
-
}
|
|
2390
|
-
},
|
|
2391
|
-
"type": "object"
|
|
2392
|
-
},
|
|
2393
|
-
"name": "list_agents",
|
|
2394
|
-
"outputSchema": null,
|
|
2395
|
-
"title": "List agents"
|
|
2396
|
-
},
|
|
2397
|
-
{
|
|
2398
|
-
"annotations": {
|
|
2399
|
-
"destructiveHint": false,
|
|
2400
|
-
"idempotentHint": true,
|
|
2401
|
-
"openWorldHint": false,
|
|
2402
|
-
"readOnlyHint": true
|
|
2403
|
-
},
|
|
2404
|
-
"description": "Tool: \"list_content\"\nPurpose:\nLists accessible Lightdash content in a project as a browsable hierarchy.\n\nUsage tips:\n- By default, lists root-level spaces.\n- Pass a spaceSlug to list direct children and content inside that space.\n- Use page for pagination. Page starts at 1.\n- Results include names, slugs, content types, URLs, and space content counts.",
|
|
2405
|
-
"inputSchema": {
|
|
2406
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2407
|
-
"properties": {
|
|
2408
|
-
"page": {
|
|
2409
|
-
"description": "Paginate results starting at 1. Pass a positive number (e.g. 1), never NaN or the string \"null\".",
|
|
2410
|
-
"exclusiveMinimum": 0,
|
|
2411
|
-
"type": "number"
|
|
2412
|
-
},
|
|
2413
|
-
"spaceSlug": {
|
|
2414
|
-
"description": "Optional space slug/path to list. Use null to list root-level content.",
|
|
2415
|
-
"type": "string"
|
|
2416
|
-
}
|
|
2417
|
-
},
|
|
3145
|
+
"required": ["pagination", "results"],
|
|
2418
3146
|
"type": "object"
|
|
2419
3147
|
},
|
|
2420
|
-
"
|
|
2421
|
-
"outputSchema": null,
|
|
2422
|
-
"title": "List content"
|
|
3148
|
+
"title": "List custom chart types"
|
|
2423
3149
|
},
|
|
2424
3150
|
{
|
|
2425
3151
|
"annotations": {
|