@walkeros/mcp 4.7.0-next-1790245733116 → 4.7.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { ListFlowsOptions, ListPreviewsOptions, GetPreviewOptions, CreatePreviewOptions, DeletePreviewOptions, ListSecretsOptions, CreateSecretOptions, UpdateSecretOptions, DeleteSecretOptions, DeployOptions, ListDeploymentsOptions, DeviceAuthorization, DeviceLoginResult, FeedbackOptions, BundleStats, PushResult } from '@walkeros/cli';
-import { Journey, JourneyGap, JourneyUnattributed, Ingest, WalkerOS, Simulation } from '@walkeros/core';
+import { Journey, JourneyGap, JourneyUnattributed, Flow, Ingest, WalkerOS, Simulation } from '@walkeros/core';
 import { ZodRawShape, z } from 'zod';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
@@ -614,10 +614,28 @@ interface FlowRuntime {
      * path or URL is refused with a `RuntimeRefusal`.
      */
     load(input: string): Promise<unknown>;
+    /**
+     * The directory local `path` packages of a loaded input resolve against:
+     * the input file's directory. Absent on a runtime without a filesystem,
+     * where such packages stay a reported skip.
+     */
+    baseDir?(input: string): string | undefined;
     /** Compile a flow. Absent on a runtime that must not build in its process. */
     bundle?(input: string, opts: BundleOptions): Promise<BundleStats | void>;
     /** Build and run one step of a flow. Absent where that must not happen. */
     simulate?(input: string, opts: SimulateOptions): Promise<Simulation.Result>;
+    /**
+     * The values of the secrets a flow config references (`$secret.NAME`),
+     * masked wherever a simulation or push result egresses. Read by the tools
+     * only on a runtime without `loadRun`; a read that fails stops the run.
+     */
+    knownSecrets?(input: string): Promise<string[]>;
+    /**
+     * Read a push or simulate input once: the config and the values of the
+     * secrets it references. A prebuilt bundle yields no config. A read that
+     * fails rejects. Absent with `simulate` and `push`.
+     */
+    loadRun?(input: string): Promise<LoadedRun>;
     /** Build and run a flow against real destinations. Absent where forbidden. */
     push?(input: string, event: Record<string, unknown>, opts: PushOptions): Promise<PushResult>;
 }
@@ -632,19 +650,40 @@ interface SimulateOptions {
     stepId: string;
     event: unknown;
     flow?: string;
-    /** Transformer steps only: pipeline context the step reads via `ctx.ingest`. */
+    /** The config from `loadRun`: the runtime does not read the input again. */
+    config?: Flow.Json;
+    /**
+     * Transformer, collector and destination steps: pipeline context the step
+     * reads via `ctx.ingest`. Source steps ignore it.
+     */
     ingest?: Omit<Ingest, '_meta'>;
-    /** Collector steps only: state snapshot seeded before enrichment runs. */
+    /**
+     * Collector state the step starts from. `consent` applies to every step
+     * (the collector's starting consent); `user`, `globals` and `timing` to
+     * collector steps only.
+     */
     state?: {
         consent?: WalkerOS.Consent;
         user?: WalkerOS.User;
         globals?: WalkerOS.Properties;
         timing?: number;
     };
+    /**
+     * Destination steps only: run this collector command with `event` as its
+     * data instead of pushing it (a step example with `command`).
+     */
+    command?: Flow.StepCommand;
+}
+/** A push or simulate input as read once by `loadRun`. */
+interface LoadedRun {
+    config?: Flow.Json;
+    knownSecrets: string[];
 }
 interface PushOptions {
     flow?: string;
     platform?: 'web' | 'server';
+    /** The config from `loadRun`: the runtime does not read the input again. */
+    config?: Flow.Json;
 }
 /**
  * Thrown by a runtime when it refuses an input on principle rather than on a