@walkeros/cli 4.1.0 → 4.1.1-next-1779485810490

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/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { Flow, Elb, WalkerOS } from '@walkeros/core';
1
+ import { Flow, Elb, WalkerOS, Simulation } from '@walkeros/core';
2
2
  export { Flow } from '@walkeros/core';
3
3
  import { BuildOptions as BuildOptions$1 } from 'esbuild';
4
4
  import { z } from '@walkeros/core/dev';
@@ -330,23 +330,8 @@ interface PushCommandOptions {
330
330
  interface PushResult {
331
331
  success: boolean;
332
332
  elbResult?: Elb.PushResult;
333
- captured?: Array<{
334
- event: unknown;
335
- timestamp: number;
336
- }>;
337
- /** Tracked destination API calls keyed by destination ID */
338
- usage?: Record<string, Array<{
339
- fn: string;
340
- args: unknown[];
341
- ts: number;
342
- }>>;
343
333
  /** Network calls captured during web simulation (fetch + sendBeacon) */
344
334
  networkCalls?: NetworkCall[];
345
- /**
346
- * Per-destination simulation results when --simulate destination.* is
347
- * called with multiple ids. Undefined for single-target or non-simulate runs.
348
- */
349
- perDestination?: Record<string, PushResult>;
350
335
  duration: number;
351
336
  error?: string;
352
337
  }
@@ -424,7 +409,7 @@ interface SimulateSourceOptions {
424
409
  * The `input` parameter is `unknown` — the CLI is agnostic to source-specific
425
410
  * content shapes. The source's createTrigger defines what it expects.
426
411
  */
427
- declare function simulateSource(configOrPath: string | Flow.Json, input: unknown, options: SimulateSourceOptions): Promise<PushResult>;
412
+ declare function simulateSource(configOrPath: string | Flow.Json, input: unknown, options: SimulateSourceOptions): Promise<Simulation.Result>;
428
413
  interface SimulateTransformerOptions {
429
414
  transformerId: string;
430
415
  bundlePath?: string;
@@ -444,7 +429,7 @@ interface SimulateTransformerOptions {
444
429
  * Captured array: first entry = input event, subsequent entries = output event(s).
445
430
  * If the transformer drops the event (returns false), output event is null.
446
431
  */
447
- declare function simulateTransformer(configOrPath: string | Flow.Json, event: WalkerOS.DeepPartialEvent, options: SimulateTransformerOptions): Promise<PushResult>;
432
+ declare function simulateTransformer(configOrPath: string | Flow.Json, event: WalkerOS.DeepPartialEvent, options: SimulateTransformerOptions): Promise<Simulation.Result>;
448
433
  interface SimulateDestinationOptions {
449
434
  destinationId: string;
450
435
  bundlePath?: string;
@@ -463,7 +448,7 @@ interface SimulateDestinationOptions {
463
448
  * pipeline support — consent checks, event mapping, createEvent enrichment,
464
449
  * before chains — without manual wiring.
465
450
  */
466
- declare function simulateDestination(configOrPath: string | Flow.Json, event: WalkerOS.DeepPartialEvent, options: SimulateDestinationOptions): Promise<PushResult>;
451
+ declare function simulateDestination(configOrPath: string | Flow.Json, event: WalkerOS.DeepPartialEvent, options: SimulateDestinationOptions): Promise<Simulation.Result>;
467
452
 
468
453
  /**
469
454
  * Run Command Types
@@ -684,15 +669,23 @@ interface WhoamiCommandOptions extends GlobalOptions {
684
669
  }
685
670
  declare function whoamiCommand(options: WhoamiCommandOptions): Promise<void>;
686
671
 
687
- declare function listProjects(): Promise<{
672
+ interface ListProjectsOptions {
673
+ cursor?: string;
674
+ limit?: number;
675
+ }
676
+ declare function listProjects(options?: ListProjectsOptions): Promise<{
688
677
  projects: {
689
678
  id: string;
690
679
  name: string;
691
680
  role: "owner" | "admin" | "member" | "deployer" | "viewer";
692
681
  createdAt: string;
693
682
  updatedAt: string;
683
+ memberCount: number;
684
+ flowCount: number;
685
+ deploymentCount: number;
694
686
  }[];
695
687
  total: number;
688
+ nextCursor: string | null;
696
689
  }>;
697
690
  declare function getProject(options?: {
698
691
  projectId?: string;
@@ -702,6 +695,9 @@ declare function getProject(options?: {
702
695
  role: "owner" | "admin" | "member" | "deployer" | "viewer";
703
696
  createdAt: string;
704
697
  updatedAt: string;
698
+ memberCount: number;
699
+ flowCount: number;
700
+ deploymentCount: number;
705
701
  }>;
706
702
  declare function createProject(options: {
707
703
  name: string;
@@ -719,6 +715,9 @@ declare function updateProject(options: {
719
715
  role: "owner" | "admin" | "member" | "deployer" | "viewer";
720
716
  createdAt: string;
721
717
  updatedAt: string;
718
+ memberCount: number;
719
+ flowCount: number;
720
+ deploymentCount: number;
722
721
  }>;
723
722
  declare function deleteProject(options?: {
724
723
  projectId?: string;
@@ -1201,7 +1200,10 @@ interface paths {
1201
1200
  */
1202
1201
  get: {
1203
1202
  parameters: {
1204
- query?: never;
1203
+ query?: {
1204
+ cursor?: string;
1205
+ limit?: number;
1206
+ };
1205
1207
  header?: never;
1206
1208
  path?: never;
1207
1209
  cookie?: never;
@@ -1738,6 +1740,8 @@ interface paths {
1738
1740
  sort?: 'name' | 'updated_at' | 'created_at';
1739
1741
  order?: 'asc' | 'desc';
1740
1742
  include_deleted?: 'true' | 'false';
1743
+ cursor?: string;
1744
+ limit?: number;
1741
1745
  };
1742
1746
  header?: never;
1743
1747
  path: {
@@ -1863,7 +1867,7 @@ interface paths {
1863
1867
  get: {
1864
1868
  parameters: {
1865
1869
  query?: {
1866
- /** @description Comma-separated dot-paths to select specific fields (e.g., "config.variables,config.flows.web.sources"). Always includes id, createdAt, updatedAt. */
1870
+ /** @description Comma-separated dot-paths to select specific fields (e.g., "config.variables,config.flows.tracking.sources"). Always includes id, createdAt, updatedAt. */
1867
1871
  fields?: string;
1868
1872
  };
1869
1873
  header?: never;
@@ -2604,7 +2608,7 @@ interface paths {
2604
2608
  };
2605
2609
  /**
2606
2610
  * Download settings JSON
2607
- * @description Download the named flow settings as a self-contained Config JSON file. Includes parent variables.
2611
+ * @description Download the named flow settings as a self-contained Config JSON file. Includes parent variables and definitions.
2608
2612
  */
2609
2613
  get: {
2610
2614
  parameters: {
@@ -2981,6 +2985,263 @@ interface paths {
2981
2985
  patch?: never;
2982
2986
  trace?: never;
2983
2987
  };
2988
+ '/api/projects/{projectId}/flows/{flowId}/previews': {
2989
+ parameters: {
2990
+ query?: never;
2991
+ header?: never;
2992
+ path?: never;
2993
+ cookie?: never;
2994
+ };
2995
+ /**
2996
+ * List previews
2997
+ * @description List all previews for a flow, ordered by creation date descending.
2998
+ */
2999
+ get: {
3000
+ parameters: {
3001
+ query?: never;
3002
+ header?: never;
3003
+ path: {
3004
+ projectId: string;
3005
+ flowId: string;
3006
+ };
3007
+ cookie?: never;
3008
+ };
3009
+ requestBody?: never;
3010
+ responses: {
3011
+ /** @description List of previews */
3012
+ 200: {
3013
+ headers: {
3014
+ [name: string]: unknown;
3015
+ };
3016
+ content: {
3017
+ 'application/json': components['schemas']['ListPreviewsResponse'];
3018
+ };
3019
+ };
3020
+ /** @description Unauthorized */
3021
+ 401: {
3022
+ headers: {
3023
+ [name: string]: unknown;
3024
+ };
3025
+ content: {
3026
+ 'application/json': components['schemas']['ErrorResponse'];
3027
+ };
3028
+ };
3029
+ /** @description Not found */
3030
+ 404: {
3031
+ headers: {
3032
+ [name: string]: unknown;
3033
+ };
3034
+ content: {
3035
+ 'application/json': components['schemas']['ErrorResponse'];
3036
+ };
3037
+ };
3038
+ };
3039
+ };
3040
+ put?: never;
3041
+ /**
3042
+ * Create preview
3043
+ * @description Create a new preview for a web flow settings entry. Bundles the flow and publishes to a unique token-based URL.
3044
+ */
3045
+ post: {
3046
+ parameters: {
3047
+ query?: never;
3048
+ header?: never;
3049
+ path: {
3050
+ projectId: string;
3051
+ flowId: string;
3052
+ };
3053
+ cookie?: never;
3054
+ };
3055
+ requestBody?: {
3056
+ content: {
3057
+ 'application/json': components['schemas']['CreatePreviewRequest'];
3058
+ };
3059
+ };
3060
+ responses: {
3061
+ /** @description Preview created */
3062
+ 201: {
3063
+ headers: {
3064
+ [name: string]: unknown;
3065
+ };
3066
+ content: {
3067
+ 'application/json': components['schemas']['PreviewResponse'];
3068
+ };
3069
+ };
3070
+ /** @description Validation error */
3071
+ 400: {
3072
+ headers: {
3073
+ [name: string]: unknown;
3074
+ };
3075
+ content: {
3076
+ 'application/json': components['schemas']['ErrorResponse'];
3077
+ };
3078
+ };
3079
+ /** @description Unauthorized */
3080
+ 401: {
3081
+ headers: {
3082
+ [name: string]: unknown;
3083
+ };
3084
+ content: {
3085
+ 'application/json': components['schemas']['ErrorResponse'];
3086
+ };
3087
+ };
3088
+ /** @description Forbidden */
3089
+ 403: {
3090
+ headers: {
3091
+ [name: string]: unknown;
3092
+ };
3093
+ content: {
3094
+ 'application/json': components['schemas']['ErrorResponse'];
3095
+ };
3096
+ };
3097
+ /** @description Not found */
3098
+ 404: {
3099
+ headers: {
3100
+ [name: string]: unknown;
3101
+ };
3102
+ content: {
3103
+ 'application/json': components['schemas']['ErrorResponse'];
3104
+ };
3105
+ };
3106
+ /** @description Quota exceeded */
3107
+ 429: {
3108
+ headers: {
3109
+ [name: string]: unknown;
3110
+ };
3111
+ content: {
3112
+ 'application/json': components['schemas']['ErrorResponse'];
3113
+ };
3114
+ };
3115
+ /** @description Bundle or upload failed */
3116
+ 502: {
3117
+ headers: {
3118
+ [name: string]: unknown;
3119
+ };
3120
+ content: {
3121
+ 'application/json': components['schemas']['ErrorResponse'];
3122
+ };
3123
+ };
3124
+ };
3125
+ };
3126
+ delete?: never;
3127
+ options?: never;
3128
+ head?: never;
3129
+ patch?: never;
3130
+ trace?: never;
3131
+ };
3132
+ '/api/projects/{projectId}/flows/{flowId}/previews/{previewId}': {
3133
+ parameters: {
3134
+ query?: never;
3135
+ header?: never;
3136
+ path?: never;
3137
+ cookie?: never;
3138
+ };
3139
+ /**
3140
+ * Get preview
3141
+ * @description Get a single preview by ID.
3142
+ */
3143
+ get: {
3144
+ parameters: {
3145
+ query?: never;
3146
+ header?: never;
3147
+ path: {
3148
+ projectId: string;
3149
+ flowId: string;
3150
+ previewId: string;
3151
+ };
3152
+ cookie?: never;
3153
+ };
3154
+ requestBody?: never;
3155
+ responses: {
3156
+ /** @description Preview details */
3157
+ 200: {
3158
+ headers: {
3159
+ [name: string]: unknown;
3160
+ };
3161
+ content: {
3162
+ 'application/json': components['schemas']['PreviewResponse'];
3163
+ };
3164
+ };
3165
+ /** @description Unauthorized */
3166
+ 401: {
3167
+ headers: {
3168
+ [name: string]: unknown;
3169
+ };
3170
+ content: {
3171
+ 'application/json': components['schemas']['ErrorResponse'];
3172
+ };
3173
+ };
3174
+ /** @description Not found */
3175
+ 404: {
3176
+ headers: {
3177
+ [name: string]: unknown;
3178
+ };
3179
+ content: {
3180
+ 'application/json': components['schemas']['ErrorResponse'];
3181
+ };
3182
+ };
3183
+ };
3184
+ };
3185
+ put?: never;
3186
+ post?: never;
3187
+ /**
3188
+ * Delete preview
3189
+ * @description Delete a preview and its S3 bundle. Requires member role.
3190
+ */
3191
+ delete: {
3192
+ parameters: {
3193
+ query?: never;
3194
+ header?: never;
3195
+ path: {
3196
+ projectId: string;
3197
+ flowId: string;
3198
+ previewId: string;
3199
+ };
3200
+ cookie?: never;
3201
+ };
3202
+ requestBody?: never;
3203
+ responses: {
3204
+ /** @description Preview deleted */
3205
+ 204: {
3206
+ headers: {
3207
+ [name: string]: unknown;
3208
+ };
3209
+ content?: never;
3210
+ };
3211
+ /** @description Unauthorized */
3212
+ 401: {
3213
+ headers: {
3214
+ [name: string]: unknown;
3215
+ };
3216
+ content: {
3217
+ 'application/json': components['schemas']['ErrorResponse'];
3218
+ };
3219
+ };
3220
+ /** @description Forbidden */
3221
+ 403: {
3222
+ headers: {
3223
+ [name: string]: unknown;
3224
+ };
3225
+ content: {
3226
+ 'application/json': components['schemas']['ErrorResponse'];
3227
+ };
3228
+ };
3229
+ /** @description Not found */
3230
+ 404: {
3231
+ headers: {
3232
+ [name: string]: unknown;
3233
+ };
3234
+ content: {
3235
+ 'application/json': components['schemas']['ErrorResponse'];
3236
+ };
3237
+ };
3238
+ };
3239
+ };
3240
+ options?: never;
3241
+ head?: never;
3242
+ patch?: never;
3243
+ trace?: never;
3244
+ };
2984
3245
  '/api/projects/{projectId}/flows/{flowId}/versions': {
2985
3246
  parameters: {
2986
3247
  query?: never;
@@ -3332,14 +3593,16 @@ interface paths {
3332
3593
  get?: never;
3333
3594
  put?: never;
3334
3595
  /**
3335
- * Trigger flow bundle
3336
- * @description Start a bundle job for a project flow. For multi-settings flows, specify the named flow via ?flow= query parameter.
3596
+ * Bundle flow
3597
+ * @description Bundle a flow using CLI. Returns bundleId (content-hash). Use ?output=download to redirect to presigned S3 URL.
3337
3598
  */
3338
3599
  post: {
3339
3600
  parameters: {
3340
3601
  query?: {
3341
3602
  /** @description Named flow to bundle (required for multi-settings flows) */
3342
3603
  flow?: string;
3604
+ /** @description Set to "download" to redirect to the bundle file */
3605
+ output?: 'download';
3343
3606
  };
3344
3607
  header?: never;
3345
3608
  path: {
@@ -3350,35 +3613,24 @@ interface paths {
3350
3613
  };
3351
3614
  requestBody?: never;
3352
3615
  responses: {
3353
- /** @description Bundle job started */
3616
+ /** @description Bundle result */
3354
3617
  200: {
3355
3618
  headers: {
3356
3619
  [name: string]: unknown;
3357
3620
  };
3358
3621
  content: {
3359
- 'application/json': components['schemas']['BundleJobResponse'];
3360
- };
3361
- };
3362
- /** @description Unauthorized */
3363
- 401: {
3364
- headers: {
3365
- [name: string]: unknown;
3366
- };
3367
- content: {
3368
- 'application/json': components['schemas']['ErrorResponse'];
3622
+ 'application/json': components['schemas']['BundleResponse'];
3369
3623
  };
3370
3624
  };
3371
- /** @description Not found */
3372
- 404: {
3625
+ /** @description Redirect to presigned bundle URL (when output=download) */
3626
+ 302: {
3373
3627
  headers: {
3374
3628
  [name: string]: unknown;
3375
3629
  };
3376
- content: {
3377
- 'application/json': components['schemas']['ErrorResponse'];
3378
- };
3630
+ content?: never;
3379
3631
  };
3380
- /** @description Flow selection required for multi-settings flows */
3381
- 422: {
3632
+ /** @description Unauthorized */
3633
+ 401: {
3382
3634
  headers: {
3383
3635
  [name: string]: unknown;
3384
3636
  };
@@ -3386,8 +3638,8 @@ interface paths {
3386
3638
  'application/json': components['schemas']['ErrorResponse'];
3387
3639
  };
3388
3640
  };
3389
- /** @description Service unavailable */
3390
- 503: {
3641
+ /** @description Not found */
3642
+ 404: {
3391
3643
  headers: {
3392
3644
  [name: string]: unknown;
3393
3645
  };
@@ -3403,22 +3655,22 @@ interface paths {
3403
3655
  patch?: never;
3404
3656
  trace?: never;
3405
3657
  };
3406
- '/api/projects/{projectId}/flows/{flowId}/bundle/stream': {
3658
+ '/api/projects/{projectId}/flows/{flowId}/simulate': {
3407
3659
  parameters: {
3408
3660
  query?: never;
3409
3661
  header?: never;
3410
3662
  path?: never;
3411
3663
  cookie?: never;
3412
3664
  };
3665
+ get?: never;
3666
+ put?: never;
3413
3667
  /**
3414
- * Stream bundle job status (SSE)
3415
- * @description Stream bundle job progress via Server-Sent Events.
3668
+ * Simulate a flow step
3669
+ * @description Execute a simulation against a pre-built bundle. Requires bundleId from the bundle endpoint.
3416
3670
  */
3417
- get: {
3671
+ post: {
3418
3672
  parameters: {
3419
- query: {
3420
- jobId: string;
3421
- };
3673
+ query?: never;
3422
3674
  header?: never;
3423
3675
  path: {
3424
3676
  projectId: string;
@@ -3426,14 +3678,20 @@ interface paths {
3426
3678
  };
3427
3679
  cookie?: never;
3428
3680
  };
3429
- requestBody?: never;
3681
+ requestBody?: {
3682
+ content: {
3683
+ 'application/json': components['schemas']['SimulateRequest'];
3684
+ };
3685
+ };
3430
3686
  responses: {
3431
- /** @description SSE event stream */
3687
+ /** @description Simulation result */
3432
3688
  200: {
3433
3689
  headers: {
3434
3690
  [name: string]: unknown;
3435
3691
  };
3436
- content?: never;
3692
+ content: {
3693
+ 'application/json': components['schemas']['SimulateResponse'];
3694
+ };
3437
3695
  };
3438
3696
  /** @description Unauthorized */
3439
3697
  401: {
@@ -3444,17 +3702,33 @@ interface paths {
3444
3702
  'application/json': components['schemas']['ErrorResponse'];
3445
3703
  };
3446
3704
  };
3705
+ /** @description Not found */
3706
+ 404: {
3707
+ headers: {
3708
+ [name: string]: unknown;
3709
+ };
3710
+ content: {
3711
+ 'application/json': components['schemas']['ErrorResponse'];
3712
+ };
3713
+ };
3714
+ /** @description Simulation container error */
3715
+ 502: {
3716
+ headers: {
3717
+ [name: string]: unknown;
3718
+ };
3719
+ content: {
3720
+ 'application/json': components['schemas']['ErrorResponse'];
3721
+ };
3722
+ };
3447
3723
  };
3448
3724
  };
3449
- put?: never;
3450
- post?: never;
3451
3725
  delete?: never;
3452
3726
  options?: never;
3453
3727
  head?: never;
3454
3728
  patch?: never;
3455
3729
  trace?: never;
3456
3730
  };
3457
- '/api/projects/{projectId}/flows/{flowId}/publish': {
3731
+ '/api/projects/{projectId}/deployments': {
3458
3732
  parameters: {
3459
3733
  query?: never;
3460
3734
  header?: never;
@@ -3462,39 +3736,47 @@ interface paths {
3462
3736
  cookie?: never;
3463
3737
  };
3464
3738
  /**
3465
- * Get publish status
3466
- * @description Get the current publish status for a flow (CDN deployment).
3739
+ * List deployments
3740
+ * @description List deployments for a project. Supports filtering by status, type, origin, and flowId, plus pagination.
3467
3741
  */
3468
3742
  get: {
3469
3743
  parameters: {
3470
- query?: never;
3744
+ query?: {
3745
+ status?:
3746
+ | 'idle'
3747
+ | 'deploying'
3748
+ | 'published'
3749
+ | 'active'
3750
+ | 'stopped'
3751
+ | 'failed';
3752
+ type?: 'web' | 'server';
3753
+ origin?: 'cloud' | 'self-hosted';
3754
+ flowId?: string;
3755
+ sort?: 'created_at' | 'updated_at';
3756
+ order?: 'asc' | 'desc';
3757
+ limit?: number;
3758
+ offset?: number | null;
3759
+ cursor?: string;
3760
+ };
3471
3761
  header?: never;
3472
3762
  path: {
3473
3763
  projectId: string;
3474
- flowId: string;
3475
3764
  };
3476
3765
  cookie?: never;
3477
3766
  };
3478
3767
  requestBody?: never;
3479
3768
  responses: {
3480
- /** @description Publish status */
3769
+ /** @description List of deployments */
3481
3770
  200: {
3482
- headers: {
3483
- [name: string]: unknown;
3484
- };
3485
- content?: never;
3486
- };
3487
- /** @description Unauthorized */
3488
- 401: {
3489
3771
  headers: {
3490
3772
  [name: string]: unknown;
3491
3773
  };
3492
3774
  content: {
3493
- 'application/json': components['schemas']['ErrorResponse'];
3775
+ 'application/json': components['schemas']['ListDeploymentsResponse'];
3494
3776
  };
3495
3777
  };
3496
- /** @description Not found */
3497
- 404: {
3778
+ /** @description Validation error */
3779
+ 400: {
3498
3780
  headers: {
3499
3781
  [name: string]: unknown;
3500
3782
  };
@@ -3502,32 +3784,6 @@ interface paths {
3502
3784
  'application/json': components['schemas']['ErrorResponse'];
3503
3785
  };
3504
3786
  };
3505
- };
3506
- };
3507
- put?: never;
3508
- /**
3509
- * Publish flow to CDN
3510
- * @description Publish a bundled flow to the CDN for client-side loading.
3511
- */
3512
- post: {
3513
- parameters: {
3514
- query?: never;
3515
- header?: never;
3516
- path: {
3517
- projectId: string;
3518
- flowId: string;
3519
- };
3520
- cookie?: never;
3521
- };
3522
- requestBody?: never;
3523
- responses: {
3524
- /** @description Flow published */
3525
- 200: {
3526
- headers: {
3527
- [name: string]: unknown;
3528
- };
3529
- content?: never;
3530
- };
3531
3787
  /** @description Unauthorized */
3532
3788
  401: {
3533
3789
  headers: {
@@ -3537,17 +3793,10 @@ interface paths {
3537
3793
  'application/json': components['schemas']['ErrorResponse'];
3538
3794
  };
3539
3795
  };
3540
- /** @description Not found */
3541
- 404: {
3542
- headers: {
3543
- [name: string]: unknown;
3544
- };
3545
- content: {
3546
- 'application/json': components['schemas']['ErrorResponse'];
3547
- };
3548
- };
3549
3796
  };
3550
3797
  };
3798
+ put?: never;
3799
+ post?: never;
3551
3800
  delete?: never;
3552
3801
  options?: never;
3553
3802
  head?: never;
@@ -3998,6 +4247,58 @@ interface paths {
3998
4247
  patch?: never;
3999
4248
  trace?: never;
4000
4249
  };
4250
+ '/api/feedback': {
4251
+ parameters: {
4252
+ query?: never;
4253
+ header?: never;
4254
+ path?: never;
4255
+ cookie?: never;
4256
+ };
4257
+ get?: never;
4258
+ put?: never;
4259
+ /**
4260
+ * Submit user feedback
4261
+ * @description Accepts free-form feedback from the walkerOS CLI, MCP, or a future in-app form. Public endpoint — no authentication required. The body `userId` is stored verbatim as a best-effort contact email and is not validated against the app users table.
4262
+ */
4263
+ post: {
4264
+ parameters: {
4265
+ query?: never;
4266
+ header?: never;
4267
+ path?: never;
4268
+ cookie?: never;
4269
+ };
4270
+ requestBody?: {
4271
+ content: {
4272
+ 'application/json': components['schemas']['FeedbackRequest'];
4273
+ };
4274
+ };
4275
+ responses: {
4276
+ /** @description Feedback stored */
4277
+ 201: {
4278
+ headers: {
4279
+ [name: string]: unknown;
4280
+ };
4281
+ content: {
4282
+ 'application/json': components['schemas']['FeedbackResponse'];
4283
+ };
4284
+ };
4285
+ /** @description Validation error */
4286
+ 400: {
4287
+ headers: {
4288
+ [name: string]: unknown;
4289
+ };
4290
+ content: {
4291
+ 'application/json': components['schemas']['ErrorResponse'];
4292
+ };
4293
+ };
4294
+ };
4295
+ };
4296
+ delete?: never;
4297
+ options?: never;
4298
+ head?: never;
4299
+ patch?: never;
4300
+ trace?: never;
4301
+ };
4001
4302
  }
4002
4303
  interface components {
4003
4304
  schemas: {
@@ -4019,6 +4320,27 @@ interface components {
4019
4320
  };
4020
4321
  };
4021
4322
  };
4323
+ ClientOutdatedError: {
4324
+ error: {
4325
+ /** @enum {string} */
4326
+ code: 'CLIENT_OUTDATED';
4327
+ /** @example This endpoint requires @walkeros/cli >= 3.5.0 (you are on 3.3.1). */
4328
+ message: string;
4329
+ /** @example 3.5.0 */
4330
+ minVersion: string;
4331
+ /** @example 3.3.1 */
4332
+ clientVersion: string;
4333
+ /** @example cli */
4334
+ client: string;
4335
+ /** @example npm install -g @walkeros/cli@latest */
4336
+ upgrade: string;
4337
+ /**
4338
+ * Format: uri
4339
+ * @example https://walkeros.io/docs/upgrading
4340
+ */
4341
+ docs: string;
4342
+ };
4343
+ };
4022
4344
  FlowConfig: {
4023
4345
  /** @enum {number} */
4024
4346
  version: 4;
@@ -4027,6 +4349,9 @@ interface components {
4027
4349
  variables?: {
4028
4350
  [key: string]: unknown;
4029
4351
  };
4352
+ definitions?: {
4353
+ [key: string]: unknown;
4354
+ };
4030
4355
  flows?: {
4031
4356
  [key: string]: unknown;
4032
4357
  };
@@ -4144,6 +4469,12 @@ interface components {
4144
4469
  * @example 2026-01-26T14:30:00.000Z
4145
4470
  */
4146
4471
  updatedAt: string;
4472
+ /** @example 3 */
4473
+ memberCount: number;
4474
+ /** @example 5 */
4475
+ flowCount: number;
4476
+ /** @example 2 */
4477
+ deploymentCount: number;
4147
4478
  };
4148
4479
  Member: {
4149
4480
  userId: string;
@@ -4245,6 +4576,7 @@ interface components {
4245
4576
  name: string;
4246
4577
  config: components['schemas']['FlowConfig'];
4247
4578
  settings?: components['schemas']['FlowSettingsEnriched'][];
4579
+ bundleId?: string | null;
4248
4580
  /**
4249
4581
  * Format: date-time
4250
4582
  * @example 2026-01-26T14:30:00.000Z
@@ -4345,6 +4677,9 @@ interface components {
4345
4677
  | 'failed';
4346
4678
  currentVersionNumber: number | null;
4347
4679
  url: string | null;
4680
+ /** @example flow_a1b2c3d4 */
4681
+ flowId: string | null;
4682
+ flowName: string | null;
4348
4683
  /** Format: date-time */
4349
4684
  createdAt: string;
4350
4685
  /** Format: date-time */
@@ -4439,6 +4774,9 @@ interface components {
4439
4774
  | 'failed';
4440
4775
  currentVersionNumber: number | null;
4441
4776
  url: string | null;
4777
+ /** @example flow_a1b2c3d4 */
4778
+ flowId: string | null;
4779
+ flowName: string | null;
4442
4780
  /** Format: date-time */
4443
4781
  createdAt: string;
4444
4782
  /** Format: date-time */
@@ -4453,6 +4791,7 @@ interface components {
4453
4791
  total: number;
4454
4792
  limit: number;
4455
4793
  offset: number;
4794
+ nextCursor?: string | null;
4456
4795
  };
4457
4796
  UpdateDeploymentResponse: {
4458
4797
  /** @example dep_a1b2c3d4 */
@@ -4554,6 +4893,48 @@ interface components {
4554
4893
  /** Format: uri */
4555
4894
  observerUrl: string;
4556
4895
  };
4896
+ PreviewResponse: {
4897
+ /** @example prv_abc123xyz456 */
4898
+ id: string;
4899
+ /** @example flow_a1b2c3d4 */
4900
+ flowId: string;
4901
+ flowSettingsId: string;
4902
+ projectId: string;
4903
+ /** @example k9x2m4p7abcd */
4904
+ token: string;
4905
+ /** Format: uri */
4906
+ bundleUrl: string;
4907
+ activationUrl: string;
4908
+ createdBy: string;
4909
+ /** Format: date-time */
4910
+ createdAt: string;
4911
+ };
4912
+ ListPreviewsResponse: {
4913
+ previews: components['schemas']['PreviewResponse'][];
4914
+ total: number;
4915
+ };
4916
+ CreatePreviewRequest: {
4917
+ flowSettingsId: string;
4918
+ };
4919
+ FeedbackRequest: {
4920
+ /** @example The MCP flow_bundle tool is great but slow on large configs. */
4921
+ text: string;
4922
+ /**
4923
+ * Format: email
4924
+ * @example alex@example.com
4925
+ */
4926
+ userId?: string;
4927
+ /** @example proj_abc123 */
4928
+ projectId?: string;
4929
+ /** @example 0.4.2 */
4930
+ version?: string;
4931
+ };
4932
+ FeedbackResponse: {
4933
+ /** @enum {boolean} */
4934
+ ok: true;
4935
+ /** @example fb_abcdef1234567890 */
4936
+ id: string;
4937
+ };
4557
4938
  MagicLinkResponse: {
4558
4939
  /** @example true */
4559
4940
  success: boolean;
@@ -4616,6 +4997,7 @@ interface components {
4616
4997
  ListProjectsResponse: {
4617
4998
  projects: components['schemas']['Project'][];
4618
4999
  total: number;
5000
+ nextCursor: string | null;
4619
5001
  };
4620
5002
  CreateProjectRequest: {
4621
5003
  name: string;
@@ -4646,6 +5028,7 @@ interface components {
4646
5028
  ListFlowsResponse: {
4647
5029
  flows: components['schemas']['FlowSummary'][];
4648
5030
  total: number;
5031
+ nextCursor: string | null;
4649
5032
  };
4650
5033
  CreateFlowRequest: {
4651
5034
  /** @example my-website-flow */
@@ -4777,11 +5160,36 @@ interface components {
4777
5160
  /** @example 90 */
4778
5161
  expiresInDays?: number | null;
4779
5162
  };
4780
- BundleJobResponse: {
4781
- jobId: string;
4782
- state: string;
4783
- hash: string;
4784
- bundlePath: string;
5163
+ BundleResponse: {
5164
+ bundleId: string;
5165
+ cached: boolean;
5166
+ };
5167
+ SimulateResponse: {
5168
+ success: boolean;
5169
+ result?: {
5170
+ /** @enum {string} */
5171
+ step: 'source' | 'transformer' | 'destination';
5172
+ name: string;
5173
+ events: {
5174
+ [key: string]: unknown;
5175
+ }[];
5176
+ calls: {
5177
+ fn: string;
5178
+ args: unknown[];
5179
+ ts: number;
5180
+ }[];
5181
+ duration: number;
5182
+ };
5183
+ };
5184
+ SimulateRequest: {
5185
+ bundleId: string;
5186
+ config: {
5187
+ [key: string]: unknown;
5188
+ };
5189
+ event: {
5190
+ [key: string]: unknown;
5191
+ };
5192
+ step: string;
4785
5193
  };
4786
5194
  RegisterRuntimeRequest: {
4787
5195
  flowId: string;
@@ -4824,6 +5232,8 @@ interface ListFlowsOptions {
4824
5232
  sort?: 'name' | 'updated_at' | 'created_at';
4825
5233
  order?: 'asc' | 'desc';
4826
5234
  includeDeleted?: boolean;
5235
+ cursor?: string;
5236
+ limit?: number;
4827
5237
  }
4828
5238
  declare function listFlows(options?: ListFlowsOptions): Promise<{
4829
5239
  flows: {
@@ -4842,6 +5252,7 @@ declare function listFlows(options?: ListFlowsOptions): Promise<{
4842
5252
  deletedAt: string | null;
4843
5253
  }[];
4844
5254
  total: number;
5255
+ nextCursor: string | null;
4845
5256
  }>;
4846
5257
  declare function listAllFlows(options?: Omit<ListFlowsOptions, 'projectId'>): Promise<ProjectFlows[]>;
4847
5258
  declare function getFlow(options: {
@@ -4859,6 +5270,9 @@ declare function getFlow(options: {
4859
5270
  variables?: {
4860
5271
  [x: string]: unknown;
4861
5272
  } | undefined;
5273
+ definitions?: {
5274
+ [x: string]: unknown;
5275
+ } | undefined;
4862
5276
  flows?: {
4863
5277
  [x: string]: unknown;
4864
5278
  } | undefined;
@@ -4883,6 +5297,7 @@ declare function getFlow(options: {
4883
5297
  createdAt: string;
4884
5298
  updatedAt: string;
4885
5299
  }[] | undefined;
5300
+ bundleId?: string | null | undefined;
4886
5301
  createdAt: string;
4887
5302
  updatedAt: string;
4888
5303
  deletedAt: string | null;
@@ -4902,6 +5317,9 @@ declare function createFlow(options: {
4902
5317
  variables?: {
4903
5318
  [x: string]: unknown;
4904
5319
  } | undefined;
5320
+ definitions?: {
5321
+ [x: string]: unknown;
5322
+ } | undefined;
4905
5323
  flows?: {
4906
5324
  [x: string]: unknown;
4907
5325
  } | undefined;
@@ -4937,6 +5355,9 @@ declare function updateFlow(options: {
4937
5355
  variables?: {
4938
5356
  [x: string]: unknown;
4939
5357
  } | undefined;
5358
+ definitions?: {
5359
+ [x: string]: unknown;
5360
+ } | undefined;
4940
5361
  flows?: {
4941
5362
  [x: string]: unknown;
4942
5363
  } | undefined;
@@ -4968,6 +5389,9 @@ declare function duplicateFlow(options: {
4968
5389
  variables?: {
4969
5390
  [x: string]: unknown;
4970
5391
  } | undefined;
5392
+ definitions?: {
5393
+ [x: string]: unknown;
5394
+ } | undefined;
4971
5395
  flows?: {
4972
5396
  [x: string]: unknown;
4973
5397
  } | undefined;
@@ -5040,6 +5464,8 @@ interface ListDeploymentsOptions {
5040
5464
  type?: 'web' | 'server';
5041
5465
  status?: string;
5042
5466
  flowId?: string;
5467
+ cursor?: string;
5468
+ limit?: number;
5043
5469
  }
5044
5470
  declare function listDeployments(options?: ListDeploymentsOptions): Promise<any>;
5045
5471
  /**
@@ -5579,4 +6005,4 @@ declare module '@walkeros/core' {
5579
6005
  }
5580
6006
  }
5581
6007
 
5582
- export { ApiError, type ApiErrorDetail, type BuildOptions, type BundleStats, type CLIBuildOptions, type ClientContext, type ClientType, type CreatePreviewOptions, type DeletePreviewOptions, type DeployOptions, DeploymentAmbiguityError, type DeploymentSummaryForFlow, type DeviceCodeOptions, type DeviceCodeResult, type ExampleLookupResult, type FeedbackOptions, type GetPreviewOptions, type GlobalOptions, type ListDeploymentsOptions, type ListFlowsOptions, type ListPreviewsOptions, type MinifyOptions, type PollOptions, type PollResult, type PrepareInput, type PreparedFlow, type ProjectFlows, type PushResult, type RunCommandOptions, type RunOptions, type RunResult, type SSEEvent, type SSEParseResult, type SimulateDestinationOptions, type SimulateSourceOptions, type SimulateTransformerOptions, type ValidateResult, type ValidationError, type ValidationType, type ValidationWarning, type WalkerOSConfig, type WrapSkeletonOptions, apiFetch, bundle, bundleCommand, clientContextHeaders, compareOutput, createApiClient, createDeployCommand, createDeployment, createDeploymentCommand, createFlow, createFlowCommand, createPreview, createProject, createProjectCommand, deleteConfig, deleteDeployment, deleteDeploymentByFlowId, deleteDeploymentCommand, deleteFlow, deleteFlowCommand, deletePreview, deleteProject, deleteProjectCommand, deploy, deployCommand, deployFetch, duplicateFlow, duplicateFlowCommand, feedback, feedbackCommand, findExample, getAuthHeaders, getClientContext, getDefaultProject, getDeployment, getDeploymentBySlug, getDeploymentBySlugCommand, getDeploymentCommand, getFeedbackPreference, getFlow, getFlowCommand, getPreview, getProject, getProjectCommand, getToken, listAllFlows, listDeployments, listDeploymentsCommand, listFlows, listFlowsCommand, listPreviews, listProjects, listProjectsCommand, loadConfig, loadJsonConfig, loginCommand, logoutCommand, mergeAuthHeaders, parseSSEEvents, pollForToken, publicFetch, push, pushCommand, readConfig, requestDeviceCode, requireProjectId, resetClientContext, resolveToken, run, runCommand, setClientContext, setDefaultProject, setFeedbackPreference, simulateDestination, simulateSource, simulateTransformer, index as telemetry, telemetryDisableCommand, telemetryEnableCommand, telemetryStatusCommand, throwApiError, updateFlow, updateFlowCommand, updateProject, updateProjectCommand, validate, validateCommand, whoami, whoamiCommand, wrapSkeleton, writeConfig };
6008
+ export { ApiError, type ApiErrorDetail, type BuildOptions, type BundleStats, type CLIBuildOptions, type ClientContext, type ClientType, type CreatePreviewOptions, type DeletePreviewOptions, type DeployOptions, DeploymentAmbiguityError, type DeploymentSummaryForFlow, type DeviceCodeOptions, type DeviceCodeResult, type ExampleLookupResult, type FeedbackOptions, type GetPreviewOptions, type GlobalOptions, type ListDeploymentsOptions, type ListFlowsOptions, type ListPreviewsOptions, type ListProjectsOptions, type MinifyOptions, type PollOptions, type PollResult, type PrepareInput, type PreparedFlow, type ProjectFlows, type PushResult, type RunCommandOptions, type RunOptions, type RunResult, type SSEEvent, type SSEParseResult, type SimulateDestinationOptions, type SimulateSourceOptions, type SimulateTransformerOptions, type ValidateResult, type ValidationError, type ValidationType, type ValidationWarning, type WalkerOSConfig, type WrapSkeletonOptions, apiFetch, bundle, bundleCommand, clientContextHeaders, compareOutput, createApiClient, createDeployCommand, createDeployment, createDeploymentCommand, createFlow, createFlowCommand, createPreview, createProject, createProjectCommand, deleteConfig, deleteDeployment, deleteDeploymentByFlowId, deleteDeploymentCommand, deleteFlow, deleteFlowCommand, deletePreview, deleteProject, deleteProjectCommand, deploy, deployCommand, deployFetch, duplicateFlow, duplicateFlowCommand, feedback, feedbackCommand, findExample, getAuthHeaders, getClientContext, getDefaultProject, getDeployment, getDeploymentBySlug, getDeploymentBySlugCommand, getDeploymentCommand, getFeedbackPreference, getFlow, getFlowCommand, getPreview, getProject, getProjectCommand, getToken, listAllFlows, listDeployments, listDeploymentsCommand, listFlows, listFlowsCommand, listPreviews, listProjects, listProjectsCommand, loadConfig, loadJsonConfig, loginCommand, logoutCommand, mergeAuthHeaders, parseSSEEvents, pollForToken, publicFetch, push, pushCommand, readConfig, requestDeviceCode, requireProjectId, resetClientContext, resolveToken, run, runCommand, setClientContext, setDefaultProject, setFeedbackPreference, simulateDestination, simulateSource, simulateTransformer, index as telemetry, telemetryDisableCommand, telemetryEnableCommand, telemetryStatusCommand, throwApiError, updateFlow, updateFlowCommand, updateProject, updateProjectCommand, validate, validateCommand, whoami, whoamiCommand, wrapSkeleton, writeConfig };