langflow-mcp-server 4.11.0 → 4.12.3

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.
Files changed (70) hide show
  1. package/.env.example +19 -1
  2. package/README.md +158 -37
  3. package/dist/__tests__/fixtures/advanced-execution.d.ts.map +1 -1
  4. package/dist/__tests__/fixtures/advanced-execution.js +7 -4
  5. package/dist/__tests__/fixtures/advanced-execution.js.map +1 -1
  6. package/dist/__tests__/fixtures/api-keys.js.map +1 -1
  7. package/dist/__tests__/fixtures/auth.d.ts.map +1 -1
  8. package/dist/__tests__/fixtures/components.d.ts.map +1 -1
  9. package/dist/__tests__/fixtures/custom-components.js.map +1 -1
  10. package/dist/__tests__/fixtures/files.d.ts.map +1 -1
  11. package/dist/__tests__/fixtures/files.js.map +1 -1
  12. package/dist/__tests__/fixtures/flows.js.map +1 -1
  13. package/dist/__tests__/fixtures/folders.js.map +1 -1
  14. package/dist/__tests__/fixtures/knowledge-bases.d.ts.map +1 -1
  15. package/dist/__tests__/fixtures/knowledge-bases.js.map +1 -1
  16. package/dist/__tests__/fixtures/misc.js.map +1 -1
  17. package/dist/__tests__/fixtures/monitoring.js.map +1 -1
  18. package/dist/__tests__/fixtures/projects.js.map +1 -1
  19. package/dist/__tests__/fixtures/run.d.ts.map +1 -1
  20. package/dist/__tests__/fixtures/store.d.ts.map +1 -1
  21. package/dist/__tests__/fixtures/store.js.map +1 -1
  22. package/dist/__tests__/fixtures/users.js.map +1 -1
  23. package/dist/__tests__/fixtures/variables.js.map +1 -1
  24. package/dist/__tests__/fixtures/vertices.d.ts.map +1 -1
  25. package/dist/index.d.ts +2 -0
  26. package/dist/index.d.ts.map +1 -1
  27. package/dist/index.js +5 -1
  28. package/dist/index.js.map +1 -1
  29. package/dist/mcp/http.d.ts +69 -0
  30. package/dist/mcp/http.d.ts.map +1 -0
  31. package/dist/mcp/http.js +595 -0
  32. package/dist/mcp/http.js.map +1 -0
  33. package/dist/mcp/index.js +39 -5
  34. package/dist/mcp/index.js.map +1 -1
  35. package/dist/mcp/prompts.js.map +1 -1
  36. package/dist/mcp/resources.d.ts.map +1 -1
  37. package/dist/mcp/resources.js +6 -17
  38. package/dist/mcp/resources.js.map +1 -1
  39. package/dist/mcp/server-consolidated.d.ts +3 -0
  40. package/dist/mcp/server-consolidated.d.ts.map +1 -1
  41. package/dist/mcp/server-consolidated.js +97 -10
  42. package/dist/mcp/server-consolidated.js.map +1 -1
  43. package/dist/mcp/server.d.ts +2 -0
  44. package/dist/mcp/server.d.ts.map +1 -1
  45. package/dist/mcp/server.js +125 -14
  46. package/dist/mcp/server.js.map +1 -1
  47. package/dist/mcp/tools-consolidated.d.ts.map +1 -1
  48. package/dist/mcp/tools-consolidated.js +130 -38
  49. package/dist/mcp/tools-consolidated.js.map +1 -1
  50. package/dist/mcp/tools.d.ts.map +1 -1
  51. package/dist/mcp/tools.js +361 -68
  52. package/dist/mcp/tools.js.map +1 -1
  53. package/dist/mcp/validation-consolidated.d.ts +254 -50
  54. package/dist/mcp/validation-consolidated.d.ts.map +1 -1
  55. package/dist/mcp/validation-consolidated.js +163 -36
  56. package/dist/mcp/validation-consolidated.js.map +1 -1
  57. package/dist/mcp/validation.d.ts +260 -51
  58. package/dist/mcp/validation.d.ts.map +1 -1
  59. package/dist/mcp/validation.js +166 -40
  60. package/dist/mcp/validation.js.map +1 -1
  61. package/dist/services/langflow-client.d.ts +29 -9
  62. package/dist/services/langflow-client.d.ts.map +1 -1
  63. package/dist/services/langflow-client.js +240 -21
  64. package/dist/services/langflow-client.js.map +1 -1
  65. package/dist/types/index.d.ts +169 -27
  66. package/dist/types/index.d.ts.map +1 -1
  67. package/dist/utils/logger.d.ts.map +1 -1
  68. package/dist/utils/logger.js +2 -3
  69. package/dist/utils/logger.js.map +1 -1
  70. package/package.json +13 -14
package/dist/mcp/tools.js CHANGED
@@ -1236,6 +1236,53 @@ Related Tools:
1236
1236
  openWorldHint: true
1237
1237
  }
1238
1238
  },
