@walkeros/cli 4.1.0 → 4.1.1-next-1779822275564

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Flow, Elb, WalkerOS } from '@walkeros/core';
+import { Flow, Elb, WalkerOS, Simulation } from '@walkeros/core';
 export { Flow } from '@walkeros/core';
 import { BuildOptions as BuildOptions$1 } from 'esbuild';
 import { z } from '@walkeros/core/dev';
@@ -330,23 +330,8 @@ interface PushCommandOptions {
 interface PushResult {
     success: boolean;
     elbResult?: Elb.PushResult;
-    captured?: Array<{
-        event: unknown;
-        timestamp: number;
-    }>;
-    /** Tracked destination API calls keyed by destination ID */
-    usage?: Record<string, Array<{
-        fn: string;
-        args: unknown[];
-        ts: number;
-    }>>;
     /** Network calls captured during web simulation (fetch + sendBeacon) */
     networkCalls?: NetworkCall[];
-    /**
-     * Per-destination simulation results when --simulate destination.* is
-     * called with multiple ids. Undefined for single-target or non-simulate runs.
-     */
-    perDestination?: Record<string, PushResult>;
     duration: number;
     error?: string;
 }
@@ -424,7 +409,7 @@ interface SimulateSourceOptions {
  * The `input` parameter is `unknown` — the CLI is agnostic to source-specific
  * content shapes. The source's createTrigger defines what it expects.
  */
-declare function simulateSource(configOrPath: string | Flow.Json, input: unknown, options: SimulateSourceOptions): Promise<PushResult>;
+declare function simulateSource(configOrPath: string | Flow.Json, input: unknown, options: SimulateSourceOptions): Promise<Simulation.Result>;
 interface SimulateTransformerOptions {
     transformerId: string;
     bundlePath?: string;
@@ -444,7 +429,7 @@ interface SimulateTransformerOptions {
  * Captured array: first entry = input event, subsequent entries = output event(s).
  * If the transformer drops the event (returns false), output event is null.
  */
-declare function simulateTransformer(configOrPath: string | Flow.Json, event: WalkerOS.DeepPartialEvent, options: SimulateTransformerOptions): Promise<PushResult>;
+declare function simulateTransformer(configOrPath: string | Flow.Json, event: WalkerOS.DeepPartialEvent, options: SimulateTransformerOptions): Promise<Simulation.Result>;
 interface SimulateDestinationOptions {
     destinationId: string;
     bundlePath?: string;
@@ -463,7 +448,7 @@ interface SimulateDestinationOptions {
  * pipeline support — consent checks, event mapping, createEvent enrichment,
  * before chains — without manual wiring.
  */
-declare function simulateDestination(configOrPath: string | Flow.Json, event: WalkerOS.DeepPartialEvent, options: SimulateDestinationOptions): Promise<PushResult>;
+declare function simulateDestination(configOrPath: string | Flow.Json, event: WalkerOS.DeepPartialEvent, options: SimulateDestinationOptions): Promise<Simulation.Result>;
 
 /**
  * Run Command Types
@@ -684,15 +669,23 @@ interface WhoamiCommandOptions extends GlobalOptions {
 }
 declare function whoamiCommand(options: WhoamiCommandOptions): Promise<void>;
 
-declare function listProjects(): Promise<{
+interface ListProjectsOptions {
+    cursor?: string;
+    limit?: number;
+}
+declare function listProjects(options?: ListProjectsOptions): Promise<{
     projects: {
         id: string;
         name: string;
         role: "owner" | "admin" | "member" | "deployer" | "viewer";
         createdAt: string;
         updatedAt: string;
+        memberCount: number;
+        flowCount: number;
+        deploymentCount: number;
     }[];
     total: number;
+    nextCursor: string | null;
 }>;
 declare function getProject(options?: {
     projectId?: string;
@@ -702,6 +695,9 @@ declare function getProject(options?: {
     role: "owner" | "admin" | "member" | "deployer" | "viewer";
     createdAt: string;
     updatedAt: string;
+    memberCount: number;
+    flowCount: number;
+    deploymentCount: number;
 }>;
 declare function createProject(options: {
     name: string;
@@ -719,6 +715,9 @@ declare function updateProject(options: {
     role: "owner" | "admin" | "member" | "deployer" | "viewer";
     createdAt: string;
     updatedAt: string;
+    memberCount: number;
+    flowCount: number;
+    deploymentCount: number;
 }>;
 declare function deleteProject(options?: {
     projectId?: string;
@@ -730,6 +729,8 @@ interface ProjectsCommandOptions extends GlobalOptions {
     output?: string;
     project?: string;
     name?: string;
+    cursor?: string;
+    limit?: number;
 }
 declare function listProjectsCommand(options: ProjectsCommandOptions): Promise<void>;
 declare function getProjectCommand(projectId: string | undefined, options: ProjectsCommandOptions): Promise<void>;
@@ -1201,7 +1202,10 @@ interface paths {
      */
     get: {
       parameters: {
-        query?: never;
+        query?: {
+          cursor?: string;
+          limit?: number;
+        };
         header?: never;
         path?: never;
         cookie?: never;
@@ -1738,6 +1742,8 @@ interface paths {
           sort?: 'name' | 'updated_at' | 'created_at';
           order?: 'asc' | 'desc';
           include_deleted?: 'true' | 'false';
+          cursor?: string;
+          limit?: number;
         };
         header?: never;
         path: {
@@ -1863,7 +1869,7 @@ interface paths {
     get: {
       parameters: {
         query?: {
-          /** @description Comma-separated dot-paths to select specific fields (e.g., "config.variables,config.flows.web.sources"). Always includes id, createdAt, updatedAt. */
+          /** @description Comma-separated dot-paths to select specific fields (e.g., "config.variables,config.flows.tracking.sources"). Always includes id, createdAt, updatedAt. */
           fields?: string;
         };
         header?: never;
@@ -2604,7 +2610,7 @@ interface paths {
     };
     /**
      * Download settings JSON
-     * @description Download the named flow settings as a self-contained Config JSON file. Includes parent variables.
+     * @description Download the named flow settings as a self-contained Config JSON file. Includes parent variables and definitions.
      */
     get: {
       parameters: {
@@ -2981,6 +2987,263 @@ interface paths {
     patch?: never;
     trace?: never;
   };
+  '/api/projects/{projectId}/flows/{flowId}/previews': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List previews
+     * @description List all previews for a flow, ordered by creation date descending.
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          projectId: string;
+          flowId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description List of previews */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ListPreviewsResponse'];
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    put?: never;
+    /**
+     * Create preview
+     * @description Create a new preview for a web flow settings entry. Bundles the flow and publishes to a unique token-based URL.
+     */
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          projectId: string;
+          flowId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          'application/json': components['schemas']['CreatePreviewRequest'];
+        };
+      };
+      responses: {
+        /** @description Preview created */
+        201: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['PreviewResponse'];
+          };
+        };
+        /** @description Validation error */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Quota exceeded */
+        429: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Bundle or upload failed */
+        502: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/projects/{projectId}/flows/{flowId}/previews/{previewId}': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get preview
+     * @description Get a single preview by ID.
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          projectId: string;
+          flowId: string;
+          previewId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Preview details */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['PreviewResponse'];
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    /**
+     * Delete preview
+     * @description Delete a preview and its S3 bundle. Requires member role.
+     */
+    delete: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          projectId: string;
+          flowId: string;
+          previewId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Preview deleted */
+        204: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content?: never;
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   '/api/projects/{projectId}/flows/{flowId}/versions': {
     parameters: {
       query?: never;
@@ -3332,14 +3595,16 @@ interface paths {
     get?: never;
     put?: never;
     /**
-     * Trigger flow bundle
-     * @description Start a bundle job for a project flow. For multi-settings flows, specify the named flow via ?flow= query parameter.
+     * Bundle flow
+     * @description Bundle a flow using CLI. Returns bundleId (content-hash). Use ?output=download to redirect to presigned S3 URL.
      */
     post: {
       parameters: {
         query?: {
           /** @description Named flow to bundle (required for multi-settings flows) */
           flow?: string;
+          /** @description Set to "download" to redirect to the bundle file */
+          output?: 'download';
         };
         header?: never;
         path: {
@@ -3350,35 +3615,24 @@ interface paths {
       };
       requestBody?: never;
       responses: {
-        /** @description Bundle job started */
+        /** @description Bundle result */
         200: {
           headers: {
             [name: string]: unknown;
           };
           content: {
-            'application/json': components['schemas']['BundleJobResponse'];
-          };
-        };
-        /** @description Unauthorized */
-        401: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            'application/json': components['schemas']['ErrorResponse'];
+            'application/json': components['schemas']['BundleResponse'];
           };
         };
-        /** @description Not found */
-        404: {
+        /** @description Redirect to presigned bundle URL (when output=download) */
+        302: {
           headers: {
             [name: string]: unknown;
           };
-          content: {
-            'application/json': components['schemas']['ErrorResponse'];
-          };
+          content?: never;
         };
-        /** @description Flow selection required for multi-settings flows */
-        422: {
+        /** @description Unauthorized */
+        401: {
           headers: {
             [name: string]: unknown;
           };
@@ -3386,8 +3640,8 @@ interface paths {
             'application/json': components['schemas']['ErrorResponse'];
           };
         };
-        /** @description Service unavailable */
-        503: {
+        /** @description Not found */
+        404: {
           headers: {
             [name: string]: unknown;
           };
@@ -3403,22 +3657,22 @@ interface paths {
     patch?: never;
     trace?: never;
   };
-  '/api/projects/{projectId}/flows/{flowId}/bundle/stream': {
+  '/api/projects/{projectId}/flows/{flowId}/simulate': {
     parameters: {
       query?: never;
       header?: never;
       path?: never;
       cookie?: never;
     };
+    get?: never;
+    put?: never;
     /**
-     * Stream bundle job status (SSE)
-     * @description Stream bundle job progress via Server-Sent Events.
+     * Simulate a flow step
+     * @description Execute a simulation against a pre-built bundle. Requires bundleId from the bundle endpoint.
      */
-    get: {
+    post: {
       parameters: {
-        query: {
-          jobId: string;
-        };
+        query?: never;
         header?: never;
         path: {
           projectId: string;
@@ -3426,14 +3680,20 @@ interface paths {
         };
         cookie?: never;
       };
-      requestBody?: never;
+      requestBody?: {
+        content: {
+          'application/json': components['schemas']['SimulateRequest'];
+        };
+      };
       responses: {
-        /** @description SSE event stream */
+        /** @description Simulation result */
         200: {
           headers: {
             [name: string]: unknown;
           };
-          content?: never;
+          content: {
+            'application/json': components['schemas']['SimulateResponse'];
+          };
         };
         /** @description Unauthorized */
         401: {
@@ -3444,17 +3704,33 @@ interface paths {
             'application/json': components['schemas']['ErrorResponse'];
           };
         };
+        /** @description Not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Simulation container error */
+        502: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
       };
     };
-    put?: never;
-    post?: never;
     delete?: never;
     options?: never;
     head?: never;
     patch?: never;
     trace?: never;
   };
-  '/api/projects/{projectId}/flows/{flowId}/publish': {
+  '/api/projects/{projectId}/deployments': {
     parameters: {
       query?: never;
       header?: never;
@@ -3462,39 +3738,47 @@ interface paths {
       cookie?: never;
     };
     /**
-     * Get publish status
-     * @description Get the current publish status for a flow (CDN deployment).
+     * List deployments
+     * @description List deployments for a project. Supports filtering by status, type, origin, and flowId, plus pagination.
      */
     get: {
       parameters: {
-        query?: never;
+        query?: {
+          status?:
+            | 'idle'
+            | 'deploying'
+            | 'published'
+            | 'active'
+            | 'stopped'
+            | 'failed';
+          type?: 'web' | 'server';
+          origin?: 'cloud' | 'self-hosted';
+          flowId?: string;
+          sort?: 'created_at' | 'updated_at';
+          order?: 'asc' | 'desc';
+          limit?: number;
+          offset?: number | null;
+          cursor?: string;
+        };
         header?: never;
         path: {
           projectId: string;
-          flowId: string;
         };
         cookie?: never;
       };
       requestBody?: never;
       responses: {
-        /** @description Publish status */
+        /** @description List of deployments */
         200: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content?: never;
-        };
-        /** @description Unauthorized */
-        401: {
           headers: {
             [name: string]: unknown;
           };
           content: {
-            'application/json': components['schemas']['ErrorResponse'];
+            'application/json': components['schemas']['ListDeploymentsResponse'];
           };
         };
-        /** @description Not found */
-        404: {
+        /** @description Validation error */
+        400: {
           headers: {
             [name: string]: unknown;
           };
@@ -3502,32 +3786,6 @@ interface paths {
             'application/json': components['schemas']['ErrorResponse'];
           };
         };
-      };
-    };
-    put?: never;
-    /**
-     * Publish flow to CDN
-     * @description Publish a bundled flow to the CDN for client-side loading.
-     */
-    post: {
-      parameters: {
-        query?: never;
-        header?: never;
-        path: {
-          projectId: string;
-          flowId: string;
-        };
-        cookie?: never;
-      };
-      requestBody?: never;
-      responses: {
-        /** @description Flow published */
-        200: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content?: never;
-        };
         /** @description Unauthorized */
         401: {
           headers: {
@@ -3537,17 +3795,10 @@ interface paths {
             'application/json': components['schemas']['ErrorResponse'];
           };
         };
-        /** @description Not found */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            'application/json': components['schemas']['ErrorResponse'];
-          };
-        };
       };
     };
+    put?: never;
+    post?: never;
     delete?: never;
     options?: never;
     head?: never;
@@ -3998,6 +4249,58 @@ interface paths {
     patch?: never;
     trace?: never;
   };
+  '/api/feedback': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Submit user feedback
+     * @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.
+     */
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          'application/json': components['schemas']['FeedbackRequest'];
+        };
+      };
+      responses: {
+        /** @description Feedback stored */
+        201: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['FeedbackResponse'];
+          };
+        };
+        /** @description Validation error */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
 }
 interface components {
   schemas: {
@@ -4019,6 +4322,27 @@ interface components {
         };
       };
     };
+    ClientOutdatedError: {
+      error: {
+        /** @enum {string} */
+        code: 'CLIENT_OUTDATED';
+        /** @example This endpoint requires @walkeros/cli >= 3.5.0 (you are on 3.3.1). */
+        message: string;
+        /** @example 3.5.0 */
+        minVersion: string;
+        /** @example 3.3.1 */
+        clientVersion: string;
+        /** @example cli */
+        client: string;
+        /** @example npm install -g @walkeros/cli@latest */
+        upgrade: string;
+        /**
+         * Format: uri
+         * @example https://walkeros.io/docs/upgrading
+         */
+        docs: string;
+      };
+    };
     FlowConfig: {
       /** @enum {number} */
       version: 4;
@@ -4027,6 +4351,9 @@ interface components {
       variables?: {
         [key: string]: unknown;
       };
+      definitions?: {
+        [key: string]: unknown;
+      };
       flows?: {
         [key: string]: unknown;
       };
@@ -4144,6 +4471,12 @@ interface components {
        * @example 2026-01-26T14:30:00.000Z
        */
       updatedAt: string;
+      /** @example 3 */
+      memberCount: number;
+      /** @example 5 */
+      flowCount: number;
+      /** @example 2 */
+      deploymentCount: number;
     };
     Member: {
       userId: string;
@@ -4245,6 +4578,7 @@ interface components {
       name: string;
       config: components['schemas']['FlowConfig'];
       settings?: components['schemas']['FlowSettingsEnriched'][];
+      bundleId?: string | null;
       /**
        * Format: date-time
        * @example 2026-01-26T14:30:00.000Z
@@ -4345,6 +4679,9 @@ interface components {
         | 'failed';
       currentVersionNumber: number | null;
       url: string | null;
+      /** @example flow_a1b2c3d4 */
+      flowId: string | null;
+      flowName: string | null;
       /** Format: date-time */
       createdAt: string;
       /** Format: date-time */
@@ -4439,6 +4776,9 @@ interface components {
         | 'failed';
       currentVersionNumber: number | null;
       url: string | null;
+      /** @example flow_a1b2c3d4 */
+      flowId: string | null;
+      flowName: string | null;
       /** Format: date-time */
       createdAt: string;
       /** Format: date-time */
@@ -4453,6 +4793,7 @@ interface components {
       total: number;
       limit: number;
       offset: number;
+      nextCursor: string | null;
     };
     UpdateDeploymentResponse: {
       /** @example dep_a1b2c3d4 */
@@ -4554,6 +4895,48 @@ interface components {
       /** Format: uri */
       observerUrl: string;
     };
+    PreviewResponse: {
+      /** @example prv_abc123xyz456 */
+      id: string;
+      /** @example flow_a1b2c3d4 */
+      flowId: string;
+      flowSettingsId: string;
+      projectId: string;
+      /** @example k9x2m4p7abcd */
+      token: string;
+      /** Format: uri */
+      bundleUrl: string;
+      activationUrl: string;
+      createdBy: string;
+      /** Format: date-time */
+      createdAt: string;
+    };
+    ListPreviewsResponse: {
+      previews: components['schemas']['PreviewResponse'][];
+      total: number;
+    };
+    CreatePreviewRequest: {
+      flowSettingsId: string;
+    };
+    FeedbackRequest: {
+      /** @example The MCP flow_bundle tool is great but slow on large configs. */
+      text: string;
+      /**
+       * Format: email
+       * @example alex@example.com
+       */
+      userId?: string;
+      /** @example proj_abc123 */
+      projectId?: string;
+      /** @example 0.4.2 */
+      version?: string;
+    };
+    FeedbackResponse: {
+      /** @enum {boolean} */
+      ok: true;
+      /** @example fb_abcdef1234567890 */
+      id: string;
+    };
     MagicLinkResponse: {
       /** @example true */
       success: boolean;
@@ -4616,6 +4999,7 @@ interface components {
     ListProjectsResponse: {
       projects: components['schemas']['Project'][];
       total: number;
+      nextCursor: string | null;
     };
     CreateProjectRequest: {
       name: string;
@@ -4646,6 +5030,7 @@ interface components {
     ListFlowsResponse: {
       flows: components['schemas']['FlowSummary'][];
       total: number;
+      nextCursor: string | null;
     };
     CreateFlowRequest: {
       /** @example my-website-flow */
@@ -4777,11 +5162,36 @@ interface components {
       /** @example 90 */
       expiresInDays?: number | null;
     };
-    BundleJobResponse: {
-      jobId: string;
-      state: string;
-      hash: string;
-      bundlePath: string;
+    BundleResponse: {
+      bundleId: string;
+      cached: boolean;
+    };
+    SimulateResponse: {
+      success: boolean;
+      result?: {
+        /** @enum {string} */
+        step: 'source' | 'transformer' | 'destination';
+        name: string;
+        events: {
+          [key: string]: unknown;
+        }[];
+        calls: {
+          fn: string;
+          args: unknown[];
+          ts: number;
+        }[];
+        duration: number;
+      };
+    };
+    SimulateRequest: {
+      bundleId: string;
+      config: {
+        [key: string]: unknown;
+      };
+      event: {
+        [key: string]: unknown;
+      };
+      step: string;
     };
     RegisterRuntimeRequest: {
       flowId: string;
@@ -4824,6 +5234,8 @@ interface ListFlowsOptions {
     sort?: 'name' | 'updated_at' | 'created_at';
     order?: 'asc' | 'desc';
     includeDeleted?: boolean;
+    cursor?: string;
+    limit?: number;
 }
 declare function listFlows(options?: ListFlowsOptions): Promise<{
     flows: {
@@ -4842,6 +5254,7 @@ declare function listFlows(options?: ListFlowsOptions): Promise<{
         deletedAt: string | null;
     }[];
     total: number;
+    nextCursor: string | null;
 }>;
 declare function listAllFlows(options?: Omit<ListFlowsOptions, 'projectId'>): Promise<ProjectFlows[]>;
 declare function getFlow(options: {
@@ -4859,6 +5272,9 @@ declare function getFlow(options: {
         variables?: {
             [x: string]: unknown;
         } | undefined;
+        definitions?: {
+            [x: string]: unknown;
+        } | undefined;
         flows?: {
             [x: string]: unknown;
         } | undefined;
@@ -4883,6 +5299,7 @@ declare function getFlow(options: {
         createdAt: string;
         updatedAt: string;
     }[] | undefined;
+    bundleId?: string | null | undefined;
     createdAt: string;
     updatedAt: string;
     deletedAt: string | null;
@@ -4902,6 +5319,9 @@ declare function createFlow(options: {
         variables?: {
             [x: string]: unknown;
         } | undefined;
+        definitions?: {
+            [x: string]: unknown;
+        } | undefined;
         flows?: {
             [x: string]: unknown;
         } | undefined;
@@ -4937,6 +5357,9 @@ declare function updateFlow(options: {
         variables?: {
             [x: string]: unknown;
         } | undefined;
+        definitions?: {
+            [x: string]: unknown;
+        } | undefined;
         flows?: {
             [x: string]: unknown;
         } | undefined;
@@ -4968,6 +5391,9 @@ declare function duplicateFlow(options: {
         variables?: {
             [x: string]: unknown;
         } | undefined;
+        definitions?: {
+            [x: string]: unknown;
+        } | undefined;
         flows?: {
             [x: string]: unknown;
         } | undefined;
@@ -4995,6 +5421,8 @@ declare function listFlowsCommand(options: FlowsCommandOptions & {
     sort?: string;
     order?: string;
     includeDeleted?: boolean;
+    cursor?: string;
+    limit?: number;
 }): Promise<void>;
 declare function getFlowCommand(flowId: string, options: FlowsCommandOptions): Promise<void>;
 declare function createFlowCommand(name: string, options: FlowsCommandOptions & {
@@ -5040,6 +5468,8 @@ interface ListDeploymentsOptions {
     type?: 'web' | 'server';
     status?: string;
     flowId?: string;
+    cursor?: string;
+    limit?: number;
 }
 declare function listDeployments(options?: ListDeploymentsOptions): Promise<any>;
 /**
@@ -5097,6 +5527,8 @@ interface DeploymentsCommandOptions extends GlobalOptions {
     type?: string;
     status?: string;
     label?: string;
+    cursor?: string;
+    limit?: number;
 }
 declare function listDeploymentsCommand(options: DeploymentsCommandOptions): Promise<void>;
 declare function getDeploymentBySlugCommand(slug: string, options: DeploymentsCommandOptions): Promise<void>;
@@ -5176,6 +5608,16 @@ interface WrapSkeletonOptions {
     previewOrigin?: string;
     /** Browser-only: project scope for preview URL isolation. */
     previewScope?: string;
+    /**
+     * Browser-only: telemetry wiring. When provided, the wrapped bundle
+     * installs an observer built via `createTelemetryObserver` onto
+     * `collector.observers` and forwards FlowState records to `observerUrl`
+     * using `createBatchedPoster`.
+     *
+     * Omit (or pass `level: 'off'`) to ship a bundle with zero telemetry
+     * plumbing.
+     */
+    telemetry?: TelemetryBundleOptions;
     /**
      * esbuild target. @default 'es2018' for browser, 'node18' for node.
      */
@@ -5185,6 +5627,18 @@ interface WrapSkeletonOptions {
     /** Fine-grained minification options, forwarded to esbuild. */
     minifyOptions?: MinifyOptions;
 }
+interface TelemetryBundleOptions {
+    /** Absolute ingest URL. POST receives JSON array of FlowState. */
+    observerUrl: string;
+    /** Deployment-scoped plaintext token. Sent as `Authorization: Bearer`. */
+    ingestToken: string;
+    /** Used as the `flowId` on every emitted FlowState. */
+    flowId: string;
+    /** Verbosity. Default 'standard'. 'off' suppresses the entire wiring. */
+    level?: 'off' | 'standard' | 'trace';
+    /** Deterministic sample fraction in [0, 1]. Default 1. */
+    sample?: number;
+}
 declare function wrapSkeleton(options: WrapSkeletonOptions): Promise<void>;
 
 declare function createApiClient(): openapi_fetch.Client<paths, `${string}/${string}`>;
@@ -5579,4 +6033,4 @@ declare module '@walkeros/core' {
     }
 }
 
-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 };
+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 };