You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
"Optional path prefix to scope the search (e.g. 'workflows/', 'environment/', 'internal/', 'components/blocks/').",
2088
+
"Optional scope. A prefix (e.g. 'workflows/', 'environment/', 'internal/') searches the VFS map under it. An exact single-file path under files/ or uploads/ (optionally with /content) searches that file's content only; folders and multi-file trees are rejected for content search.",
2089
+
},
2090
+
pattern: {
2091
+
type: 'string',
2092
+
description:
2093
+
"Regex pattern to search for. Searches VFS map entries (workflow JSON, metadata, plans, memories) by default; searches a single file's extracted text when path is one files/ or uploads/ file leaf.",
2071
2094
},
2072
-
pattern: {type: 'string',description: 'Regex pattern to search for in file contents.'},
"Workspace ID. Required for 'create' when there is no workspace in context (otherwise the current workspace context is used); optional filter for 'list'.",
2271
+
"Workspace ID. Required for 'create' when there is no workspace in context; otherwise the current workspace context is used.",
'The names of the uploaded files to materialize (e.g. ["report.pdf", "data.csv"])',
2660
2682
items: {type: 'string'},
2661
2683
},
2662
-
knowledgeBaseId: {
2663
-
type: 'string',
2664
-
description:
2665
-
'ID of an existing knowledge base to add the file to (only used with operation "knowledge_base"). If omitted, a new KB is created.',
2666
-
},
2667
2684
operation: {
2668
2685
type: 'string',
2669
2686
description:
2670
-
'What to do with the file. "save" promotes it to files/. "import" imports a workflow JSON. "table" converts CSV/TSV/JSON to a table. "knowledge_base" saves and adds to a KB. Defaults to "save".',
2671
-
enum: ['save','import','table','knowledge_base'],
2687
+
'What to do with the file. "save" promotes it to a permanent files/ path. "import" imports a workflow JSON as a workspace workflow. Defaults to "save".',
2688
+
enum: ['save','import'],
2672
2689
default: 'save',
2673
2690
},
2674
-
tableName: {
2675
-
type: 'string',
2676
-
description:
2677
-
'Custom name for the table (only used with operation "table"). Defaults to the file name without extension.',
id: {type: 'string',description: 'Canonical resource ID for non-file resources.'},
2838
2850
path: {
2839
2851
type: 'string',
2840
-
description: 'Canonical VFS path for type "file", e.g. "files/Reports/report.pdf".',
2852
+
description:
2853
+
'Encoded VFS path for type "file" (percent-encoded per segment, e.g. "files/Reports/Q4%20Report.pdf"). Copy it verbatim from glob/read/workspace context output — do not decode it to a display name or re-encode it.',
"Path to the file to read (e.g. 'workflows/My%20Workflow/state.json' or 'workflows/Projects/Q1/My%20Workflow/state.json').",
3016
+
"Path to the VFS resource to read (e.g. 'workflows/My%20Workflow/state.json', 'files/Q4%20Report.pdf/content' for file bytes/parsed text, or 'uploads/data.csv' for a chat upload). Copy paths verbatim from glob/grep/read output.",
'Reuse the recorded input from a past execution of this workflow (from query_logs) instead of supplying workflow_input — handy for replaying a run without retyping inputs. The reused input is re-validated against the trigger. Mutually exclusive with workflow_input and useMockPayload.',
3315
+
},
3298
3316
triggerBlockId: {
3299
3317
type: 'string',
3300
3318
description:
3301
-
'Optional trigger block ID when the workflow has multiple entrypoints and you need to target a specific one.',
3319
+
'Trigger block ID to run from (from get_workflow_run_options). Required when the workflow has multiple entrypoints.',
3302
3320
},
3303
3321
useDeployedState: {
3304
3322
type: 'boolean',
3305
3323
description:
3306
3324
'When true, runs the deployed version instead of the live draft. Default: false (draft).',
3307
3325
},
3326
+
useMockPayload: {
3327
+
type: 'boolean',
3328
+
description:
3329
+
"When true, run with the trigger's generated mock payload instead of workflow_input. Prefer building your own workflow_input; use this only when you can't.",
3330
+
},
3308
3331
workflowId: {
3309
3332
type: 'string',
3310
3333
description:
3311
3334
'Optional workflow ID to run. If not provided, uses the current workflow in context.',
3312
3335
},
3313
3336
workflow_input: {
3314
3337
type: 'object',
3315
-
description: 'JSON object with key-value mappings where each key is an input field name',
3338
+
description:
3339
+
"JSON object matching the target trigger's inputSchema (from get_workflow_run_options). For external/webhook triggers this is the event payload; for API/Input triggers it is the form fields.",
'Reuse the recorded input from a past execution of this workflow (from query_logs) instead of supplying workflow_input. The reused input is re-validated against the trigger. Mutually exclusive with workflow_input and useMockPayload.',
3359
+
},
3331
3360
stopAfterBlockId: {
3332
3361
type: 'string',
3333
3362
description: 'The block ID to stop after. Execution halts once this block completes.',
3334
3363
},
3335
3364
triggerBlockId: {
3336
3365
type: 'string',
3337
3366
description:
3338
-
'Optional trigger block ID when the workflow has multiple entrypoints and you need to target a specific one.',
3367
+
'Trigger block ID to run from (from get_workflow_run_options). Required when the workflow has multiple entrypoints.',
3339
3368
},
3340
3369
useDeployedState: {
3341
3370
type: 'boolean',
3342
3371
description:
3343
3372
'When true, runs the deployed version instead of the live draft. Default: false (draft).',
3344
3373
},
3374
+
useMockPayload: {
3375
+
type: 'boolean',
3376
+
description:
3377
+
"When true, run with the trigger's generated mock payload instead of workflow_input. Prefer building your own workflow_input; use this only when you can't.",
3378
+
},
3345
3379
workflowId: {
3346
3380
type: 'string',
3347
3381
description:
3348
3382
'Optional workflow ID to run. If not provided, uses the current workflow in context.',
3349
3383
},
3350
3384
workflow_input: {
3351
3385
type: 'object',
3352
-
description: 'JSON object with key-value mappings where each key is an input field name',
3386
+
description:
3387
+
"JSON object matching the target trigger's inputSchema (from get_workflow_run_options). For external/webhook triggers this is the event payload; for API/Input triggers it is the form fields.",
"Optional path prefix to scope the search (e.g. 'workflows/', 'environment/', 'internal/', 'components/blocks/').",
1875
+
"Optional scope. A prefix (e.g. 'workflows/', 'environment/', 'internal/') searches the VFS map under it. An exact single-file path under files/ or uploads/ (optionally with /content) searches that file's content only; folders and multi-file trees are rejected for content search.",
1863
1876
},
1864
1877
pattern: {
1865
1878
type: 'string',
1866
-
description: 'Regex pattern to search for in file contents.',
1879
+
description:
1880
+
"Regex pattern to search for. Searches VFS map entries (workflow JSON, metadata, plans, memories) by default; searches a single file's extracted text when path is one files/ or uploads/ file leaf.",
"Workspace ID. Required for 'create' when there is no workspace in context (otherwise the current workspace context is used); optional filter for 'list'.",
2062
+
"Workspace ID. Required for 'create' when there is no workspace in context; otherwise the current workspace context is used.",
'ID of an existing knowledge base to add the file to (only used with operation "knowledge_base"). If omitted, a new KB is created.',
2462
-
},
2463
2472
operation: {
2464
2473
type: 'string',
2465
2474
description:
2466
-
'What to do with the file. "save" promotes it to files/. "import" imports a workflow JSON. "table" converts CSV/TSV/JSON to a table. "knowledge_base" saves and adds to a KB. Defaults to "save".',
2467
-
enum: ['save','import','table','knowledge_base'],
2475
+
'What to do with the file. "save" promotes it to a permanent files/ path. "import" imports a workflow JSON as a workspace workflow. Defaults to "save".',
2476
+
enum: ['save','import'],
2468
2477
default: 'save',
2469
2478
},
2470
-
tableName: {
2471
-
type: 'string',
2472
-
description:
2473
-
'Custom name for the table (only used with operation "table"). Defaults to the file name without extension.',
description: 'Canonical VFS path for type "file", e.g. "files/Reports/report.pdf".',
2612
+
description:
2613
+
'Encoded VFS path for type "file" (percent-encoded per segment, e.g. "files/Reports/Q4%20Report.pdf"). Copy it verbatim from glob/read/workspace context output — do not decode it to a display name or re-encode it.',
"Path to the file to read (e.g. 'workflows/My%20Workflow/state.json' or 'workflows/Projects/Q1/My%20Workflow/state.json').",
2779
+
"Path to the VFS resource to read (e.g. 'workflows/My%20Workflow/state.json', 'files/Q4%20Report.pdf/content' for file bytes/parsed text, or 'uploads/data.csv' for a chat upload). Copy paths verbatim from glob/grep/read output.",
'Reuse the recorded input from a past execution of this workflow (from query_logs) instead of supplying workflow_input — handy for replaying a run without retyping inputs. The reused input is re-validated against the trigger. Mutually exclusive with workflow_input and useMockPayload.',
3067
+
},
3058
3068
triggerBlockId: {
3059
3069
type: 'string',
3060
3070
description:
3061
-
'Optional trigger block ID when the workflow has multiple entrypoints and you need to target a specific one.',
3071
+
'Trigger block ID to run from (from get_workflow_run_options). Required when the workflow has multiple entrypoints.',
3062
3072
},
3063
3073
useDeployedState: {
3064
3074
type: 'boolean',
3065
3075
description:
3066
3076
'When true, runs the deployed version instead of the live draft. Default: false (draft).',
3067
3077
},
3078
+
useMockPayload: {
3079
+
type: 'boolean',
3080
+
description:
3081
+
"When true, run with the trigger's generated mock payload instead of workflow_input. Prefer building your own workflow_input; use this only when you can't.",
3082
+
},
3068
3083
workflowId: {
3069
3084
type: 'string',
3070
3085
description:
3071
3086
'Optional workflow ID to run. If not provided, uses the current workflow in context.',
3072
3087
},
3073
3088
workflow_input: {
3074
3089
type: 'object',
3075
-
description: 'JSON object with key-value mappings where each key is an input field name',
3090
+
description:
3091
+
"JSON object matching the target trigger's inputSchema (from get_workflow_run_options). For external/webhook triggers this is the event payload; for API/Input triggers it is the form fields.",
'Reuse the recorded input from a past execution of this workflow (from query_logs) instead of supplying workflow_input. The reused input is re-validated against the trigger. Mutually exclusive with workflow_input and useMockPayload.',
3105
+
},
3085
3106
stopAfterBlockId: {
3086
3107
type: 'string',
3087
3108
description: 'The block ID to stop after. Execution halts once this block completes.',
3088
3109
},
3089
3110
triggerBlockId: {
3090
3111
type: 'string',
3091
3112
description:
3092
-
'Optional trigger block ID when the workflow has multiple entrypoints and you need to target a specific one.',
3113
+
'Trigger block ID to run from (from get_workflow_run_options). Required when the workflow has multiple entrypoints.',
3093
3114
},
3094
3115
useDeployedState: {
3095
3116
type: 'boolean',
3096
3117
description:
3097
3118
'When true, runs the deployed version instead of the live draft. Default: false (draft).',
3098
3119
},
3120
+
useMockPayload: {
3121
+
type: 'boolean',
3122
+
description:
3123
+
"When true, run with the trigger's generated mock payload instead of workflow_input. Prefer building your own workflow_input; use this only when you can't.",
3124
+
},
3099
3125
workflowId: {
3100
3126
type: 'string',
3101
3127
description:
3102
3128
'Optional workflow ID to run. If not provided, uses the current workflow in context.',
3103
3129
},
3104
3130
workflow_input: {
3105
3131
type: 'object',
3106
-
description: 'JSON object with key-value mappings where each key is an input field name',
3132
+
description:
3133
+
"JSON object matching the target trigger's inputSchema (from get_workflow_run_options). For external/webhook triggers this is the event payload; for API/Input triggers it is the form fields.",
0 commit comments