1239
+ {
1240
+ name: 'build_public_flow',
1241
+ description: 'Build a public flow without authentication using Langflow 1.11.x public-build semantics.',
1242
+ inputSchema: {
1243
+ type: 'object',
1244
+ properties: {
1245
+ flow_id: { type: 'string', description: 'Public flow ID (UUID)' },
1246
+ inputs: {
1247
+ type: ['object', 'null'],
1248
+ description: 'Optional single input request with components, input_value, session, and type'
1249
+ },
1250
+ files: { type: ['array', 'null'], items: { type: 'string' }, description: 'Optional flow-scoped file paths' },
1251
+ stop_component_id: { type: ['string', 'null'], description: 'Optional component to stop at' },
1252
+ start_component_id: { type: ['string', 'null'], description: 'Optional component to start from' },
1253
+ log_builds: { type: ['boolean', 'null'], description: 'Whether to log the public build' },
1254
+ flow_name: { type: ['string', 'null'], description: 'Optional flow name override' },
1255
+ event_delivery: { type: 'string', enum: ['polling', 'streaming', 'direct'], description: 'Build event delivery mode' }
1256
+ },
1257
+ required: ['flow_id']
1258
+ },
1259
+ annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }
1260
+ },
1261
+ {
1262
+ name: 'get_public_build_events',
1263
+ description: 'Get events for a public flow build job, including streaming event payloads.',
1264
+ inputSchema: {
1265
+ type: 'object',
1266
+ properties: {
1267
+ job_id: { type: 'string', description: 'Public build job ID' },
1268
+ event_delivery: { type: 'string', enum: ['polling', 'streaming', 'direct'], description: 'Event delivery mode' }
1269
+ },
1270
+ required: ['job_id']
1271
+ },
1272
+ annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
1273
+ },
1274
+ {
1275
+ name: 'cancel_public_build',
1276
+ description: 'Cancel a public flow build job.',
1277
+ inputSchema: {
1278
+ type: 'object',
1279
+ properties: {
1280
+ job_id: { type: 'string', description: 'Public build job ID' }
1281
+ },
1282
+ required: ['job_id']
1283
+ },
1284
+ annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }
1285
+ },
1239
1286
  {
1240
1287
  name: 'list_knowledge_bases',
1241
1288
  description: `List all knowledge bases for Retrieval-Augmented Generation (RAG) workflows.
@@ -1656,7 +1703,7 @@ Related Tools:
1656
1703
  },
1657
1704
  {
1658
1705
  name: 'run_flow_advanced',
1659
- description: 'Advanced flow execution with full parameter control including tweaks, input/output types, session management, and streaming. Supports both flow UUID and flow name.',
1706
+ description: 'Advanced flow execution using Langflow 1.11.x input/output request arrays, tweaks, sessions, and streaming.',
1660
1707
  inputSchema: {
1661
1708
  type: 'object',
1662
1709
  properties: {
@@ -1664,28 +1711,21 @@ Related Tools:
1664
1711
  type: 'string',
1665
1712
  description: 'Flow ID (UUID) or flow name to execute'
1666
1713
  },
1667
- input_value: {
1668
- type: 'string',
1669
- description: 'Input value for the flow'
1670
- },
1671
- input_type: {
1672
- type: 'string',
1673
- description: 'Type of input (e.g., "chat", "text")'
1674
- },
1675
- output_type: {
1676
- type: 'string',
1677
- description: 'Expected output type (e.g., "chat", "text", "json")'
1714
+ inputs: {
1715
+ type: ['array', 'null'],
1716
+ description: 'InputValueRequest array with optional components, input_value, session, and type'
1678
1717
  },
1679
- output_component: {
1680
- type: 'string',
1681
- description: 'Specific output component to retrieve results from'
1718
+ outputs: {
1719
+ type: ['array', 'null'],
1720
+ items: { type: 'string' },
1721
+ description: 'Optional output component names or IDs'
1682
1722
  },
1683
1723
  tweaks: {
1684
- type: 'object',
1724
+ type: ['object', 'null'],
1685
1725
  description: 'Component-specific parameter overrides'
1686
1726
  },
1687
1727
  session_id: {
1688
- type: 'string',
1728
+ type: ['string', 'null'],
1689
1729
  description: 'Session ID for conversation continuity'
1690
1730
  },
1691
1731
  user_id: {
@@ -1872,7 +1912,7 @@ Related Tools:
1872
1912
  },
1873
1913
  {
1874
1914
  name: 'get_monitor_messages',
1875
- description: 'Query chat/message history with flexible filtering options. Retrieve messages filtered by flow ID, session, sender, or sender name. Supports custom ordering for chronological or reverse-chronological message retrieval. Essential for debugging chat flows, analyzing conversation patterns, and monitoring user interactions.',
1915
+ description: 'Query a window of chat messages filtered by flow, session, sender, or sender name. Langflow selects the newest 100 by default (maximum 200; limit 0 uses the default). Use offset to page into older history; order and order_by sort within the selected window.',
1876
1916
  inputSchema: {
1877
1917
  type: 'object',
1878
1918
  properties: {
@@ -1895,6 +1935,11 @@ Related Tools:
1895
1935
  order_by: {
1896
1936
  type: 'string',
1897
1937
  description: 'Optional field to order results by (default: timestamp)'
1938
+ },
1939
+ limit: { type: 'integer', minimum: 0, description: 'Window size; omitted or 0 uses 100, upstream clamps values above 200' },
1940
+ offset: { type: 'integer', minimum: 0, description: 'Messages to skip from newest history (default: 0)' },
1941
+ order: {
1942
+ type: 'string', enum: ['ASC', 'DESC'], description: 'Display order within the selected window (default: ASC)'
1898
1943
  }
1899
1944
  }
1900
1945
  },
@@ -1907,7 +1952,7 @@ Related Tools:
1907
1952
  },
1908
1953
  {
1909
1954
  name: 'get_monitor_message',
1910
- description: 'Get detailed information about a specific message by ID. Retrieves complete message data including sender, content, timestamp, and metadata. Useful for inspecting individual message details and debugging message-related issues.',
1955
+ description: 'Find a message by ID by scanning history in windows of 200 within the configured request timeout (default: 30 seconds). A timeout is reported if the lookup budget expires. For large histories, use get_monitor_messages with flow or session filters and offset paging.',
1911
1956
  inputSchema: {
1912
1957
  type: 'object',
1913
1958
  properties: {
@@ -1928,14 +1973,15 @@ Related Tools:
1928
1973
  },
1929
1974
  {
1930
1975
  name: 'get_monitor_sessions',
1931
- description: 'List all chat session IDs, optionally filtered by flow. Returns array of session identifiers that can be used to query session-specific messages. Essential for discovering active sessions, monitoring concurrent users, and analyzing session patterns.',
1976
+ description: 'List the newest chat session IDs, optionally filtered by flow. Langflow returns 100 by default, at most 200; limit 0 uses the default. Sessions are ordered by latest message timestamp descending. Older sessions beyond the cap are not returned.',
1932
1977
  inputSchema: {
1933
1978
  type: 'object',
1934
1979
  properties: {
1935
1980
  flow_id: {
1936
1981
  type: 'string',
1937
1982
  description: 'Optional flow ID (UUID) to filter sessions by flow'
1938
- }
1983
+ },
1984
+ limit: { type: 'integer', minimum: 0, description: 'Session limit; omitted or 0 uses 100, upstream clamps values above 200' }
1939
1985
  }
1940
1986
  },
1941
1987
  annotations: {
@@ -1947,14 +1993,17 @@ Related Tools:
1947
1993
  },
1948
1994
  {
1949
1995
  name: 'get_monitor_session_messages',
1950
- description: 'Get all messages for a specific session ID. Retrieves complete conversation history for a session in chronological order. Essential for reviewing full conversation context, debugging session-specific issues, and analyzing user interactions within a session.',
1996
+ description: 'Get a window of messages for a session. Langflow selects the newest 100 by default (maximum 200; limit 0 uses the default), displayed in timestamp ASC order unless order is supplied. Use offset to page into older history.',
1951
1997
  inputSchema: {
1952
1998
  type: 'object',
1953
1999
  properties: {
1954
2000
  session_id: {
1955
2001
  type: 'string',
1956
2002
  description: 'Session ID to retrieve messages for'
1957
- }
2003
+ },
2004
+ limit: { type: 'integer', minimum: 0, description: 'Window size; omitted or 0 uses 100, upstream clamps values above 200' },
2005
+ offset: { type: 'integer', minimum: 0, description: 'Messages to skip from newest session history (default: 0)' },
2006
+ order: { type: 'string', enum: ['ASC', 'DESC'], description: 'Display order within the selected window (default: ASC)' }
1958
2007
  },
1959
2008
  required: ['session_id']
1960
2009
  },
@@ -3053,13 +3102,16 @@ Related Tools:
3053
3102
  },
3054
3103
  {
3055
3104
  name: 'get_shared_messages',
3056
- description: 'Get shared (playground) messages for a source flow, optionally filtered by session and ordered.',
3105
+ description: 'Get a window of shared (playground) messages for a source flow, optionally filtered by session. Langflow selects the newest 100 by default (maximum 200; limit 0 uses the default). Use offset to page into older history; order and order_by sort within the selected window.',
3057
3106
  inputSchema: {
3058
3107
  type: 'object',
3059
3108
  properties: {
3060
3109
  source_flow_id: { type: 'string', description: 'Source flow ID' },
3061
3110
  session_id: { type: 'string', description: 'Optional session ID filter' },
3062
- order_by: { type: 'string', description: 'Optional order-by field' }
3111
+ order_by: { type: 'string', description: 'Optional order-by field' },
3112
+ limit: { type: 'integer', minimum: 0, description: 'Window size; omitted or 0 uses 100, upstream clamps values above 200' },
3113
+ offset: { type: 'integer', minimum: 0, description: 'Messages to skip from newest history (default: 0)' },
3114
+ order: { type: 'string', enum: ['ASC', 'DESC'], description: 'Display order within the selected window (default: ASC)' }
3063
3115
  },
3064
3116
  required: ['source_flow_id']
3065
3117
  },
@@ -3067,11 +3119,12 @@ Related Tools:
3067
3119
  },
3068
3120
  {
3069
3121
  name: 'get_shared_sessions',
3070
- description: 'Get the list of shared session IDs for a source flow.',
3122
+ description: 'List the newest shared session IDs for a source flow, ordered by latest message timestamp descending. Langflow returns 100 by default, at most 200; limit 0 uses the default. Older sessions beyond the cap are not returned.',
3071
3123
  inputSchema: {
3072
3124
  type: 'object',
3073
3125
  properties: {
3074
- source_flow_id: { type: 'string', description: 'Source flow ID' }
3126
+ source_flow_id: { type: 'string', description: 'Source flow ID' },
3127
+ limit: { type: 'integer', minimum: 0, description: 'Session limit; omitted or 0 uses 100, upstream clamps values above 200' }
3075
3128
  },
3076
3129
  required: ['source_flow_id']
3077
3130
  },
@@ -3190,7 +3243,8 @@ Related Tools:
3190
3243
  include_deprecated: { type: 'boolean', description: 'Include deprecated models' },
3191
3244
  tool_calling: { type: 'boolean', description: 'Filter to tool-calling models' },
3192
3245
  reasoning: { type: 'boolean', description: 'Filter to reasoning models' },
3193
- search: { type: 'string', description: 'Search query' }
3246
+ search: { type: 'string', description: 'Search query' },
3247
+ purpose: { type: 'string', enum: ['use', 'configure'], description: 'Optional provider visibility purpose' }
3194
3248
  }
3195
3249
  },
3196
3250
  annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
@@ -3198,7 +3252,12 @@ Related Tools:
3198
3252
  {
3199
3253
  name: 'list_model_providers',
3200
3254
  description: 'List all known model providers.',
3201
- inputSchema: { type: 'object', properties: {} },
3255
+ inputSchema: {
3256
+ type: 'object',
3257
+ properties: {
3258
+ purpose: { type: 'string', enum: ['use', 'configure'], description: 'Optional provider visibility purpose' }
3259
+ }
3260
+ },
3202
3261
  annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
3203
3262
  },
3204
3263
  {
@@ -3207,7 +3266,8 @@ Related Tools:
3207
3266
  inputSchema: {
3208
3267
  type: 'object',
3209
3268
  properties: {
3210
- providers: { type: 'array', items: { type: 'string' }, description: 'Optional provider names to check' }
3269
+ providers: { type: 'array', items: { type: 'string' }, description: 'Optional provider names to check' },
3270
+ purpose: { type: 'string', enum: ['use', 'configure'], description: 'Optional provider visibility purpose' }
3211
3271
  }
3212
3272
  },
3213
3273
  annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
@@ -3218,7 +3278,8 @@ Related Tools:
3218
3278
  inputSchema: {
3219
3279
  type: 'object',
3220
3280
  properties: {
3221
- model_names: { type: 'array', items: { type: 'string' }, description: 'Optional model names to check' }
3281
+ model_names: { type: 'array', items: { type: 'string' }, description: 'Optional model names to check' },
3282
+ purpose: { type: 'string', enum: ['use', 'configure'], description: 'Optional provider visibility purpose' }
3222
3283
  }
3223
3284
  },
3224
3285
  annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
@@ -3288,7 +3349,12 @@ Related Tools:
3288
3349
  {
3289
3350
  name: 'get_provider_variable_mapping',
3290
3351
  description: 'Get the mapping between model providers and their required global variables.',
3291
- inputSchema: { type: 'object', properties: {} },
3352
+ inputSchema: {
3353
+ type: 'object',
3354
+ properties: {
3355
+ purpose: { type: 'string', enum: ['use', 'configure'], description: 'Optional provider visibility purpose' }
3356
+ }
3357
+ },
3292
3358
  annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
3293
3359
  },
3294
3360
  {
@@ -3307,13 +3373,23 @@ Related Tools:
3307
3373
  {
3308
3374
  name: 'get_language_model_options',
3309
3375
  description: 'Get available language (LLM) model options.',
3310
- inputSchema: { type: 'object', properties: {} },
3376
+ inputSchema: {
3377
+ type: 'object',
3378
+ properties: {
3379
+ purpose: { type: 'string', enum: ['use', 'configure'], description: 'Optional provider visibility purpose' }
3380
+ }
3381
+ },
3311
3382
  annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
3312
3383
  },
3313
3384
  {
3314
3385
  name: 'get_embedding_model_options',
3315
3386
  description: 'Get available embedding model options.',
3316
- inputSchema: { type: 'object', properties: {} },
3387
+ inputSchema: {
3388
+ type: 'object',
3389
+ properties: {
3390
+ purpose: { type: 'string', enum: ['use', 'configure'], description: 'Optional provider visibility purpose' }
3391
+ }
3392
+ },
3317
3393
  annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
3318
3394
  },
3319
3395
  {
@@ -3323,13 +3399,36 @@ Related Tools:
3323
3399
  type: 'object',
3324
3400
  properties: {
3325
3401
  flow_id: { type: 'string', description: 'Flow ID' },
3326
- input_value: { type: 'string', description: 'User input/instruction' },
3327
- session_id: { type: 'string', description: 'Optional session ID' },
3328
- component_id: { type: 'string', description: 'Optional target component ID' },
3329
- field_name: { type: 'string', description: 'Optional target field name' },
3330
- model_name: { type: 'string', description: 'Optional model name' },
3331
- provider: { type: 'string', description: 'Optional provider' },
3332
- max_retries: { type: 'number', description: 'Optional max retries' }
3402
+ input_value: { type: ['string', 'null'], description: 'User input/instruction (server-configured limit)' },
3403
+ iterations_limit: { type: ['number', 'null'], description: 'Maximum assistant iterations (1-200)' },
3404
+ session_id: { type: ['string', 'null'], description: 'Optional session ID' },
3405
+ component_id: { type: ['string', 'null'], description: 'Optional target component ID' },
3406
+ field_name: { type: ['string', 'null'], description: 'Optional target field name' },
3407
+ model_name: { type: ['string', 'null'], description: 'Optional model name' },
3408
+ provider: { type: ['string', 'null'], description: 'Optional provider' },
3409
+ history_limit: { type: ['number', 'null'], description: 'Optional assistant history limit (0-100)' },
3410
+ max_retries: { type: ['number', 'null'], description: 'Optional max retries (1-5)' }
3411
+ },
3412
+ required: ['flow_id']
3413
+ },
3414
+ annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
3415
+ },
3416
+ {
3417
+ name: 'agentic_assist_stream',
3418
+ description: 'Request streaming agentic assistance for building or editing a flow component.',
3419
+ inputSchema: {
3420
+ type: 'object',
3421
+ properties: {
3422
+ flow_id: { type: 'string', description: 'Flow ID' },
3423
+ input_value: { type: ['string', 'null'], description: 'User input/instruction (server-configured limit)' },
3424
+ iterations_limit: { type: ['number', 'null'], description: 'Maximum assistant iterations (1-200)' },
3425
+ max_retries: { type: ['number', 'null'], description: 'Maximum retries (1-5)' },
3426
+ session_id: { type: ['string', 'null'], description: 'Optional session ID' },
3427
+ component_id: { type: ['string', 'null'], description: 'Optional target component ID' },
3428
+ field_name: { type: ['string', 'null'], description: 'Optional target field name' },
3429
+ model_name: { type: ['string', 'null'], description: 'Optional model name' },
3430
+ provider: { type: ['string', 'null'], description: 'Optional provider' },
3431
+ history_limit: { type: ['number', 'null'], description: 'Optional assistant history limit (0-100)' }
3333
3432
  },
3334
3433
  required: ['flow_id']
3335
3434
  },
@@ -3349,13 +3448,15 @@ Related Tools:
3349
3448
  properties: {
3350
3449
  flow_name: { type: 'string', description: 'Agentic flow name to execute' },
3351
3450
  flow_id: { type: 'string', description: 'Flow ID' },
3352
- input_value: { type: 'string', description: 'User input/instruction' },
3353
- session_id: { type: 'string', description: 'Optional session ID' },
3354
- component_id: { type: 'string', description: 'Optional target component ID' },
3355
- field_name: { type: 'string', description: 'Optional target field name' },
3356
- model_name: { type: 'string', description: 'Optional model name' },
3357
- provider: { type: 'string', description: 'Optional provider' },
3358
- max_retries: { type: 'number', description: 'Optional max retries' }
3451
+ input_value: { type: ['string', 'null'], description: 'User input/instruction (server-configured limit)' },
3452
+ iterations_limit: { type: ['number', 'null'], description: 'Maximum assistant iterations (1-200)' },
3453
+ session_id: { type: ['string', 'null'], description: 'Optional session ID' },
3454
+ component_id: { type: ['string', 'null'], description: 'Optional target component ID' },
3455
+ field_name: { type: ['string', 'null'], description: 'Optional target field name' },
3456
+ model_name: { type: ['string', 'null'], description: 'Optional model name' },
3457
+ provider: { type: ['string', 'null'], description: 'Optional provider' },
3458
+ history_limit: { type: ['number', 'null'], description: 'Optional assistant history limit (0-100)' },
3459
+ max_retries: { type: ['number', 'null'], description: 'Optional max retries (1-5)' }
3359
3460
  },
3360
3461
  required: ['flow_name', 'flow_id']
3361
3462
  },
@@ -3374,15 +3475,27 @@ Related Tools:
3374
3475
  },
3375
3476
  {
3376
3477
  name: 'run_workflow',
3377
- description: 'Run a workflow (V2) for a flow with inputs. Supports streaming and background execution.',
3478
+ description: 'Run a Langflow 1.12.x v2 workflow with sync, stream, or background mode.',
3378
3479
  inputSchema: {
3379
3480
  type: 'object',
3380
3481
  properties: {
3381
3482
  flow_id: { type: 'string', description: 'Flow ID' },
3382
- inputs: { type: 'object', description: 'Workflow inputs' },
3383
- stream: { type: 'boolean', description: 'Stream the run' },
3384
- background: { type: 'boolean', description: 'Run in background' },
3385
- globals: { type: 'object', description: 'Request-level global variables (Langflow 1.10.0)' }
3483
+ input_value: { type: 'string', description: 'Chat-style input value' },
3484
+ mode: { type: 'string', enum: ['sync', 'stream', 'background'], description: 'Execution mode' },
3485
+ stream_protocol: { type: 'string', description: 'Streaming protocol, for example langflow or agui' },
3486
+ expose_graph_state: {
3487
+ type: ['boolean', 'null'],
3488
+ description: 'For streaming runs, include per-node graph events. Omitted or null uses the protocol default: false for AG-UI and true for Langflow. Ignored in sync mode.'
3489
+ },
3490
+ data: { type: ['object', 'null'], description: 'Optional live-canvas flow data override' },
3491
+ files: { type: ['array', 'null'], items: { type: 'string' }, description: 'Pre-uploaded file paths' },
3492
+ globals: { type: 'object', description: 'Request-level global variables' },
3493
+ idempotency_key: { type: ['string', 'null'], description: 'Deduplication key for background submits' },
3494
+ output_ids: { type: ['array', 'null'], items: { type: 'string' }, description: 'Output component IDs for sync mode' },
3495
+ session_id: { type: ['string', 'null'], description: 'Optional session ID' },
3496
+ start_component_id: { type: ['string', 'null'], description: 'Optional partial-run start component' },
3497
+ stop_component_id: { type: ['string', 'null'], description: 'Optional partial-run stop component' },
3498
+ tweaks: { type: 'object', description: 'Per-component parameter overrides' }
3386
3499
  },
3387
3500
  required: ['flow_id']
3388
3501
  },
@@ -3844,10 +3957,15 @@ Related Tools:
3844
3957
  type: 'object',
3845
3958
  properties: {
3846
3959
  user_id: { type: 'string', description: 'Filter by user ID' },
3960
+ actor_type: { type: 'string', enum: ['user', 'api_key', 'unknown', 'anonymous_public'], description: 'Filter by credential actor type; unknown also includes legacy rows without a type' },
3961
+ actor_id: { type: 'string', description: 'Filter by credential actor UUID' },
3847
3962
  resource_type: { type: 'string', description: 'Filter by resource type' },
3848
3963
  resource_id: { type: 'string', description: 'Filter by resource ID' },
3849
3964
  action: { type: 'string', description: 'Filter by audit action' },
3850
- result: { type: 'string', description: 'Filter by result outcome' },
3965
+ exclude_action: { type: 'array', items: { type: 'string' }, description: 'Exclude rows matching any of these action names' },
3966
+ result: { type: 'string', enum: ['allow', 'deny', 'owner_override', 'skip'], description: 'Filter by result outcome' },
3967
+ event: { type: 'array', items: { type: 'string' }, description: 'Include rows matching any of these details.event classes' },
3968
+ exclude_event: { type: 'array', items: { type: 'string' }, description: 'Exclude these details.event classes; legacy unclassified rows remain included' },
3851
3969
  since: { type: 'string', description: 'Start timestamp (ISO 8601)' },
3852
3970
  until: { type: 'string', description: 'End timestamp (ISO 8601)' },
3853
3971
  page: { type: 'number', description: 'Page number' },
@@ -3881,6 +3999,7 @@ Related Tools:
3881
3999
  flow_id: { type: 'string', description: 'Associated flow ID' },
3882
4000
  threshold: { type: 'number', description: 'Capture threshold' },
3883
4001
  auto_capture: { type: 'boolean', description: 'Automatically capture memories' },
4002
+ embedding_provider: { type: 'string', description: 'Embedding provider selected for the embedding model' },
3884
4003
  embedding_model: { type: 'string', description: 'Embedding model name' },
3885
4004
  preprocessing: { type: 'boolean', description: 'Enable preprocessing' },
3886
4005
  preproc_model: { type: 'string', description: 'Preprocessing model name' },
@@ -4181,7 +4300,7 @@ Related Tools:
4181
4300
  },
4182
4301
  {
4183
4302
  name: 'list_a2a_agents',
4184
- description: 'List available A2A (Agent-to-Agent) agents (Langflow 1.11.0). Requires server-side A2A enablement (LANGFLOW_A2A_ENABLED).',
4303
+ description: 'List available A2A (Agent-to-Agent) agents (Langflow 1.11.x). Requires server-side A2A enablement (LANGFLOW_A2A_ENABLED).',
4185
4304
  inputSchema: {
4186
4305
  type: 'object',
4187
4306
  properties: {}
@@ -4190,7 +4309,7 @@ Related Tools:
4190
4309
  },
4191
4310
  {
4192
4311
  name: 'get_a2a_agent_card',
4193
- description: 'Get the A2A agent card (.well-known/agent-card.json) for a flow (Langflow 1.11.0). Requires server-side A2A enablement.',
4312
+ description: 'Get the A2A agent card (.well-known/agent-card.json) for a flow (Langflow 1.11.x). Requires server-side A2A enablement.',
4194
4313
  inputSchema: {
4195
4314
  type: 'object',
4196
4315
  properties: {
@@ -4202,7 +4321,7 @@ Related Tools:
4202
4321
  },
4203
4322
  {
4204
4323
  name: 'invoke_a2a_jsonrpc',
4205
- description: 'Invoke a flow via the A2A JSON-RPC endpoint (Langflow 1.11.0). The JSON-RPC envelope is a passthrough; validation lives server-side.',
4324
+ description: 'Invoke a flow via the A2A JSON-RPC endpoint (Langflow 1.11.x). The JSON-RPC envelope is a passthrough; validation lives server-side.',
4206
4325
  inputSchema: {
4207
4326
  type: 'object',
4208
4327
  properties: {
@@ -4218,18 +4337,19 @@ Related Tools:
4218
4337
  },
4219
4338
  {
4220
4339
  name: 'list_pending_workflows',
4221
- description: 'List pending human-in-the-loop workflows awaiting a decision (Langflow 1.11.0). Optionally filter by flow_id.',
4340
+ description: 'List pending human-in-the-loop requests for a required flow ID (Langflow 1.11.x).',
4222
4341
  inputSchema: {
4223
4342
  type: 'object',
4224
4343
  properties: {
4225
- flow_id: { type: 'string', description: 'Optional flow ID filter' }
4226
- }
4344
+ flow_id: { type: 'string', description: 'Flow ID to list pending HITL requests for' }
4345
+ },
4346
+ required: ['flow_id']
4227
4347
  },
4228
4348
  annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
4229
4349
  },
4230
4350
  {
4231
4351
  name: 'get_workflow_events',
4232
- description: 'Re-attach to a workflow job event stream by job ID (Langflow 1.11.0). Streaming is not incrementally surfaced; the initial payload is returned.',
4352
+ description: 'Re-attach to a workflow job event stream by job ID (Langflow 1.11.x). Streaming is not incrementally surfaced; the initial payload is returned.',
4233
4353
  inputSchema: {
4234
4354
  type: 'object',
4235
4355
  properties: {
@@ -4241,31 +4361,204 @@ Related Tools:
4241
4361
  },
4242
4362
  {
4243
4363
  name: 'resume_workflow',
4244
- description: 'Resume a paused human-in-the-loop workflow with a decision payload (Langflow 1.11.0). The decision payload is a passthrough; validation lives server-side.',
4364
+ description: 'Resume a paused human-in-the-loop workflow with the pending request ID and optional decision (Langflow 1.11.x).',
4245
4365
  inputSchema: {
4246
4366
  type: 'object',
4247
4367
  properties: {
4248
4368
  job_id: { type: 'string', description: 'Workflow job ID' },
4249
- decision: { type: 'object', description: 'HITL decision payload' }
4369
+ request_id: { type: 'string', description: 'Pending HITL request ID' },
4370
+ decision: { type: ['object', 'null'], description: 'Optional HITL decision payload' }
4250
4371
  },
4251
- required: ['job_id', 'decision']
4372
+ required: ['job_id', 'request_id']
4252
4373
  },
4253
4374
  annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
4254
4375
  },
4255
4376
  {
4256
4377
  name: 'run_public_workflow',
4257
- description: 'Run a public (unauthenticated-eligible) workflow (Langflow 1.11.0). Stream-only execution; streaming is not incrementally surfaced.',
4378
+ description: 'Run a public (unauthenticated-eligible) workflow (Langflow 1.11.x). Stream-only execution; streaming is not incrementally surfaced.',
4258
4379
  inputSchema: {
4259
4380
  type: 'object',
4260
4381
  properties: {
4261
4382
  flow_id: { type: 'string', description: 'Flow ID' },
4262
- inputs: { type: 'object', description: 'Workflow inputs' },
4263
- globals: { type: 'object', description: 'Request-level global variables' },
4264
- stream: { type: 'boolean', description: 'Stream the run' }
4383
+ input_value: { type: 'string', description: 'Chat-style input value (max 65536 characters)' },
4384
+ mode: { type: 'string', enum: ['stream'], description: 'Always stream for public execution' },
4385
+ stream_protocol: { type: 'string', description: 'Streaming protocol, for example langflow or agui' },
4386
+ files: { type: ['array', 'null'], items: { type: 'string' }, description: 'Flow-scoped pre-uploaded file paths' },
4387
+ session_id: { type: ['string', 'null'], description: 'Optional caller session (max 256 characters)' },
4388
+ start_component_id: { type: ['string', 'null'], description: 'Optional partial-run start component' },
4389
+ stop_component_id: { type: ['string', 'null'], description: 'Optional partial-run stop component' }
4265
4390
  },
4266
4391
  required: ['flow_id']
4267
4392
  },
4268
4393
  annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
4394
+ },
4395
+ {
4396
+ name: 'get_healthz',
4397
+ description: 'Get the Langflow Kubernetes-style readiness report from /healthz (Langflow 1.12.x).',
4398
+ inputSchema: { type: 'object', properties: {} },
4399
+ annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
4400
+ },
4401
+ {
4402
+ name: 'list_model_provider_descriptors',
4403
+ description: 'List policy-visible model providers with stable IDs and display names (Langflow 1.12.x).',
4404
+ inputSchema: {
4405
+ type: 'object',
4406
+ properties: {
4407
+ purpose: { type: 'string', enum: ['use', 'configure'], description: 'Optional provider visibility purpose' }
4408
+ }
4409
+ },
4410
+ annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
4411
+ },
4412
+ {
4413
+ name: 'get_model_provider_policy',
4414
+ description: 'Read the install-wide approved model-provider policy (superuser-only Langflow 1.12.x API).',
4415
+ inputSchema: { type: 'object', properties: {} },
4416
+ annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
4417
+ },
4418
+ {
4419
+ name: 'replace_model_provider_policy',
4420
+ description: 'Replace the install-wide approved model-provider policy (superuser-only Langflow 1.12.x API).',
4421
+ inputSchema: {
4422
+ type: 'object',
4423
+ properties: {
4424
+ approved_provider_ids: { type: 'array', items: { type: 'string' }, description: 'Complete approved provider ID set' }
4425
+ },
4426
+ required: ['approved_provider_ids']
4427
+ },
4428
+ annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }
4429
+ },
4430
+ {
4431
+ name: 'get_catalog_component_policy',
4432
+ description: 'Read the global blocked-component catalog policy (superuser-only Langflow 1.12.x API).',
4433
+ inputSchema: { type: 'object', properties: {} },
4434
+ annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
4435
+ },
4436
+ {
4437
+ name: 'replace_catalog_component_policy',
4438
+ description: 'Replace the global blocked-component catalog policy (superuser-only Langflow 1.12.x API).',
4439
+ inputSchema: {
4440
+ type: 'object',
4441
+ properties: { blocked: { type: 'array', items: { type: 'string' }, description: 'Complete blocked component key set' } },
4442
+ required: ['blocked']
4443
+ },
4444
+ annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }
4445
+ },
4446
+ {
4447
+ name: 'get_catalog_template_policy',
4448
+ description: 'Read the global blocked-template catalog policy (superuser-only Langflow 1.12.x API).',
4449
+ inputSchema: { type: 'object', properties: {} },
4450
+ annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
4451
+ },
4452
+ {
4453
+ name: 'replace_catalog_template_policy',
4454
+ description: 'Replace the global blocked-template catalog policy (superuser-only Langflow 1.12.x API).',
4455
+ inputSchema: {
4456
+ type: 'object',
4457
+ properties: { blocked: { type: 'array', items: { type: 'string' }, description: 'Complete blocked template key set' } },
4458
+ required: ['blocked']
4459
+ },
4460
+ annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }
4461
+ },
4462
+ {
4463
+ name: 'get_catalog_policy_usage',
4464
+ description: 'Count flows using each catalog component (superuser-only Langflow 1.12.x API).',
4465
+ inputSchema: { type: 'object', properties: {} },
4466
+ annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
4467
+ },
4468
+ {
4469
+ name: 'get_catalog_policy_usage_flows',
4470
+ description: 'List flows affected by blocking a catalog component key (superuser-only Langflow 1.12.x API).',
4471
+ inputSchema: {
4472
+ type: 'object',
4473
+ properties: {
4474
+ component: { type: 'string', description: 'Component key to look up' },
4475
+ limit: { type: 'number', description: 'Maximum number of flows, 1-500' }
4476
+ },
4477
+ required: ['component']
4478
+ },
4479
+ annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
4480
+ },
4481
+ {
4482
+ name: 'get_policy_bundle',
4483
+ description: 'Read the atomic provider-and-catalog policy bundle (superuser-only Langflow 1.12.x API).',
4484
+ inputSchema: { type: 'object', properties: {} },
4485
+ annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
4486
+ },
4487
+ {
4488
+ name: 'replace_policy_bundle',
4489
+ description: 'Atomically replace the provider-and-catalog policy bundle using an expected revision (Langflow 1.12.x).',
4490
+ inputSchema: {
4491
+ type: 'object',
4492
+ properties: {
4493
+ expected_revision: { type: 'number', description: 'Revision read before the replacement' },
4494
+ approved_provider_ids: { type: 'array', items: { type: 'string' } },
4495
+ blocked_component_keys: { type: 'array', items: { type: 'string' } },
4496
+ blocked_template_keys: { type: 'array', items: { type: 'string' } },
4497
+ blocked_model_keys: { type: 'array', items: { type: 'string' } },
4498
+ reason: { type: ['string', 'null'], description: 'Optional change reason, max 1024 characters' }
4499
+ },
4500
+ required: ['expected_revision', 'approved_provider_ids', 'blocked_component_keys', 'blocked_template_keys']
4501
+ },
4502
+ annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }
4503
+ },
4504
+ {
4505
+ name: 'list_policy_bundle_history',
4506
+ description: 'List historical policy bundle revisions (superuser-only Langflow 1.12.x API).',
4507
+ inputSchema: {
4508
+ type: 'object',
4509
+ properties: {
4510
+ limit: { type: 'number', description: 'Number of revisions, 1-200' },
4511
+ before_revision: { type: ['number', 'null'], description: 'Return revisions before this number' }
4512
+ }
4513
+ },
4514
+ annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
4515
+ },
4516
+ {
4517
+ name: 'rollback_policy_bundle',
4518
+ description: 'Roll back the policy bundle to a prior revision with optimistic concurrency protection (Langflow 1.12.x).',
4519
+ inputSchema: {
4520
+ type: 'object',
4521
+ properties: {
4522
+ revision: { type: 'number', description: 'Target revision' },
4523
+ expected_revision: { type: 'number', description: 'Current revision required for the rollback' },
4524
+ reason: { type: ['string', 'null'], description: 'Optional rollback reason, max 1024 characters' }
4525
+ },
4526
+ required: ['revision', 'expected_revision']
4527
+ },
4528
+ annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true }
4529
+ },
4530
+ {
4531
+ name: 'upsert_project',
4532
+ description: 'Create or update a project at a caller-supplied ID using Langflow 1.12.x PUT upsert semantics.',
4533
+ inputSchema: {
4534
+ type: 'object',
4535
+ properties: {
4536
+ project_id: { type: 'string', description: 'Project UUID' },
4537
+ name: { type: 'string', description: 'Project name' },
4538
+ description: { type: ['string', 'null'], description: 'Project description' },
4539
+ auth_settings: { type: ['object', 'null'], description: 'Project authentication settings' },
4540
+ components_list: { type: ['array', 'null'], items: { type: 'string' } },
4541
+ flows_list: { type: ['array', 'null'], items: { type: 'string' } }
4542
+ },
4543
+ required: ['project_id', 'name']
4544
+ },
4545
+ annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }
4546
+ },
4547
+ {
4548
+ name: 'agentic_assist_run',
4549
+ description: 'Run the Langflow agentic assistant headlessly and persist its flow changes (Langflow 1.12.x SSE API).',
4550
+ inputSchema: {
4551
+ type: 'object',
4552
+ properties: {
4553
+ instruction: { type: 'string', description: 'Assistant instruction' },
4554
+ flow_id: { type: ['string', 'null'], description: 'Optional existing flow ID' },
4555
+ provider: { type: ['string', 'null'], description: 'Optional model provider' },
4556
+ model_name: { type: ['string', 'null'], description: 'Optional model name' },
4557
+ session_id: { type: ['string', 'null'], description: 'Optional assistant session ID' }
4558
+ },
4559
+ required: ['instruction']
4560
+ },
4561
+ annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true }
4269
4562
  }
4270
4563
  ];
4271
4564
  //# sourceMappingURL=tools.js.map