@walkeros/core 4.3.0 → 4.3.1-next-1784373088875

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @walkeros/core
 
+## 4.3.1-next-1784373088875
+
+### Patch Changes
+
+- f2030ab: Push results now report when an event was intentionally dropped by a
+  transformer chain, via a new `PushResult.dropped` flag, instead of a drop
+  looking identical to a normal delivery. The chain result also names which
+  transformer stopped the chain (`ChainResult.droppedBy`), and the collector
+  logs the drop at debug level.
+- 2d6ab82: Connect a running flow to an observation session and watch its live
+  events from web, server, or bundled runtimes. Commit only a public observer
+  URL and project binding; the per-session credential arrives out-of-band, so no
+  secrets land in code or artifacts. Ingest posts carry a versioned envelope
+  with release provenance, and `walkeros observe start` opens sessions from the
+  terminal.
+
 ## 4.3.0
 
 ### Minor Changes

package/dist/dev.d.mts

@@ -3568,6 +3568,21 @@ declare const InitConfigSchema: z.ZodObject<{
     stores: z.ZodOptional<z.ZodUnknown>;
     custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>>;
     hooks: z.ZodOptional<z.ZodUnknown>;
+    observe: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        url: z.ZodString;
+        binding: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        url: z.ZodString;
+        sessionId: z.ZodString;
+        token: z.ZodString;
+        level: z.ZodOptional<z.ZodEnum<{
+            trace: "trace";
+            off: "off";
+            standard: "standard";
+        }>>;
+        sample: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>;
+    observers: z.ZodOptional<z.ZodUnknown>;
 }, z.core.$strip>;
 /**
  * PushContext - Context for collector.push
@@ -5272,12 +5287,30 @@ declare const ContractSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
     events: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
     schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>>;
+/**
+ * Observe schema (Flow.Observe).
+ *
+ * @remarks
+ * Observability configuration block. `url` + `binding` form the public web
+ * connect pair (safe to commit; the per-session credential arrives
+ * out-of-band). `level` and `sample` are managed-telemetry knobs.
+ */
+declare const ObserveSchema: z.ZodObject<{
+    level: z.ZodOptional<z.ZodEnum<{
+        trace: "trace";
+        off: "off";
+        standard: "standard";
+    }>>;
+    sample: z.ZodOptional<z.ZodNumber>;
+    url: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 /**
  * Per-flow Config schema (Flow.Config).
  *
  * @remarks
  * Groups platform identity, optional public URL, free-form settings bag,
- * and bundle (build-time) configuration.
+ * bundle (build-time) configuration, and observability configuration.
  */
 declare const ConfigSchema: z.ZodObject<{
     platform: z.ZodEnum<{
@@ -5295,6 +5328,16 @@ declare const ConfigSchema: z.ZodObject<{
         overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         traceInclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
+    observe: z.ZodOptional<z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<{
+            trace: "trace";
+            off: "off";
+            standard: "standard";
+        }>>;
+        sample: z.ZodOptional<z.ZodNumber>;
+        url: z.ZodOptional<z.ZodString>;
+        binding: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
  * Single flow schema (Flow).
@@ -5320,6 +5363,16 @@ declare const FlowSchema: z.ZodObject<{
             overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             traceInclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>;
+        observe: z.ZodOptional<z.ZodObject<{
+            level: z.ZodOptional<z.ZodEnum<{
+                trace: "trace";
+                off: "off";
+                standard: "standard";
+            }>>;
+            sample: z.ZodOptional<z.ZodNumber>;
+            url: z.ZodOptional<z.ZodString>;
+            binding: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     sources: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         package: z.ZodOptional<z.ZodString>;
@@ -5534,6 +5587,16 @@ declare const JsonSchema$1: z.ZodObject<{
                 overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 traceInclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strict>>;
+            observe: z.ZodOptional<z.ZodObject<{
+                level: z.ZodOptional<z.ZodEnum<{
+                    trace: "trace";
+                    off: "off";
+                    standard: "standard";
+                }>>;
+                sample: z.ZodOptional<z.ZodNumber>;
+                url: z.ZodOptional<z.ZodString>;
+                binding: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         sources: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             package: z.ZodOptional<z.ZodString>;
@@ -5753,6 +5816,12 @@ declare function safeParseConfig(data: unknown): z.ZodSafeParseResult<{
                 overrides?: Record<string, string> | undefined;
                 traceInclude?: string[] | undefined;
             } | undefined;
+            observe?: {
+                level?: "trace" | "off" | "standard" | undefined;
+                sample?: number | undefined;
+                url?: string | undefined;
+                binding?: string | undefined;
+            } | undefined;
         } | undefined;
         sources?: Record<string, {
             package?: string | undefined;
@@ -5950,6 +6019,12 @@ declare function safeParseFlow(data: unknown): z.ZodSafeParseResult<{
             overrides?: Record<string, string> | undefined;
             traceInclude?: string[] | undefined;
         } | undefined;
+        observe?: {
+            level?: "trace" | "off" | "standard" | undefined;
+            sample?: number | undefined;
+            url?: string | undefined;
+            binding?: string | undefined;
+        } | undefined;
     } | undefined;
     sources?: Record<string, {
         package?: string | undefined;
@@ -6147,6 +6222,16 @@ declare const configJsonSchema: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<
                 overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 traceInclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strict>>;
+            observe: z.ZodOptional<z.ZodObject<{
+                level: z.ZodOptional<z.ZodEnum<{
+                    trace: "trace";
+                    off: "off";
+                    standard: "standard";
+                }>>;
+                sample: z.ZodOptional<z.ZodNumber>;
+                url: z.ZodOptional<z.ZodString>;
+                binding: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         sources: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             package: z.ZodOptional<z.ZodString>;
@@ -6375,6 +6460,7 @@ declare const flow_ContractSchemaEntry: typeof ContractSchemaEntry;
 declare const flow_DestinationSchema: typeof DestinationSchema;
 declare const flow_FlowSchema: typeof FlowSchema;
 declare const flow_JsonSchemaSchema: typeof JsonSchemaSchema;
+declare const flow_ObserveSchema: typeof ObserveSchema;
 declare const flow_SettingsSchema: typeof SettingsSchema;
 declare const flow_SourceSchema: typeof SourceSchema;
 declare const flow_StepExampleSchema: typeof StepExampleSchema;
@@ -6399,7 +6485,7 @@ declare const flow_storeJsonSchema: typeof storeJsonSchema;
 declare const flow_transformerJsonSchema: typeof transformerJsonSchema;
 declare const flow_validateEventsJsonSchema: typeof validateEventsJsonSchema;
 declare namespace flow {
-  export { flow_BundlePackageSchema as BundlePackageSchema, flow_BundleSchema as BundleSchema, CodeSchema$1 as CodeSchema, flow_ConfigSchema as ConfigSchema, flow_ContractActionsSchema as ContractActionsSchema, flow_ContractEventsSchema as ContractEventsSchema, flow_ContractRuleSchema as ContractRuleSchema, flow_ContractSchema as ContractSchema, flow_ContractSchemaEntry as ContractSchemaEntry, flow_DestinationSchema as DestinationSchema, flow_FlowSchema as FlowSchema, JsonSchema$1 as JsonSchema, flow_JsonSchemaSchema as JsonSchemaSchema, flow_SettingsSchema as SettingsSchema, flow_SourceSchema as SourceSchema, flow_StepExampleSchema as StepExampleSchema, flow_StepExamplesSchema as StepExamplesSchema, flow_StoreSchema as StoreSchema, flow_TransformerSchema as TransformerSchema, flow_TriggerDescriptorSchema as TriggerDescriptorSchema, flow_ValidateEventsSchema as ValidateEventsSchema, flow_VariablesSchema as VariablesSchema, flow_configJsonSchema as configJsonSchema, flow_contractJsonSchema as contractJsonSchema, flow_contractRuleJsonSchema as contractRuleJsonSchema, flow_destinationJsonSchema as destinationJsonSchema, flow_flowConfigJsonSchema as flowConfigJsonSchema, flow_flowJsonSchema as flowJsonSchema, flow_parseConfig as parseConfig, flow_parseFlow as parseFlow, flow_safeParseConfig as safeParseConfig, flow_safeParseFlow as safeParseFlow, flow_sourceJsonSchema as sourceJsonSchema, flow_storeJsonSchema as storeJsonSchema, flow_transformerJsonSchema as transformerJsonSchema, flow_validateEventsJsonSchema as validateEventsJsonSchema };
+  export { flow_BundlePackageSchema as BundlePackageSchema, flow_BundleSchema as BundleSchema, CodeSchema$1 as CodeSchema, flow_ConfigSchema as ConfigSchema, flow_ContractActionsSchema as ContractActionsSchema, flow_ContractEventsSchema as ContractEventsSchema, flow_ContractRuleSchema as ContractRuleSchema, flow_ContractSchema as ContractSchema, flow_ContractSchemaEntry as ContractSchemaEntry, flow_DestinationSchema as DestinationSchema, flow_FlowSchema as FlowSchema, JsonSchema$1 as JsonSchema, flow_JsonSchemaSchema as JsonSchemaSchema, flow_ObserveSchema as ObserveSchema, flow_SettingsSchema as SettingsSchema, flow_SourceSchema as SourceSchema, flow_StepExampleSchema as StepExampleSchema, flow_StepExamplesSchema as StepExamplesSchema, flow_StoreSchema as StoreSchema, flow_TransformerSchema as TransformerSchema, flow_TriggerDescriptorSchema as TriggerDescriptorSchema, flow_ValidateEventsSchema as ValidateEventsSchema, flow_VariablesSchema as VariablesSchema, flow_configJsonSchema as configJsonSchema, flow_contractJsonSchema as contractJsonSchema, flow_contractRuleJsonSchema as contractRuleJsonSchema, flow_destinationJsonSchema as destinationJsonSchema, flow_flowConfigJsonSchema as flowConfigJsonSchema, flow_flowJsonSchema as flowJsonSchema, flow_parseConfig as parseConfig, flow_parseFlow as parseFlow, flow_safeParseConfig as safeParseConfig, flow_safeParseFlow as safeParseFlow, flow_sourceJsonSchema as sourceJsonSchema, flow_storeJsonSchema as storeJsonSchema, flow_transformerJsonSchema as transformerJsonSchema, flow_validateEventsJsonSchema as validateEventsJsonSchema };
 }
 
 /**
@@ -7304,6 +7390,43 @@ interface Ingest {
     _meta: IngestMeta;
 }
 
+/**
+ * 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;
+
 /**
  * FlowState is the canonical observation record emitted at each hop in a
  * walkerOS pipeline. Telemetry helpers populate one of these per (step,
@@ -7344,6 +7467,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
@@ -7471,6 +7596,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;
@@ -9173,6 +9312,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).

package/dist/dev.d.ts

@@ -3568,6 +3568,21 @@ declare const InitConfigSchema: z.ZodObject<{
     stores: z.ZodOptional<z.ZodUnknown>;
     custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>>;
     hooks: z.ZodOptional<z.ZodUnknown>;
+    observe: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        url: z.ZodString;
+        binding: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        url: z.ZodString;
+        sessionId: z.ZodString;
+        token: z.ZodString;
+        level: z.ZodOptional<z.ZodEnum<{
+            trace: "trace";
+            off: "off";
+            standard: "standard";
+        }>>;
+        sample: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>;
+    observers: z.ZodOptional<z.ZodUnknown>;
 }, z.core.$strip>;
 /**
  * PushContext - Context for collector.push
@@ -5272,12 +5287,30 @@ declare const ContractSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
     events: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
     schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>>;
+/**
+ * Observe schema (Flow.Observe).
+ *
+ * @remarks
+ * Observability configuration block. `url` + `binding` form the public web
+ * connect pair (safe to commit; the per-session credential arrives
+ * out-of-band). `level` and `sample` are managed-telemetry knobs.
+ */
+declare const ObserveSchema: z.ZodObject<{
+    level: z.ZodOptional<z.ZodEnum<{
+        trace: "trace";
+        off: "off";
+        standard: "standard";
+    }>>;
+    sample: z.ZodOptional<z.ZodNumber>;
+    url: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 /**
  * Per-flow Config schema (Flow.Config).
  *
  * @remarks
  * Groups platform identity, optional public URL, free-form settings bag,
- * and bundle (build-time) configuration.
+ * bundle (build-time) configuration, and observability configuration.
  */
 declare const ConfigSchema: z.ZodObject<{
     platform: z.ZodEnum<{
@@ -5295,6 +5328,16 @@ declare const ConfigSchema: z.ZodObject<{
         overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         traceInclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
+    observe: z.ZodOptional<z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<{
+            trace: "trace";
+            off: "off";
+            standard: "standard";
+        }>>;
+        sample: z.ZodOptional<z.ZodNumber>;
+        url: z.ZodOptional<z.ZodString>;
+        binding: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
  * Single flow schema (Flow).
@@ -5320,6 +5363,16 @@ declare const FlowSchema: z.ZodObject<{
             overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             traceInclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>;
+        observe: z.ZodOptional<z.ZodObject<{
+            level: z.ZodOptional<z.ZodEnum<{
+                trace: "trace";
+                off: "off";
+                standard: "standard";
+            }>>;
+            sample: z.ZodOptional<z.ZodNumber>;
+            url: z.ZodOptional<z.ZodString>;
+            binding: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     sources: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         package: z.ZodOptional<z.ZodString>;
@@ -5534,6 +5587,16 @@ declare const JsonSchema$1: z.ZodObject<{
                 overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 traceInclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strict>>;
+            observe: z.ZodOptional<z.ZodObject<{
+                level: z.ZodOptional<z.ZodEnum<{
+                    trace: "trace";
+                    off: "off";
+                    standard: "standard";
+                }>>;
+                sample: z.ZodOptional<z.ZodNumber>;
+                url: z.ZodOptional<z.ZodString>;
+                binding: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         sources: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             package: z.ZodOptional<z.ZodString>;
@@ -5753,6 +5816,12 @@ declare function safeParseConfig(data: unknown): z.ZodSafeParseResult<{
                 overrides?: Record<string, string> | undefined;
                 traceInclude?: string[] | undefined;
             } | undefined;
+            observe?: {
+                level?: "trace" | "off" | "standard" | undefined;
+                sample?: number | undefined;
+                url?: string | undefined;
+                binding?: string | undefined;
+            } | undefined;
         } | undefined;
         sources?: Record<string, {
             package?: string | undefined;
@@ -5950,6 +6019,12 @@ declare function safeParseFlow(data: unknown): z.ZodSafeParseResult<{
             overrides?: Record<string, string> | undefined;
             traceInclude?: string[] | undefined;
         } | undefined;
+        observe?: {
+            level?: "trace" | "off" | "standard" | undefined;
+            sample?: number | undefined;
+            url?: string | undefined;
+            binding?: string | undefined;
+        } | undefined;
     } | undefined;
     sources?: Record<string, {
         package?: string | undefined;
@@ -6147,6 +6222,16 @@ declare const configJsonSchema: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<
                 overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 traceInclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strict>>;
+            observe: z.ZodOptional<z.ZodObject<{
+                level: z.ZodOptional<z.ZodEnum<{
+                    trace: "trace";
+                    off: "off";
+                    standard: "standard";
+                }>>;
+                sample: z.ZodOptional<z.ZodNumber>;
+                url: z.ZodOptional<z.ZodString>;
+                binding: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         sources: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             package: z.ZodOptional<z.ZodString>;
@@ -6375,6 +6460,7 @@ declare const flow_ContractSchemaEntry: typeof ContractSchemaEntry;
 declare const flow_DestinationSchema: typeof DestinationSchema;
 declare const flow_FlowSchema: typeof FlowSchema;
 declare const flow_JsonSchemaSchema: typeof JsonSchemaSchema;
+declare const flow_ObserveSchema: typeof ObserveSchema;
 declare const flow_SettingsSchema: typeof SettingsSchema;
 declare const flow_SourceSchema: typeof SourceSchema;
 declare const flow_StepExampleSchema: typeof StepExampleSchema;
@@ -6399,7 +6485,7 @@ declare const flow_storeJsonSchema: typeof storeJsonSchema;
 declare const flow_transformerJsonSchema: typeof transformerJsonSchema;
 declare const flow_validateEventsJsonSchema: typeof validateEventsJsonSchema;
 declare namespace flow {
-  export { flow_BundlePackageSchema as BundlePackageSchema, flow_BundleSchema as BundleSchema, CodeSchema$1 as CodeSchema, flow_ConfigSchema as ConfigSchema, flow_ContractActionsSchema as ContractActionsSchema, flow_ContractEventsSchema as ContractEventsSchema, flow_ContractRuleSchema as ContractRuleSchema, flow_ContractSchema as ContractSchema, flow_ContractSchemaEntry as ContractSchemaEntry, flow_DestinationSchema as DestinationSchema, flow_FlowSchema as FlowSchema, JsonSchema$1 as JsonSchema, flow_JsonSchemaSchema as JsonSchemaSchema, flow_SettingsSchema as SettingsSchema, flow_SourceSchema as SourceSchema, flow_StepExampleSchema as StepExampleSchema, flow_StepExamplesSchema as StepExamplesSchema, flow_StoreSchema as StoreSchema, flow_TransformerSchema as TransformerSchema, flow_TriggerDescriptorSchema as TriggerDescriptorSchema, flow_ValidateEventsSchema as ValidateEventsSchema, flow_VariablesSchema as VariablesSchema, flow_configJsonSchema as configJsonSchema, flow_contractJsonSchema as contractJsonSchema, flow_contractRuleJsonSchema as contractRuleJsonSchema, flow_destinationJsonSchema as destinationJsonSchema, flow_flowConfigJsonSchema as flowConfigJsonSchema, flow_flowJsonSchema as flowJsonSchema, flow_parseConfig as parseConfig, flow_parseFlow as parseFlow, flow_safeParseConfig as safeParseConfig, flow_safeParseFlow as safeParseFlow, flow_sourceJsonSchema as sourceJsonSchema, flow_storeJsonSchema as storeJsonSchema, flow_transformerJsonSchema as transformerJsonSchema, flow_validateEventsJsonSchema as validateEventsJsonSchema };
+  export { flow_BundlePackageSchema as BundlePackageSchema, flow_BundleSchema as BundleSchema, CodeSchema$1 as CodeSchema, flow_ConfigSchema as ConfigSchema, flow_ContractActionsSchema as ContractActionsSchema, flow_ContractEventsSchema as ContractEventsSchema, flow_ContractRuleSchema as ContractRuleSchema, flow_ContractSchema as ContractSchema, flow_ContractSchemaEntry as ContractSchemaEntry, flow_DestinationSchema as DestinationSchema, flow_FlowSchema as FlowSchema, JsonSchema$1 as JsonSchema, flow_JsonSchemaSchema as JsonSchemaSchema, flow_ObserveSchema as ObserveSchema, flow_SettingsSchema as SettingsSchema, flow_SourceSchema as SourceSchema, flow_StepExampleSchema as StepExampleSchema, flow_StepExamplesSchema as StepExamplesSchema, flow_StoreSchema as StoreSchema, flow_TransformerSchema as TransformerSchema, flow_TriggerDescriptorSchema as TriggerDescriptorSchema, flow_ValidateEventsSchema as ValidateEventsSchema, flow_VariablesSchema as VariablesSchema, flow_configJsonSchema as configJsonSchema, flow_contractJsonSchema as contractJsonSchema, flow_contractRuleJsonSchema as contractRuleJsonSchema, flow_destinationJsonSchema as destinationJsonSchema, flow_flowConfigJsonSchema as flowConfigJsonSchema, flow_flowJsonSchema as flowJsonSchema, flow_parseConfig as parseConfig, flow_parseFlow as parseFlow, flow_safeParseConfig as safeParseConfig, flow_safeParseFlow as safeParseFlow, flow_sourceJsonSchema as sourceJsonSchema, flow_storeJsonSchema as storeJsonSchema, flow_transformerJsonSchema as transformerJsonSchema, flow_validateEventsJsonSchema as validateEventsJsonSchema };
 }
 
 /**
@@ -7304,6 +7390,43 @@ interface Ingest {
     _meta: IngestMeta;
 }
 
+/**
+ * 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;
+
 /**
  * FlowState is the canonical observation record emitted at each hop in a
  * walkerOS pipeline. Telemetry helpers populate one of these per (step,
@@ -7344,6 +7467,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
@@ -7471,6 +7596,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;
@@ -9173,6 +9312,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).