@walkeros/core 4.3.0 → 4.3.1

package/dist/index.d.mts

@@ -224,6 +224,71 @@ interface Ingest {
 /** Create a fresh Ingest for a new pipeline invocation. */
 declare function createIngest(sourceId: string): Ingest;
 
+/**
+ * Unified observation connect protocol: the public shapes and pure parsers a
+ * customer-side runtime uses to attach to an observation session. Everything a
+ * customer commits is public (`url`, `binding`); the per-session credential
+ * arrives out-of-band and is only parsed here, never verified: the observer
+ * is its verifier. No DOM, no Node, pure string/object functions.
+ */
+/** Web arm connect config. Every value is public and safe to commit. */
+interface ObserveWeb {
+    url: string;
+    binding: string;
+    /**
+     * FlowState scoping id stamped onto every posted record. Defaults to the
+     * collector's flow name; bakers (e.g. a preview artifact) set it so records
+     * carry the platform's flow id rather than the config's local name.
+     */
+    flowId?: string;
+    /**
+     * Observer verbosity once a credential attaches. Defaults to 'standard'.
+     * Also drives the collector-wide capture level supplier, so 'trace'
+     * enables destination call capture.
+     */
+    level?: 'off' | 'standard' | 'trace';
+    /** Deterministic sample fraction in [0, 1]. Defaults to 1. */
+    sample?: number;
+}
+/** Server arm connect config, assembled from the deployment's env trio. */
+interface ObserveServer {
+    url: string;
+    sessionId: string;
+    token: string;
+    level?: 'off' | 'standard' | 'trace';
+    /** Deterministic sample fraction in [0, 1]. Defaults to 1. */
+    sample?: number;
+}
+type Observe = ObserveWeb | ObserveServer;
+/** Claims carried by a parsed `obsw_` web credential. */
+interface ObserveCredential {
+    /** Project binding. Must match the value baked into the host bundle. */
+    pb: string;
+    /** Session id the credential attaches to. */
+    ses: string;
+    /** Web ingest token. Opaque here; the observer verifies it. */
+    secret: string;
+}
+/**
+ * Parse a web observation credential of the exact shape
+ * `obsw_<pb>.<ses>.<secret>`: the `obsw_` prefix followed by exactly three
+ * non-empty dot-separated segments. Returns null (never throws) on every
+ * malformed shape: wrong prefix, wrong segment count, empty segment.
+ */
+declare function parseObserveCredential(raw: string): ObserveCredential | null;
+/**
+ * Read the server arm's connect config from an env record. Callers pass their
+ * own env (e.g. `process.env`); core never reads globals. Returns an
+ * `ObserveServer` only when the full trio (`WALKEROS_OBSERVER_URL`,
+ * `WALKEROS_DEPLOYMENT_ID`, `WALKEROS_INGEST_TOKEN`) is present, carrying
+ * `WALKEROS_OBSERVE_LEVEL` into `level`. An explicitly set level that names
+ * no known value (e.g. a typo'd `offf`) rejects the whole config: silently
+ * observing at the default `standard` against a probable opt-out intent is
+ * the one failure mode this parser must never produce. Otherwise undefined:
+ * an unconfigured deployment does zero observation work.
+ */
+declare function observeFromEnv(env: Record<string, string | undefined>): ObserveServer | undefined;
+
 /**
  * FlowState is the canonical observation record emitted at each hop in a
  * walkerOS pipeline. Telemetry helpers populate one of these per (step,
@@ -264,6 +329,8 @@ interface FlowState {
     sourceId?: string;
     /** Per-poster monotonic record counter for gap detection. Stamped by the batched poster, not emitters. */
     seq?: number;
+    /** Release provenance of the runtime that produced this state, e.g. a deployment id. Stamped by the wiring layer, not emitters. */
+    release?: string;
     /**
      * Vendor calls recorded via wrapEnv on destination out records. Captured only
      * at trace level and only when the destination declares a `calls` list
@@ -404,6 +471,20 @@ interface InitConfig extends Partial<Config$6> {
     custom?: Properties;
     /** Hooks for pipeline observation and interception */
     hooks?: Functions;
+    /**
+     * Observation session connect config, wired by `startFlow` before the run
+     * command. The server form attaches a telemetry poster directly from its
+     * config trio; the web form attaches only when an `elbObserve` credential
+     * is present (URL param or storage slot) and its binding matches. Purely
+     * advisory: nothing on this path can affect event processing.
+     */
+    observe?: Observe;
+    /**
+     * Caller-supplied observers, added verbatim to `collector.observers` by
+     * `startFlow`. Escape hatch for custom emit targets; same advisory
+     * contract as every observer (thrown values are swallowed by emitStep).
+     */
+    observers?: ObserverFn[];
 }
 interface SessionData extends Properties {
     isStart: boolean;
@@ -1751,6 +1832,19 @@ declare namespace Flow {
         level?: 'off' | 'standard' | 'trace';
         /** Deterministic sample fraction in [0, 1]. Defaults to 1. */
         sample?: number;
+        /**
+         * Observer base URL for the web connect form. Public, safe to commit.
+         * When `url` and `binding` are both set on a web flow, the bundler bakes
+         * exactly this pair into the generated startFlow config; the runtime
+         * attaches only when an out-of-band `elbObserve` credential is present.
+         * Secrets never live in flow config.
+         */
+        url?: string;
+        /**
+         * Public project binding a web observe credential must match. Paired
+         * with `url`; public, safe to commit.
+         */
+        binding?: string;
     }
     /**
      * Reusable values referenced via `$var.name` (with optional deep paths).
@@ -4489,6 +4583,16 @@ interface SwapActivatorConfig {
  * stored activation clears.
  */
 declare const SESSION_STORAGE_KEY = "elbPreviewSession";
+/**
+ * Storage slot for the observe ingest credential companion (`obsw_...`), a
+ * plaintext bearer credential riding the activation URL. The web arm never
+ * verifies it (the observer is its verifier): the activator only ferries it
+ * from the activation URL into storage, where the observe wiring reads it to
+ * attach to the observation session. Same lifecycle as the session companion:
+ * set (or cleared) whenever a URL activation succeeds, cleared whenever the
+ * stored activation clears.
+ */
+declare const OBSERVE_STORAGE_KEY = "elbObserve";
 /**
  * Decide whether a preview bundle should boot in place of this bundle's own flow.
  *
@@ -4568,8 +4672,21 @@ type PosterFetch = (url: string, init: {
     headers: Record<string, string>;
     body: string;
 }) => Promise<PosterResponse>;
+/**
+ * Versioned ingest wire format. Every POST body is one envelope; a batch
+ * split into multiple chunks posts one complete envelope per chunk. The
+ * version field lets the observer evolve its parse without sniffing shapes:
+ * runtimes pinned to this poster keep emitting `v: 1` and the server keeps
+ * accepting it.
+ */
+interface IngestEnvelope {
+    /** Wire format version. */
+    v: 1;
+    /** FlowState records in arrival order, each stamped with a seq. */
+    records: FlowState[];
+}
 interface BatchedPosterOptions {
-    /** Absolute HTTP endpoint URL. POST with JSON array body. */
+    /** Absolute HTTP endpoint URL. POST with a versioned envelope JSON body. */
     url: string;
     /** Bearer token sent in the `Authorization` header. */
     token: string;
@@ -4587,6 +4704,20 @@ interface BatchedPosterOptions {
     fetch?: PosterFetch;
     /** Called when the underlying POST rejects. Defaults to swallowing. */
     onError?: (err: unknown) => void;
+    /**
+     * Extra headers merged into every request (e.g. `X-Walkeros-Binding`).
+     * The fixed `Content-Type` and `Authorization` headers win on collision,
+     * matched case-insensitively (header names are case-insensitive on the
+     * wire, so a lowercase `authorization` is dropped too).
+     */
+    headers?: Record<string, string>;
+    /**
+     * Called with the HTTP status of every response, before any non-2xx
+     * error handling. Lets callers react to a 401/404 (stop posting,
+     * self-heal) without parsing error strings. Not called when the fetch
+     * rejects, since no response exists.
+     */
+    onStatus?: (status: number) => void;
 }
 /**
  * Build a batched emit callback. The returned function is synchronous, never
@@ -5040,4 +5171,4 @@ declare const REF_CODE_PREFIX = "$code:";
  */
 declare function scanFlowRefs(value: unknown, into?: Set<string>): Set<string>;
 
-export { type ActivationGrant, type AssembleJourneysOptions, type BatchedPosterOptions, type BreakerState, CLOCK_SKEW_MS, cache as Cache, type CacheEnvelope, type CacheResult, type ClickIdEntry, collector as Collector, type CompiledCache, Const, context as Context, type Credential, type Debounced, destination as Destination, type DestroyContext, type DestroyFn, type DroppedCounters, ENV_MARKER_PREFIX, elb as Elb, type EmitFn, type ExampleSummary, FatalError, Flow, type FlowConfigResolver, type FlowState, type FlowStateBatch, type FlowStatePhase, type FlowStepType, type GetStore, hint as Hint, hooks as Hooks, type Ingest, type IngestMeta, type Journey, type JourneyAssembly, type JourneyBranch, type JourneyCorrelation, type JourneyEntry, type JourneyGap, type JourneyHop, type JourneyHopStatus, type JourneyPlatform, type JourneyStatus, type JourneyTopology, type JourneyTopologyNode, type JsonSchema, Level, lifecycle as Lifecycle, type LifecycleContext, logger as Logger, MAX_SESSION_MS, mapping as Mapping, type MarketingParameters, matcher as Matcher, type MockLogger, OBSERVE_ENV_KEY, type ObserverFn, on as On, type ParsedGrant, type ParsedTraceparent, type PosterFetch, type PosterResponse, type PreviewCrypto, type PreviewFailure, type PreviewKey, type PreviewSubtle, REF_CODE_PREFIX, REF_CONTRACT, REF_ENV, REF_FLOW, REF_SECRET, REF_STORE, REF_VAR_FULL, REF_VAR_INLINE, request as Request, type ResolveContractsOptions, type ResolveOptions, type RespondFn, type RespondOptions, SECRET_MARKER_PREFIX, SESSION_STORAGE_KEY, STEP_OPERATIVE_FIELDS, type ScheduleOptions, type SendDataValue, type SendHeaders, type SendResponse, type ServiceAccount, type SetupFn, simulation as Simulation, source as Source, type State, type StepEntryErrorCode, type StepEntryValidation, type StepKind, type StorageType, store as Store, StoreCodecError, type SwapActivatorConfig, type TelemetryLevel, type TelemetryOptions, type TelemetryOptionsSupplier, transformer as Transformer, trigger as Trigger, URL_WINDOW_MS, type ValidateEvents, type VerifyParams, type VerifyResult, walkeros as WalkerOS, type WalkerOSPackage, type WalkerOSPackageInfo, type WalkerOSPackageMeta, anonymizeIP, applyState, applyUpdate, assembleJourneys, assign, branch, browserSwapActivator, buildCacheContext, castToProperty, castValue, checkCache, clone, compileCache, compileMatcher, compileState, createBatchedPoster, createDestination, createEvent, createIngest, createLogger, createMockContext, createMockLogger, createRespond, createTelemetryObserver, debounce, deepMerge, defaultClickIds, deleteByPath, deserializeStoreValue, emitStep, fetchPackage, fetchPackageSchema, filterValues, flattenIncludeSections, formatOut, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getFlowSettings, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getNextSteps, getOS, getOSVersion, getPlatform, getSpanId, getTraceId, getTraceUntil, isArguments, isArray, isBoolean, isCommand, isDefined, isElementOrDocument, isEnvObserve, isFunction, isNumber, isObject, isPathStepEntry, isPropertyType, isRouteArray, isRouteConfigEntry, isSameType, isSampled, isStoreValue, isString, mcpError, mcpResult, mergeContractSchemas, mergeMappingRule, mockEnv, packageNameToVariable, parseCallPath, parseGrant, parseTraceparent, parseUserAgent, processEventMapping, readCacheEnvelope, requestToData, requestToParameter, resolveContracts, resolveSetup, resolveTelemetryOptions, scanFlowRefs, serializeStoreValue, setByPath, setTraceUntil, stepId, storeCache, throttle, throwError, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, validateStepEntry, verifyActivation, walkPath, wrapCacheEnvelope, wrapCondition, wrapFn, wrapValidate };
+export { type ActivationGrant, type AssembleJourneysOptions, type BatchedPosterOptions, type BreakerState, CLOCK_SKEW_MS, cache as Cache, type CacheEnvelope, type CacheResult, type ClickIdEntry, collector as Collector, type CompiledCache, Const, context as Context, type Credential, type Debounced, destination as Destination, type DestroyContext, type DestroyFn, type DroppedCounters, ENV_MARKER_PREFIX, elb as Elb, type EmitFn, type ExampleSummary, FatalError, Flow, type FlowConfigResolver, type FlowState, type FlowStateBatch, type FlowStatePhase, type FlowStepType, type GetStore, hint as Hint, hooks as Hooks, type Ingest, type IngestEnvelope, type IngestMeta, type Journey, type JourneyAssembly, type JourneyBranch, type JourneyCorrelation, type JourneyEntry, type JourneyGap, type JourneyHop, type JourneyHopStatus, type JourneyPlatform, type JourneyStatus, type JourneyTopology, type JourneyTopologyNode, type JsonSchema, Level, lifecycle as Lifecycle, type LifecycleContext, logger as Logger, MAX_SESSION_MS, mapping as Mapping, type MarketingParameters, matcher as Matcher, type MockLogger, OBSERVE_ENV_KEY, OBSERVE_STORAGE_KEY, type Observe, type ObserveCredential, type ObserveServer, type ObserveWeb, type ObserverFn, on as On, type ParsedGrant, type ParsedTraceparent, type PosterFetch, type PosterResponse, type PreviewCrypto, type PreviewFailure, type PreviewKey, type PreviewSubtle, REF_CODE_PREFIX, REF_CONTRACT, REF_ENV, REF_FLOW, REF_SECRET, REF_STORE, REF_VAR_FULL, REF_VAR_INLINE, request as Request, type ResolveContractsOptions, type ResolveOptions, type RespondFn, type RespondOptions, SECRET_MARKER_PREFIX, SESSION_STORAGE_KEY, STEP_OPERATIVE_FIELDS, type ScheduleOptions, type SendDataValue, type SendHeaders, type SendResponse, type ServiceAccount, type SetupFn, simulation as Simulation, source as Source, type State, type StepEntryErrorCode, type StepEntryValidation, type StepKind, type StorageType, store as Store, StoreCodecError, type SwapActivatorConfig, type TelemetryLevel, type TelemetryOptions, type TelemetryOptionsSupplier, transformer as Transformer, trigger as Trigger, URL_WINDOW_MS, type ValidateEvents, type VerifyParams, type VerifyResult, walkeros as WalkerOS, type WalkerOSPackage, type WalkerOSPackageInfo, type WalkerOSPackageMeta, anonymizeIP, applyState, applyUpdate, assembleJourneys, assign, branch, browserSwapActivator, buildCacheContext, castToProperty, castValue, checkCache, clone, compileCache, compileMatcher, compileState, createBatchedPoster, createDestination, createEvent, createIngest, createLogger, createMockContext, createMockLogger, createRespond, createTelemetryObserver, debounce, deepMerge, defaultClickIds, deleteByPath, deserializeStoreValue, emitStep, fetchPackage, fetchPackageSchema, filterValues, flattenIncludeSections, formatOut, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getFlowSettings, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getNextSteps, getOS, getOSVersion, getPlatform, getSpanId, getTraceId, getTraceUntil, isArguments, isArray, isBoolean, isCommand, isDefined, isElementOrDocument, isEnvObserve, isFunction, isNumber, isObject, isPathStepEntry, isPropertyType, isRouteArray, isRouteConfigEntry, isSameType, isSampled, isStoreValue, isString, mcpError, mcpResult, mergeContractSchemas, mergeMappingRule, mockEnv, observeFromEnv, packageNameToVariable, parseCallPath, parseGrant, parseObserveCredential, parseTraceparent, parseUserAgent, processEventMapping, readCacheEnvelope, requestToData, requestToParameter, resolveContracts, resolveSetup, resolveTelemetryOptions, scanFlowRefs, serializeStoreValue, setByPath, setTraceUntil, stepId, storeCache, throttle, throwError, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, validateStepEntry, verifyActivation, walkPath, wrapCacheEnvelope, wrapCondition, wrapFn, wrapValidate };

package/dist/index.d.ts

@@ -224,6 +224,71 @@ interface Ingest {
 /** Create a fresh Ingest for a new pipeline invocation. */
 declare function createIngest(sourceId: string): Ingest;
 
+/**
+ * Unified observation connect protocol: the public shapes and pure parsers a
+ * customer-side runtime uses to attach to an observation session. Everything a
+ * customer commits is public (`url`, `binding`); the per-session credential
+ * arrives out-of-band and is only parsed here, never verified: the observer
+ * is its verifier. No DOM, no Node, pure string/object functions.
+ */
+/** Web arm connect config. Every value is public and safe to commit. */
+interface ObserveWeb {
+    url: string;
+    binding: string;
+    /**
+     * FlowState scoping id stamped onto every posted record. Defaults to the
+     * collector's flow name; bakers (e.g. a preview artifact) set it so records
+     * carry the platform's flow id rather than the config's local name.
+     */
+    flowId?: string;
+    /**
+     * Observer verbosity once a credential attaches. Defaults to 'standard'.
+     * Also drives the collector-wide capture level supplier, so 'trace'
+     * enables destination call capture.
+     */
+    level?: 'off' | 'standard' | 'trace';
+    /** Deterministic sample fraction in [0, 1]. Defaults to 1. */
+    sample?: number;
+}
+/** Server arm connect config, assembled from the deployment's env trio. */
+interface ObserveServer {
+    url: string;
+    sessionId: string;
+    token: string;
+    level?: 'off' | 'standard' | 'trace';
+    /** Deterministic sample fraction in [0, 1]. Defaults to 1. */
+    sample?: number;
+}
+type Observe = ObserveWeb | ObserveServer;
+/** Claims carried by a parsed `obsw_` web credential. */
+interface ObserveCredential {
+    /** Project binding. Must match the value baked into the host bundle. */
+    pb: string;
+    /** Session id the credential attaches to. */
+    ses: string;
+    /** Web ingest token. Opaque here; the observer verifies it. */
+    secret: string;
+}
+/**
+ * Parse a web observation credential of the exact shape
+ * `obsw_<pb>.<ses>.<secret>`: the `obsw_` prefix followed by exactly three
+ * non-empty dot-separated segments. Returns null (never throws) on every
+ * malformed shape: wrong prefix, wrong segment count, empty segment.
+ */
+declare function parseObserveCredential(raw: string): ObserveCredential | null;
+/**
+ * Read the server arm's connect config from an env record. Callers pass their
+ * own env (e.g. `process.env`); core never reads globals. Returns an
+ * `ObserveServer` only when the full trio (`WALKEROS_OBSERVER_URL`,
+ * `WALKEROS_DEPLOYMENT_ID`, `WALKEROS_INGEST_TOKEN`) is present, carrying
+ * `WALKEROS_OBSERVE_LEVEL` into `level`. An explicitly set level that names
+ * no known value (e.g. a typo'd `offf`) rejects the whole config: silently
+ * observing at the default `standard` against a probable opt-out intent is
+ * the one failure mode this parser must never produce. Otherwise undefined:
+ * an unconfigured deployment does zero observation work.
+ */
+declare function observeFromEnv(env: Record<string, string | undefined>): ObserveServer | undefined;
+
 /**
  * FlowState is the canonical observation record emitted at each hop in a
  * walkerOS pipeline. Telemetry helpers populate one of these per (step,
@@ -264,6 +329,8 @@ interface FlowState {
     sourceId?: string;
     /** Per-poster monotonic record counter for gap detection. Stamped by the batched poster, not emitters. */
     seq?: number;
+    /** Release provenance of the runtime that produced this state, e.g. a deployment id. Stamped by the wiring layer, not emitters. */
+    release?: string;
     /**
      * Vendor calls recorded via wrapEnv on destination out records. Captured only
      * at trace level and only when the destination declares a `calls` list
@@ -404,6 +471,20 @@ interface InitConfig extends Partial<Config$6> {
     custom?: Properties;
     /** Hooks for pipeline observation and interception */
     hooks?: Functions;
+    /**
+     * Observation session connect config, wired by `startFlow` before the run
+     * command. The server form attaches a telemetry poster directly from its
+     * config trio; the web form attaches only when an `elbObserve` credential
+     * is present (URL param or storage slot) and its binding matches. Purely
+     * advisory: nothing on this path can affect event processing.
+     */
+    observe?: Observe;
+    /**
+     * Caller-supplied observers, added verbatim to `collector.observers` by
+     * `startFlow`. Escape hatch for custom emit targets; same advisory
+     * contract as every observer (thrown values are swallowed by emitStep).
+     */
+    observers?: ObserverFn[];
 }
 interface SessionData extends Properties {
     isStart: boolean;
@@ -1751,6 +1832,19 @@ declare namespace Flow {
         level?: 'off' | 'standard' | 'trace';
         /** Deterministic sample fraction in [0, 1]. Defaults to 1. */
         sample?: number;
+        /**
+         * Observer base URL for the web connect form. Public, safe to commit.
+         * When `url` and `binding` are both set on a web flow, the bundler bakes
+         * exactly this pair into the generated startFlow config; the runtime
+         * attaches only when an out-of-band `elbObserve` credential is present.
+         * Secrets never live in flow config.
+         */
+        url?: string;
+        /**
+         * Public project binding a web observe credential must match. Paired
+         * with `url`; public, safe to commit.
+         */
+        binding?: string;
     }
     /**
      * Reusable values referenced via `$var.name` (with optional deep paths).
@@ -4489,6 +4583,16 @@ interface SwapActivatorConfig {
  * stored activation clears.
  */
 declare const SESSION_STORAGE_KEY = "elbPreviewSession";
+/**
+ * Storage slot for the observe ingest credential companion (`obsw_...`), a
+ * plaintext bearer credential riding the activation URL. The web arm never
+ * verifies it (the observer is its verifier): the activator only ferries it
+ * from the activation URL into storage, where the observe wiring reads it to
+ * attach to the observation session. Same lifecycle as the session companion:
+ * set (or cleared) whenever a URL activation succeeds, cleared whenever the
+ * stored activation clears.
+ */
+declare const OBSERVE_STORAGE_KEY = "elbObserve";
 /**
  * Decide whether a preview bundle should boot in place of this bundle's own flow.
  *
@@ -4568,8 +4672,21 @@ type PosterFetch = (url: string, init: {
     headers: Record<string, string>;
     body: string;
 }) => Promise<PosterResponse>;
+/**
+ * Versioned ingest wire format. Every POST body is one envelope; a batch
+ * split into multiple chunks posts one complete envelope per chunk. The
+ * version field lets the observer evolve its parse without sniffing shapes:
+ * runtimes pinned to this poster keep emitting `v: 1` and the server keeps
+ * accepting it.
+ */
+interface IngestEnvelope {
+    /** Wire format version. */
+    v: 1;
+    /** FlowState records in arrival order, each stamped with a seq. */
+    records: FlowState[];
+}
 interface BatchedPosterOptions {
-    /** Absolute HTTP endpoint URL. POST with JSON array body. */
+    /** Absolute HTTP endpoint URL. POST with a versioned envelope JSON body. */
     url: string;
     /** Bearer token sent in the `Authorization` header. */
     token: string;
@@ -4587,6 +4704,20 @@ interface BatchedPosterOptions {
     fetch?: PosterFetch;
     /** Called when the underlying POST rejects. Defaults to swallowing. */
     onError?: (err: unknown) => void;
+    /**
+     * Extra headers merged into every request (e.g. `X-Walkeros-Binding`).
+     * The fixed `Content-Type` and `Authorization` headers win on collision,
+     * matched case-insensitively (header names are case-insensitive on the
+     * wire, so a lowercase `authorization` is dropped too).
+     */
+    headers?: Record<string, string>;
+    /**
+     * Called with the HTTP status of every response, before any non-2xx
+     * error handling. Lets callers react to a 401/404 (stop posting,
+     * self-heal) without parsing error strings. Not called when the fetch
+     * rejects, since no response exists.
+     */
+    onStatus?: (status: number) => void;
 }
 /**
  * Build a batched emit callback. The returned function is synchronous, never
@@ -5040,4 +5171,4 @@ declare const REF_CODE_PREFIX = "$code:";
  */
 declare function scanFlowRefs(value: unknown, into?: Set<string>): Set<string>;
 
-export { type ActivationGrant, type AssembleJourneysOptions, type BatchedPosterOptions, type BreakerState, CLOCK_SKEW_MS, cache as Cache, type CacheEnvelope, type CacheResult, type ClickIdEntry, collector as Collector, type CompiledCache, Const, context as Context, type Credential, type Debounced, destination as Destination, type DestroyContext, type DestroyFn, type DroppedCounters, ENV_MARKER_PREFIX, elb as Elb, type EmitFn, type ExampleSummary, FatalError, Flow, type FlowConfigResolver, type FlowState, type FlowStateBatch, type FlowStatePhase, type FlowStepType, type GetStore, hint as Hint, hooks as Hooks, type Ingest, type IngestMeta, type Journey, type JourneyAssembly, type JourneyBranch, type JourneyCorrelation, type JourneyEntry, type JourneyGap, type JourneyHop, type JourneyHopStatus, type JourneyPlatform, type JourneyStatus, type JourneyTopology, type JourneyTopologyNode, type JsonSchema, Level, lifecycle as Lifecycle, type LifecycleContext, logger as Logger, MAX_SESSION_MS, mapping as Mapping, type MarketingParameters, matcher as Matcher, type MockLogger, OBSERVE_ENV_KEY, type ObserverFn, on as On, type ParsedGrant, type ParsedTraceparent, type PosterFetch, type PosterResponse, type PreviewCrypto, type PreviewFailure, type PreviewKey, type PreviewSubtle, REF_CODE_PREFIX, REF_CONTRACT, REF_ENV, REF_FLOW, REF_SECRET, REF_STORE, REF_VAR_FULL, REF_VAR_INLINE, request as Request, type ResolveContractsOptions, type ResolveOptions, type RespondFn, type RespondOptions, SECRET_MARKER_PREFIX, SESSION_STORAGE_KEY, STEP_OPERATIVE_FIELDS, type ScheduleOptions, type SendDataValue, type SendHeaders, type SendResponse, type ServiceAccount, type SetupFn, simulation as Simulation, source as Source, type State, type StepEntryErrorCode, type StepEntryValidation, type StepKind, type StorageType, store as Store, StoreCodecError, type SwapActivatorConfig, type TelemetryLevel, type TelemetryOptions, type TelemetryOptionsSupplier, transformer as Transformer, trigger as Trigger, URL_WINDOW_MS, type ValidateEvents, type VerifyParams, type VerifyResult, walkeros as WalkerOS, type WalkerOSPackage, type WalkerOSPackageInfo, type WalkerOSPackageMeta, anonymizeIP, applyState, applyUpdate, assembleJourneys, assign, branch, browserSwapActivator, buildCacheContext, castToProperty, castValue, checkCache, clone, compileCache, compileMatcher, compileState, createBatchedPoster, createDestination, createEvent, createIngest, createLogger, createMockContext, createMockLogger, createRespond, createTelemetryObserver, debounce, deepMerge, defaultClickIds, deleteByPath, deserializeStoreValue, emitStep, fetchPackage, fetchPackageSchema, filterValues, flattenIncludeSections, formatOut, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getFlowSettings, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getNextSteps, getOS, getOSVersion, getPlatform, getSpanId, getTraceId, getTraceUntil, isArguments, isArray, isBoolean, isCommand, isDefined, isElementOrDocument, isEnvObserve, isFunction, isNumber, isObject, isPathStepEntry, isPropertyType, isRouteArray, isRouteConfigEntry, isSameType, isSampled, isStoreValue, isString, mcpError, mcpResult, mergeContractSchemas, mergeMappingRule, mockEnv, packageNameToVariable, parseCallPath, parseGrant, parseTraceparent, parseUserAgent, processEventMapping, readCacheEnvelope, requestToData, requestToParameter, resolveContracts, resolveSetup, resolveTelemetryOptions, scanFlowRefs, serializeStoreValue, setByPath, setTraceUntil, stepId, storeCache, throttle, throwError, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, validateStepEntry, verifyActivation, walkPath, wrapCacheEnvelope, wrapCondition, wrapFn, wrapValidate };
+export { type ActivationGrant, type AssembleJourneysOptions, type BatchedPosterOptions, type BreakerState, CLOCK_SKEW_MS, cache as Cache, type CacheEnvelope, type CacheResult, type ClickIdEntry, collector as Collector, type CompiledCache, Const, context as Context, type Credential, type Debounced, destination as Destination, type DestroyContext, type DestroyFn, type DroppedCounters, ENV_MARKER_PREFIX, elb as Elb, type EmitFn, type ExampleSummary, FatalError, Flow, type FlowConfigResolver, type FlowState, type FlowStateBatch, type FlowStatePhase, type FlowStepType, type GetStore, hint as Hint, hooks as Hooks, type Ingest, type IngestEnvelope, type IngestMeta, type Journey, type JourneyAssembly, type JourneyBranch, type JourneyCorrelation, type JourneyEntry, type JourneyGap, type JourneyHop, type JourneyHopStatus, type JourneyPlatform, type JourneyStatus, type JourneyTopology, type JourneyTopologyNode, type JsonSchema, Level, lifecycle as Lifecycle, type LifecycleContext, logger as Logger, MAX_SESSION_MS, mapping as Mapping, type MarketingParameters, matcher as Matcher, type MockLogger, OBSERVE_ENV_KEY, OBSERVE_STORAGE_KEY, type Observe, type ObserveCredential, type ObserveServer, type ObserveWeb, type ObserverFn, on as On, type ParsedGrant, type ParsedTraceparent, type PosterFetch, type PosterResponse, type PreviewCrypto, type PreviewFailure, type PreviewKey, type PreviewSubtle, REF_CODE_PREFIX, REF_CONTRACT, REF_ENV, REF_FLOW, REF_SECRET, REF_STORE, REF_VAR_FULL, REF_VAR_INLINE, request as Request, type ResolveContractsOptions, type ResolveOptions, type RespondFn, type RespondOptions, SECRET_MARKER_PREFIX, SESSION_STORAGE_KEY, STEP_OPERATIVE_FIELDS, type ScheduleOptions, type SendDataValue, type SendHeaders, type SendResponse, type ServiceAccount, type SetupFn, simulation as Simulation, source as Source, type State, type StepEntryErrorCode, type StepEntryValidation, type StepKind, type StorageType, store as Store, StoreCodecError, type SwapActivatorConfig, type TelemetryLevel, type TelemetryOptions, type TelemetryOptionsSupplier, transformer as Transformer, trigger as Trigger, URL_WINDOW_MS, type ValidateEvents, type VerifyParams, type VerifyResult, walkeros as WalkerOS, type WalkerOSPackage, type WalkerOSPackageInfo, type WalkerOSPackageMeta, anonymizeIP, applyState, applyUpdate, assembleJourneys, assign, branch, browserSwapActivator, buildCacheContext, castToProperty, castValue, checkCache, clone, compileCache, compileMatcher, compileState, createBatchedPoster, createDestination, createEvent, createIngest, createLogger, createMockContext, createMockLogger, createRespond, createTelemetryObserver, debounce, deepMerge, defaultClickIds, deleteByPath, deserializeStoreValue, emitStep, fetchPackage, fetchPackageSchema, filterValues, flattenIncludeSections, formatOut, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getFlowSettings, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getNextSteps, getOS, getOSVersion, getPlatform, getSpanId, getTraceId, getTraceUntil, isArguments, isArray, isBoolean, isCommand, isDefined, isElementOrDocument, isEnvObserve, isFunction, isNumber, isObject, isPathStepEntry, isPropertyType, isRouteArray, isRouteConfigEntry, isSameType, isSampled, isStoreValue, isString, mcpError, mcpResult, mergeContractSchemas, mergeMappingRule, mockEnv, observeFromEnv, packageNameToVariable, parseCallPath, parseGrant, parseObserveCredential, parseTraceparent, parseUserAgent, processEventMapping, readCacheEnvelope, requestToData, requestToParameter, resolveContracts, resolveSetup, resolveTelemetryOptions, scanFlowRefs, serializeStoreValue, setByPath, setTraceUntil, stepId, storeCache, throttle, throwError, transformData, traverseEnv, trim, tryCatch, tryCatchAsync, useHooks, validateStepEntry, verifyActivation, walkPath, wrapCacheEnvelope, wrapCondition, wrapFn, wrapValidate };