@walkeros/mcp 4.7.0-next-1790722899482 → 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, Flow, 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,15 +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 result egresses. Absent with `simulate`.
+     * 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>;
 }
@@ -637,6 +650,8 @@ interface SimulateOptions {
     stepId: string;
     event: unknown;
     flow?: string;
+    /** 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.
@@ -659,9 +674,16 @@ interface SimulateOptions {
      */
     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