@lightdash/common 3.106.1 → 3.108.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/adminTypes.d.ts +8 -0
- package/dist/cjs/ee/AiAgent/adminTypes.d.ts.map +1 -1
- package/dist/cjs/ee/AiAgent/composerArtifact.d.ts +5 -2
- package/dist/cjs/ee/AiAgent/composerArtifact.d.ts.map +1 -1
- package/dist/cjs/ee/AiAgent/composerArtifact.js +7 -7
- package/dist/cjs/ee/AiAgent/composerArtifact.js.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolComposerQueryArgs.d.ts +29 -0
- package/dist/cjs/ee/AiAgent/schemas/tools/toolComposerQueryArgs.d.ts.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolComposerQueryArgs.js +55 -6
- package/dist/cjs/ee/AiAgent/schemas/tools/toolComposerQueryArgs.js.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolDefinitions.d.ts +2 -2
- package/dist/cjs/ee/AiAgent/schemas/tools/toolDefinitions.d.ts.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolDefinitions.js +4 -2
- package/dist/cjs/ee/AiAgent/schemas/tools/toolDefinitions.js.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolGetQueryResultArgs.js +1 -1
- package/dist/cjs/ee/commercialFeatureFlags.d.ts +0 -1
- package/dist/cjs/ee/commercialFeatureFlags.d.ts.map +1 -1
- package/dist/cjs/ee/commercialFeatureFlags.js +0 -1
- package/dist/cjs/ee/commercialFeatureFlags.js.map +1 -1
- package/dist/cjs/schemas/json/mcp-tools-1.0.json +895 -748
- package/dist/cjs/types/aiPrincipal.d.ts +1 -0
- package/dist/cjs/types/aiPrincipal.d.ts.map +1 -1
- package/dist/cjs/types/aiPrincipal.js +5 -0
- package/dist/cjs/types/aiPrincipal.js.map +1 -1
- package/dist/cjs/types/analytics.d.ts +2 -1
- package/dist/cjs/types/analytics.d.ts.map +1 -1
- package/dist/cjs/types/analytics.js +3 -1
- package/dist/cjs/types/analytics.js.map +1 -1
- package/dist/cjs/types/api.d.ts +0 -1
- package/dist/cjs/types/api.d.ts.map +1 -1
- package/dist/cjs/types/api.js.map +1 -1
- package/dist/cjs/types/queryHistoryList.d.ts.map +1 -1
- package/dist/cjs/types/queryHistoryList.js +1 -0
- package/dist/cjs/types/queryHistoryList.js.map +1 -1
- package/dist/esm/.tsbuildinfo +1 -1
- package/dist/esm/ee/AiAgent/adminTypes.d.ts +8 -0
- package/dist/esm/ee/AiAgent/adminTypes.d.ts.map +1 -1
- package/dist/esm/ee/AiAgent/composerArtifact.d.ts +5 -2
- package/dist/esm/ee/AiAgent/composerArtifact.d.ts.map +1 -1
- package/dist/esm/ee/AiAgent/composerArtifact.js +7 -7
- package/dist/esm/ee/AiAgent/composerArtifact.js.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolComposerQueryArgs.d.ts +29 -0
- package/dist/esm/ee/AiAgent/schemas/tools/toolComposerQueryArgs.d.ts.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolComposerQueryArgs.js +54 -5
- package/dist/esm/ee/AiAgent/schemas/tools/toolComposerQueryArgs.js.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolDefinitions.d.ts +2 -2
- package/dist/esm/ee/AiAgent/schemas/tools/toolDefinitions.d.ts.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolDefinitions.js +5 -3
- package/dist/esm/ee/AiAgent/schemas/tools/toolDefinitions.js.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolGetQueryResultArgs.js +1 -1
- package/dist/esm/ee/commercialFeatureFlags.d.ts +0 -1
- package/dist/esm/ee/commercialFeatureFlags.d.ts.map +1 -1
- package/dist/esm/ee/commercialFeatureFlags.js +0 -1
- package/dist/esm/ee/commercialFeatureFlags.js.map +1 -1
- package/dist/esm/schemas/json/mcp-tools-1.0.json +895 -748
- package/dist/esm/types/aiPrincipal.d.ts +1 -0
- package/dist/esm/types/aiPrincipal.d.ts.map +1 -1
- package/dist/esm/types/aiPrincipal.js +5 -0
- package/dist/esm/types/aiPrincipal.js.map +1 -1
- package/dist/esm/types/analytics.d.ts +2 -1
- package/dist/esm/types/analytics.d.ts.map +1 -1
- package/dist/esm/types/analytics.js +3 -1
- package/dist/esm/types/analytics.js.map +1 -1
- package/dist/esm/types/api.d.ts +0 -1
- package/dist/esm/types/api.d.ts.map +1 -1
- package/dist/esm/types/api.js.map +1 -1
- package/dist/esm/types/queryHistoryList.d.ts.map +1 -1
- package/dist/esm/types/queryHistoryList.js +1 -0
- package/dist/esm/types/queryHistoryList.js.map +1 -1
- package/dist/types/.tsbuildinfo +1 -1
- package/dist/types/ee/AiAgent/adminTypes.d.ts +8 -0
- package/dist/types/ee/AiAgent/adminTypes.d.ts.map +1 -1
- package/dist/types/ee/AiAgent/composerArtifact.d.ts +5 -2
- package/dist/types/ee/AiAgent/composerArtifact.d.ts.map +1 -1
- package/dist/types/ee/AiAgent/composerArtifact.js +7 -7
- package/dist/types/ee/AiAgent/composerArtifact.js.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolComposerQueryArgs.d.ts +29 -0
- package/dist/types/ee/AiAgent/schemas/tools/toolComposerQueryArgs.d.ts.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolComposerQueryArgs.js +54 -5
- package/dist/types/ee/AiAgent/schemas/tools/toolComposerQueryArgs.js.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolDefinitions.d.ts +2 -2
- package/dist/types/ee/AiAgent/schemas/tools/toolDefinitions.d.ts.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolDefinitions.js +5 -3
- package/dist/types/ee/AiAgent/schemas/tools/toolDefinitions.js.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolGetQueryResultArgs.js +1 -1
- package/dist/types/ee/commercialFeatureFlags.d.ts +0 -1
- package/dist/types/ee/commercialFeatureFlags.d.ts.map +1 -1
- package/dist/types/ee/commercialFeatureFlags.js +0 -1
- package/dist/types/ee/commercialFeatureFlags.js.map +1 -1
- package/dist/types/schemas/json/mcp-tools-1.0.json +895 -748
- package/dist/types/types/aiPrincipal.d.ts +1 -0
- package/dist/types/types/aiPrincipal.d.ts.map +1 -1
- package/dist/types/types/aiPrincipal.js +5 -0
- package/dist/types/types/aiPrincipal.js.map +1 -1
- package/dist/types/types/analytics.d.ts +2 -1
- package/dist/types/types/analytics.d.ts.map +1 -1
- package/dist/types/types/analytics.js +3 -1
- package/dist/types/types/analytics.js.map +1 -1
- package/dist/types/types/api.d.ts +0 -1
- package/dist/types/types/api.d.ts.map +1 -1
- package/dist/types/types/api.js.map +1 -1
- package/dist/types/types/queryHistoryList.d.ts.map +1 -1
- package/dist/types/types/queryHistoryList.js +1 -0
- package/dist/types/types/queryHistoryList.js.map +1 -1
- package/package.json +1 -1
|
@@ -1756,7 +1756,7 @@
|
|
|
1756
1756
|
"readOnlyHint": true,
|
|
1757
1757
|
"title": "Get query result"
|
|
1758
1758
|
},
|
|
1759
|
-
"description": "Poll an existing run_sql or
|
|
1759
|
+
"description": "Poll an existing run_sql, run_metric_query or query node 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.",
|
|
1760
1760
|
"inputSchema": {
|
|
1761
1761
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1762
1762
|
"properties": {
|
|
@@ -3158,307 +3158,792 @@
|
|
|
3158
3158
|
"idempotentHint": true,
|
|
3159
3159
|
"openWorldHint": false,
|
|
3160
3160
|
"readOnlyHint": true,
|
|
3161
|
-
"title": "
|
|
3162
|
-
},
|
|
3163
|
-
"description": "Read a dashboard, chart, SQL chart or data app as JSON by its slug. Dashboard chart tiles include a read-only chartQuery (the explore and field ids the chart uses) for targeting dashboard filters per tile without reading each chart. Data apps are read-only: a view of what the app shows and its per-explore data references, without code.",
|
|
3164
|
-
"inputSchema": {
|
|
3165
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3166
|
-
"properties": {
|
|
3167
|
-
"slug": {
|
|
3168
|
-
"description": "Slug of the content to read.",
|
|
3169
|
-
"minLength": 1,
|
|
3170
|
-
"type": "string"
|
|
3171
|
-
},
|
|
3172
|
-
"type": {
|
|
3173
|
-
"description": "Type of Lightdash content to read.",
|
|
3174
|
-
"enum": ["dashboard", "chart", "sql_chart", "data_app"],
|
|
3175
|
-
"type": "string"
|
|
3176
|
-
}
|
|
3177
|
-
},
|
|
3178
|
-
"required": ["slug", "type"],
|
|
3179
|
-
"type": "object"
|
|
3180
|
-
},
|
|
3181
|
-
"name": "read_content",
|
|
3182
|
-
"outputSchema": null,
|
|
3183
|
-
"title": "Read content"
|
|
3184
|
-
},
|
|
3185
|
-
{
|
|
3186
|
-
"annotations": {
|
|
3187
|
-
"destructiveHint": false,
|
|
3188
|
-
"idempotentHint": true,
|
|
3189
|
-
"openWorldHint": false,
|
|
3190
|
-
"readOnlyHint": true,
|
|
3191
|
-
"title": "Read Skill"
|
|
3161
|
+
"title": "Run composer queries"
|
|
3192
3162
|
},
|
|
3193
|
-
"description": "
|
|
3163
|
+
"description": "Run a pipeline: one or more nodes submitted together, where duckdb and python nodes join or transform other nodes' results. A pipeline of one node runs a single semantic-layer or SQL query, and later calls can reuse its node.\n\nNode kinds:\n- \"semanticLayer\": a metric query against an explore. Result columns are the requested field ids.\n- \"sql\": raw SQL against the project warehouse; available only when run_sql is.\n- \"external\": DuckDB SQL over uploaded or connected tables declared in \"tables\".\n- \"duckdb\": DuckDB SQL over other results declared in \"references\".\n- \"python\": pandas code over other results declared in \"references\".\n\nA node reads only the rows its references returned, so a referenced result that reached its limit is incomplete: before totalling, averaging or ranking over it, give that node a limit that holds its whole population, or aggregate there.\n\nA python node's \"code\" defines `def run(inputs, params)`, and semanticLayer \"filters\" are flat expression strings; each field documents its contract.\n\nReuse earlier nodes: a result returns a sessionId once a node has finished; finished nodes are saved in it. On a follow-up, pass that sessionId and read saved nodes by node id in \"references\", submitting only the new nodes. Reused nodes come with everything they read and are served from cache when possible, so results come back faster. A saved node id names one node for the whole session, so give a changed node a new node id; a failed or unfinished node is not saved, so resubmit it under the same id. Omit sessionId to start a new session.\n\nReturns a preview of the terminal node's rows and every node's queryUuid. The terminal node is the unique sink, or the node named in terminalNodeId. If the result is running, follow up with get_query_result on the terminal node's queryUuid; it also fetches the first page of any node's result by its queryUuid. query computes data only; it saves and charts nothing.",
|
|
3194
3164
|
"inputSchema": {
|
|
3195
3165
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3196
3166
|
"properties": {
|
|
3197
|
-
"
|
|
3198
|
-
"description": "
|
|
3199
|
-
"type": "string"
|
|
3200
|
-
}
|
|
3201
|
-
},
|
|
3202
|
-
"required": ["name"],
|
|
3203
|
-
"type": "object"
|
|
3204
|
-
},
|
|
3205
|
-
"name": "read_skill",
|
|
3206
|
-
"outputSchema": {
|
|
3207
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3208
|
-
"additionalProperties": false,
|
|
3209
|
-
"properties": {
|
|
3210
|
-
"body": {
|
|
3167
|
+
"description": {
|
|
3168
|
+
"description": "A one-line description of what the pipeline computes.",
|
|
3211
3169
|
"type": "string"
|
|
3212
3170
|
},
|
|
3213
|
-
"
|
|
3214
|
-
"
|
|
3215
|
-
"
|
|
3216
|
-
"
|
|
3217
|
-
|
|
3218
|
-
},
|
|
3219
|
-
"digest": {
|
|
3220
|
-
"type": "string"
|
|
3221
|
-
},
|
|
3222
|
-
"mimeType": {
|
|
3223
|
-
"type": "string"
|
|
3224
|
-
},
|
|
3225
|
-
"name": {
|
|
3226
|
-
"type": "string"
|
|
3227
|
-
},
|
|
3228
|
-
"resources": {
|
|
3229
|
-
"items": {
|
|
3230
|
-
"additionalProperties": false,
|
|
3171
|
+
"queries": {
|
|
3172
|
+
"description": "The nodes to submit, in any order: reads are resolved from duckdb references.",
|
|
3173
|
+
"items": {
|
|
3174
|
+
"anyOf": [
|
|
3175
|
+
{
|
|
3231
3176
|
"properties": {
|
|
3232
3177
|
"description": {
|
|
3178
|
+
"description": "One sentence for a business user on what this node does to the data, adding to the title rather than repeating it, e.g. \"Sums completed order revenue per month over the last year.\" Shown as the node's heading in the pipeline list.",
|
|
3233
3179
|
"type": "string"
|
|
3234
3180
|
},
|
|
3235
|
-
"
|
|
3181
|
+
"dimensions": {
|
|
3182
|
+
"description": "Dimension field ids to group by, from the explore's schema.",
|
|
3183
|
+
"items": {
|
|
3184
|
+
"type": "string"
|
|
3185
|
+
},
|
|
3186
|
+
"type": "array"
|
|
3187
|
+
},
|
|
3188
|
+
"exploreName": {
|
|
3189
|
+
"description": "The explore to run the metric query against.",
|
|
3236
3190
|
"type": "string"
|
|
3237
3191
|
},
|
|
3238
|
-
"
|
|
3192
|
+
"filters": {
|
|
3193
|
+
"additionalProperties": false,
|
|
3194
|
+
"description": "Filters on this node's explore as flat expression strings, never structured rule objects: one for dimension fields and one for metric fields, each choosing AND or OR independently and combined with AND. Null when unfiltered, or null for an unused kind.",
|
|
3195
|
+
"properties": {
|
|
3196
|
+
"dimensions": {
|
|
3197
|
+
"description": "Flat filter expression for dimension fields.",
|
|
3198
|
+
"maxLength": 16384,
|
|
3199
|
+
"minLength": 1,
|
|
3200
|
+
"type": "string"
|
|
3201
|
+
},
|
|
3202
|
+
"metrics": {
|
|
3203
|
+
"description": "Flat filter expression for metric fields.",
|
|
3204
|
+
"maxLength": 16384,
|
|
3205
|
+
"minLength": 1,
|
|
3206
|
+
"type": "string"
|
|
3207
|
+
}
|
|
3208
|
+
},
|
|
3209
|
+
"type": "object"
|
|
3210
|
+
},
|
|
3211
|
+
"limit": {
|
|
3212
|
+
"default": 500,
|
|
3213
|
+
"description": "Maximum number of rows this node returns. Defaults to 500, max 5000.",
|
|
3214
|
+
"exclusiveMinimum": 0,
|
|
3215
|
+
"maximum": 5000,
|
|
3216
|
+
"type": "integer"
|
|
3217
|
+
},
|
|
3218
|
+
"metrics": {
|
|
3219
|
+
"description": "Metric field ids to compute, from the explore's schema.",
|
|
3220
|
+
"items": {
|
|
3221
|
+
"type": "string"
|
|
3222
|
+
},
|
|
3223
|
+
"type": "array"
|
|
3224
|
+
},
|
|
3225
|
+
"nodeId": {
|
|
3226
|
+
"description": "Names this node so other nodes can read its result.",
|
|
3227
|
+
"pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
|
|
3239
3228
|
"type": "string"
|
|
3240
3229
|
},
|
|
3241
|
-
"
|
|
3230
|
+
"parameters": {
|
|
3231
|
+
"anyOf": [
|
|
3232
|
+
{
|
|
3233
|
+
"additionalProperties": {
|
|
3234
|
+
"anyOf": [
|
|
3235
|
+
{
|
|
3236
|
+
"type": "string"
|
|
3237
|
+
},
|
|
3238
|
+
{
|
|
3239
|
+
"type": "number"
|
|
3240
|
+
},
|
|
3241
|
+
{
|
|
3242
|
+
"items": {
|
|
3243
|
+
"type": "string"
|
|
3244
|
+
},
|
|
3245
|
+
"type": "array"
|
|
3246
|
+
},
|
|
3247
|
+
{
|
|
3248
|
+
"items": {
|
|
3249
|
+
"type": "number"
|
|
3250
|
+
},
|
|
3251
|
+
"type": "array"
|
|
3252
|
+
}
|
|
3253
|
+
]
|
|
3254
|
+
},
|
|
3255
|
+
"propertyNames": {
|
|
3256
|
+
"type": "string"
|
|
3257
|
+
},
|
|
3258
|
+
"type": "object"
|
|
3259
|
+
},
|
|
3260
|
+
{
|
|
3261
|
+
"type": "null"
|
|
3262
|
+
}
|
|
3263
|
+
],
|
|
3264
|
+
"default": null,
|
|
3265
|
+
"description": "Parameter values for this node, keyed by parameter name exactly as shown in the explore metadata (e.g. {\"orders.metric\": \"active_users\"}). Set them whenever a selected field is marked \"requires parameters\" and the default does not match what the user asked for: an unset parameter silently resolves to its default, which can return the wrong data. null when the explore has no parameters or the defaults are correct."
|
|
3266
|
+
},
|
|
3267
|
+
"sorts": {
|
|
3268
|
+
"description": "Sorts by fields this node also selects in dimensions or metrics, e.g. [{\"fieldId\": \"orders_order_date\", \"descending\": true}].",
|
|
3269
|
+
"items": {
|
|
3270
|
+
"properties": {
|
|
3271
|
+
"descending": {
|
|
3272
|
+
"description": "If true sorts in descending order, ascending otherwise.",
|
|
3273
|
+
"type": "boolean"
|
|
3274
|
+
},
|
|
3275
|
+
"fieldId": {
|
|
3276
|
+
"description": "Field id to sort by.",
|
|
3277
|
+
"type": "string"
|
|
3278
|
+
}
|
|
3279
|
+
},
|
|
3280
|
+
"required": [
|
|
3281
|
+
"fieldId",
|
|
3282
|
+
"descending"
|
|
3283
|
+
],
|
|
3284
|
+
"type": "object"
|
|
3285
|
+
},
|
|
3286
|
+
"type": "array"
|
|
3287
|
+
},
|
|
3288
|
+
"sourceType": {
|
|
3289
|
+
"const": "semanticLayer",
|
|
3242
3290
|
"type": "string"
|
|
3243
3291
|
},
|
|
3244
|
-
"
|
|
3292
|
+
"title": {
|
|
3293
|
+
"description": "Short label a reader understands without seeing the query, two to five words, e.g. \"Revenue by month\". Shown to users instead of the node id.",
|
|
3294
|
+
"type": "string"
|
|
3295
|
+
}
|
|
3296
|
+
},
|
|
3297
|
+
"required": [
|
|
3298
|
+
"sourceType",
|
|
3299
|
+
"nodeId",
|
|
3300
|
+
"title",
|
|
3301
|
+
"description",
|
|
3302
|
+
"exploreName",
|
|
3303
|
+
"dimensions",
|
|
3304
|
+
"metrics"
|
|
3305
|
+
],
|
|
3306
|
+
"type": "object"
|
|
3307
|
+
},
|
|
3308
|
+
{
|
|
3309
|
+
"properties": {
|
|
3310
|
+
"description": {
|
|
3311
|
+
"description": "One sentence for a business user on what this node does to the data, adding to the title rather than repeating it, e.g. \"Sums completed order revenue per month over the last year.\" Shown as the node's heading in the pipeline list.",
|
|
3245
3312
|
"type": "string"
|
|
3246
3313
|
},
|
|
3247
|
-
"
|
|
3248
|
-
"
|
|
3314
|
+
"limit": {
|
|
3315
|
+
"default": 500,
|
|
3316
|
+
"description": "Maximum number of rows this node returns. Defaults to 500, max 5000.",
|
|
3317
|
+
"exclusiveMinimum": 0,
|
|
3318
|
+
"maximum": 5000,
|
|
3319
|
+
"type": "integer"
|
|
3249
3320
|
},
|
|
3250
|
-
"
|
|
3321
|
+
"nodeId": {
|
|
3322
|
+
"description": "Names this node so other nodes can read its result.",
|
|
3323
|
+
"pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
|
|
3251
3324
|
"type": "string"
|
|
3252
3325
|
},
|
|
3253
|
-
"
|
|
3326
|
+
"sourceType": {
|
|
3327
|
+
"const": "sql",
|
|
3328
|
+
"type": "string"
|
|
3329
|
+
},
|
|
3330
|
+
"sql": {
|
|
3331
|
+
"description": "A SELECT or WITH statement in the warehouse's SQL dialect.",
|
|
3332
|
+
"type": "string"
|
|
3333
|
+
},
|
|
3334
|
+
"title": {
|
|
3335
|
+
"description": "Short label a reader understands without seeing the query, two to five words, e.g. \"Revenue by month\". Shown to users instead of the node id.",
|
|
3254
3336
|
"type": "string"
|
|
3255
3337
|
}
|
|
3256
3338
|
},
|
|
3257
3339
|
"required": [
|
|
3258
|
-
"
|
|
3259
|
-
"
|
|
3260
|
-
"name",
|
|
3340
|
+
"sourceType",
|
|
3341
|
+
"nodeId",
|
|
3261
3342
|
"title",
|
|
3262
3343
|
"description",
|
|
3263
|
-
"
|
|
3264
|
-
"size",
|
|
3265
|
-
"digest"
|
|
3344
|
+
"sql"
|
|
3266
3345
|
],
|
|
3267
3346
|
"type": "object"
|
|
3268
3347
|
},
|
|
3269
|
-
|
|
3270
|
-
},
|
|
3271
|
-
"size": {
|
|
3272
|
-
"type": "number"
|
|
3273
|
-
},
|
|
3274
|
-
"title": {
|
|
3275
|
-
"type": "string"
|
|
3276
|
-
},
|
|
3277
|
-
"uri": {
|
|
3278
|
-
"type": "string"
|
|
3279
|
-
}
|
|
3280
|
-
},
|
|
3281
|
-
"required": [
|
|
3282
|
-
"name",
|
|
3283
|
-
"uri",
|
|
3284
|
-
"title",
|
|
3285
|
-
"description",
|
|
3286
|
-
"mimeType",
|
|
3287
|
-
"size",
|
|
3288
|
-
"digest",
|
|
3289
|
-
"resources"
|
|
3290
|
-
],
|
|
3291
|
-
"type": "object"
|
|
3292
|
-
}
|
|
3293
|
-
},
|
|
3294
|
-
"required": ["skill", "body"],
|
|
3295
|
-
"type": "object"
|
|
3296
|
-
},
|
|
3297
|
-
"title": "Read Skill"
|
|
3298
|
-
},
|
|
3299
|
-
{
|
|
3300
|
-
"annotations": {
|
|
3301
|
-
"destructiveHint": false,
|
|
3302
|
-
"idempotentHint": true,
|
|
3303
|
-
"openWorldHint": false,
|
|
3304
|
-
"readOnlyHint": true,
|
|
3305
|
-
"title": "Read Skill Resource"
|
|
3306
|
-
},
|
|
3307
|
-
"description": "Read a supporting resource file of a Lightdash built-in skill.",
|
|
3308
|
-
"inputSchema": {
|
|
3309
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3310
|
-
"properties": {
|
|
3311
|
-
"name": {
|
|
3312
|
-
"description": "Skill name from list_skills, for example developing-in-lightdash",
|
|
3313
|
-
"type": "string"
|
|
3314
|
-
},
|
|
3315
|
-
"path": {
|
|
3316
|
-
"description": "Resource path from list_skills, for example resources/dashboard-reference.md",
|
|
3317
|
-
"type": "string"
|
|
3318
|
-
}
|
|
3319
|
-
},
|
|
3320
|
-
"required": ["name", "path"],
|
|
3321
|
-
"type": "object"
|
|
3322
|
-
},
|
|
3323
|
-
"name": "read_skill_resource",
|
|
3324
|
-
"outputSchema": {
|
|
3325
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3326
|
-
"additionalProperties": false,
|
|
3327
|
-
"properties": {
|
|
3328
|
-
"body": {
|
|
3329
|
-
"type": "string"
|
|
3330
|
-
},
|
|
3331
|
-
"resource": {
|
|
3332
|
-
"additionalProperties": false,
|
|
3333
|
-
"properties": {
|
|
3334
|
-
"description": {
|
|
3335
|
-
"type": "string"
|
|
3336
|
-
},
|
|
3337
|
-
"digest": {
|
|
3338
|
-
"type": "string"
|
|
3339
|
-
},
|
|
3340
|
-
"mimeType": {
|
|
3341
|
-
"type": "string"
|
|
3342
|
-
},
|
|
3343
|
-
"name": {
|
|
3344
|
-
"type": "string"
|
|
3345
|
-
},
|
|
3346
|
-
"path": {
|
|
3347
|
-
"type": "string"
|
|
3348
|
-
},
|
|
3349
|
-
"size": {
|
|
3350
|
-
"type": "number"
|
|
3351
|
-
},
|
|
3352
|
-
"title": {
|
|
3353
|
-
"type": "string"
|
|
3354
|
-
},
|
|
3355
|
-
"uri": {
|
|
3356
|
-
"type": "string"
|
|
3357
|
-
}
|
|
3358
|
-
},
|
|
3359
|
-
"required": [
|
|
3360
|
-
"path",
|
|
3361
|
-
"uri",
|
|
3362
|
-
"name",
|
|
3363
|
-
"title",
|
|
3364
|
-
"description",
|
|
3365
|
-
"mimeType",
|
|
3366
|
-
"size",
|
|
3367
|
-
"digest"
|
|
3368
|
-
],
|
|
3369
|
-
"type": "object"
|
|
3370
|
-
},
|
|
3371
|
-
"skill": {
|
|
3372
|
-
"additionalProperties": false,
|
|
3373
|
-
"properties": {
|
|
3374
|
-
"description": {
|
|
3375
|
-
"type": "string"
|
|
3376
|
-
},
|
|
3377
|
-
"digest": {
|
|
3378
|
-
"type": "string"
|
|
3379
|
-
},
|
|
3380
|
-
"mimeType": {
|
|
3381
|
-
"type": "string"
|
|
3382
|
-
},
|
|
3383
|
-
"name": {
|
|
3384
|
-
"type": "string"
|
|
3385
|
-
},
|
|
3386
|
-
"resources": {
|
|
3387
|
-
"items": {
|
|
3388
|
-
"additionalProperties": false,
|
|
3348
|
+
{
|
|
3389
3349
|
"properties": {
|
|
3390
3350
|
"description": {
|
|
3351
|
+
"description": "One sentence for a business user on what this node does to the data, adding to the title rather than repeating it, e.g. \"Sums completed order revenue per month over the last year.\" Shown as the node's heading in the pipeline list.",
|
|
3391
3352
|
"type": "string"
|
|
3392
3353
|
},
|
|
3393
|
-
"
|
|
3354
|
+
"limit": {
|
|
3355
|
+
"default": 500,
|
|
3356
|
+
"description": "Maximum number of rows this node returns. Defaults to 500, max 5000.",
|
|
3357
|
+
"exclusiveMinimum": 0,
|
|
3358
|
+
"maximum": 5000,
|
|
3359
|
+
"type": "integer"
|
|
3360
|
+
},
|
|
3361
|
+
"nodeId": {
|
|
3362
|
+
"description": "Names this node so other nodes can read its result.",
|
|
3363
|
+
"pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
|
|
3394
3364
|
"type": "string"
|
|
3395
3365
|
},
|
|
3396
|
-
"
|
|
3366
|
+
"references": {
|
|
3367
|
+
"anyOf": [
|
|
3368
|
+
{
|
|
3369
|
+
"items": {
|
|
3370
|
+
"pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
|
|
3371
|
+
"type": "string"
|
|
3372
|
+
},
|
|
3373
|
+
"type": "array"
|
|
3374
|
+
},
|
|
3375
|
+
{
|
|
3376
|
+
"additionalProperties": {
|
|
3377
|
+
"pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
|
|
3378
|
+
"type": "string"
|
|
3379
|
+
},
|
|
3380
|
+
"propertyNames": {
|
|
3381
|
+
"type": "string"
|
|
3382
|
+
},
|
|
3383
|
+
"type": "object"
|
|
3384
|
+
}
|
|
3385
|
+
],
|
|
3386
|
+
"description": "Which nodes the SQL reads, by node id: an array (each exposed as a table named by its node id), or a map of {tableName: nodeId} to alias them."
|
|
3387
|
+
},
|
|
3388
|
+
"sourceType": {
|
|
3389
|
+
"const": "duckdb",
|
|
3397
3390
|
"type": "string"
|
|
3398
3391
|
},
|
|
3399
|
-
"
|
|
3392
|
+
"sql": {
|
|
3393
|
+
"description": "DuckDB SQL over the tables \"references\" exposes.",
|
|
3400
3394
|
"type": "string"
|
|
3401
3395
|
},
|
|
3402
|
-
"
|
|
3396
|
+
"title": {
|
|
3397
|
+
"description": "Short label a reader understands without seeing the query, two to five words, e.g. \"Revenue by month\". Shown to users instead of the node id.",
|
|
3398
|
+
"type": "string"
|
|
3399
|
+
}
|
|
3400
|
+
},
|
|
3401
|
+
"required": [
|
|
3402
|
+
"sourceType",
|
|
3403
|
+
"nodeId",
|
|
3404
|
+
"title",
|
|
3405
|
+
"description",
|
|
3406
|
+
"sql",
|
|
3407
|
+
"references"
|
|
3408
|
+
],
|
|
3409
|
+
"type": "object"
|
|
3410
|
+
},
|
|
3411
|
+
{
|
|
3412
|
+
"properties": {
|
|
3413
|
+
"description": {
|
|
3414
|
+
"description": "One sentence for a business user on what this node does to the data, adding to the title rather than repeating it, e.g. \"Sums completed order revenue per month over the last year.\" Shown as the node's heading in the pipeline list.",
|
|
3403
3415
|
"type": "string"
|
|
3404
3416
|
},
|
|
3405
|
-
"
|
|
3406
|
-
"
|
|
3417
|
+
"limit": {
|
|
3418
|
+
"default": 500,
|
|
3419
|
+
"description": "Maximum number of rows this node returns. Defaults to 500, max 5000.",
|
|
3420
|
+
"exclusiveMinimum": 0,
|
|
3421
|
+
"maximum": 5000,
|
|
3422
|
+
"type": "integer"
|
|
3407
3423
|
},
|
|
3408
|
-
"
|
|
3424
|
+
"nodeId": {
|
|
3425
|
+
"description": "Names this node so other nodes can read its result.",
|
|
3426
|
+
"pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
|
|
3409
3427
|
"type": "string"
|
|
3410
3428
|
},
|
|
3411
|
-
"
|
|
3429
|
+
"sourceType": {
|
|
3430
|
+
"const": "external",
|
|
3431
|
+
"type": "string"
|
|
3432
|
+
},
|
|
3433
|
+
"sql": {
|
|
3434
|
+
"description": "DuckDB SQL over the tables \"tables\" declares.",
|
|
3435
|
+
"type": "string"
|
|
3436
|
+
},
|
|
3437
|
+
"tables": {
|
|
3438
|
+
"anyOf": [
|
|
3439
|
+
{
|
|
3440
|
+
"items": {
|
|
3441
|
+
"type": "string"
|
|
3442
|
+
},
|
|
3443
|
+
"type": "array"
|
|
3444
|
+
},
|
|
3445
|
+
{
|
|
3446
|
+
"additionalProperties": {
|
|
3447
|
+
"type": "string"
|
|
3448
|
+
},
|
|
3449
|
+
"propertyNames": {
|
|
3450
|
+
"type": "string"
|
|
3451
|
+
},
|
|
3452
|
+
"type": "object"
|
|
3453
|
+
}
|
|
3454
|
+
],
|
|
3455
|
+
"description": "External tables this node reads: an array of table names (each exposed under its name), or a map of {sqlAlias: tableNameOrTableUuid}. Prefer table UUIDs from attached-source context so renames cannot break the query."
|
|
3456
|
+
},
|
|
3457
|
+
"title": {
|
|
3458
|
+
"description": "Short label a reader understands without seeing the query, two to five words, e.g. \"Revenue by month\". Shown to users instead of the node id.",
|
|
3412
3459
|
"type": "string"
|
|
3413
3460
|
}
|
|
3414
3461
|
},
|
|
3415
3462
|
"required": [
|
|
3416
|
-
"
|
|
3417
|
-
"
|
|
3418
|
-
"name",
|
|
3463
|
+
"sourceType",
|
|
3464
|
+
"nodeId",
|
|
3419
3465
|
"title",
|
|
3420
3466
|
"description",
|
|
3421
|
-
"
|
|
3422
|
-
"
|
|
3423
|
-
"digest"
|
|
3467
|
+
"sql",
|
|
3468
|
+
"tables"
|
|
3424
3469
|
],
|
|
3425
3470
|
"type": "object"
|
|
3426
|
-
}
|
|
3427
|
-
|
|
3428
|
-
},
|
|
3429
|
-
"size": {
|
|
3430
|
-
"type": "number"
|
|
3431
|
-
},
|
|
3432
|
-
"title": {
|
|
3433
|
-
"type": "string"
|
|
3434
|
-
},
|
|
3435
|
-
"uri": {
|
|
3436
|
-
"type": "string"
|
|
3437
|
-
}
|
|
3471
|
+
}
|
|
3472
|
+
]
|
|
3438
3473
|
},
|
|
3439
|
-
"
|
|
3440
|
-
|
|
3441
|
-
|
|
3442
|
-
|
|
3443
|
-
|
|
3444
|
-
|
|
3445
|
-
|
|
3446
|
-
|
|
3447
|
-
|
|
3448
|
-
|
|
3449
|
-
"type": "object"
|
|
3474
|
+
"minItems": 1,
|
|
3475
|
+
"type": "array"
|
|
3476
|
+
},
|
|
3477
|
+
"terminalNodeId": {
|
|
3478
|
+
"description": "The terminal node. Null picks the unique sink, the one submitted node no other submitted node reads; name a node when there are several sinks.",
|
|
3479
|
+
"type": "string"
|
|
3480
|
+
},
|
|
3481
|
+
"title": {
|
|
3482
|
+
"description": "A short title for the result.",
|
|
3483
|
+
"type": "string"
|
|
3450
3484
|
}
|
|
3451
3485
|
},
|
|
3452
|
-
"required": ["
|
|
3486
|
+
"required": ["queries"],
|
|
3453
3487
|
"type": "object"
|
|
3454
3488
|
},
|
|
3455
|
-
"
|
|
3456
|
-
|
|
3457
|
-
|
|
3458
|
-
|
|
3459
|
-
"
|
|
3460
|
-
|
|
3461
|
-
|
|
3489
|
+
"name": "query",
|
|
3490
|
+
"outputSchema": {
|
|
3491
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3492
|
+
"additionalProperties": false,
|
|
3493
|
+
"properties": {
|
|
3494
|
+
"nodes": {
|
|
3495
|
+
"description": "Every node of the pipeline, in dependency order.",
|
|
3496
|
+
"items": {
|
|
3497
|
+
"additionalProperties": false,
|
|
3498
|
+
"properties": {
|
|
3499
|
+
"columns": {
|
|
3500
|
+
"anyOf": [
|
|
3501
|
+
{
|
|
3502
|
+
"items": {
|
|
3503
|
+
"additionalProperties": false,
|
|
3504
|
+
"properties": {
|
|
3505
|
+
"reference": {
|
|
3506
|
+
"description": "Column name as it appears in the rows.",
|
|
3507
|
+
"type": "string"
|
|
3508
|
+
},
|
|
3509
|
+
"type": {
|
|
3510
|
+
"enum": [
|
|
3511
|
+
"string",
|
|
3512
|
+
"number",
|
|
3513
|
+
"timestamp",
|
|
3514
|
+
"date",
|
|
3515
|
+
"boolean"
|
|
3516
|
+
],
|
|
3517
|
+
"type": "string"
|
|
3518
|
+
}
|
|
3519
|
+
},
|
|
3520
|
+
"required": [
|
|
3521
|
+
"reference",
|
|
3522
|
+
"type"
|
|
3523
|
+
],
|
|
3524
|
+
"type": "object"
|
|
3525
|
+
},
|
|
3526
|
+
"type": "array"
|
|
3527
|
+
},
|
|
3528
|
+
{
|
|
3529
|
+
"type": "null"
|
|
3530
|
+
}
|
|
3531
|
+
],
|
|
3532
|
+
"description": "Result columns; null until the node is done."
|
|
3533
|
+
},
|
|
3534
|
+
"limit": {
|
|
3535
|
+
"description": "Row limit this node ran with. A rowCount equal to it means the node reached its limit, so more rows may exist.",
|
|
3536
|
+
"exclusiveMinimum": 0,
|
|
3537
|
+
"maximum": 9007199254740991,
|
|
3538
|
+
"type": "integer"
|
|
3539
|
+
},
|
|
3540
|
+
"nodeId": {
|
|
3541
|
+
"description": "Names this node so other nodes can read its result.",
|
|
3542
|
+
"pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
|
|
3543
|
+
"type": "string"
|
|
3544
|
+
},
|
|
3545
|
+
"queryUuid": {
|
|
3546
|
+
"description": "Pass to get_query_result to read this node.",
|
|
3547
|
+
"type": "string"
|
|
3548
|
+
},
|
|
3549
|
+
"reachedLimit": {
|
|
3550
|
+
"description": "True when rowCount reached limit, so more rows may exist and nodes reading it may be computed on incomplete rows.",
|
|
3551
|
+
"type": "boolean"
|
|
3552
|
+
},
|
|
3553
|
+
"rowCount": {
|
|
3554
|
+
"anyOf": [
|
|
3555
|
+
{
|
|
3556
|
+
"maximum": 9007199254740991,
|
|
3557
|
+
"minimum": 0,
|
|
3558
|
+
"type": "integer"
|
|
3559
|
+
},
|
|
3560
|
+
{
|
|
3561
|
+
"type": "null"
|
|
3562
|
+
}
|
|
3563
|
+
],
|
|
3564
|
+
"description": "Rows this node returned; null when its query is not ready."
|
|
3565
|
+
},
|
|
3566
|
+
"sourceType": {
|
|
3567
|
+
"enum": [
|
|
3568
|
+
"semanticLayer",
|
|
3569
|
+
"sql",
|
|
3570
|
+
"duckdb",
|
|
3571
|
+
"external",
|
|
3572
|
+
"python",
|
|
3573
|
+
"api"
|
|
3574
|
+
],
|
|
3575
|
+
"type": "string"
|
|
3576
|
+
},
|
|
3577
|
+
"status": {
|
|
3578
|
+
"enum": ["done", "running", "failed"],
|
|
3579
|
+
"type": "string"
|
|
3580
|
+
},
|
|
3581
|
+
"title": {
|
|
3582
|
+
"description": "What users see for this node.",
|
|
3583
|
+
"type": ["string", "null"]
|
|
3584
|
+
}
|
|
3585
|
+
},
|
|
3586
|
+
"required": [
|
|
3587
|
+
"nodeId",
|
|
3588
|
+
"title",
|
|
3589
|
+
"sourceType",
|
|
3590
|
+
"rowCount",
|
|
3591
|
+
"limit",
|
|
3592
|
+
"queryUuid",
|
|
3593
|
+
"status",
|
|
3594
|
+
"reachedLimit",
|
|
3595
|
+
"columns"
|
|
3596
|
+
],
|
|
3597
|
+
"type": "object"
|
|
3598
|
+
},
|
|
3599
|
+
"type": "array"
|
|
3600
|
+
},
|
|
3601
|
+
"rowCount": {
|
|
3602
|
+
"anyOf": [
|
|
3603
|
+
{
|
|
3604
|
+
"maximum": 9007199254740991,
|
|
3605
|
+
"minimum": 0,
|
|
3606
|
+
"type": "integer"
|
|
3607
|
+
},
|
|
3608
|
+
{
|
|
3609
|
+
"type": "null"
|
|
3610
|
+
}
|
|
3611
|
+
],
|
|
3612
|
+
"description": "Total rows in the terminal result; null while running."
|
|
3613
|
+
},
|
|
3614
|
+
"sessionId": {
|
|
3615
|
+
"description": "Composer session holding the ready nodes; pass it as sessionId to read them by node id in a later call. Null when no node was saved and no sessionId was passed.",
|
|
3616
|
+
"type": ["string", "null"]
|
|
3617
|
+
},
|
|
3618
|
+
"status": {
|
|
3619
|
+
"description": "running when the terminal node outlived the wait; poll get_query_result with its queryUuid.",
|
|
3620
|
+
"enum": ["done", "running"],
|
|
3621
|
+
"type": "string"
|
|
3622
|
+
},
|
|
3623
|
+
"terminalNodeId": {
|
|
3624
|
+
"description": "Node whose rows are previewed.",
|
|
3625
|
+
"pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
|
|
3626
|
+
"type": "string"
|
|
3627
|
+
}
|
|
3628
|
+
},
|
|
3629
|
+
"required": [
|
|
3630
|
+
"sessionId",
|
|
3631
|
+
"status",
|
|
3632
|
+
"terminalNodeId",
|
|
3633
|
+
"rowCount",
|
|
3634
|
+
"nodes"
|
|
3635
|
+
],
|
|
3636
|
+
"type": "object"
|
|
3637
|
+
},
|
|
3638
|
+
"title": "Run composer queries"
|
|
3639
|
+
},
|
|
3640
|
+
{
|
|
3641
|
+
"annotations": {
|
|
3642
|
+
"destructiveHint": false,
|
|
3643
|
+
"idempotentHint": true,
|
|
3644
|
+
"openWorldHint": false,
|
|
3645
|
+
"readOnlyHint": true,
|
|
3646
|
+
"title": "Read content"
|
|
3647
|
+
},
|
|
3648
|
+
"description": "Read a dashboard, chart, SQL chart or data app as JSON by its slug. Dashboard chart tiles include a read-only chartQuery (the explore and field ids the chart uses) for targeting dashboard filters per tile without reading each chart. Data apps are read-only: a view of what the app shows and its per-explore data references, without code.",
|
|
3649
|
+
"inputSchema": {
|
|
3650
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3651
|
+
"properties": {
|
|
3652
|
+
"slug": {
|
|
3653
|
+
"description": "Slug of the content to read.",
|
|
3654
|
+
"minLength": 1,
|
|
3655
|
+
"type": "string"
|
|
3656
|
+
},
|
|
3657
|
+
"type": {
|
|
3658
|
+
"description": "Type of Lightdash content to read.",
|
|
3659
|
+
"enum": ["dashboard", "chart", "sql_chart", "data_app"],
|
|
3660
|
+
"type": "string"
|
|
3661
|
+
}
|
|
3662
|
+
},
|
|
3663
|
+
"required": ["slug", "type"],
|
|
3664
|
+
"type": "object"
|
|
3665
|
+
},
|
|
3666
|
+
"name": "read_content",
|
|
3667
|
+
"outputSchema": null,
|
|
3668
|
+
"title": "Read content"
|
|
3669
|
+
},
|
|
3670
|
+
{
|
|
3671
|
+
"annotations": {
|
|
3672
|
+
"destructiveHint": false,
|
|
3673
|
+
"idempotentHint": true,
|
|
3674
|
+
"openWorldHint": false,
|
|
3675
|
+
"readOnlyHint": true,
|
|
3676
|
+
"title": "Read Skill"
|
|
3677
|
+
},
|
|
3678
|
+
"description": "Read the main SKILL.md instructions of a Lightdash built-in skill named by list_skills.",
|
|
3679
|
+
"inputSchema": {
|
|
3680
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3681
|
+
"properties": {
|
|
3682
|
+
"name": {
|
|
3683
|
+
"description": "Skill name from list_skills, for example developing-in-lightdash",
|
|
3684
|
+
"type": "string"
|
|
3685
|
+
}
|
|
3686
|
+
},
|
|
3687
|
+
"required": ["name"],
|
|
3688
|
+
"type": "object"
|
|
3689
|
+
},
|
|
3690
|
+
"name": "read_skill",
|
|
3691
|
+
"outputSchema": {
|
|
3692
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3693
|
+
"additionalProperties": false,
|
|
3694
|
+
"properties": {
|
|
3695
|
+
"body": {
|
|
3696
|
+
"type": "string"
|
|
3697
|
+
},
|
|
3698
|
+
"skill": {
|
|
3699
|
+
"additionalProperties": false,
|
|
3700
|
+
"properties": {
|
|
3701
|
+
"description": {
|
|
3702
|
+
"type": "string"
|
|
3703
|
+
},
|
|
3704
|
+
"digest": {
|
|
3705
|
+
"type": "string"
|
|
3706
|
+
},
|
|
3707
|
+
"mimeType": {
|
|
3708
|
+
"type": "string"
|
|
3709
|
+
},
|
|
3710
|
+
"name": {
|
|
3711
|
+
"type": "string"
|
|
3712
|
+
},
|
|
3713
|
+
"resources": {
|
|
3714
|
+
"items": {
|
|
3715
|
+
"additionalProperties": false,
|
|
3716
|
+
"properties": {
|
|
3717
|
+
"description": {
|
|
3718
|
+
"type": "string"
|
|
3719
|
+
},
|
|
3720
|
+
"digest": {
|
|
3721
|
+
"type": "string"
|
|
3722
|
+
},
|
|
3723
|
+
"mimeType": {
|
|
3724
|
+
"type": "string"
|
|
3725
|
+
},
|
|
3726
|
+
"name": {
|
|
3727
|
+
"type": "string"
|
|
3728
|
+
},
|
|
3729
|
+
"path": {
|
|
3730
|
+
"type": "string"
|
|
3731
|
+
},
|
|
3732
|
+
"size": {
|
|
3733
|
+
"type": "number"
|
|
3734
|
+
},
|
|
3735
|
+
"title": {
|
|
3736
|
+
"type": "string"
|
|
3737
|
+
},
|
|
3738
|
+
"uri": {
|
|
3739
|
+
"type": "string"
|
|
3740
|
+
}
|
|
3741
|
+
},
|
|
3742
|
+
"required": [
|
|
3743
|
+
"path",
|
|
3744
|
+
"uri",
|
|
3745
|
+
"name",
|
|
3746
|
+
"title",
|
|
3747
|
+
"description",
|
|
3748
|
+
"mimeType",
|
|
3749
|
+
"size",
|
|
3750
|
+
"digest"
|
|
3751
|
+
],
|
|
3752
|
+
"type": "object"
|
|
3753
|
+
},
|
|
3754
|
+
"type": "array"
|
|
3755
|
+
},
|
|
3756
|
+
"size": {
|
|
3757
|
+
"type": "number"
|
|
3758
|
+
},
|
|
3759
|
+
"title": {
|
|
3760
|
+
"type": "string"
|
|
3761
|
+
},
|
|
3762
|
+
"uri": {
|
|
3763
|
+
"type": "string"
|
|
3764
|
+
}
|
|
3765
|
+
},
|
|
3766
|
+
"required": [
|
|
3767
|
+
"name",
|
|
3768
|
+
"uri",
|
|
3769
|
+
"title",
|
|
3770
|
+
"description",
|
|
3771
|
+
"mimeType",
|
|
3772
|
+
"size",
|
|
3773
|
+
"digest",
|
|
3774
|
+
"resources"
|
|
3775
|
+
],
|
|
3776
|
+
"type": "object"
|
|
3777
|
+
}
|
|
3778
|
+
},
|
|
3779
|
+
"required": ["skill", "body"],
|
|
3780
|
+
"type": "object"
|
|
3781
|
+
},
|
|
3782
|
+
"title": "Read Skill"
|
|
3783
|
+
},
|
|
3784
|
+
{
|
|
3785
|
+
"annotations": {
|
|
3786
|
+
"destructiveHint": false,
|
|
3787
|
+
"idempotentHint": true,
|
|
3788
|
+
"openWorldHint": false,
|
|
3789
|
+
"readOnlyHint": true,
|
|
3790
|
+
"title": "Read Skill Resource"
|
|
3791
|
+
},
|
|
3792
|
+
"description": "Read a supporting resource file of a Lightdash built-in skill.",
|
|
3793
|
+
"inputSchema": {
|
|
3794
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3795
|
+
"properties": {
|
|
3796
|
+
"name": {
|
|
3797
|
+
"description": "Skill name from list_skills, for example developing-in-lightdash",
|
|
3798
|
+
"type": "string"
|
|
3799
|
+
},
|
|
3800
|
+
"path": {
|
|
3801
|
+
"description": "Resource path from list_skills, for example resources/dashboard-reference.md",
|
|
3802
|
+
"type": "string"
|
|
3803
|
+
}
|
|
3804
|
+
},
|
|
3805
|
+
"required": ["name", "path"],
|
|
3806
|
+
"type": "object"
|
|
3807
|
+
},
|
|
3808
|
+
"name": "read_skill_resource",
|
|
3809
|
+
"outputSchema": {
|
|
3810
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3811
|
+
"additionalProperties": false,
|
|
3812
|
+
"properties": {
|
|
3813
|
+
"body": {
|
|
3814
|
+
"type": "string"
|
|
3815
|
+
},
|
|
3816
|
+
"resource": {
|
|
3817
|
+
"additionalProperties": false,
|
|
3818
|
+
"properties": {
|
|
3819
|
+
"description": {
|
|
3820
|
+
"type": "string"
|
|
3821
|
+
},
|
|
3822
|
+
"digest": {
|
|
3823
|
+
"type": "string"
|
|
3824
|
+
},
|
|
3825
|
+
"mimeType": {
|
|
3826
|
+
"type": "string"
|
|
3827
|
+
},
|
|
3828
|
+
"name": {
|
|
3829
|
+
"type": "string"
|
|
3830
|
+
},
|
|
3831
|
+
"path": {
|
|
3832
|
+
"type": "string"
|
|
3833
|
+
},
|
|
3834
|
+
"size": {
|
|
3835
|
+
"type": "number"
|
|
3836
|
+
},
|
|
3837
|
+
"title": {
|
|
3838
|
+
"type": "string"
|
|
3839
|
+
},
|
|
3840
|
+
"uri": {
|
|
3841
|
+
"type": "string"
|
|
3842
|
+
}
|
|
3843
|
+
},
|
|
3844
|
+
"required": [
|
|
3845
|
+
"path",
|
|
3846
|
+
"uri",
|
|
3847
|
+
"name",
|
|
3848
|
+
"title",
|
|
3849
|
+
"description",
|
|
3850
|
+
"mimeType",
|
|
3851
|
+
"size",
|
|
3852
|
+
"digest"
|
|
3853
|
+
],
|
|
3854
|
+
"type": "object"
|
|
3855
|
+
},
|
|
3856
|
+
"skill": {
|
|
3857
|
+
"additionalProperties": false,
|
|
3858
|
+
"properties": {
|
|
3859
|
+
"description": {
|
|
3860
|
+
"type": "string"
|
|
3861
|
+
},
|
|
3862
|
+
"digest": {
|
|
3863
|
+
"type": "string"
|
|
3864
|
+
},
|
|
3865
|
+
"mimeType": {
|
|
3866
|
+
"type": "string"
|
|
3867
|
+
},
|
|
3868
|
+
"name": {
|
|
3869
|
+
"type": "string"
|
|
3870
|
+
},
|
|
3871
|
+
"resources": {
|
|
3872
|
+
"items": {
|
|
3873
|
+
"additionalProperties": false,
|
|
3874
|
+
"properties": {
|
|
3875
|
+
"description": {
|
|
3876
|
+
"type": "string"
|
|
3877
|
+
},
|
|
3878
|
+
"digest": {
|
|
3879
|
+
"type": "string"
|
|
3880
|
+
},
|
|
3881
|
+
"mimeType": {
|
|
3882
|
+
"type": "string"
|
|
3883
|
+
},
|
|
3884
|
+
"name": {
|
|
3885
|
+
"type": "string"
|
|
3886
|
+
},
|
|
3887
|
+
"path": {
|
|
3888
|
+
"type": "string"
|
|
3889
|
+
},
|
|
3890
|
+
"size": {
|
|
3891
|
+
"type": "number"
|
|
3892
|
+
},
|
|
3893
|
+
"title": {
|
|
3894
|
+
"type": "string"
|
|
3895
|
+
},
|
|
3896
|
+
"uri": {
|
|
3897
|
+
"type": "string"
|
|
3898
|
+
}
|
|
3899
|
+
},
|
|
3900
|
+
"required": [
|
|
3901
|
+
"path",
|
|
3902
|
+
"uri",
|
|
3903
|
+
"name",
|
|
3904
|
+
"title",
|
|
3905
|
+
"description",
|
|
3906
|
+
"mimeType",
|
|
3907
|
+
"size",
|
|
3908
|
+
"digest"
|
|
3909
|
+
],
|
|
3910
|
+
"type": "object"
|
|
3911
|
+
},
|
|
3912
|
+
"type": "array"
|
|
3913
|
+
},
|
|
3914
|
+
"size": {
|
|
3915
|
+
"type": "number"
|
|
3916
|
+
},
|
|
3917
|
+
"title": {
|
|
3918
|
+
"type": "string"
|
|
3919
|
+
},
|
|
3920
|
+
"uri": {
|
|
3921
|
+
"type": "string"
|
|
3922
|
+
}
|
|
3923
|
+
},
|
|
3924
|
+
"required": [
|
|
3925
|
+
"name",
|
|
3926
|
+
"uri",
|
|
3927
|
+
"title",
|
|
3928
|
+
"description",
|
|
3929
|
+
"mimeType",
|
|
3930
|
+
"size",
|
|
3931
|
+
"digest",
|
|
3932
|
+
"resources"
|
|
3933
|
+
],
|
|
3934
|
+
"type": "object"
|
|
3935
|
+
}
|
|
3936
|
+
},
|
|
3937
|
+
"required": ["skill", "resource", "body"],
|
|
3938
|
+
"type": "object"
|
|
3939
|
+
},
|
|
3940
|
+
"title": "Read Skill Resource"
|
|
3941
|
+
},
|
|
3942
|
+
{
|
|
3943
|
+
"annotations": {
|
|
3944
|
+
"destructiveHint": false,
|
|
3945
|
+
"idempotentHint": true,
|
|
3946
|
+
"openWorldHint": false,
|
|
3462
3947
|
"readOnlyHint": true,
|
|
3463
3948
|
"title": "Render chart"
|
|
3464
3949
|
},
|
|
@@ -3730,213 +4215,47 @@
|
|
|
3730
4215
|
"description": "Present while the grouped query for the chart is still running. Call render_chart again with the same arguments.",
|
|
3731
4216
|
"type": "string"
|
|
3732
4217
|
}
|
|
3733
|
-
},
|
|
3734
|
-
"required": [
|
|
3735
|
-
"status",
|
|
3736
|
-
"queryUuid",
|
|
3737
|
-
"nextPollAfterMs",
|
|
3738
|
-
"heartbeatAt"
|
|
3739
|
-
],
|
|
3740
|
-
"type": "object"
|
|
3741
|
-
}
|
|
3742
|
-
]
|
|
3743
|
-
}
|
|
3744
|
-
},
|
|
3745
|
-
"required": ["result"],
|
|
3746
|
-
"type": "object"
|
|
3747
|
-
},
|
|
3748
|
-
"title": "Render chart"
|
|
3749
|
-
},
|
|
3750
|
-
{
|
|
3751
|
-
"annotations": {
|
|
3752
|
-
"destructiveHint": false,
|
|
3753
|
-
"idempotentHint": true,
|
|
3754
|
-
"openWorldHint": false,
|
|
3755
|
-
"readOnlyHint": true,
|
|
3756
|
-
"title": "Resolve URL"
|
|
3757
|
-
},
|
|
3758
|
-
"description": "Tool: resolve_url\n\nExpand a share link, a URL whose path is \"/share/<id>\" (e.g. \"<host>/share/aBcD1234...\"), into the full URL it redirects to. Share links are opaque, so this is the only way to see what they point at; read the identifiers (project uuid, chart or dashboard uuid, explore name) from the expanded URL, then fetch the content with other tools such as read_content.\n\nEvery other URL, such as \"/projects/<uuid>/saved/<uuid>\" or \"/projects/<uuid>/dashboards/<uuid>\", already contains its identifiers: read them from the path and go straight to the appropriate tool. URLs from another instance cannot be resolved.",
|
|
3759
|
-
"inputSchema": {
|
|
3760
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3761
|
-
"properties": {
|
|
3762
|
-
"url": {
|
|
3763
|
-
"description": "The Lightdash URL to resolve, exactly as provided.",
|
|
3764
|
-
"minLength": 1,
|
|
3765
|
-
"type": "string"
|
|
3766
|
-
}
|
|
3767
|
-
},
|
|
3768
|
-
"required": ["url"],
|
|
3769
|
-
"type": "object"
|
|
3770
|
-
},
|
|
3771
|
-
"name": "resolve_url",
|
|
3772
|
-
"outputSchema": null,
|
|
3773
|
-
"title": "Resolve URL"
|
|
3774
|
-
},
|
|
3775
|
-
{
|
|
3776
|
-
"annotations": {
|
|
3777
|
-
"destructiveHint": false,
|
|
3778
|
-
"idempotentHint": true,
|
|
3779
|
-
"openWorldHint": false,
|
|
3780
|
-
"readOnlyHint": true,
|
|
3781
|
-
"title": "Route agent"
|
|
3782
|
-
},
|
|
3783
|
-
"description": "Select the best AI agent for a user request within the required projectUuid when agent-specific scope is useful and routing is available. Pass the returned agentUuid explicitly to subsequent scoped tools. If routing is unavailable, pick an agent from list_agents and pass its agentUuid explicitly; omit agentUuid when full project scope is desired. Also updates shared agent context for clients that use it.",
|
|
3784
|
-
"inputSchema": {
|
|
3785
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3786
|
-
"properties": {
|
|
3787
|
-
"projectUuid": {
|
|
3788
|
-
"type": "string"
|
|
3789
|
-
},
|
|
3790
|
-
"prompt": {
|
|
3791
|
-
"type": "string"
|
|
3792
|
-
}
|
|
3793
|
-
},
|
|
3794
|
-
"required": ["prompt"],
|
|
3795
|
-
"type": "object"
|
|
3796
|
-
},
|
|
3797
|
-
"name": "route_agent",
|
|
3798
|
-
"outputSchema": {
|
|
3799
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3800
|
-
"additionalProperties": false,
|
|
3801
|
-
"properties": {
|
|
3802
|
-
"agentDescription": {
|
|
3803
|
-
"type": ["string", "null"]
|
|
3804
|
-
},
|
|
3805
|
-
"agentName": {
|
|
3806
|
-
"type": "string"
|
|
3807
|
-
},
|
|
3808
|
-
"agentProjectUuid": {
|
|
3809
|
-
"type": "string"
|
|
3810
|
-
},
|
|
3811
|
-
"agentSpaceAccess": {
|
|
3812
|
-
"items": {
|
|
3813
|
-
"type": "string"
|
|
3814
|
-
},
|
|
3815
|
-
"type": "array"
|
|
3816
|
-
},
|
|
3817
|
-
"agentTags": {
|
|
3818
|
-
"anyOf": [
|
|
3819
|
-
{
|
|
3820
|
-
"items": {
|
|
3821
|
-
"type": "string"
|
|
3822
|
-
},
|
|
3823
|
-
"type": "array"
|
|
3824
|
-
},
|
|
3825
|
-
{
|
|
3826
|
-
"type": "null"
|
|
3827
|
-
}
|
|
3828
|
-
]
|
|
3829
|
-
},
|
|
3830
|
-
"agentUuid": {
|
|
3831
|
-
"type": "string"
|
|
3832
|
-
},
|
|
3833
|
-
"candidates": {
|
|
3834
|
-
"items": {
|
|
3835
|
-
"additionalProperties": false,
|
|
3836
|
-
"properties": {
|
|
3837
|
-
"agentUuid": {
|
|
3838
|
-
"type": "string"
|
|
3839
|
-
},
|
|
3840
|
-
"description": {
|
|
3841
|
-
"type": ["string", "null"]
|
|
3842
|
-
},
|
|
3843
|
-
"name": {
|
|
3844
|
-
"type": "string"
|
|
3845
|
-
}
|
|
3846
|
-
},
|
|
3847
|
-
"required": ["agentUuid", "name", "description"],
|
|
3848
|
-
"type": "object"
|
|
3849
|
-
},
|
|
3850
|
-
"type": "array"
|
|
3851
|
-
},
|
|
3852
|
-
"confidence": {
|
|
3853
|
-
"enum": ["high", "medium", "low"],
|
|
3854
|
-
"type": "string"
|
|
3855
|
-
},
|
|
3856
|
-
"explores": {
|
|
3857
|
-
"items": {
|
|
3858
|
-
"type": "string"
|
|
3859
|
-
},
|
|
3860
|
-
"type": "array"
|
|
3861
|
-
},
|
|
3862
|
-
"instruction": {
|
|
3863
|
-
"type": ["string", "null"]
|
|
3864
|
-
},
|
|
3865
|
-
"reasoning": {
|
|
3866
|
-
"type": "string"
|
|
3867
|
-
},
|
|
3868
|
-
"verifiedQuestions": {
|
|
3869
|
-
"items": {
|
|
3870
|
-
"type": "string"
|
|
3871
|
-
},
|
|
3872
|
-
"type": "array"
|
|
3873
|
-
}
|
|
3874
|
-
},
|
|
3875
|
-
"required": [
|
|
3876
|
-
"agentUuid",
|
|
3877
|
-
"agentName",
|
|
3878
|
-
"agentDescription",
|
|
3879
|
-
"agentTags",
|
|
3880
|
-
"agentSpaceAccess",
|
|
3881
|
-
"agentProjectUuid",
|
|
3882
|
-
"explores",
|
|
3883
|
-
"verifiedQuestions",
|
|
3884
|
-
"instruction",
|
|
3885
|
-
"confidence",
|
|
3886
|
-
"reasoning",
|
|
3887
|
-
"candidates"
|
|
3888
|
-
],
|
|
4218
|
+
},
|
|
4219
|
+
"required": [
|
|
4220
|
+
"status",
|
|
4221
|
+
"queryUuid",
|
|
4222
|
+
"nextPollAfterMs",
|
|
4223
|
+
"heartbeatAt"
|
|
4224
|
+
],
|
|
4225
|
+
"type": "object"
|
|
4226
|
+
}
|
|
4227
|
+
]
|
|
4228
|
+
}
|
|
4229
|
+
},
|
|
4230
|
+
"required": ["result"],
|
|
3889
4231
|
"type": "object"
|
|
3890
4232
|
},
|
|
3891
|
-
"title": "
|
|
4233
|
+
"title": "Render chart"
|
|
3892
4234
|
},
|
|
3893
4235
|
{
|
|
3894
4236
|
"annotations": {
|
|
3895
|
-
"destructiveHint":
|
|
3896
|
-
"idempotentHint":
|
|
3897
|
-
"openWorldHint":
|
|
3898
|
-
"readOnlyHint":
|
|
3899
|
-
"title": "
|
|
4237
|
+
"destructiveHint": false,
|
|
4238
|
+
"idempotentHint": true,
|
|
4239
|
+
"openWorldHint": false,
|
|
4240
|
+
"readOnlyHint": true,
|
|
4241
|
+
"title": "Resolve URL"
|
|
3900
4242
|
},
|
|
3901
|
-
"description": "Tool:
|
|
4243
|
+
"description": "Tool: resolve_url\n\nExpand a share link, a URL whose path is \"/share/<id>\" (e.g. \"<host>/share/aBcD1234...\"), into the full URL it redirects to. Share links are opaque, so this is the only way to see what they point at; read the identifiers (project uuid, chart or dashboard uuid, explore name) from the expanded URL, then fetch the content with other tools such as read_content.\n\nEvery other URL, such as \"/projects/<uuid>/saved/<uuid>\" or \"/projects/<uuid>/dashboards/<uuid>\", already contains its identifiers: read them from the path and go straight to the appropriate tool. URLs from another instance cannot be resolved.",
|
|
3902
4244
|
"inputSchema": {
|
|
3903
4245
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3904
4246
|
"properties": {
|
|
3905
|
-
"
|
|
3906
|
-
"description": "
|
|
4247
|
+
"url": {
|
|
4248
|
+
"description": "The Lightdash URL to resolve, exactly as provided.",
|
|
3907
4249
|
"minLength": 1,
|
|
3908
4250
|
"type": "string"
|
|
3909
4251
|
}
|
|
3910
4252
|
},
|
|
3911
|
-
"required": ["
|
|
3912
|
-
"type": "object"
|
|
3913
|
-
},
|
|
3914
|
-
"name": "run_ai_writeback",
|
|
3915
|
-
"outputSchema": {
|
|
3916
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3917
|
-
"additionalProperties": false,
|
|
3918
|
-
"properties": {
|
|
3919
|
-
"aiWritebackRunUuid": {
|
|
3920
|
-
"description": "Id of the writeback run that just started. Pass this to get_ai_writeback_status to check progress and get the pull request URL.",
|
|
3921
|
-
"type": "string"
|
|
3922
|
-
},
|
|
3923
|
-
"errorMessage": {
|
|
3924
|
-
"description": "Why the run failed, or null on success. Only present on the completed result of a task-augmented call.",
|
|
3925
|
-
"type": ["string", "null"]
|
|
3926
|
-
},
|
|
3927
|
-
"prUrl": {
|
|
3928
|
-
"description": "URL of the opened pull request, or null when the run made no changes or failed. Only present on the completed result of a task-augmented call.",
|
|
3929
|
-
"type": ["string", "null"]
|
|
3930
|
-
},
|
|
3931
|
-
"status": {
|
|
3932
|
-
"description": "Final run status. Only present on the completed result of a task-augmented call.",
|
|
3933
|
-
"type": "string"
|
|
3934
|
-
}
|
|
3935
|
-
},
|
|
3936
|
-
"required": ["aiWritebackRunUuid"],
|
|
4253
|
+
"required": ["url"],
|
|
3937
4254
|
"type": "object"
|
|
3938
4255
|
},
|
|
3939
|
-
"
|
|
4256
|
+
"name": "resolve_url",
|
|
4257
|
+
"outputSchema": null,
|
|
4258
|
+
"title": "Resolve URL"
|
|
3940
4259
|
},
|
|
3941
4260
|
{
|
|
3942
4261
|
"annotations": {
|
|
@@ -3944,337 +4263,165 @@
|
|
|
3944
4263
|
"idempotentHint": true,
|
|
3945
4264
|
"openWorldHint": false,
|
|
3946
4265
|
"readOnlyHint": true,
|
|
3947
|
-
"title": "
|
|
4266
|
+
"title": "Route agent"
|
|
3948
4267
|
},
|
|
3949
|
-
"description": "
|
|
4268
|
+
"description": "Select the best AI agent for a user request within the required projectUuid when agent-specific scope is useful and routing is available. Pass the returned agentUuid explicitly to subsequent scoped tools. If routing is unavailable, pick an agent from list_agents and pass its agentUuid explicitly; omit agentUuid when full project scope is desired. Also updates shared agent context for clients that use it.",
|
|
3950
4269
|
"inputSchema": {
|
|
3951
4270
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3952
4271
|
"properties": {
|
|
3953
|
-
"
|
|
3954
|
-
"description": "A one-line description of what the pipeline computes.",
|
|
4272
|
+
"projectUuid": {
|
|
3955
4273
|
"type": "string"
|
|
3956
4274
|
},
|
|
3957
|
-
"
|
|
3958
|
-
"
|
|
3959
|
-
|
|
3960
|
-
|
|
3961
|
-
|
|
3962
|
-
|
|
3963
|
-
|
|
3964
|
-
|
|
3965
|
-
|
|
3966
|
-
|
|
3967
|
-
|
|
3968
|
-
|
|
3969
|
-
|
|
3970
|
-
|
|
3971
|
-
|
|
3972
|
-
|
|
3973
|
-
|
|
3974
|
-
|
|
3975
|
-
|
|
3976
|
-
|
|
3977
|
-
|
|
3978
|
-
|
|
3979
|
-
|
|
3980
|
-
|
|
3981
|
-
|
|
3982
|
-
|
|
3983
|
-
|
|
3984
|
-
|
|
3985
|
-
|
|
3986
|
-
|
|
3987
|
-
|
|
3988
|
-
|
|
3989
|
-
"description": "Flat filter expression for metric fields.",
|
|
3990
|
-
"maxLength": 16384,
|
|
3991
|
-
"minLength": 1,
|
|
3992
|
-
"type": "string"
|
|
3993
|
-
}
|
|
3994
|
-
},
|
|
3995
|
-
"type": "object"
|
|
3996
|
-
},
|
|
3997
|
-
"limit": {
|
|
3998
|
-
"default": 500,
|
|
3999
|
-
"description": "Maximum number of rows this node returns. Defaults to 500, max 5000.",
|
|
4000
|
-
"exclusiveMinimum": 0,
|
|
4001
|
-
"maximum": 5000,
|
|
4002
|
-
"type": "integer"
|
|
4003
|
-
},
|
|
4004
|
-
"metrics": {
|
|
4005
|
-
"description": "Metric field ids to compute, from the explore's schema.",
|
|
4006
|
-
"items": {
|
|
4007
|
-
"type": "string"
|
|
4008
|
-
},
|
|
4009
|
-
"type": "array"
|
|
4010
|
-
},
|
|
4011
|
-
"nodeId": {
|
|
4012
|
-
"description": "Names this node so other nodes can read its result.",
|
|
4013
|
-
"pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
|
|
4014
|
-
"type": "string"
|
|
4015
|
-
},
|
|
4016
|
-
"parameters": {
|
|
4017
|
-
"anyOf": [
|
|
4018
|
-
{
|
|
4019
|
-
"additionalProperties": {
|
|
4020
|
-
"anyOf": [
|
|
4021
|
-
{
|
|
4022
|
-
"type": "string"
|
|
4023
|
-
},
|
|
4024
|
-
{
|
|
4025
|
-
"type": "number"
|
|
4026
|
-
},
|
|
4027
|
-
{
|
|
4028
|
-
"items": {
|
|
4029
|
-
"type": "string"
|
|
4030
|
-
},
|
|
4031
|
-
"type": "array"
|
|
4032
|
-
},
|
|
4033
|
-
{
|
|
4034
|
-
"items": {
|
|
4035
|
-
"type": "number"
|
|
4036
|
-
},
|
|
4037
|
-
"type": "array"
|
|
4038
|
-
}
|
|
4039
|
-
]
|
|
4040
|
-
},
|
|
4041
|
-
"propertyNames": {
|
|
4042
|
-
"type": "string"
|
|
4043
|
-
},
|
|
4044
|
-
"type": "object"
|
|
4045
|
-
},
|
|
4046
|
-
{
|
|
4047
|
-
"type": "null"
|
|
4048
|
-
}
|
|
4049
|
-
],
|
|
4050
|
-
"default": null,
|
|
4051
|
-
"description": "Parameter values for this node, keyed by parameter name exactly as shown in the explore metadata (e.g. {\"orders.metric\": \"active_users\"}). Set them whenever a selected field is marked \"requires parameters\" and the default does not match what the user asked for: an unset parameter silently resolves to its default, which can return the wrong data. null when the explore has no parameters or the defaults are correct."
|
|
4052
|
-
},
|
|
4053
|
-
"sorts": {
|
|
4054
|
-
"description": "Sorts by fields this node also selects in dimensions or metrics, e.g. [{\"fieldId\": \"orders_order_date\", \"descending\": true}].",
|
|
4055
|
-
"items": {
|
|
4056
|
-
"properties": {
|
|
4057
|
-
"descending": {
|
|
4058
|
-
"description": "If true sorts in descending order, ascending otherwise.",
|
|
4059
|
-
"type": "boolean"
|
|
4060
|
-
},
|
|
4061
|
-
"fieldId": {
|
|
4062
|
-
"description": "Field id to sort by.",
|
|
4063
|
-
"type": "string"
|
|
4064
|
-
}
|
|
4065
|
-
},
|
|
4066
|
-
"required": [
|
|
4067
|
-
"fieldId",
|
|
4068
|
-
"descending"
|
|
4069
|
-
],
|
|
4070
|
-
"type": "object"
|
|
4071
|
-
},
|
|
4072
|
-
"type": "array"
|
|
4073
|
-
},
|
|
4074
|
-
"sourceType": {
|
|
4075
|
-
"const": "semanticLayer",
|
|
4076
|
-
"type": "string"
|
|
4077
|
-
},
|
|
4078
|
-
"title": {
|
|
4079
|
-
"description": "Short label a reader understands without seeing the query, two to five words, e.g. \"Revenue by month\". Shown to users instead of the node id.",
|
|
4080
|
-
"type": "string"
|
|
4081
|
-
}
|
|
4082
|
-
},
|
|
4083
|
-
"required": [
|
|
4084
|
-
"sourceType",
|
|
4085
|
-
"nodeId",
|
|
4086
|
-
"title",
|
|
4087
|
-
"description",
|
|
4088
|
-
"exploreName",
|
|
4089
|
-
"dimensions",
|
|
4090
|
-
"metrics"
|
|
4091
|
-
],
|
|
4092
|
-
"type": "object"
|
|
4093
|
-
},
|
|
4094
|
-
{
|
|
4095
|
-
"properties": {
|
|
4096
|
-
"description": {
|
|
4097
|
-
"description": "One sentence for a business user on what this node does to the data, adding to the title rather than repeating it, e.g. \"Sums completed order revenue per month over the last year.\" Shown as the node's heading in the pipeline list.",
|
|
4098
|
-
"type": "string"
|
|
4099
|
-
},
|
|
4100
|
-
"limit": {
|
|
4101
|
-
"default": 500,
|
|
4102
|
-
"description": "Maximum number of rows this node returns. Defaults to 500, max 5000.",
|
|
4103
|
-
"exclusiveMinimum": 0,
|
|
4104
|
-
"maximum": 5000,
|
|
4105
|
-
"type": "integer"
|
|
4106
|
-
},
|
|
4107
|
-
"nodeId": {
|
|
4108
|
-
"description": "Names this node so other nodes can read its result.",
|
|
4109
|
-
"pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
|
|
4110
|
-
"type": "string"
|
|
4111
|
-
},
|
|
4112
|
-
"sourceType": {
|
|
4113
|
-
"const": "sql",
|
|
4114
|
-
"type": "string"
|
|
4115
|
-
},
|
|
4116
|
-
"sql": {
|
|
4117
|
-
"description": "A SELECT or WITH statement in the warehouse's SQL dialect.",
|
|
4118
|
-
"type": "string"
|
|
4119
|
-
},
|
|
4120
|
-
"title": {
|
|
4121
|
-
"description": "Short label a reader understands without seeing the query, two to five words, e.g. \"Revenue by month\". Shown to users instead of the node id.",
|
|
4122
|
-
"type": "string"
|
|
4123
|
-
}
|
|
4124
|
-
},
|
|
4125
|
-
"required": [
|
|
4126
|
-
"sourceType",
|
|
4127
|
-
"nodeId",
|
|
4128
|
-
"title",
|
|
4129
|
-
"description",
|
|
4130
|
-
"sql"
|
|
4131
|
-
],
|
|
4132
|
-
"type": "object"
|
|
4275
|
+
"prompt": {
|
|
4276
|
+
"type": "string"
|
|
4277
|
+
}
|
|
4278
|
+
},
|
|
4279
|
+
"required": ["prompt"],
|
|
4280
|
+
"type": "object"
|
|
4281
|
+
},
|
|
4282
|
+
"name": "route_agent",
|
|
4283
|
+
"outputSchema": {
|
|
4284
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
4285
|
+
"additionalProperties": false,
|
|
4286
|
+
"properties": {
|
|
4287
|
+
"agentDescription": {
|
|
4288
|
+
"type": ["string", "null"]
|
|
4289
|
+
},
|
|
4290
|
+
"agentName": {
|
|
4291
|
+
"type": "string"
|
|
4292
|
+
},
|
|
4293
|
+
"agentProjectUuid": {
|
|
4294
|
+
"type": "string"
|
|
4295
|
+
},
|
|
4296
|
+
"agentSpaceAccess": {
|
|
4297
|
+
"items": {
|
|
4298
|
+
"type": "string"
|
|
4299
|
+
},
|
|
4300
|
+
"type": "array"
|
|
4301
|
+
},
|
|
4302
|
+
"agentTags": {
|
|
4303
|
+
"anyOf": [
|
|
4304
|
+
{
|
|
4305
|
+
"items": {
|
|
4306
|
+
"type": "string"
|
|
4133
4307
|
},
|
|
4134
|
-
|
|
4135
|
-
|
|
4136
|
-
|
|
4137
|
-
|
|
4138
|
-
|
|
4139
|
-
|
|
4140
|
-
|
|
4141
|
-
|
|
4142
|
-
|
|
4143
|
-
|
|
4144
|
-
|
|
4145
|
-
|
|
4146
|
-
|
|
4147
|
-
|
|
4148
|
-
|
|
4149
|
-
|
|
4150
|
-
"type": "string"
|
|
4151
|
-
},
|
|
4152
|
-
"references": {
|
|
4153
|
-
"anyOf": [
|
|
4154
|
-
{
|
|
4155
|
-
"items": {
|
|
4156
|
-
"pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
|
|
4157
|
-
"type": "string"
|
|
4158
|
-
},
|
|
4159
|
-
"type": "array"
|
|
4160
|
-
},
|
|
4161
|
-
{
|
|
4162
|
-
"additionalProperties": {
|
|
4163
|
-
"pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
|
|
4164
|
-
"type": "string"
|
|
4165
|
-
},
|
|
4166
|
-
"propertyNames": {
|
|
4167
|
-
"type": "string"
|
|
4168
|
-
},
|
|
4169
|
-
"type": "object"
|
|
4170
|
-
}
|
|
4171
|
-
],
|
|
4172
|
-
"description": "Which nodes the SQL reads, by node id: an array (each exposed as a table named by its node id), or a map of {tableName: nodeId} to alias them."
|
|
4173
|
-
},
|
|
4174
|
-
"sourceType": {
|
|
4175
|
-
"const": "duckdb",
|
|
4176
|
-
"type": "string"
|
|
4177
|
-
},
|
|
4178
|
-
"sql": {
|
|
4179
|
-
"description": "DuckDB SQL over the tables \"references\" exposes.",
|
|
4180
|
-
"type": "string"
|
|
4181
|
-
},
|
|
4182
|
-
"title": {
|
|
4183
|
-
"description": "Short label a reader understands without seeing the query, two to five words, e.g. \"Revenue by month\". Shown to users instead of the node id.",
|
|
4184
|
-
"type": "string"
|
|
4185
|
-
}
|
|
4186
|
-
},
|
|
4187
|
-
"required": [
|
|
4188
|
-
"sourceType",
|
|
4189
|
-
"nodeId",
|
|
4190
|
-
"title",
|
|
4191
|
-
"description",
|
|
4192
|
-
"sql",
|
|
4193
|
-
"references"
|
|
4194
|
-
],
|
|
4195
|
-
"type": "object"
|
|
4308
|
+
"type": "array"
|
|
4309
|
+
},
|
|
4310
|
+
{
|
|
4311
|
+
"type": "null"
|
|
4312
|
+
}
|
|
4313
|
+
]
|
|
4314
|
+
},
|
|
4315
|
+
"agentUuid": {
|
|
4316
|
+
"type": "string"
|
|
4317
|
+
},
|
|
4318
|
+
"candidates": {
|
|
4319
|
+
"items": {
|
|
4320
|
+
"additionalProperties": false,
|
|
4321
|
+
"properties": {
|
|
4322
|
+
"agentUuid": {
|
|
4323
|
+
"type": "string"
|
|
4196
4324
|
},
|
|
4197
|
-
{
|
|
4198
|
-
"
|
|
4199
|
-
|
|
4200
|
-
|
|
4201
|
-
|
|
4202
|
-
},
|
|
4203
|
-
"limit": {
|
|
4204
|
-
"default": 500,
|
|
4205
|
-
"description": "Maximum number of rows this node returns. Defaults to 500, max 5000.",
|
|
4206
|
-
"exclusiveMinimum": 0,
|
|
4207
|
-
"maximum": 5000,
|
|
4208
|
-
"type": "integer"
|
|
4209
|
-
},
|
|
4210
|
-
"nodeId": {
|
|
4211
|
-
"description": "Names this node so other nodes can read its result.",
|
|
4212
|
-
"pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,62}$",
|
|
4213
|
-
"type": "string"
|
|
4214
|
-
},
|
|
4215
|
-
"sourceType": {
|
|
4216
|
-
"const": "external",
|
|
4217
|
-
"type": "string"
|
|
4218
|
-
},
|
|
4219
|
-
"sql": {
|
|
4220
|
-
"description": "DuckDB SQL over the tables \"tables\" declares.",
|
|
4221
|
-
"type": "string"
|
|
4222
|
-
},
|
|
4223
|
-
"tables": {
|
|
4224
|
-
"anyOf": [
|
|
4225
|
-
{
|
|
4226
|
-
"items": {
|
|
4227
|
-
"type": "string"
|
|
4228
|
-
},
|
|
4229
|
-
"type": "array"
|
|
4230
|
-
},
|
|
4231
|
-
{
|
|
4232
|
-
"additionalProperties": {
|
|
4233
|
-
"type": "string"
|
|
4234
|
-
},
|
|
4235
|
-
"propertyNames": {
|
|
4236
|
-
"type": "string"
|
|
4237
|
-
},
|
|
4238
|
-
"type": "object"
|
|
4239
|
-
}
|
|
4240
|
-
],
|
|
4241
|
-
"description": "External tables this node reads: an array of table names (each exposed under its name), or a map of {sqlAlias: tableNameOrTableUuid}. Prefer table UUIDs from attached-source context so renames cannot break the query."
|
|
4242
|
-
},
|
|
4243
|
-
"title": {
|
|
4244
|
-
"description": "Short label a reader understands without seeing the query, two to five words, e.g. \"Revenue by month\". Shown to users instead of the node id.",
|
|
4245
|
-
"type": "string"
|
|
4246
|
-
}
|
|
4247
|
-
},
|
|
4248
|
-
"required": [
|
|
4249
|
-
"sourceType",
|
|
4250
|
-
"nodeId",
|
|
4251
|
-
"title",
|
|
4252
|
-
"description",
|
|
4253
|
-
"sql",
|
|
4254
|
-
"tables"
|
|
4255
|
-
],
|
|
4256
|
-
"type": "object"
|
|
4325
|
+
"description": {
|
|
4326
|
+
"type": ["string", "null"]
|
|
4327
|
+
},
|
|
4328
|
+
"name": {
|
|
4329
|
+
"type": "string"
|
|
4257
4330
|
}
|
|
4258
|
-
|
|
4331
|
+
},
|
|
4332
|
+
"required": ["agentUuid", "name", "description"],
|
|
4333
|
+
"type": "object"
|
|
4259
4334
|
},
|
|
4260
|
-
"minItems": 1,
|
|
4261
4335
|
"type": "array"
|
|
4262
4336
|
},
|
|
4263
|
-
"
|
|
4264
|
-
"
|
|
4337
|
+
"confidence": {
|
|
4338
|
+
"enum": ["high", "medium", "low"],
|
|
4265
4339
|
"type": "string"
|
|
4266
4340
|
},
|
|
4267
|
-
"
|
|
4268
|
-
"
|
|
4341
|
+
"explores": {
|
|
4342
|
+
"items": {
|
|
4343
|
+
"type": "string"
|
|
4344
|
+
},
|
|
4345
|
+
"type": "array"
|
|
4346
|
+
},
|
|
4347
|
+
"instruction": {
|
|
4348
|
+
"type": ["string", "null"]
|
|
4349
|
+
},
|
|
4350
|
+
"reasoning": {
|
|
4269
4351
|
"type": "string"
|
|
4352
|
+
},
|
|
4353
|
+
"verifiedQuestions": {
|
|
4354
|
+
"items": {
|
|
4355
|
+
"type": "string"
|
|
4356
|
+
},
|
|
4357
|
+
"type": "array"
|
|
4270
4358
|
}
|
|
4271
4359
|
},
|
|
4272
|
-
"required": [
|
|
4360
|
+
"required": [
|
|
4361
|
+
"agentUuid",
|
|
4362
|
+
"agentName",
|
|
4363
|
+
"agentDescription",
|
|
4364
|
+
"agentTags",
|
|
4365
|
+
"agentSpaceAccess",
|
|
4366
|
+
"agentProjectUuid",
|
|
4367
|
+
"explores",
|
|
4368
|
+
"verifiedQuestions",
|
|
4369
|
+
"instruction",
|
|
4370
|
+
"confidence",
|
|
4371
|
+
"reasoning",
|
|
4372
|
+
"candidates"
|
|
4373
|
+
],
|
|
4273
4374
|
"type": "object"
|
|
4274
4375
|
},
|
|
4275
|
-
"
|
|
4276
|
-
|
|
4277
|
-
|
|
4376
|
+
"title": "Route agent"
|
|
4377
|
+
},
|
|
4378
|
+
{
|
|
4379
|
+
"annotations": {
|
|
4380
|
+
"destructiveHint": true,
|
|
4381
|
+
"idempotentHint": false,
|
|
4382
|
+
"openWorldHint": true,
|
|
4383
|
+
"readOnlyHint": false,
|
|
4384
|
+
"title": "Run AI writeback"
|
|
4385
|
+
},
|
|
4386
|
+
"description": "Tool: run_ai_writeback\n\nChange a Lightdash project's dbt project from a natural-language prompt. The GitHub repository and dbt sub-folder are resolved server-side from its dbt connection; never specify them.\n\nSafety and requirements:\n- NOT read-only or idempotent: each call can start a run and open a new pull request. Use only when the user explicitly wants a dbt change.\n- Requires a GitHub-backed dbt connection, the organization's GitHub App installation, and AI writeback enabled for the organization.\n\nExecution:\n- Returns immediately with aiWritebackRunUuid; does not wait for completion. A background sandbox clones the project's GitHub repository and runs the prompt through Claude Code CLI against dbt. If files change, a branch is committed and pushed, and a pull request opened.\n- Runs usually take a few minutes. Poll get_ai_writeback_status every 10-15 seconds with aiWritebackRunUuid for progress and the pull request URL.\n- Clients declaring io.modelcontextprotocol/tasks in per-request capabilities instead get a task handle (resultType: \"task\", taskId = run id). Poll tasks/get and cancel via tasks/cancel, rather than using get_ai_writeback_status.\n\nInput:\n- prompt: a clear, self-contained change, e.g. \"Add a total_revenue metric to orders as the sum of amount\".\n- With multiple dbt sources, name the intended source in the prompt, e.g. \"In the marketing dbt project, ...\"; never pass a source ID. If ambiguous, the run ends with status \"error\" and an error message listing the source names. Call run_ai_writeback again with the intended source named in the prompt.\n\nNormal response (MCP CallToolResult): content contains a text message saying the run started and to poll get_ai_writeback_status; structuredContent is { aiWritebackRunUuid: string }.\n",
|
|
4387
|
+
"inputSchema": {
|
|
4388
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
4389
|
+
"properties": {
|
|
4390
|
+
"prompt": {
|
|
4391
|
+
"description": "A clear, self-contained description of the change to make to the dbt project that backs the target Lightdash project. If the project has more than one dbt source, name the intended one here (e.g. \"In jaffle-2, add ...\") — a later get_ai_writeback_status call reports whether the run could tell which source you meant.",
|
|
4392
|
+
"minLength": 1,
|
|
4393
|
+
"type": "string"
|
|
4394
|
+
}
|
|
4395
|
+
},
|
|
4396
|
+
"required": ["prompt"],
|
|
4397
|
+
"type": "object"
|
|
4398
|
+
},
|
|
4399
|
+
"name": "run_ai_writeback",
|
|
4400
|
+
"outputSchema": {
|
|
4401
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
4402
|
+
"additionalProperties": false,
|
|
4403
|
+
"properties": {
|
|
4404
|
+
"aiWritebackRunUuid": {
|
|
4405
|
+
"description": "Id of the writeback run that just started. Pass this to get_ai_writeback_status to check progress and get the pull request URL.",
|
|
4406
|
+
"type": "string"
|
|
4407
|
+
},
|
|
4408
|
+
"errorMessage": {
|
|
4409
|
+
"description": "Why the run failed, or null on success. Only present on the completed result of a task-augmented call.",
|
|
4410
|
+
"type": ["string", "null"]
|
|
4411
|
+
},
|
|
4412
|
+
"prUrl": {
|
|
4413
|
+
"description": "URL of the opened pull request, or null when the run made no changes or failed. Only present on the completed result of a task-augmented call.",
|
|
4414
|
+
"type": ["string", "null"]
|
|
4415
|
+
},
|
|
4416
|
+
"status": {
|
|
4417
|
+
"description": "Final run status. Only present on the completed result of a task-augmented call.",
|
|
4418
|
+
"type": "string"
|
|
4419
|
+
}
|
|
4420
|
+
},
|
|
4421
|
+
"required": ["aiWritebackRunUuid"],
|
|
4422
|
+
"type": "object"
|
|
4423
|
+
},
|
|
4424
|
+
"title": "Run AI writeback"
|
|
4278
4425
|
},
|
|
4279
4426
|
{
|
|
4280
4427
|
"annotations": {
|